Prerequisites
Before proceeding with the setup, ensure that you have the following tools installed on your system. These tools will provide the necessary environment for containerization, orchestration, and DNS management throughout the process.
1. Docker and Minikube
We use Docker as our Kubernetes driver. Other drivers include hyperkit, virtualbox, and hyperv.
If you want to use another minikube driver, please refer to the Minikube documentation. If you want to use another kubernetes distribution, please refer to the respective documentation. Please make sure that the kubernetes distribution that you are installing does not include ingress, cert-manager, and loadbalancer, since they will be installed in the next steps specifically for CIVITAS/CORE.
Docker Desktop
macOS
brew install --cask docker
Windows
winget install Docker.DockerDesktop
Check Version (on both macOS and Windows)
docker --version
Minikube
macOS
brew install minikube
Windows
winget install minikube
Check Version (on both macOS and Windows)
minikube version
2. Kubectl
Kubectl is the command-line tool for interacting with Kubernetes clusters. It allows you to deploy applications, inspect resources, and manage Kubernetes components.
macOS
brew install kubectl
Windows
winget install kubernetes-cli
Check Version (on both macOS and Windows)
kubectl version --client
3. Helm
Helm is a package manager for Kubernetes, simplifying the process of installing and managing Kubernetes applications by using "Helm charts" (pre-configured Kubernetes resources).
macOS
brew install helm
Windows
choco install kubernetes-helm
Check Version (on both macOS and Windows)
helm version
4. OpenSSL
OpenSSL is a toolkit for the implementation of SSL/TLS and cryptographic functions. It's necessary for generating secure certificates and managing encryption during the setup process.
macOS
brew install openssl
Windows
choco install openssl
Check Version (on both macOS and Windows)
openssl version
5. Acrylic DNS Proxy (Windows) or dnsmasq (Linux/macOS)
DNS management tools like the Acrylic DNS Proxy (for Windows) and dnsmasq (for Linux/macOS) are used for local domain name resolution. They are essential for resolving custom domains like civitas.test in your local Kubernetes environment.
Acrylic DNS Proxy (for Windows)
Download and install the Acrylic DNS Proxy from here.
dnsmasq (for macOS and Linux)
brew install dnsmasq
Once you have installed these tools, verify that they are functioning correctly before proceeding.
6. Ansible, Ansible Galaxy modules and Python modules
Also, make sure that all Python and Ansible modules are installed to fulfill the requirements for the control system. You can do that with these commands
pip install -r requirements.txt
ansible-galaxy collection install -r ansible-collections.yml
The files are available in the respository.
For further information, please refer to the Installation Guide.