Deploy the argo-workflow helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the Argo Workflows Helm chart on a Kubernetes cluster managed by Rancher, you'll need to perform a few steps. We'll assume that you already have a Rancher-managed Kubernetes cluster up and running.

Here are the steps we'll take in the Pulumi program:

1. **Set up the Rancher provider**: This enables us to interact with the Rancher API using Pulumi.
2. **Define a Kubernetes Namespace**: It's best practice to install Helm charts within their own namespace on your cluster.
3. **Deploy the Argo Workflows Helm Chart**: We'll use a `helm.v3.Chart` resource for this.

Here's a TypeScript program you can use to deploy the Argo Workflows Helm chart on a Rancher-managed Kubernetes cluster:

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

// Initialize Rancher provider. The configuration should be set via environment variables or the Pulumi configuration system.
const rancherProvider = new rancher2.Provider("rancher", {
    // Provide specific provider configuration like API URL and access keys if necessary
    // apiUrl: 'https://your-rancher-api-url',
    // accessKey: 'your-rancher-access-key',
    // secretKey: 'your-rancher-secret-key',
});

// Create a Kubernetes namespace for Argo Workflows
const argoNamespace = new k8s.core.v1.Namespace("argo-namespace", {
    metadata: { name: "argo-workflows" },
}, { provider: rancherProvider });

// Deploy Argo Workflows Helm chart
const argoChart = new k8s.helm.v3.Chart("argo-workflows", {
    chart: "argo",
    version: "0.16.7", // Specify the version of Argo Workflows you want to deploy
    fetchOpts: {
        repo: "https://argoproj.github.io/argo-helm", // The repository where the Helm chart is hosted
    },
    namespace: argoNamespace.metadata.name,
    // Set values for the Helm chart as needed
    values: {
        server: {
            serviceType: "LoadBalancer",
        },
    },
}, { provider: rancherProvider, dependsOn: [argoNamespace] });

// Export the URL of the Argo Workflows server
export const argoServerUrl = argoChart.getResourceProperty("v1/Service", "argo-workflows-argo-server", "status")
    .apply(status => status.loadBalancer.ingress[0].hostname || status.loadBalancer.ingress[0].ip);
```

- The `@pulumi/kubernetes` and `@pulumi/rancher2` packages are the Pulumi SDKs for Kubernetes and Rancher respectively.
- We initialize the Rancher provider by providing necessary credentials like the API URL, access key, and secret key. You might need to configure the provider with additional details depending on your setup.
- We create a Kubernetes namespace called `argo-workflows`. This is a standard Kubernetes namespace resource.
- We define a `helm.v3.Chart` resource to install the Argo Workflows Helm chart from the official Argo Helm chart repository.
- We specify the chart version we want to install. It's important to use a specific version for predictable deployments.
- We set necessary values in the Helm chart, such as exposing the Argo Workflows server via a LoadBalancer service.
- Lastly, we export the URL of the Argo Workflows server so that you can access it outside of the cluster.

After writing this code into a `.ts` file, you can deploy it using the Pulumi CLI by running `pulumi up`.

Remember, you need to have Pulumi installed and set up, as well as have a Rancher-managed Kubernetes cluster available for this code to work. The Pulumi program should run "out of the box" after adjusting any configuration necessary for your specific Rancher environment, such as the cluster's API URL and access credentials.