To use Convox’s local development Rack feature on macOS, you will need install following applications locally:
Convox development racks run on Minikube with several required options:
--insecure-registry=”registry.<RACK_NAME>.macdev.convox.cloud”--kubernetes-version=<k8s_VERSION>--driver=dockerThe first thing you must choose is the name for your rack as it will be a component of other installation parameters. For this documentation we will use the rack name: test-local
Then verify the Kubernetes version for the rack version you are going to install. At the time of this writing it is v1.23.0
You will start Minikube with the command:
minikube start --kubernetes-version=<k8s_VERSION> --insecure-registry="https://registry.<RACK_NAME>.macdev.convox.cloud" --driver=docker
For this example the command would be:
minikube start --kubernetes-version=v1.23.0 --insecure-registry="https://registry.test-local.macdev.convox.cloud" --driver=docker
Now enable Minikube ingress and ingress-dns addons:
minikube addons enable ingress
minikube addons enable ingress-dns
Then install the local development rack with the command convox rack install local <RACK_NAME> -v <VERSION> os=mac
NOTE:: Rack version
-vmust be3.10.5or later
For this example the command would be:
convox rack install local test-local -v 3.10.5 os=mac
Once the rack is installed you should be able to see it by running: convox racks
Finally, to address the rack on macOS you must open a new terminal window and run minikube tunnel
NOTE:: You must keep the terminal window with the tunnel active open to address the rack
You can now run: convox rack -r <RACK_NAME> to verify connectivity.
Local rack files are stored at /Users/$USER/Library/Preferences/convox/racks/<RACK_NAME>
If you run into any issues installing and need to delete the local rack you can run:
sudo rm –rf /Users/$USER/Library/Preferences/convox/racks/<RACK_NAME>
