You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
* Add changes to restart from stepRewrote restart pipeline section with change to restart in pipeline policy* Update restart step option* Update monitoring-pipelines.md
*Globalbuild view: The default view, displaysbuilds for allpipelines for all projectsacross your organization.
13
+
*Project build view: Selecting aprojectdisplays the builds for thepipelines in theproject.
14
14
15
15
Both views have the same controls and filters.
16
16
@@ -368,39 +368,50 @@ max-width="70%"
368
368
369
369
###Restarting the pipeline
370
370
371
-
You can choose to restart any pipeline by clicking the button at the top right corner.
371
+
You can restart a failed pipeline either from the beginning or from a failed step.
372
+
373
+
* Restart from beginning
374
+
Restarts the pipeline with the**same** state as in its original execution, including the original Git commit.
375
+
>To restart the pipeline with a_new_ state, use the**Run** button in the[pipeline editor]({{site.baseurl}}/docs/pipelines/pipelines/#using-the-inline-pipeline-editor), and select any of the available[triggers]({{site.baseurl}}/docs/pipelines/triggers/).
376
+
377
+
* Restart from failed step
378
+
Restarts the pipeline from the step that failed in the previous execution. Similar to restarting from the beginning, restarting from a failed step also restarts the pipeline with the same state at that point in time, including the original Git commit. You can restart from the Builds page or directly from the specific step that failed.
379
+
380
+
381
+
382
+
>The option to restart from a failed step is available only when**Permit restart pipeline from failed step** is enabled in the pipeline's settings. See[Restart pipeline option in Policies]({{site.baseurl}}/docs/pipelines/pipelines/#policies).<br>
383
+
If your pipeline has some flaky steps, you can also use the [retry syntax]({{site.baseurl}}/docs/pipelines/what-is-the-codefresh-yaml/#retrying-a-step) in your YAML instead of restarting them manually each time they fail.
384
+
385
+
**Restart pipeline from Builds view**
386
+
387
+
* In the row with the pipeline to restart, click**Restart**, and then select the required option.
388
+
>Disabled**From Failed Steps** indicates that the option is not enabled for the pipeline.
>It is important to note that "Restart from beginning" will restart a pipeline with the**same** state that it had in its original execution (including the original git commit). If you want to execute a pipeline again with a new state instead, you need to use the*Run* button in the[pipeline editor]({{site.baseurl}}/docs/pipelines/pipelines/#using-the-inline-pipeline-editor) and selecting any of the available[triggers]({{site.baseurl}}/docs/pipelines/triggers/).
384
-
385
-
386
-
387
-
If the pipeline has failed, you can choose to restart it only from the failed step and onwards.
388
-
389
-
You can also restart from a failed step right from the graphical view:
401
+
**Restart from step view**
402
+
* Click the pipeline to view its steps.
403
+
* Go to the failed step, right-click and then select**Restart from this step**.
>Notice again that restarting a pipeline from a failed step means restarting the pipeline with the**same** state that it had at the point in time (including the original git commit).
402
-
403
-
If your pipeline has some flaky steps, you can also use the[retry syntax]({{site.baseurl}}/docs/pipelines/what-is-the-codefresh-yaml/#retrying-a-step) in your yaml instead of restarting them manually each time they fail.
404
415
405
416
406
417
##Monitoring pipelines outside the Codefresh UI
@@ -424,8 +435,8 @@ caption="Pull Request Status"
424
435
max-width="50%"
425
436
%}
426
437
427
-
If you havesetupa[Git trigger]({{site.baseurl}}/docs/pipelines/triggers/git-triggers/) in Codefresh then by default this happens automatically without any other configuration
428
-
for all automated commits(that are comingfrom webhooks).
438
+
If you haveset upa[Git trigger]({{site.baseurl}}/docs/pipelines/triggers/git-triggers/) in Codefresh, then by default this happens automatically without any other configuration
439
+
for all automated commits from webhooks.
429
440
430
441
If you start a build manually then by default the git status will**not** be updated (i.e. the result of the pipeline
Copy file name to clipboardExpand all lines: _docs/pipelines/pipelines.md
+5Lines changed: 5 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -223,6 +223,11 @@ Once you create your pipeline you can also click on the top tab called *Settings
223
223
- Builds in pending approval will**be** counted when determining the concurrency limit for a pipeline
224
224
- Honor the option defined globally in your Codefresh account
225
225
226
+
-**Restart pipeline**
227
+
**Permit restart pipeline from failed step**: When enabled (the default), allows users to restart the pipeline directly from the failed step. Otherwise, users can only restart the pipeline from the beginning.
228
+
229
+
As this option restarts the failed step with the same state, you may find it useful to disable this option based on the usage. For example, restarting a custom Helm promotion step that failed, restarts the step with the same revision and does not promote the newest images as it should.
230
+
226
231
####Select Kubernetes cluster contexts
227
232
By default, all clusters integrated with Codefresh are automatically available for all pipelines in the account.
228
233
The inject cluster option when enabled for the account allows you to selectively restrict the clusters which can be accessed from pipelines created for the user account.