summaryrefslogtreecommitdiff
path: root/doc/ci
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ci')
-rw-r--r--doc/ci/img/pipeline-delete.pngbin0 -> 35251 bytes
-rw-r--r--doc/ci/pipelines.md22
2 files changed, 19 insertions, 3 deletions
diff --git a/doc/ci/img/pipeline-delete.png b/doc/ci/img/pipeline-delete.png
new file mode 100644
index 00000000000..65b42100099
--- /dev/null
+++ b/doc/ci/img/pipeline-delete.png
Binary files differ
diff --git a/doc/ci/pipelines.md b/doc/ci/pipelines.md
index d1e50039417..4d942ea3d54 100644
--- a/doc/ci/pipelines.md
+++ b/doc/ci/pipelines.md
@@ -305,12 +305,14 @@ For example, the query string
### Accessing pipelines
You can find the current and historical pipeline runs under your project's
-**CI/CD > Pipelines** page. Clicking on a pipeline will show the jobs that were run for
-that pipeline.
+**CI/CD > Pipelines** page. You can also access pipelines for a merge request by navigating
+to its **Pipelines** tab.
![Pipelines index page](img/pipelines_index.png)
-You can also access pipelines for a merge request by navigating to its **Pipelines** tab.
+Clicking on a pipeline will bring you to the **Pipeline Details** page and show
+the jobs that were run for that pipeline. From here you can cancel a running pipeline,
+retry jobs on a failed pipeline, or [delete a pipeline](#deleting-a-single-pipeline).
### Accessing individual jobs
@@ -410,6 +412,20 @@ This functionality is only available:
- For users with at least Developer access.
- If the the stage contains [manual actions](#manual-actions-from-pipeline-graphs).
+### Deleting a single pipeline
+
+> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/24851) in GitLab 12.7.
+
+Users with [owner permissions](../user/permissions.md) in a project can delete a pipeline
+by clicking on the pipeline in the **CI/CD > Pipelines** to get to the **Pipeline Details**
+page, then using the **Delete** button.
+
+![Pipeline Delete Button](img/pipeline-delete.png)
+
+CAUTION: **Warning:**
+Deleting a pipeline will expire all pipeline caches, and delete all related objects,
+such as builds, logs, artifacts, and triggers. **This action cannot be undone.**
+
## Most Recent Pipeline
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/issues/50499) in GitLab 12.3.