How to 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 cluster's config/common.json. See Upgrade behavior.
Prerequisites
You need the following before you start.
- A running CosmicAC deployment. See Deploy CosmicAC.
- The deployment repo on your host, and the new image
TAGyou want to deploy.
Back up the current state
task backupSet the new tag
Set TAG=<newtag> in .env, or pass it inline in the next step.
Run the update
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 added config keys, merge them into your existing config files, then run task restart.
Verify the deployment
Confirm the services are healthy. See Verify the deployment. If a worker won't connect, re-run task wire, then recreate it.
Roll back
Run task update TAG=<previousTag> to roll back to the previous release. State is preserved, but run task backup first for a snapshot.