Skip to content

You are viewing documentation for Immuta version 2023.2.

For the latest version, view our documentation for Immuta SaaS or the latest self-hosted version.

Deploying Immuta Cluster Infrastructure on AKS/ACS

Audience: System Administrators

Content Summary: Before installing Immuta, you will need to spin up your AKS or ACS cluster. This page outlines how to deploy Immuta cluster infrastructure on AKS and ACS.

If you would like to install Immuta on an existing AKS or ACS cluster, you can skip this section. However, we recommend deploying a dedicated resource group and cluster for Immuta if possible.

Once you have deployed your cluster infrastructure, please visit Helm Installation on Microsoft Azure Kubernetes Service to finish installing Immuta.

Support for AKS and ACS

Best Practice: Use AKS

Immuta highly recommends to use the improved version of Azure Kubernetes Service, AKS. Immuta on AKS will exhibit superior stability, performance, and scalability than a deployment on the deprecated version known as ACS.

Create Resource Group

You will need a resource group to deploy your AKS or ACS cluster in:

az group create --name immuta-resource-group --location <your desired region>

Note: There is no naming requirement for the Immuta resource group.

Create VM Cluster

Now it is time to spin up your cluster resources in Azure. This step will be different depending on whether you are deploying an AKS or ACS cluster.

After running the command, you will have to wait a few moments as the cluster resources are starting up.

Create AKS Cluster (Recommended):

az aks create \
--resource-group immuta-resource-group \
--name immuta-cluster \
--node-count 3 \
--node-vm-size Standard_DS3_v2 \
--generate-ssh-keys

Create ACS Cluster (Deprecated):

az acs create \
--orchestrator-type kubernetes \
--resource-group immuta-resource-group \
--name immuta-cluster \
--agent-count 3 \
--agent-vm-size Standard_DS3_v2 \
--generate-ssh-keys

Configure kubectl

You will need to configure the kubectl command line utility to use the Immuta cluster.

Install kubectl through Azure CLI

If you do not have kubectl installed, you can install it through the Azure CLI.

If you are using AKS, run

az aks install-cli

For ACS clusters, run

az acs kubernetes install-cli

Point kubectl to your Immuta cluster

If you are using AKS, run

az aks get-credentials --resource-group immuta-resource-group --name immuta-cluster

For ACS clusters, run

az acs kubernetes get-credentials --resource-group immuta-resource-group --name immuta-cluster

External References