This repository is used by the IBM Garage Cloud Native Toolkit CLI igc enable command. It contains the default pipelines used when choosing what pipeline to add to your project. You can use this template and customize the pipelines to suit your needs. Run the igc enable command with the --repo argument to pass in the location of your copy of this template.
The igc enable command expects the pipelines to be packaged into gzip'd tarballs and published to GitHub Pages. Therefore the url format for the command would be igc enable --repo https://<org-name>.github.io/<repo-name>/
Where
<org-name>is the name of your github organization or owner.<repo-name>is the name of the github repo.
To customize the pipelines in this repo
- Click the
button - Select the owner/organization and enter a repository name
- Select Include all branches, we need the publish and gh_pages branches as well
- Click the
button.
You can now modify the pipelines to suit your needs.
Before you can use your pipelines you need to publish them to GitHub pages.
There are three ways you can publish the pipelines.
- GitHub Actions
- Travis
- Manually
The GitHub actions are located in the .github/workflows/publish.yaml file. When creating a copy of this template in a GitHub environment that supports actions they should automatically publish your pipelines
There is a .travis.yml file located in the repo. Update the REPO_URL environment variable and then configure Travis.
There is a ./ci/build.sh script in the repository.
Run this script which should package up the pipelines into gzip'd tarballs, change to the gh-pages branch, copy the files into the correct locations, and generates the index.yaml file.
Commit and push the changes to the gh-pages branch