This repository both bootstraps and manages the deployment lifecycle of Lodestar across multiple versions. It contains a manifest which controls the release version of all individual components of Lodestar. It is meant to be used with Argo CD.
To create an instance of Lodestar in a cluster, apply the bootstrap Helm chart using the following command:
helm install lodestar bootstrap/ --set application.ref=<desired git ref>Make sure to replace <desired-git-ref> with the tag that you want to deploy to this cluster. If this is a staging cluster, you might have a Git tag such as deploy-staging; and if this is a production cluster, maybe deploy-production.
Lodestar is not a single application, but a collection of components (or services) that all add up to a working system. Those services might be versioned separately from one another. Therefore, a "deployment of Lodestar" is really a manifest of the versions of its constituent components that are known to work well with each other.
This manifest lives in applications/values.yaml:
applicationVersions:
frontend: &frontendVersion 4edb30
backend: &backendVersion 3a03d2
git-api: &gitApiVersion 8cb605
launcher: &launcherVersion 8bca47
...
appName: &yamlAnchorName <ref-to-deploy>NOTE: Because Helm does not support templating inside of the values.yaml file, we need to use YAML anchors if we want to prevent duplicate definitions of data.
Automatic syncing, pruning, and self healing is enabled for this project - so committing a change to the above manifest and tagging it appropriately as deploy-staging or deploy-production will cause an Argo CD instance bootstrapped with that tag to deploy those versions of the applications.
Creating releases is automated through the use of GitHub Actions Workflows. To create a release, you can just create an issue in this repository named as the release you'd like to create using the "Creating a release" template, and use the below triggers in an issue comment to begin:
/release - This trigger along with the appropriate parameters can be used to create a release branch that will then be used to promote the appropriate changes into a new environment branch. The following parameters can be passed to it:
| Variable | Description | Required |
|---|---|---|
| frontend | The version to use for the frontend application | no |
| backend | The version to use for the backend application | no |
| gitapi | The version to use for the Git API | no |
| dispatcher | The version to use for the Resource Dispatcher | no |
| agnosticv | The version to use for AgnosticV | no |
| anarchy | The version to use for Anarchy | no |
| poolboy | The version to use for Poolboy | no |
/promote - This trigger along with the appropriate parameters can be used to promote the changes contained in a release branch into a specified environment branch that ArgoCD is watching. These promotions are auto-merged, so you should be sure that you are ready for a promotion when you run this command. It does not accept any parameters.
/cancel - This trigger cancels the rollout/closes the release issue and signals that a new issue should be created if a release is still desired.