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

Once 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.