Deploy the haproxy-postgres helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the `haproxy-postgres` Helm chart on a Rancher-managed Kubernetes cluster using Pulumi, you will need to perform the following steps:

1. Set up the necessary prerequisites, like having access to a Rancher-managed Kubernetes cluster and being authenticated to it.
2. Install the Pulumi CLI and set up a Pulumi project if you haven't done so yet.
3. Install the `rancher2` Pulumi provider, which allows you to interact with Rancher.
4. Write a Pulumi program in TypeScript to deploy the Helm chart.

First, let's discuss the Pulumi resources we'll be using:

- `rancher2.Cluster`: Represents a Kubernetes cluster managed by Rancher. In this case, we'll assume you already have a cluster provisioned and will use its ID to deploy the Helm chart.
- `rancher2.CatalogV2`: Represents a Rancher Catalog, which is a collection of Helm charts that Rancher can deploy.
- `rancher2.AppV2`: Represents a Rancher application that is deployed from a Helm chart within a catalog.

Below is a Pulumi program written in TypeScript that demonstrates how to deploy the `haproxy-postgres` Helm chart on a Rancher-managed Kubernetes cluster. Please ensure you have installed the `@pulumi/rancher2` package from npm, which provides the necessary Pulumi resources to interact with Rancher.

```typescript
import * as pulumi from "@pulumi/pulumi";
import * as rancher2 from "@pulumi/rancher2";

// Provide the Rancher-managed cluster ID where the Helm chart will be deployed.
const clusterId = "your-cluster-id"; // Replace with your actual cluster ID

// Create a Rancher Catalog resource if it's not already set up. This step is
// typically done once per Rancher setup and not necessarily for each deployment.
const cat = new rancher2.CatalogV2("haproxy-postgres-catalog", {
    clusterId: clusterId,
    url: "https://charts.bitnami.com/bitnami", // Assuming 'haproxy-postgres' is available in this Bitnami repository
});

// Deploying Helm chart onto the Rancher-managed cluster.
const haproxyPostgresApp = new rancher2.AppV2("haproxy-postgres-app", {
    clusterId: clusterId,
    namespace: "default", // Provide the target namespace inside the cluster
    repoName: cat.name,   // Bind the helm chart to the catalog created
    chartName: "haproxy-postgres", // The name of the Helm chart to deploy
    chartVersion: "1.0.0", // Specify the version of the chart you wish to deploy
    values: pulumi.output({}) // Provide any custom values.yaml file content here if needed
});

// Export the name of the deployed app
export const appName = haproxyPostgresApp.name;
```

In the above program:

- `clusterId` should be replaced with the actual ID of your Rancher-managed Kubernetes cluster.
- `CatalogV2` is created pointing to the Bitnami repository that contains the `haproxy-postgres` Helm chart, assuming that's where this chart resides.
- `AppV2` resource ties together the cluster, the catalog, and the Helm chart. The chart from the catalog is being deployed to the default namespace.
- The `chartVersion` is set to `1.0.0`, which you should replace with the specific version of `haproxy-postgres` you want to use.
- The `values` parameter lets you customize the Helm chart deployment by providing your configuration as you would normally include in a `values.yaml` file.
- Finally, it exports the app name as an output of the Pulumi program, which can be useful for retrieving deployment details later.

Remember, please replace placeholder strings with the actual values you intend to use for your deployment. This might include the cluster ID, namespace, and version of the Helm chart. Before you can run this program, you need to ensure that your Pulumi stack is configured to communicate with your Rancher instance, and you have the correct permissions.