1. Packages
  2. Azure Native
  3. How-to Guides
  4. Azure Kubernetes Service (AKS) Cluster and Helm Chart
This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.66.0 published on Wednesday, Oct 9, 2024 by Pulumi

Azure Kubernetes Service (AKS) Cluster and Helm Chart

azure-native logo
This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
Azure Native v2.66.0 published on Wednesday, Oct 9, 2024 by Pulumi

    View Code Deploy this example with Pulumi

    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

    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.

    1. Get the code:

      $ git clone git@github.com:pulumi/examples.git
      $ cd examples/azure-py-aks-helm
      
    2. Create a new stack, which is an isolated deployment target for this example:

      $ pulumi stack init
      
    3. Set the required configuration variables for this program:

      $ pulumi config set azure-native:location westus2
      
    4. 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):

      $ pulumi up
      

      Note: this command will create a virtual environment and restore dependencies automatically as described in Pulumi docs.

    5. 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 (apache_service_ip).

      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 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
      
    6. 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.

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

      $ pulumi destroy
      $ pulumi stack rm
      $ rm kubeconfig.yaml
      
    azure-native logo
    This is the latest version of Azure Native. Use the Azure Native v1 docs if using the v1 version of this package.
    Azure Native v2.66.0 published on Wednesday, Oct 9, 2024 by Pulumi