Using the Jet CLI

2 minute read

If you are unfamiliar with CloudBees CodeShip Pro, we recommend our getting started guide or the features overview page. Note that if you are using CloudBees CodeShip Basic, you will not be able to use the local CLI.

Using The Jet CLI

To list available commands, run jet with no parameters, jet -h or jet --help:

$ jet Usage: jet [command] Available Commands: cleanup Remove docker resources left behind by jet decrypt Decrypt a file using an AES key encrypt Encrypt a file using an AES key generate Generate an AES key for encrypting files help Help about any command load Pull or build service images run Run a command inside a service container steps Run steps update Download and install the latest version of Jet validate Validate codeship-services.yml and codeship-steps.yml files version Display the jet version Flags: -h, --help help for jet Use "jet [command] --help" for more information about a command.

Troubleshooting With Jet

Because the Jet CLI accurately reproduces your CI/CD build pipeline locally, you can use it to quickly solve difficult problems.

For instance, if a test or command fails on a build in CodeShip, you can try to reproduce the error with jet steps. When you want to test a change, jet steps will let you verify the change is working prior to committing so that you don’t have to wait for the full build to run remotely to get feedback.

We recommend that developers using CodeShip make use of the Jet CLI to improve productivity and solve build-related issues.

The results of a jet steps run can differ from the corresponding CloudBees CodeShip Pro build. We’ve listed a number of reasons for why that may be the case.

Examples

Display help text

To list the help for any command, execute the command followed by the -h or --help flag.

$ jet steps -h Run steps Usage: jet steps [flags] Flags: --ci-branch string The name of the branch being built --ci-build-id string The id of the build being run ...

Option types

Multi

Some flags like -e=[ ] may be used multiple times in a single command line, for example:

$ jet steps -e foo=bar -e baz=qux

String and Integers

Some flags require a string like --ci-branch and can only be specified once.

$ jet steps --ci-branch master