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.19.1 darwin-x64 node-v11.3.0
|
28 | $ heroku --help [COMMAND]
|
29 | USAGE
|
30 | $ heroku COMMAND
|
31 | ...
|
32 | ```
|
33 |
|
34 | # Commands
|
35 |
|
36 | * [`heroku ci`](#heroku-ci)
|
37 | * [`heroku ci:info TEST-RUN`](#heroku-ciinfo-test-run)
|
38 | * [`heroku ci:last`](#heroku-cilast)
|
39 | * [`heroku ci:rerun [NUMBER]`](#heroku-cirerun-number)
|
40 | * [`heroku ci:run`](#heroku-cirun)
|
41 |
|
42 | ## `heroku ci`
|
43 |
|
44 | display the most recent CI runs for the given pipeline
|
45 |
|
46 | ```
|
47 | USAGE
|
48 | $ heroku ci
|
49 |
|
50 | OPTIONS
|
51 | -p, --pipeline=pipeline name of pipeline
|
52 | --json output in json format
|
53 | --watch keep running and watch for new and update tests
|
54 |
|
55 | EXAMPLE
|
56 | $ heroku ci --app murmuring-headland-14719
|
57 | ```
|
58 |
|
59 | _See code: [src/commands/ci/index.ts](https://github.com/heroku/cli/blob/v7.19.1/packages/ci/src/commands/ci/index.ts)_
|
60 |
|
61 | ## `heroku ci:info TEST-RUN`
|
62 |
|
63 | show the status of a specific test run
|
64 |
|
65 | ```
|
66 | USAGE
|
67 | $ heroku ci:info TEST-RUN
|
68 |
|
69 | OPTIONS
|
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:info 1288 --app murmuring-headland-14719
|
75 | ```
|
76 |
|
77 | _See code: [src/commands/ci/info.ts](https://github.com/heroku/cli/blob/v7.19.1/packages/ci/src/commands/ci/info.ts)_
|
78 |
|
79 | ## `heroku ci:last`
|
80 |
|
81 | looks for the most recent run and returns the output of that run
|
82 |
|
83 | ```
|
84 | USAGE
|
85 | $ heroku ci:last
|
86 |
|
87 | OPTIONS
|
88 | -p, --pipeline=pipeline name of pipeline
|
89 | --node=node the node number to show its setup and output
|
90 |
|
91 | EXAMPLE
|
92 | $ heroku ci:last --app murmuring-headland-14719 --node 100
|
93 | ```
|
94 |
|
95 | _See code: [src/commands/ci/last.ts](https://github.com/heroku/cli/blob/v7.19.1/packages/ci/src/commands/ci/last.ts)_
|
96 |
|
97 | ## `heroku ci:rerun [NUMBER]`
|
98 |
|
99 | rerun tests against current directory
|
100 |
|
101 | ```
|
102 | USAGE
|
103 | $ heroku ci:rerun [NUMBER]
|
104 |
|
105 | OPTIONS
|
106 | -p, --pipeline=pipeline name of pipeline
|
107 |
|
108 | EXAMPLE
|
109 | $ heroku ci:rerun 985 --app murmuring-headland-14719
|
110 | ```
|
111 |
|
112 | _See code: [src/commands/ci/rerun.ts](https://github.com/heroku/cli/blob/v7.19.1/packages/ci/src/commands/ci/rerun.ts)_
|
113 |
|
114 | ## `heroku ci:run`
|
115 |
|
116 | run tests against current directory
|
117 |
|
118 | ```
|
119 | USAGE
|
120 | $ heroku ci:run
|
121 |
|
122 | OPTIONS
|
123 | -p, --pipeline=pipeline name of pipeline
|
124 |
|
125 | EXAMPLE
|
126 | $ heroku ci:run --app murmuring-headland-14719
|
127 | ```
|
128 |
|
129 | _See code: [src/commands/ci/run.ts](https://github.com/heroku/cli/blob/v7.19.1/packages/ci/src/commands/ci/run.ts)_
|
130 |
|
131 | * [`heroku ci:info`](#heroku-ci-info)
|
132 | * [`heroku ci:last`](#heroku-ci-last)
|
133 | * [`heroku ci:run`](#heroku-ci-run)
|
134 | * [`heroku ci:rerun`](#heroku-ci-rerun)
|
135 |
|
136 | ## `heroku ci:info`
|
137 |
|
138 | Shows the information for a particular ci run on a pipeline.
|
139 |
|
140 | ```
|
141 | USAGE
|
142 | $ heroku ci:info 555 --pipeline=my-pipeline # 555 is the test number
|
143 | ```
|
144 |
|
145 | ## `heroku ci:last`
|
146 |
|
147 | Shows the information for the last run for a given pipeline.
|
148 |
|
149 | ```
|
150 | USAGE
|
151 | $ heroku ci:last --pipeline=my-pipeline
|
152 | ```
|
153 |
|
154 | ## `heroku ci:run`
|
155 |
|
156 | Run this from within your repo directory to trigger a test agains the current branch and commit.
|
157 |
|
158 | ```
|
159 | USAGE
|
160 | $ heroku ci:run --pipeline=my-pipeline
|
161 | ```
|
162 |
|
163 | ## `heroku ci:rerun`
|
164 |
|
165 | Re-run a previous test run. If no test run number is provided, the most recent test run will be re-run.
|
166 |
|
167 | ```
|
168 | USAGE
|
169 | $ heroku ci:rerun 555 --pipeline=my-pipeline # 555 is the test number
|
170 | ```
|