Deploy the hivemq-platform helm chart on Digital Ocean Kubernetes Service
TypeScriptTo deploy the HiveMQ platform Helm chart on the Digital Ocean Kubernetes Service (DOKS), we will perform the following steps using Pulumi:
- Provision a new Kubernetes cluster on DigitalOcean.
- Deploy the HiveMQ platform Helm chart into the newly created cluster.
We will use the
digitalocean.KubernetesCluster
resource to create a Kubernetes cluster on DigitalOcean. This will set up the Kubernetes control plane and worker nodes required to host our applications.After the cluster is provisioned, we will use the
kubernetes.helm.sh/v3.Chart
resource to deploy the HiveMQ platform into our cluster. The Helm chart resource allows us to install Helm charts into a Kubernetes cluster, managing the deployment as a simple resource in our Pulumi program.Here's a TypeScript program that demonstrates this process:
import * as pulumi from "@pulumi/pulumi"; import * as digitalocean from "@pulumi/digitalocean"; import * as kubernetes from "@pulumi/kubernetes"; // Step 1: Create a new DigitalOcean Kubernetes cluster. const cluster = new digitalocean.KubernetesCluster("hivemq-k8s-cluster", { region: "nyc1", version: "latest", nodePool: { name: "worker-pool", size: "s-1vcpu-2gb", nodeCount: 2, }, }); // Export the Kubeconfig so you can connect to the cluster with kubectl. export const kubeconfig = cluster.kubeConfigs[0].rawConfig; // Step 2: Deploy the HiveMQ platform using a Helm chart. // Create a Kubernetes provider instance that uses our cluster's kubeconfig. const k8sProvider = new kubernetes.Provider("hivemq-k8s-provider", { kubeconfig: kubeconfig, }); // Use the Helm Chart resource to deploy HiveMQ. const hivemqChart = new kubernetes.helm.v3.Chart("hivemq-chart", { chart: "hivemq-platform", // For demo purposes, I use the stable repo's URL. Adjust if you have a specific repo. fetchOpts: { repo: "https://repository.hivemq.com/helm/" }, namespace: "default", }, { provider: k8sProvider }); // Export the Helm chart deployment's status. export const hivemqDeploymentStatus = hivemqChart.status;
Explanation:
- We start by importing the required Pulumi packages for DigitalOcean and Kubernetes.
- We create a new DigitalOcean Kubernetes cluster with the
digitalocean.KubernetesCluster
resource. Here, we specify the cluster's region, Kubernetes version, and node pool configuration such as node size and the desired number of nodes. - We export the
kubeconfig
of the cluster, which is needed to communicate with the cluster usingkubectl
or similar tools. - We create a new Pulumi Kubernetes provider and select our cluster's
kubeconfig
to ensure that subsequent resources are deployed to this cluster. - Finally, we deploy the HiveMQ platform using
kubernetes.helm.v3.Chart
. We specify the name of the Helm chart (hivemq-platform
) and any necessary fetch options, like the repository URL where the chart is hosted. - The chart is deployed to the default namespace on the Kubernetes cluster, but you can change the namespace as per your requirements.
- An export statement allows us to observe the status of the Helm chart deployment through Pulumi's stack output.
To run this program:
- Ensure you have Pulumi CLI installed and configured with access to a DigitalOcean account.
- Save the code to a file, e.g.,
index.ts
in a new Pulumi project directory. - Run
pulumi up
to create both the Kubernetes cluster and deploy the HiveMQ platform. - Use the printed
kubeconfig
stack output to configure your localkubectl
.
Make sure to investigate the documentation for the HiveMQ Helm chart to understand which
values
you may want to customize. You can pass a customvalues
object to the chart resource to configure any chart-specific resources, security settings, persistent volumes, etc.Keep in mind that, as with all infrastructure and application deployments, you should review the security considerations and best practices provided by both the cloud provider and the application vendor.