Deploy the vhss helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy a Helm chart on Rancher using Pulumi, you would use the Pulumi Rancher2 provider. The provider allows you to interact with and manage Rancher resources, such as clusters, workloads, and Helm charts. In this example, I'll illustrate how to deploy a Helm chart to a Rancher-managed Kubernetes cluster.

Before running the Pulumi code, you need to have access to a Rancher server and a Kubernetes cluster managed by Rancher. You should also have the `vhss` Helm chart available in a Helm repository or as files in your local system.

Below is a Pulumi TypeScript program that deploys the `vhss` Helm chart to a Rancher Kubernetes cluster. This example assumes you have already set up the necessary Rancher access credentials and the Pulumi Rancher2 provider.

Here's what the code does step by step:

1. **Imports**: The `@pulumi/rancher2` package is imported to interact with Rancher resources. If this package is not already present in your project, you will need to add it using npm or Yarn.

2. **Helm Chart Deployment**: The `App` class from the `@pulumi/rancher2` package is used to deploy the Helm chart. You need to provide the name of the chart, its version, the Rancher project ID where it will be deployed, and optionally the values to customize the chart deployment.

3. **Exporting Outputs**: We export the `app.id` to get the deployment ID, which can be used for reference or dependencies in other parts of Pulumi code.

Here is the TypeScript program to deploy the `vhss` Helm chart on a Rancher-managed cluster:

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

// Create a new Rancher 2 App, which deploys a Helm chart.
const vhssApp = new rancher2.App('vhss-app', {
    // The project ID is part of your Kubernetes cluster managed by Rancher. Replace the placeholder
    // with the actual project ID.
    projectId: 'my-rancher-project-id',

// Specify the Helm chart repository URL and the chart name/version to deploy. For a local chart, you might not need
    // a repository URL, but you'll need to include the chart as part of your deployment in a different manner.
    // Replace these placeholders with the correct values for the vhss chart.
    targetNamespace: 'vhss-namespace',
    chartName: 'vhss',
    chartVersion: '1.0.0',

// You can provide custom values for the Helm chart by specifying them in the 'valuesYaml' property.
    // This field expects a YAML-formatted string. If you have a `values.yaml` file, you can import and use it here.
    valuesYaml: `key1: value1
key2: value2
# ... other custom values ...`
});

// Export the ID of the deployed Helm chart application.
export const appId = vhssApp.id;
```

Replace the placeholders for `projectId`, `chartName`, `chartVersion`, and `valuesYaml` with actual values from your Rancher environment and Helm chart. The `targetNamespace` is the Kubernetes namespace where the Helm chart will be deployed.

To run this program, save it to a file named `index.ts` in your Pulumi project, and then execute `pulumi up` using the Pulumi CLI. This command will initiate the deployment of the Helm chart.

You can check the status of the deployment and manage it through both the Rancher UI and Pulumi's outputs and logs. The deployment ID output can be used to reference this specific deployment in further Pulumi code or in your CI/CD pipelines.