Upgrade Platform with an External Database
info
This feature is available from the Platform version v4.8.0
Modify the following with your specific values to replace on the whole page and generate copyable commands:
This procedure describes how to upgrade vCluster Platform with minimal downtime. Because all replicas run in a single cluster, a standard rolling upgrade handles the transition automatically.
Prerequisites​
- Updated values file (
platform-ha-values.yaml) kubectlcontext configured for the cluster- The target chart version available in the Helm repository
Step 1 - Upgrade the deployment​
- vCluster CLI
- Helm
vcluster platform start \
--namespace vcluster-platform \
--kube-context arn:aws:eks:us-east-1:123456789012:cluster/platform-ha \
--values platform-ha-values.yaml \
--upgrade \
--no-tunnel
Modify the following with your specific values to generate a copyable command:
helm upgrade loft vcluster-platform --install --create-namespace --repository-config='' \
--namespace vcluster-platform \
--repo "https://charts.loft.sh/" \
--version 4.8.0 \
--kube-context arn:aws:eks:us-east-1:123456789012:cluster/platform-ha \
-f platform-ha-values.yaml \
--server-side=true --force-conflicts
The --server-side=true --force-conflicts flags are required because the platform chart manages CRDs that may conflict during upgrades.
Step 2 - Wait for the rollout to complete​
kubectl --context arn:aws:eks:us-east-1:123456789012:cluster/platform-ha \
rollout status deployment/loft -n vcluster-platform
Step 3 - Verify the deployment​
Confirm that all platform and agent deployments are running the expected image:
echo -n "Platform: " && kubectl --context arn:aws:eks:us-east-1:123456789012:cluster/platform-ha get deployment -n vcluster-platform loft \
-o jsonpath='{.spec.template.spec.containers[0].image}' && echo
The platform automatically upgrades connected agents after the platform upgrade completes.