1 | @heroku-cli/plugin-ci
|
2 | =====================
|
3 |
|
4 | Heroku CLI plugin for Heroku CI
|
5 |
|
6 | [![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
|
7 | [![Version](https://img.shields.io/npm/v/@heroku-cli/plugin-ci.svg)](https://npmjs.org/package/@heroku-cli/plugin-ci)
|
8 |
|
9 | [![CircleCI](https://circleci.com/gh/heroku/cli/tree/master.svg?style=shield)](https://circleci.com/gh/heroku/cli/tree/master)
|
10 |
|
11 | [![Appveyor CI](https://ci.appveyor.com/api/projects/status/github/heroku/cli?branch=master&svg=true)](https://ci.appveyor.com/project/heroku/cli/branch/master)
|
12 | [![Codecov](https://codecov.io/gh/heroku/cli/branch/master/graph/badge.svg)](https://codecov.io/gh/heroku/cli)
|
13 | [![Downloads/week](https://img.shields.io/npm/dw/@heroku-cli/plugin-ci.svg)](https://npmjs.org/package/@heroku-cli/plugin-ci)
|
14 | [![License](https://img.shields.io/npm/l/@heroku-cli/plugin-ci.svg)](https://github.com/heroku/cli/blob/master/package.json)
|
15 |
|
16 |
|
17 | * [Usage](#usage)
|
18 | * [Commands](#commands)
|
19 |
|
20 | # Usage
|
21 |
|
22 | ```sh-session
|
23 | $ npm install -g @heroku-cli/plugin-ci
|
24 | $ heroku COMMAND
|
25 | running command...
|
26 | $ heroku (-v|--version|version)
|
27 | @heroku-cli/plugin-ci/7.7.10 darwin-x64 node-v10.7.0
|
28 | $ heroku --help [COMMAND]
|
29 | USAGE
|
30 | $ heroku COMMAND
|
31 | ...
|
32 | ```
|
33 |
|
34 | # Commands
|
35 |
|
36 | * [`heroku ci:info TEST-RUN`](#heroku-ciinfo-test-run)
|
37 | * [`heroku ci:last`](#heroku-cilast)
|
38 | * [`heroku ci:rerun [NUMBER]`](#heroku-cirerun-number)
|
39 | * [`heroku ci:run`](#heroku-cirun)
|
40 |
|
41 | ## `heroku ci:info TEST-RUN`
|
42 |
|
43 | show the status of a specific test run
|
44 |
|
45 | ```
|
46 | USAGE
|
47 | $ heroku ci:info TEST-RUN
|
48 |
|
49 | OPTIONS
|
50 | -a, --app=app [default: safe-sea-44297] app to run command against
|
51 | -p, --pipeline=pipeline name of pipeline
|
52 | --node=node the node number to show its setup and output
|
53 |
|
54 | EXAMPLE
|
55 | $ heroku ci:info 1288 --app murmuring-headland-14719
|
56 | ```
|
57 |
|
58 | _See code: [src/commands/ci/info.ts](https://github.com/heroku/cli/blob/v7.7.10/src/commands/ci/info.ts)_
|
59 |
|
60 | ## `heroku ci:last`
|
61 |
|
62 | looks for the most recent run and returns the output of that run
|
63 |
|
64 | ```
|
65 | USAGE
|
66 | $ heroku ci:last
|
67 |
|
68 | OPTIONS
|
69 | -a, --app=app [default: safe-sea-44297] app to run command against
|
70 | -p, --pipeline=pipeline name of pipeline
|
71 | --node=node the node number to show its setup and output
|
72 |
|
73 | EXAMPLE
|
74 | $ heroku ci:last --app murmuring-headland-14719 --node 100
|
75 | ```
|
76 |
|
77 | _See code: [src/commands/ci/last.ts](https://github.com/heroku/cli/blob/v7.7.10/src/commands/ci/last.ts)_
|
78 |
|
79 | ## `heroku ci:rerun [NUMBER]`
|
80 |
|
81 | rerun tests against current directory
|
82 |
|
83 | ```
|
84 | USAGE
|
85 | $ heroku ci:rerun [NUMBER]
|
86 |
|
87 | OPTIONS
|
88 | -a, --app=app [default: safe-sea-44297] app to run command against
|
89 | -p, --pipeline=pipeline name of pipeline
|
90 |
|
91 | EXAMPLE
|
92 | $ heroku ci:rerun 985 --app murmuring-headland-14719
|
93 | ```
|
94 |
|
95 | _See code: [src/commands/ci/rerun.ts](https://github.com/heroku/cli/blob/v7.7.10/src/commands/ci/rerun.ts)_
|
96 |
|
97 | ## `heroku ci:run`
|
98 |
|
99 | run tests against current directory
|
100 |
|
101 | ```
|
102 | USAGE
|
103 | $ heroku ci:run
|
104 |
|
105 | OPTIONS
|
106 | -a, --app=app [default: safe-sea-44297] app to run command against
|
107 | -p, --pipeline=pipeline name of pipeline
|
108 |
|
109 | EXAMPLE
|
110 | $ heroku ci:run --app murmuring-headland-14719
|
111 | ```
|
112 |
|
113 | _See code: [src/commands/ci/run.ts](https://github.com/heroku/cli/blob/v7.7.10/src/commands/ci/run.ts)_
|
114 |
|
115 | * [`heroku ci:info`](#heroku-ci-info)
|
116 | * [`heroku ci:last`](#heroku-ci-last)
|
117 | * [`heroku ci:run`](#heroku-ci-run)
|
118 | * [`heroku ci:rerun`](#heroku-ci-rerun)
|
119 |
|
120 | ## `heroku ci:info`
|
121 |
|
122 | Shows the information for a particular ci run on a pipeline.
|
123 |
|
124 | ```
|
125 | USAGE
|
126 | $ heroku ci:info 555 --pipeline=my-pipeline # 555 is the test number
|
127 | ```
|
128 |
|
129 | ## `heroku ci:last`
|
130 |
|
131 | Shows the information for the last run for a given pipeline.
|
132 |
|
133 | ```
|
134 | USAGE
|
135 | $ heroku ci:last --pipeline=my-pipeline
|
136 | ```
|
137 |
|
138 | ## `heroku ci:run`
|
139 |
|
140 | Run this from within your repo directory to trigger a test agains the current branch and commit.
|
141 |
|
142 | ```
|
143 | USAGE
|
144 | $ heroku ci:run --pipeline=my-pipeline
|
145 | ```
|
146 |
|
147 | ## `heroku ci:rerun`
|
148 |
|
149 | Re-run a previous test run. If no test run number is provided, the most recent test run will be re-run.
|
150 |
|
151 | ```
|
152 | USAGE
|
153 | $ heroku ci:rerun 555 --pipeline=my-pipeline # 555 is the test number
|
154 | ```
|