Upgrading to 1.40.0 on macOS
This guide is for users deploying the Controller and Registry on macOS. There are no changes for Linux/Docker packages.
Prior to 1.40.0 of the Anka Build Cloud Controller & Registry, we provided a native macOS pkg that combined the Controller, Registry, and etcd. We also provided a standalone Registry pkg, which has also drastically changed, but most users relied on the combined package.
Starting in 1.40.0, we are no longer providing the combined package and will now only provide the two standalone packages: The Controller + etcd and the Registry package.
Users coming from the combined package need to consider the appropriate migration path which we will detail below. If you are only using the Standalone Registry package, there will be instructions included at the bottom of this guide for that too.
Combined Package
Any ENVs you had in the combined package’s /usr/local/bin/anka-controllerd
specific to the registry that was built-in must be moved into the registry’s config at /usr/local/bin/anka-registryd
.
Quick Overview of changes
No combined pkg available. PKG will now be named
anka-controller-arm64-VERSION.pkg
.Any registry specific ENV flags are no longer available for the controller standalone package.
The
ANKA_STANDALONE
ENV will now only control if the built-inetcd
will start with the controller.
Steps to Upgrade
You will need to re-create all of your Groups and permissions. You can technically migrate them one by one, but the time it takes to do this vs just re-creating them on the new packages is the same, if not slower.
Uninstall the current standalone package:
sudo /Library/Application\ Support/Veertu/Anka/tools/controller/uninstall.sh
Follow the setup guide.
Standalone Registry Users
Registry mac package requires a full uninstall and re-install to upgrade.
The Registry Standalone package for macOS now comes with an updated plist, a new anka-registryd
file that holds configuration, and a anka-registry
executable that has start/restart/stop/status/logs
commands (identical to the controller mac package). Full Registry Standalone guide here.
Quick Overview of changes
A command is now available to control the registry:
usage: /usr/local/bin/anka-registry [start|stop|restart|status|logs]
Configuration is done using ENVs set in /usr/local/bin/anka-registryd (similar to the controller).
Registry mac package logs will be at
/Library/Logs/Veertu/AnkaRegistry
.Registry mac package uninstaller at
/Library/Application Support/Veertu/Anka/tools/registry/uninstall.sh
.Mac package names have changed to be similar to our docker packaging. For example,
anka-registry-amd64-VERSION.pkg
.Registry mac package was using port
80
by default. It is now8089
.