Usage¶
How to consume this configuration¶
This configuration is not a complete Kayobe configuration, rather it should be treated as a base, in place of the upstream kayobe-config. Indeed, this repository is based on the upstream kayobe-config, with some opinionated configuration changes applied.
Since this repository makes changes to the base configuration, it works best when used with Kayobe’s multiple environments feature.
This configuration should be consumed using the StackHPC Kayobe fork, which includes backported support for Ansible collections.
New deployments¶
If starting a new deployment, clone this repository as the starting point for your configuration:
git clone https://github.com/stackhpc/stackhpc-kayobe-config -b stackhpc/2023.1
Existing deployments¶
If migrating an existing deployment to StackHPC Kayobe configuration, you will need to merge the changes in this repository into your repository:
git remote add stackhpc https://github.com/stackhpc/stackhpc-kayobe-config git fetch stackhpc git merge stackhpc/stackhpc/2023.1
Updating¶
This base configuration will be updated over time, to update repository versions, container image tags, and other configuration. Deployments may consume these updates by merging in the changes with their local configuration:
git fetch stackhpc git merge stackhpc/stackhpc/2023.1
The intention is to avoid merge conflicts where possible, but there may be cases where this is difficult. We are open to discussion on how best to approach this on both sides.