Deploy the ibm-itxa-prod helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy a Helm chart on a Rancher-managed Kubernetes cluster using Pulumi, you need to have access to a Rancher instance and the Kubernetes cluster where you want to deploy the Helm chart. We will assume that you have set up your Rancher environment and that you have the necessary permissions to deploy to the cluster.

To deploy a Helm chart, we'll use the `rancher2` provider within Pulumi. This provider allows us to interact with Rancher resources, including catalogs and Helm chart deployments.

In this program, we’re going to:

1. Create a `CatalogV2` resource to add a catalog where the Helm chart is located.
2. Use the `AppV2` resource to deploy the Helm chart to our Kubernetes cluster within Rancher.

Make sure you have installed the necessary Pulumi providers, such as `@pulumi/rancher2`, by running `npm install @pulumi/rancher2`.

Below is the TypeScript program to deploy the `ibm-itxa-prod` Helm chart on a Rancher-managed Kubernetes cluster.

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

// Replace these variables with appropriate values for your Rancher setup
const clusterId = "your-cluster-id";
const catalogName = "your-catalog-name";
const catalogUrl = "your-catalog-url"; // The URL should point to where your Helm chart is located
const namespace = "desired-namespace"; // Make sure this namespace exists in your cluster or create it
const helmChartName = "ibm-itxa-prod";
const helmReleaseName = "ibm-itxa-prod-release";
const helmVersion = "the-chart-version"; // Specify the chart version you wish to deploy

// Create a new catalog that points to the repository containing the Helm chart
const catalog = new rancher2.CatalogV2(catalogName, {
    clusterId: clusterId,
    url: catalogUrl,
    // If your catalog is a Git repository and requires authentication, provide a secret to allow access
    // For example:
    // gitRepo: "https://github.com/your/repo",
    // gitBranch: "master",
    // secretName: "git-repo-secret",
    // secretNamespace: namespace,
});

// Create an App resource to deploy the Helm chart
const helmChartApp = new rancher2.AppV2(helmReleaseName, {
    clusterId: clusterId,
    // Specify the catalog created earlier
    catalogName: catalog.metadata.name,
    chartName: helmChartName,
    chartVersion: helmVersion,
    namespace: namespace,
    // Define values for the Helm chart if necessary
    // For example:
    // values: `key1: value1
key2: value2`,
});

// Export the app's name and status
export const helmAppReleaseName = helmChartApp.metadata.name;
export const helmAppStatus = helmChartApp.status;
```

This program creates a catalog resource pointing to the URL where your Helm chart is stored. It then deploys an app using the specified Helm chart from the catalog into the given namespace. The `chartVersion` should correspond to the specific version of the Helm chart that you want to deploy.

Also, the `values` field in deploying the app allows you to specify any custom configuration needed for the Helm chart. This field accepts a multi-line string in YAML format that will be passed to the Helm chart during deployment.

Remember that you might need to install the `rancher2` provider, authenticate with Rancher, and set up your Kubernetes cluster in Rancher before executing this program. Consult the Rancher and Pulumi documentation for guidance on these tasks.

After running this Pulumi program with `pulumi up`, your Helm chart should be deployed to your Rancher-managed Kubernetes cluster.