Deploy the cluster-api-provider-hetzner helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the `cluster-api-provider-hetzner` Helm chart on a Rancher-managed Kubernetes cluster, you would typically follow these steps:

1. **Set up the Rancher Kubernetes environment:** You need to have a running instance of Rancher and a managed Kubernetes cluster within Rancher where you can deploy Helm charts.

2. **Add Helm Chart Repository:** If the repository for `cluster-api-provider-hetzner` is not already added to Rancher, you will need to add it.

3. **Deploy the Helm Chart:** Use Rancher's capabilities to deploy the Helm chart into the Kubernetes cluster managed by Rancher.

Using Pulumi, you can automate these tasks by writing a TypeScript program that uses the Rancher2 provider.

Please note that Pulumi works with cloud resources and assumes that you've already configured the Pulumi CLI and cloud providers. Make sure you have Pulumi and the necessary cloud provider (e.g., AWS, Azure, Google Cloud) CLI installed and configured on your machine. "Configured" means that you've set up access credentials and default regions that Pulumi can use to interact with your cloud resources.

Below you'll find a TypeScript program that automates the process of deploying a Helm chart to a Rancher-managed Kubernetes cluster. Please replace the placeholder values with your specific details, such as `clusterId`, chart repository URL, and other necessary chart values.

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

// Set up the provider to communicate with your Rancher instance.
const rancherProvider = new rancher2.Provider("rancher", {
    apiURL: "https://your-rancher-server-url/v3",
    accessToken: "token", // Your token to authenticate with the Rancher API (sensitive data).
    cacerts: "certificate-authority-data", // Required if Rancher server uses self-signed cert.
});

// Register the Helm chart repository in the Rancher.
const catalog = new rancher2.CatalogV2("cluster-api-provider-hetzner-repo", {
    clusterId: "clusterId", // Your managed cluster ID in Rancher.
    url: "https://charts.example.com/", // URL for the Helm chart repository that hosts the cluster-api-provider-hetzner chart.
    name: "cluster-api-provider-hetzner",
}, { provider: rancherProvider });

// Now, we can deploy the Helm chart to the cluster
const helmChart = new k8s.helm.v3.Chart("cluster-api-provider-hetzner-chart", {
    repo: catalog.name,
    chart: "cluster-api-provider-hetzner",
    version: "chart-version", // Replace with the version of the chart you want to deploy.
    namespace: "desired-namespace", // Namespace where you want the chart to be deployed.
    values: {
        // Provide any necessary values here.
    },
    // Ensure that the Helm chart repository is registered before attempting to use the chart.
    transformations: [args => ({ ...args, dependsOn: catalog })],
}, { provider: rancherProvider });

// Export the endpoint of the deployed service.
export const endpoint = helmChart.getResourceProperty("v1/Service", "my-service", "status").apply(status => status.loadBalancer.ingress[0].ip);

```

### Explanation
- **Provider Setup:** We first define (`rancherProvider`) to interact with your instance of Rancher. The `apiURL` and `accessToken` are required to authenticate with the Rancher API.

- **Catalog Registration:** With `rancher2.CatalogV2`, we add the `cluster-api-provider-hetzner` chart repository to the specified Rancher cluster. This step simulates adding a new Helm Repository via the Rancher2 UI or API.

- **Helm Chart Deployment:** We then create an instance of `k8s.helm.v3.Chart` to deploy the `cluster-api-provider-hetzner` Helm chart into our Kubernetes cluster. The `repo` value should be set to the name we've defined in the `CatalogV2` resource. Additionally, we provide a `namespace` where we want our chart deployed and any `values` that are needed for the chart configuration.

- **Dependencies:** The `transformations` field sets a dependency on the `CatalogV2` resource to ensure that the Helm repository is available before attempting to deploy the chart.

- **Endpoint Export:** Finally, we export an endpoint, which is useful if your Helm chart includes a Service of type LoadBalancer and you want to know the IP address to access the deployed services.

This program is written using Pulumi and the `@pulumi/rancher2` package to handle Rancher resources. Be sure to replace placeholder values with actual values from your environment. If the Helm chart requires specific configuration values, ensure you include them in the `values` section of the Helm chart deployment step.