Deploy the kimai2 helm chart on Azure Kubernetes Service (AKS)

Question

Pulumi · Accepted Answer

To deploy the Kimai2 helm chart on Azure Kubernetes Service (AKS), we will follow these steps using Pulumi and TypeScript:

1. **Create an AKS cluster**: We will set up an AKS cluster using Azure's native capabilities through Pulumi.
2. **Deploy the Helm Chart**: Once the AKS cluster is ready, we will then deploy the Kimai2 Helm chart to the AKS cluster using Pulumi's Kubernetes provider.

We'll use two Pulumi resources for this process:

- `azure-native:containerservice:ManagedCluster` to create the AKS cluster.
- `kubernetes.helm.v3.Chart` to deploy the Helm chart on the AKS cluster.

Here is the program that accomplishes the deployment:

```typescript
import * as azure from "@pulumi/azure-native";
import * as k8s from "@pulumi/kubernetes";
import * as pulumi from "@pulumi/pulumi";

// A new resource group to contain our AKS cluster
const resourceGroup = new azure.resources.ResourceGroup("myResourceGroup");

// Create an AKS Cluster
const aksCluster = new azure.containerservice.ManagedCluster("myAKSCluster", {
    // Replace with your desired settings and parameters
    resourceGroupName: resourceGroup.name,
    agentPoolProfiles: [{
        count: 2,
        maxPods: 110,
        mode: "System",
        name: "agentpool",
        osDiskSizeGB: 30,
        vmSize: "Standard_DS2_v2",
    }],
    dnsPrefix: `${pulumi.getStack()}-kube`,
    enableRBAC: true,
});

// Export the kubeconfig
export const kubeconfig = aksCluster.kubeConfigRaw;

// Create a Kubernetes provider instance that uses our AKS cluster from above.
const k8sProvider = new k8s.Provider("k8sProvider", {
    kubeconfig,
});

// Deploy the Kimai2 Helm chart on the AKS cluster
const kimai2Chart = new k8s.helm.v3.Chart("kimai2", {
    chart: "kimai2", // This should match the chart name in the helm repository
    version: "1.0.0", // Replace with the desired version of the chart
    fetchOpts: {
        repo: "http://kimai-charts.example.com/", // Replace with the actual Helm chart repository
    },
}, { provider: k8sProvider });

// Export the public IP to access the Kimai2 instance
export const kimai2IP = kimai2Chart.getResourceProperty("v1/Service", "kimai2", "status").loadBalancer.ingress[0].ip;
```

This program performs the following actions:

- It imports the packages we need: Azure-specific (`@pulumi/azure-native`) and Kubernetes (`@pulumi/kubernetes`).
- It creates a new resource group where the AKS cluster will reside.
- It provisions an AKS cluster with a specified DNS prefix and RBAC enabled. The agent pool profile contains the VM size and the number of VMs that will be part of the cluster.
- It exports the raw Kubernetes configuration to be used by the Kubernetes provider to manage Kubernetes resources.
- It creates a Kubernetes provider that uses the AKS cluster as its target.
- It deploys the Kimai2 Helm chart using the `kubernetes.helm.v3.Chart` resource; to do this, we specify the chart name, version, and repository where the Helm chart is located.
- Finally, it attempts to export the public IP address allocated to the Kimai2 service, which will be used to access the Kimai2 web interface once it is deployed and running.

Please ensure that you have the Helm chart's correct name, version, and repository URL. You may have to modify these values based on where the Kimai2 Helm chart is stored and its actual version.

Note: You will need to have Pulumi configured with access to your Azure account, and to have Helm and kubectl installed on your system for this code to work. The Pulumi CLI will prompt you for the necessary Azure credentials the first time you try to create resources.

To execute the program:

- Install Pulumi CLI.
- Set up Azure CLI and log in using `az login`.
- Save this code in a file with a `.ts` extension, like `index.ts`.
- Run `pulumi up` to launch the deployment.

After the deployment, you can visit the `kimai2IP` address in your browser to access Kimai2. If any additional configuration is required, such as setting up helm repositories or custom values for the deployment, you should include that in the `k8s.helm.v3.Chart` resource arguments.