Upgrade the CosmicAC stack
Upgrade a running CosmicAC deployment to a new image release.
Upgrade a running CosmicAC deployment to a new image release.
In-cluster job images upgrade separately
task update upgrades only the Compose platform stack, not the GPU and inference images that run as jobs in your Kubernetes cluster. To change those, update their tags in the k8s worker's config/common.json.
Prerequisites
You need the following before you start:
- A running CosmicAC deployment. See Deploy CosmicAC.
- The deployment repository on your host.
- The new image
TAGyou want to deploy.
Steps
Set the new tag
Set TAG=<newtag> in .env, or pass it inline in the next step.
Run the update
Pull the new images, seed any new config, and recreate the stack at the new tag:
task updateTo skip editing .env, pass the tag inline with task update TAG=<newtag>. To scope the upgrade to one service, add SERVICES="cosmicac-app-node".
Merge new config keys
If the release adds new config keys, add them to your existing config files, then run task restart. task update does not merge new keys into files you already have.
Verify the deployment
Confirm every service is up:
task psFor the full health checks, see Verify the deployment.
If a worker won't connect, refresh the shared runtime keys, then recreate the worker so it picks them up:
task wire
task restart SERVICES="cosmicac-wrk-server-k8s-nvidia"Roll back
To roll back, deploy the previous tag. The rollback preserves your state, but back up first for a snapshot:
task backup
task update TAG=<previousTag>