Skip to content

Commit

Permalink
fix: Add rollback FAQ and slack notifications image (#157)
Browse files Browse the repository at this point in the history
  • Loading branch information
tkyi authored Mar 19, 2018
1 parent 8f6db57 commit a9788c4
Show file tree
Hide file tree
Showing 3 changed files with 23 additions and 7 deletions.
28 changes: 22 additions & 6 deletions docs/user-guide/FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,12 +80,28 @@ requires different approaches based on what layer it's failing.

1.`/opt/sd/launch: not found` This issue affects Alpine based images because it uses musl instead of glibc. Workaround is to create the following symlink `mkdir /lib64 && ln -s /lib/libc.musl-x86_64.so.1 /lib64/ld-linux-x86-64.so.2` when creating your Docker image.

## How do I re-run a job's build?
To re-run a job's build from a past event, do the following steps.
## How do I rollback?

1. User must be logged-in.
1. Click on desired event from event list, which loads the detailed event graph.
1. Click on the the job icon from the graph and click "Start pipeline from here".
You can use one of two patterns to rollback: either rerunning a build in your pipeline or running a detached pipeline.

![Select Event and load event graph](../assets/re-run-select.png)
### How do I rerun a job's build?

To rerun a job's build from a past event, do the following steps.

1. Log in.
1. Click on the desired event from the event list, which loads the detailed event graph.
1. Then, click the job bubble you'd like to rerun. In the pop up, select “Start pipeline from here” to rerun that job using that event context.
![Load event graph](../assets/re-run-select.png)
![Start new build for job](../assets/re-run-start.png)

### How do I run a detached pipeline?

To rollback, do the following steps. You'll most likely want to `meta set` an image name or version in your last job (in this example, job D) and `meta get` that name or version in your rollback job (in this example, detached). The detached job will have access to the metadata set in job D.

1. Log in.
1. Click on the desired event from the event list, which loads the detailed event graph.
![Select Event](http://78.media.tumblr.com/fb595b0e3f2493c9b4623a05d2dd60dc/tumblr_inline_p5aw66dJ1n1uvhog4_1280.png)
1. Then, click the job bubble at the start of that detached pipeline. In the pop up, select “Start pipeline from here” to start the detached workflow with the desired event context.
![Load event graph](http://78.media.tumblr.com/fb595b0e3f2493c9b4623a05d2dd60dc/tumblr_inline_p5aw66dJ1n1uvhog4_1280.png)
1. Click Yes to rerun the pipeline from that job.
![Start new build for job](http://78.media.tumblr.com/f99978ba2dcea4a67e352b053e50ae76/tumblr_inline_p5aw6lyDLW1uvhog4_1280.png)
Binary file added docs/user-guide/assets/slack-notification.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/user-guide/configuration/workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -143,7 +143,7 @@ jobs:
```

## Detached Jobs and Pipelines
It is possible to define workflows that do not have any external trigger. These workflows are "detached" from the normal flow of the pipeline. Some example use cases of this would be to define a rollback flow for your pipeline that could be manually triggered. Invoking a detached pipeline involves the same steps as [Re-running a job's build](../FAQ#how-do-i-re-run-a-jobs-build)
It is possible to define workflows that do not have any external trigger. These workflows are "detached" from the normal flow of the pipeline. Some example use cases of this would be to define a rollback flow for your pipeline that could be manually triggered. Invoking a detached pipeline involves the same steps as doing a [rollback](../FAQ#how-do-i-rollback).

### Example
In the following example `detached-main` job is detached.
Expand Down

0 comments on commit a9788c4

Please sign in to comment.