diff --git a/vcluster/deploy/control-plane/binary/manage.mdx b/vcluster/deploy/control-plane/binary/manage.mdx index 12b606241..737373a31 100644 --- a/vcluster/deploy/control-plane/binary/manage.mdx +++ b/vcluster/deploy/control-plane/binary/manage.mdx @@ -19,6 +19,37 @@ import TenancySupport from '../../../_fragments/tenancy-support.mdx'; +## Upgrading vCluster Standalone version + +To upgrade a vCluster Standalone to the new version, download the binary from the releases page, and then restart the vCluster systemD service. + + + + On the control-plane node, download the binary for the target version: + ```shell title="Download vCluster standalone binary" + export VCLUSTER_VERSION="vX.Y.Z" # modify to the target version + export TARGETARCH="amd64" # amd64 / arm64 + curl -fsSLk -o /tmp/vcluster-new "https://github.com/loft-sh/vcluster/releases/download/${VCLUSTER_VERSION}/vcluster-linux-${TARGETARCH}-standalone" + ``` + then, copy it to the `/var/lib/vcluster/bin/vcluster`: + + ```shell title="Upgrade binary" + chmod +x /tmp/vcluster-new + # copy old version as a backup + cp /var/lib/vcluster/bin/vcluster /tmp/vcluster-old.bak + cp /tmp/vcluster-new /var/lib/vcluster/bin/vcluster + ``` + + + Restart vCluster systemD service to deploy your changes. + + ```bash title="Restart vCluster" + systemctl restart vcluster.service + ``` + + + + ## Removing nodes If you have not enabled joining the control plane nodes as worker nodes, then removing vCluster @@ -230,4 +261,4 @@ Run 'kubectl get nodes' on the control-plane to see this node join the cluster. - \ No newline at end of file +