Deploy the mysql-storage helm chart on Rancher

Question

Pulumi · Accepted Answer

Deploying a Helm chart on a Rancher-managed Kubernetes cluster using Pulumi involves several steps. First, you need to have a Rancher Kubernetes cluster up and running. Second, you need to install the Helm chart to the cluster.

Here's a breakdown of the steps you will follow in the Pulumi program below:

1. Establish a connection to your Rancher server using the `rancher2` provider.
2. Access an existing cluster managed by Rancher or provision a new one.
3. Deploy the MySQL Helm chart to your Rancher-managed Kubernetes cluster.

To deploy the MySQL Helm chart, you can use the Pulumi Kubernetes provider in combination with the Rancher2 provider to configure your cluster and deploy applications.

Below is a TypeScript program that demonstrates how to perform these steps using Pulumi:

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

// Step 1: Configure the Rancher2 provider
// This relies on your Rancher API token and server URL being set
// as environment variables `RANCHER_TOKEN_KEY` and `RANCHER_SERVER_URL`.
const rancher2Provider = new rancher2.Provider("rancher2-provider", {
    apiToken: process.env.RANCHER_TOKEN_KEY,
    serverUrl: process.env.RANCHER_SERVER_URL,
});

// Step 2: Obtain access to your Rancher-managed Kubernetes cluster
// For this example, we are assuming that you have an existing cluster named "my-cluster"
// Replace "my-cluster" with the actual name of your Rancher-managed cluster.
const cluster = rancher2.getCluster({
    name: "my-cluster",
}, { provider: rancher2Provider });

// Step 3: Deploy the MySQL Helm chart to the cluster
// Ensure you have the Helm chart details such as repository URL, chart name, and version.
const mysqlRelease = new k8s.helm.v3.Release("mysql-storage", {
    chart: "mysql",
    version: "1.6.9", // specify the exact chart version you need
    repositoryOpts: {
        repo: "https://charts.helm.sh/stable", // use the correct Helm chart repository URL
    },
    // Set the values for the MySQL Helm chart
    values: {
        mysqlUser: "my-user",
        mysqlPassword: "my-password", // replace with your desired password
        // ... any other MySQL-specific configurations
    },
    // Specify the namespace and kubeconfig from the fetched Rancher cluster
    namespace: "default", // or the namespace where you want to deploy your chart
}, { provider: new k8s.Provider("k8s-provider", {
    kubeconfig: cluster.kubeConfig,
}) });

// Export the release name of MySQL to check your Helm release is installed
export const mysqlReleaseName = mysqlRelease.status.name;
```

In this program, we start by configuring the `rancher2` provider with an API token and the server URL for your Rancher server. Make sure that you replace the placeholder with your actual Rancher server URL and that your API token is available as an environment variable.

Next, we fetch the details of a specific Rancher-managed cluster by its name. In your case, you'd replace `"my-cluster"` with the actual name of your cluster.

In step 3, we deploy the MySQL Helm chart named `mysql-storage` to the specified cluster. The `k8s.helm.v3.Release` resource takes care of deploying the Helm chart with the provided configuration values.

You must provide the `repositoryOpts` information with the correct Helm chart repository and chart version you wish to deploy. Similarly, you need to provide the MySQL-specific configuration inside the `values` property.

Lastly, we export the Helm release name so we can easily confirm that the Helm chart has been deployed successfully.

Remember that the Pulumi program shown here is a boilerplate and should be customized with the specific versions of the MySQL Helm chart you wish to use as well as settings like namespace and other MySQL configurations. Ensure you have the Rancher2 provider properly configured with the necessary permissions and that your Kubernetes provider is correctly set up with the kubeconfig obtained from Rancher.

To execute this Pulumi program, you'd need to have Pulumi installed and configured on your local machine along with Node.js for running TypeScript-based programs. Then, you'd simply navigate to the directory containing this program and run `pulumi up` to apply the changes. After you run the program, you can inspect the state and outputs with `pulumi stack output`.