deployment
Build, push, and deploy services via GitOps in this repo. Use when updating images, manifests, or rolling out changes with Argo CD.
When & Why to Use This Skill
This Claude skill streamlines the GitOps deployment process by automating service builds, container image pushes, and manifest updates. Designed for environments using Argo CD, it facilitates safe and efficient Kubernetes rollouts, configuration management, and rapid rollbacks through standardized repository scripts and environment-specific overrides.
Use Cases
- Automated Image Updates: Build and push new container images to registries (e.g., Bumba or Jangar) immediately after service code changes.
- GitOps Manifest Management: Update Kubernetes manifests and Kustomize configurations within the `argocd/` directory to reflect infrastructure or runtime changes.
- Deployment Verification: Monitor and verify the status of service rollouts using integrated kubectl commands to ensure high availability and successful deployment.
- Emergency Rollbacks: Quickly revert to previous stable versions by rolling back manifest changes and triggering Argo CD reconciliation in case of deployment failures.
| name | deployment |
|---|---|
| description | Build, push, and deploy services via GitOps in this repo. Use when updating images, manifests, or rolling out changes with Argo CD. |
Deployment
Overview
Deploy changes using repo scripts and GitOps manifests in argocd/. Scripts build and push images, update manifests, and trigger rollouts.
When to use
- You changed service code and need a new image.
- You updated manifests or runtime config under
argocd/. - You need to roll out or roll back a service quickly and safely.
Service deploy scripts
Bumba:
bun run packages/scripts/src/bumba/deploy-service.ts
Jangar:
bun run packages/scripts/src/jangar/deploy-service.ts
Environment overrides
Bumba script supports:
BUMBA_IMAGE_REGISTRYBUMBA_IMAGE_REPOSITORYBUMBA_IMAGE_TAGBUMBA_KUSTOMIZE_PATHBUMBA_K8S_NAMESPACEBUMBA_K8S_DEPLOYMENT
Jangar script supports:
JANGAR_IMAGE_REGISTRYJANGAR_IMAGE_REPOSITORYJANGAR_IMAGE_TAGJANGAR_KUSTOMIZE_PATHJANGAR_SERVICE_MANIFEST
Rollout verification
kubectl rollout status deployment/bumba -n jangar
kubectl rollout status deployment/jangar -n jangar
Rollback
- Revert the tag change in
argocd/applications/bumba/kustomization.yaml. - Re-apply manifests or let Argo CD reconcile.
Resources
- Reference:
references/deploy-runbook.md - Helper script:
scripts/deploy-service.sh - Checklist:
assets/deploy-checklist.md