CI/CD Reusable Workflows

Deployment workflow

To automate deployment process DevOps team has created reusable workflow that can be referenced in your repo GitHub Actions configuration.

push to default branch (master or main) triggers deployment to development
creating v[semver] tag triggers deployment to development first, if it succeeded then deployment to production follows, requiring a manual approval from group-backend-deployers.
hotfixes can be deployed to production by checking out branch from tagged release and manually triggering workflow
arbitrary branches can be deployed to development/demo by triggering workflow

Docker image is built and pushed to artifact registry
Deployment is verified using kubeval
Deployment is run against environment, waiting for resources liveness and readiness probes if specified

Navigate to build workflow in your repository.

Click on Run workflow:

Select desired branch and environment and run workflow:

Install GitHub CLI:

brew install gh

Trigger deployment:

gh workflow run --ref build -f environment=

Example:

gh workflow run --ref feat-teams-api build -f environment=demo

Create branch from last tagged release:

git checkout -b hotfix- $(git tag --sort=committerdate | grep -E '^v.*' | tail -1)

Trigger deployment:

gh workflow run --ref hotfix- build -f environment=production

Example:

git checkout -b hotfix-roles-config $(git tag --sort=committerdate | grep -E '^v.*' | tail -1)

gh workflow run --ref hotfix-roles-config -f environment=production\

We use CUE to manage and generate actual workflows. Don't make any direct change in .github/workflows folder, it will be overwritten.

Contributing flow:

Changes should be made within pkg/*
Run make to generate actual workflows
Commit your change for both pkg/* and generated workflows in .github/workflows
PR time!