Deploy the pi-hole helm chart on Kubernetes

Question

Pulumi · Accepted Answer

To deploy the Pi-hole Helm chart on a Kubernetes cluster using Pulumi, we'll utilize the kubernetes.helm.v3.Chart resource from Pulumi's Kubernetes provider. This allows us to deploy Helm charts in a Kubernetes cluster with ease, treating Helm charts as Pulumi resources.

Here's a breakdown of the Pulumi code to deploy the Pi-hole Helm chart:

Import the necessary Pulumi and Kubernetes packages.
Create a Kubernetes Chart resource specifying the Pi-hole chart. We use the helm.sh/v3 API version for this.
Optionally, you can set the values property to customize the Pi-hole Helm chart deployment. For instance, you could specify values for environment variables, resource requests and limits, or any other supported configurable option within the Pi-hole chart.

Below is the TypeScript program to deploy the Pi-hole Helm chart. Make sure you have a Kubernetes cluster running and your kubectl is configured to connect to it. Pulumi uses your kubectl configuration context to deploy resources to the appropriate cluster.

import * as kubernetes from "@pulumi/kubernetes";

// Create a Pi-hole Helm chart instance in the Kubernetes cluster. This assumes that you have Helm installed on your cluster.
const piHoleChart = new kubernetes.helm.v3.Chart("pi-hole", {
    // Replace <repository-url> with the actual repository URL where your Pi-hole Helm chart is located,
    // and <chart-name> with the name of the Pi-hole Helm chart.
    chart: "<chart-name>",
    fetchOpts: {
        repo: "<repository-url>",
    },
    // Optionally, specify the namespace where the chart should be deployed. If not specified, it will be deployed to the default namespace.
    namespace: "pi-hole",
    // Values can be customized according to your needs. Refer to the Pi-hole Helm chart's values.yaml for configuration options.
    values: {
        service: {
            type: "ClusterIP",
        },
    },
});

// Export the base domain that the Pi-hole will be available at.
// Make sure that the DNS is correctly set up to resolve to the external IP of the Pi-hole service.
export const baseDomain = piHoleChart.getResourceProperty("v1/Service", "pi-hole-web", "status").apply(status => status.loadBalancer.ingress[0].hostname);

In this code:

We're importing the @pulumi/kubernetes package to interact with Kubernetes resources.
We create a new instance of kubernetes.helm.v3.Chart, which represents the Pi-hole Helm chart deployment.
We specify the chart option with the name of the Pi-hole Helm chart and provide the repository with the fetchOpts option.
We deploy to the pi-hole namespace.
We customize some of the Helm chart values under values. In this example, we're setting the service type to ClusterIP so that the pi-hole service is only accessible within the Kubernetes cluster. To set more configuration values, you would modify this values property accordingly.
We export the baseDomain, which represents the domain where the Pi-hole will be available, assuming you've set up your DNS to point to this domain and that it resolves to the external IP where Pi-hole is exposed.

Ensure that you have set up Pulumi with the correct context of which Kubernetes cluster to deploy to, as it relies on your existing kubectl context.

After running this code with Pulumi, the Pi-hole Helm chart will be deployed into your Kubernetes cluster. You can manage and update it as you would with any other Pulumi resource.

To execute this Pulumi program:

Ensure that Pulumi is installed on your machine.
Set up a new Pulumi project using pulumi new kubernetes-typescript.
Replace the contents of index.ts with the above code, adjusting the Helm chart's details (<repository-url> and <chart-name>) as needed.
Run pulumi up to preview and deploy the resources.

Make sure to adjust <repository-url> and <chart-name> with the values specific to the Pi-hole Helm chart that you want to deploy. These will typically be provided in the official documentation for the Pi-hole Helm chart.