DevContainer User
7235d2dc67
Release workflow was using GHA cache which served stale layers, causing tools like gh CLI to be missing from tagged images despite being in the Dockerfile. Use no-cache for release builds to ensure every layer is built fresh. Regular CI builds keep the cache for speed. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
CI/CD Pipeline Guide
🚀 Simplified Pipeline - Only 3 Workflows!
1️⃣ For Releases → Unified Release
Use this for all version releases:
- Go to Actions → Unified Release
- Click "Run workflow"
- Either:
- Enter specific version (e.g.,
0.2.1), OR - Choose release type (patch/minor/major) for auto-increment
- Enter specific version (e.g.,
- Click "Run workflow"
This single workflow does EVERYTHING:
- ✅ Updates chart version
- ✅ Creates git tag
- ✅ Builds Docker image with all proper tags
- ✅ Publishes Helm chart to GitHub Pages (
https://cpfarhood.github.io/devcontainer) - ✅ Creates GitHub Release with changelog
2️⃣ For Quick Fixes → Quick Fix Build
Use this for emergency fixes without version changes:
- Go to Actions → Quick Fix Build
- Click "Run workflow"
- Enter tag (default:
latest) - Click "Run workflow"
Just builds and pushes Docker image - no version bumps, no releases.
3️⃣ Automatic CI → Build and Push
Runs automatically on:
- Pushes to
main(builds and pushes; skipped for release commits via[skip ci]) - Pull requests (builds but doesn't push)
- Manual trigger available
Workflow Files
| Workflow | File | Purpose | When to Use |
|---|---|---|---|
| Unified Release | release-unified.yaml |
Full release process | New versions |
| Quick Fix Build | quick-fix.yaml |
Docker build only | Hotfixes |
| Build and Push | build-and-push.yaml |
CI/CD automation | PRs & tags |
Examples
Release a new version
# Via GitHub UI (Recommended):
# Go to Actions → Unified Release → Run workflow
# Via GitHub CLI:
gh workflow run release-unified.yaml -f version=0.2.1
# OR auto-increment:
gh workflow run release-unified.yaml -f release_type=patch
Push a quick fix
# Via GitHub UI:
# Go to Actions → Quick Fix Build → Run workflow
# Via GitHub CLI:
gh workflow run quick-fix.yaml -f tag=hotfix-1
Check workflow status
# List all recent runs
gh run list --limit 5
# Watch a specific workflow
gh run watch
Version Strategy
- Major (1.0.0): Breaking changes
- Minor (0.2.0): New features
- Patch (0.2.1): Bug fixes
What We Fixed
Before (Nightmare 😱)
- Auto-version-bump with
[skip ci]prevented Docker builds - 6+ disconnected workflows
- Manual tag deletion and re-pushing
- Version conflicts everywhere
After (Simple! 🎉)
- 3 total workflows (down from 6+)
- 1 button for complete releases
- Release builds its own Docker image —
[skip ci]on the version commit prevents duplicate CI builds - Clear separation of concerns