cortex cluster configure # or: cortex cluster configure --config cluster.yaml
# spin down your clustercortex cluster down# update your CLI to the latest versionpip install --upgrade cortex# confirm versioncortex version# spin up your clustercortex cluster up
In production environments, you can upgrade your cluster without downtime if you have a backend service or DNS in front of your Cortex cluster:
Spin up a new cluster. For example:
cortex cluster up --config new-cluster.yaml --configure-env new (this will create a CLI environment named
new for accessing the new cluster).
Re-deploy your APIs in your new cluster. For example, if the name of your CLI environment for your old cluster is
old, you can use
cortex get --env old to list all running APIs in your old cluster, and re-deploy them in the new cluster by changing directories to each API's project folder and running
cortex deploy --env new.
Route requests to your new cluster.
If you are using a custom domain: update the A record in your Route 53 hosted zone to point to your new cluster's API load balancer.
If you have a backend service which makes requests to Cortex: update your backend service to make requests to the new cluster's endpoints.
If you have a self-managed API Gateway in front of your Cortex cluster: update the routes to use new cluster's endpoints.
Spin down your old cluster. If you updated DNS settings, wait 24-48 hours before spinning down your old cluster to allow the DNS cache to be flushed.