In order to use Octorelease you must follow these steps:
- Install Octorelease in your project
- Configure your Continuous Integration service to run Octorelease
- Configure your Git repository and package manager repository authentication in your Continuous Integration service
- Configure Octorelease options and plugins
For Node modules projects it is recommended to install Octorelease locally:
$ npm install --save-dev @octorelease/core
For other types of projects you can skip this step since npx
will install Octorelease directly in the CI environment.
In your CI environment, run the octorelease
command with npx
:
$ npx octorelease
Note: For projects that use GitHub workflows, you don't need to install Octorelease or run it with npx
. It can be invoked as an action in your workflow instead:
- uses: zowe-actions/octorelease@v1
The octorelease
command must be executed only after all the tests in the CI build pass. If the build runs multiple jobs (for example to test on multiple Operating Systems or Node versions) the CI has to be configured to guarantee that the octorelease
command is executed only after all jobs are successful. Here are a few examples of the CI services that can be used to achieve this:
See CI configuration recipes for more details.
Octorelease requires authentication to perform actions like pushing to the project Git repository and publishing to a package manager registry. Authentication tokens or credentials have to be made available in the CI service via environment variables. See each plugin's documentation for the environment variables required.
TODO
TODO
TODO