Upgrading your Anka Controller and Registry
Deciding when to upgrade
Veertu's published pre-upgrade considerations will help you to decide when your team ought to upgrade your controller and registry.
Gaining access to your Anka controller environment
- Collect the Anka Controller IP address and the associated password from your IP Plan.
- With a VPN connection to your Anka environment open, SSH into the Anka Controller with the following command:
ssh [email protected]<IP ADDRESS>
password: <PASSWORD>
Backing up your docker-compose.yml
file
docker-compose.yml
fileOnce you've SSHed into the server, you'll first want to back up your docker-compose.yml
file to save yourself the trouble of resetting ports and volume mounts in a fresh file later should something go awry.
Download and install the upgrade
NOTE: The following update will not affect your stored VM templates. However, it is highly recommended that you suspend CI jobs, and allow any remaining jobs to complete, prior to the upgrade process.
- Download and extract the latest version of the controller and registry by running the following:
FULL_FILE_NAME=$(echo $(curl -Ls -r 0-1 -o /dev/null -w %{url_effective} https://veertu.com/downloads/ankacontroller-registry-docker-latest) | cut -d/ -f5)
PARTIAL_FILE_NAME=$(echo $FULL_FILE_NAME | awk -F'.tar.gz' '{print $1}')
mkdir -p $PARTIAL_FILE_NAME
cd $PARTIAL_FILE_NAME
curl -Ls https://veertu.com/downloads/ankacontroller-registry-docker-latest -o $FULL_FILE_NAME
tar -xzvf $FULL_FILE_NAME
- Copy your
docker-compose.yml
file from the previous installation into your newly extracted directory.
cp <old_anka-controller-registry...>/docker-compose.yml <new_anka-controller-registry...>/docker-compose.yml
- Stop and remove the currently running deployment by running the following from within the original installation's directory:
docker-compose -f docker-compose.yml down
- Restart the containers with updated source code by running the following within the newly extracted directory:
docker-compose -f docker-compose.yml up -d --build
Install proper agent version across associated nodes
Veertu recommends this step to ensure the compatibility of the nodes with the newly updated controller and registry. They provide an API endpoint that will allow you to automate the node updates via the controller.
Additional support
We recommend contacting Veertu directly for product-focused support. You may reach them by email at [email protected], or on Slack at https://slack.veertu.com/
Lastly, If you have a legacy environment (pre 1.16.0-05de337e), please open a support ticket, so we can assist you and Veertu with the upgrade.
Updated 9 months ago