Azure Kubernetes Service (AKS) Cluster and Helm Chart
The example showcases the native Azure provider for Pulumi.
Install Python 3.6 or higher.
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 email@example.com:pulumi/examples.git $ cd examples/azure-py-aks-helm
Create a new stack, which is an isolated deployment target for this example:
$ pulumi stack init
Set the required configuration variables for this program:
$ pulumi config set azure-native:location westus2
Deploy everything with the
pulumi upcommand. 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):
$ pulumi up
Note: this command will create a virtual environment and restore dependencies automatically as described in Pulumi docs.
Now your cluster and Apache server are ready. Several output variables will be printed, including your cluster name (
cluster_name), Kubernetes config (
kubeconfig) and server IP address (
Using these output variables, you may access your Apache server:
$ curl $(pulumi stack output apache_service_ip) <html><body><h1>It works!</h1></body></html>
And you may also configure your
kubectlclient using the
$ 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 126.96.36.199 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 upto 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.
Once you are done, you can destroy all of the resources, and the stack:
$ pulumi destroy $ pulumi stack rm $ rm kubeconfig.yaml