Azure Kubernetes Service (AKS) Cluster and Helm Chart in Go

This example lives in the pulumi/examples repository. Check out just this directory to use it:

$ git clone --filter=blob:none --sparse https://github.com/pulumi/examples pulumi-examples
$ git -C pulumi-examples sparse-checkout set azure-go-aks-helm
$ cd pulumi-examples/azure-go-aks-helm

This example demonstrates creating an Azure Kubernetes Service (AKS) cluster and deploying a Helm Chart from Bitnami Helm chart repository into this cluster, all in one Pulumi program.

The example showcases the native Azure provider for Pulumi.

Prerequisites#

Install Pulumi.
Install Go
We will be deploying to Azure, so you will need an Azure account. If you do not have an account, sign up for free here.
Setup and authenticate the native Azure provider for Pulumi.

Running the Example#

In this example we will provision a Kubernetes cluster running a public Apache web server, verify we can access it, and clean up when done.

Get the code:

$ git clone git@github.com:pulumi/examples.git
$ cd examples/azure-go-aks-helm

Restore dependencies and build:
Terminal window
```
$ go build
```
Create a new stack, which is an isolated deployment target for this example:
Terminal window
```
$ pulumi stack init
```
Set the required configuration variables for this program:
Terminal window
```
$ pulumi config set azure-native:location westus2
```
Deploy everything with the pulumi up command. This provisions all the Azure resources necessary, including an Active Directory service principal, AKS cluster, and then deploys the Apache Helm Chart, all in a single gesture (takes 5-10 min):
Terminal window
```
$ pulumi up
```

Now your cluster and Apache server are ready. Several output variables will be printed, including your cluster name (clusterName), Kubernetes config (kubeconfig) and server IP address (apacheServiceIP).

Using these output variables, you may access your Apache server:

$ curl $(pulumi stack output apacheServiceIP)
<html><body><h1>It works!</h1></body></html>

And you may also configure your kubectl client using the kubeConfig configuration:

$ pulumi stack output kubeconfig --show-secrets > kubeconfig.yaml
$ KUBECONFIG=./kubeconfig.yaml kubectl get service

NAME           TYPE           CLUSTER-IP     EXTERNAL-IP      PORT(S)                      AGE
apache-chart   LoadBalancer   10.0.154.121   40.125.100.104   80:30472/TCP,443:30364/TCP   8m
kubernetes     ClusterIP      10.0.0.1       <none>           443/TCP                      8m

At this point, you have a running cluster. 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. This could be altering the existing chart, adding new Azure or Kubernetes resources, or anything, really.

TIP: if you make changes to the example code outside of an IDE, run the Go compiler after every change:
Terminal window
```
$ go build
```
Once you are done, you can destroy all of the resources, and the stack:
Terminal window
```
$ pulumi destroy
$ pulumi stack rm
$ rm kubeconfig.yaml
```

Azure Kubernetes Service (AKS) Cluster and Helm Chart

Prerequisites#

Running the Example#

Related

A Helm chart deployed to AKS that stores TODOs in an Azure Cosmos DB MongoDB API

Azure Kubernetes Service (AKS) Cluster and Helm Chart

The infrastructure as code platform for any cloud.