---
title: "Multiple Azure Kubernetes Service (AKS) Clusters"
description: "Create multiple Azure Kubernetes Service (AKS) clusters in different regions and with different node counts"
url: "https://www.pulumi.com/dev/examples/azure-py-aks-multicluster/"
image: "https://www.pulumi.com/assets/og/dev/examples/azure-py-aks-multicluster.png"
---

# Multiple Azure Kubernetes Service (AKS) Clusters

Create multiple Azure Kubernetes Service (AKS) clusters in different regions and with different node counts

- Source on GitHub: https://github.com/pulumi/examples/tree/master/azure-py-aks-multicluster
- Deploy with Pulumi: https://app.pulumi.com/new?template=https%3A%2F%2Fgithub.com%2Fpulumi%2Fexamples%2Ftree%2Fmaster%2Fazure-py-aks-multicluster

## Get started with this example

This example lives in the [pulumi/examples](https://github.com/pulumi/examples/tree/master/azure-py-aks-multicluster) repo. Pull down just this directory to follow along:

```bash
git clone --filter=blob:none --sparse https://github.com/pulumi/examples pulumi-examples
git -C pulumi-examples sparse-checkout set azure-py-aks-multicluster
cd pulumi-examples/azure-py-aks-multicluster
```

This example demonstrates creating multiple Azure Kubernetes Service (AKS) clusters in different regions and with
different node counts. Please see https://docs.microsoft.com/en-us/azure/aks/ for more information about AKS.

## Prerequisites

Ensure you have [downloaded and installed the Pulumi CLI](https://www.pulumi.com/docs/get-started/install/).

We will be deploying to Azure, so you will need an Azure account. If you don't have an account,
[sign up for free here](https://azure.microsoft.com/en-us/free/).
[Follow the instructions here](https://www.pulumi.com/docs/intro/cloud-providers/azure/setup/) to connect Pulumi to your Azure account.

## Running the Example

> **Note**: Due to an issue in the Azure AD Terraform Provider (https://github.com/hashicorp/terraform-provider-azuread/issues/4) the
> creation of an Azure Service Principal, which is needed to create the Kubernetes cluster (see __main__.py), is delayed and may not
> be available when the cluster is created. If you get a Service Principal not found error, as a work around, you should be able to run `pulumi up`
> again, at which time the Service Principal should have been created.

After cloning this repo, `cd` into it and run these commands.

1. Create a new stack, which is an isolated deployment target for this example:

    ```bash
    $ pulumi stack init
    ```

2. Set the required configuration variables for this program:

    ```bash
    $ pulumi config set azure-native:environment public
    $ pulumi config set password --secret [your-cluster-password-here]
    $ ssh-keygen -t rsa -f key.rsa
    $ pulumi config set sshPublicKey < key.rsa.pub
    ```

3. Deploy everything with the `pulumi up` command. This provisions all the Azure resources necessary, including
   an Active Directory service principal and AKS clusters:

    ```bash
    $ pulumi up
    ```

4. After a couple minutes, your AKS clusters will be ready. The AKS cluster names will be printed as output variables
   once `pulumi up` completes.

    ```bash
    $ pulumi up
    ...

    Outputs:
      + aksClusterNames: [
      +     [0]: "akscluster-east513be264"
      +     [1]: "akscluster-westece285c7"
        ]
    ...
    ```

5. At this point, you have multiple AKS clusters running in different regions. Feel free to modify your program, and
   run `pulumi up` to redeploy changes. The Pulumi CLI automatically detects what has changed and makes the minimal
   edits necessary to accomplish these changes.

6. Once you are done, you can destroy all of the resources, and the stack:

    ```bash
    $ pulumi destroy
    $ pulumi stack rm
    ```