Install—Deploy or Release—On-premise Kubernetes

Important: Use these instructions to install Digital.ai Deploy or Release on a minikube multi-node cluster for testing or illustration purposes. Do not use these instructions to set up a production environment.

For information on performing an air-gapped installation, refer to the following topics:

• Install or upgrade Deploy in an air-gapped environment
• Install or Upgrade Digital.ai Release on an Air-gapped Kubernetes Cluster

Prerequisites

• Read and understand the Plan Your Installation or Upgrade page
• Read and understand the XL CLI's xl kube command
• A computer that runs Windows, Linux, or macOS to install and run minikube, XL CLI, and VM manager such as VirtualBox
• A minikube cluster where you install Digital.ai Deploy or Release
• XL CLI 22.3.0 or later
• minikube
• yq 4.18.2 or later

Important: If you want to enable the TLS protocol in your cluster, you must have the TLS secret created in the namespace before you start the installation or upgrade. This means that you must create the namespace first, create the TLS secret in that namesapce, and use the same namespace and TLS secret during the installation or upgrade of Digital.ai Deploy or Release.

The xl kube install and xl kube upgrade wizards let you go with the default (latest) docker image tags available when you install or upgrade Digital.ai Deploy or Release. However, here are the Docker Hub links to verify all the the available image tags.

• Digital.ai Deploy Operator Image
• Digital.al Release Operator Image
• Digital.ai Deploy Image
• Digital.ai Release Image
• Digital.ai Deploy Task Engine Image
• Digital.ai Deploy Central Configuration Image

Step 1—Install and Start minikube

1. Verify the requirements to install minikube.

2. Clean up the minikube installation if you have installed it in a Docker-based setup.

   minikube stop; minikube delete &&
   docker stop $(docker ps -aq) &&
   rm -rf ~/.kube ~/.minikube &&
   sudo rm -rf /usr/local/bin/localkube /usr/local/bin/minikube &&
   launchctl stop '*kubelet*.mount' &&
   launchctl stop localkube.service &&
   launchctl disable localkube.service &&
   sudo rm -rf /etc/kubernetes/ &&
   docker system prune -af --volumes

   Note that you must run minikube on a VM.

3. Install a VM manager such as VirtualBox and start the minikube.

   For example, use the following command to start minikube on VM.

   minikube start --driver=virtualbox -p k120 --kubernetes-version=v1.20.0

Step 2—Install the kubectl, XL CLI, and yq

1. Install the XL CLI and yq.

   See:

   • kubectl
   • XL CLI 22.3.0 or later
   • yq 4.18.2 or later

Step 4—Create the Cluster

See Using Multi-Node Clusters.

Step 5—Install Digital.ai Deploy or Release

1. Run the xl kube install command. For more information about flags to skip prompts, enable additional logging, and so on, see xl kube install Command Reference.
2. Answer the questions in the installation wizard.
3. When prompted, select PlainK8s [Plain multi-node K8s cluster] as the Kubernetes setup where the Digital.ai Devops Platform will be installed. For more information, see:
   • Installation Wizard for Deploy.
   • Installation Wizard for Release.
4. Complete the installation.
5. Log on to the Deploy or Release server and verify the installation.