Deploy the state-machine-service helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the `state-machine-service` helm chart on Rancher using Pulumi, we first need to ensure that we have a Rancher instance running and that we are able to interact with it. Pulumi interacts with Rancher by using its provider to manage resources, and in this case, we will use the Rancher2 provider.

Below, I will outline the steps required to set up and deploy the Helm chart using Pulumi and Typescript.

1. **Install Pulumi**: Make sure Pulumi is installed on your local machine. You can find installation instructions on the [Pulumi Get Started](https://www.pulumi.com/docs/get-started/) page.

2. **Configure Access to Rancher**: You'll need to ensure you have access to your Rancher cluster and you know your cluster ID. This typically involves capturing the Rancher API URL, access key, and secret key which can be obtained from your Rancher Dashboard under API & Keys.

3. **Set Up Your Pulumi Project**: Initialize a new Pulumi project by running `pulumi new typescript` in your terminal and follow the prompts.

4. **Install the Rancher2 Pulumi Provider**: Add the `@pulumi/rancher2` package to your project with `npm install @pulumi/rancher2`.

5. **Create Rancher Resources in Your Program**: Write the Pulumi code to interact with Rancher and deploy the Helm chart.

For example, here is a TypeScript Pulumi program that deploys a Helm chart to a Rancher cluster:

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

// Configure access to the Rancher2 provider
const config = new pulumi.Config();
const rancherApiUrl = config.require('rancherApiUrl');
const rancherAccessKey = config.requireSecret('rancherAccessKey');
const rancherSecretKey = config.requireSecret('rancherSecretKey');
const clusterId = config.require('clusterId'); // The ID of the cluster to deploy resources into

// Initialize the Rancher2 provider with the necessary credentials
const rancherProvider = new rancher2.Provider('rancher', {
    apiUrl: rancherApiUrl,
    accessKey: rancherAccessKey,
    secretKey: rancherSecretKey,
});

// Deploy the state-machine-service Helm chart using the App resource
const helmChart = new rancher2.App('state-machine-service', {
    clusterId: clusterId,
    namespaceId: 'default', // Adjust this to the namespace you want to deploy into
    projectId: `${clusterId}:project-x`, // Adjust `project-x` to your Rancher project ID
    repoName: 'helm-repository', // Adjust to the repository where your chart is hosted
    chartName: 'state-machine-service',
    targetNamespace: 'default', // Adjust if you want to deploy into a different namespace
    values: {}, // Add any values you want to override in the Helm chart
    // Other optional parameters ...
}, { provider: rancherProvider });

// Export the App name and status
export const appStatus = helmChart.status;
export const appName = helmChart.metadata.apply(metadata => metadata.name);
```

Please ensure that you replace placeholders like `rancherApiUrl`, `rancherAccessKey`, `rancherSecretKey`, `clusterId`, and other repository and chart-specific options with the actual values associated with your setup.

This code sets up the Pulumi Rancher2 provider with your Rancher credentials. It then deploys the `state-machine-service` Helm chart to your desired cluster and namespace within Rancher. The values object is empty here but would typically contain any chart values you need to override.

Once you have written this code into a file (e.g., `index.ts`), simply run `pulumi up` to execute the deployment.

Remember also to install the necessary Pulumi packages and configure Pulumi with the Rancher access details if you haven't. You can do this by setting up a `Pulumi.yaml` file in your project's root folder and running `npm install` to ensure all dependencies are installed based on your `package.json` definitions.