88 lines
4.1 KiB
Markdown
88 lines
4.1 KiB
Markdown
The `rad job` command lets you manage job COBs. Let's first checkout the
|
|
`heartwood` repository:
|
|
|
|
```
|
|
$ rad checkout rad:z42hL2jL4XNk6K8oHQaSWfMgCL7ji
|
|
✓ Repository checkout successful under ./heartwood
|
|
$ cd heartwood
|
|
```
|
|
|
|
Using the `rad job` (or `rad job list`) command we can see that there are
|
|
currently no jobs listed:
|
|
|
|
```
|
|
$ rad job
|
|
Nothing to show.
|
|
```
|
|
|
|
Let's create a job to represent a new CI run. We check what the current `HEAD`
|
|
of the repository is, and use the `rad job trigger` to start a fresh job for
|
|
that commit:
|
|
|
|
```
|
|
$ git rev-parse HEAD
|
|
f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354
|
|
$ rad job trigger f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354
|
|
╭──────────────────────────────────────────────────╮
|
|
│ Job fbbda2447c30ebbab9b746498cd41a383ff05225 │
|
|
│ Commit f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354 │
|
|
│ State fresh │
|
|
╰──────────────────────────────────────────────────╯
|
|
```
|
|
|
|
Let's check the list again, and we should we see our fresh job there:
|
|
|
|
```
|
|
$ rad job
|
|
╭───────────────────────────────╮
|
|
│ ● ID Commit State │
|
|
├───────────────────────────────┤
|
|
│ ● fbbda24 f2de534 fresh │
|
|
╰───────────────────────────────╯
|
|
```
|
|
|
|
From there we can start a new job, assigning an arbitrary identifier `xyzzy`,
|
|
which would usually from the CI system that is running the job:
|
|
|
|
```
|
|
$ rad job start fbbda2447c30ebbab9b746498cd41a383ff05225 xyzzy
|
|
```
|
|
|
|
Checking the job again, we can now see that the job is `running`:
|
|
|
|
```
|
|
$ rad job
|
|
╭─────────────────────────────────╮
|
|
│ ● ID Commit State │
|
|
├─────────────────────────────────┤
|
|
│ ● fbbda24 f2de534 running │
|
|
╰─────────────────────────────────╯
|
|
$ rad job show fbbda2447c30ebbab9b746498cd41a383ff05225
|
|
╭──────────────────────────────────────────────────╮
|
|
│ Job fbbda2447c30ebbab9b746498cd41a383ff05225 │
|
|
│ Commit f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354 │
|
|
│ State running │
|
|
│ Run ID xyzzy │
|
|
╰──────────────────────────────────────────────────╯
|
|
```
|
|
|
|
When a job has finished, we can mark it as done -- either with a `--success` or
|
|
`--failed` flag -- using the `rad job finish` command:
|
|
|
|
```
|
|
$ rad job finish --success fbbda2447c30ebbab9b746498cd41a383ff05225
|
|
$ rad job
|
|
╭───────────────────────────────────╮
|
|
│ ● ID Commit State │
|
|
├───────────────────────────────────┤
|
|
│ ● fbbda24 f2de534 succeeded │
|
|
╰───────────────────────────────────╯
|
|
$ rad job show fbbda2447c30ebbab9b746498cd41a383ff05225
|
|
╭──────────────────────────────────────────────────╮
|
|
│ Job fbbda2447c30ebbab9b746498cd41a383ff05225 │
|
|
│ Commit f2de534b5e81d7c6e2dcaf58c3dd91573c0a0354 │
|
|
│ State succeeded │
|
|
│ Run ID xyzzy │
|
|
╰──────────────────────────────────────────────────╯
|
|
```
|