Deploy the sumologic-fluentd helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the `sumologic-fluentd` Helm chart on a Rancher-managed Kubernetes cluster using Pulumi, you'll first need to create or use an existing cluster, and then deploy the Helm chart to that cluster.

Here's a step-by-step explanation of how to achieve this:

1. **Setting up the Cluster**: Before you can deploy any applications, you first need a Kubernetes cluster. If you are using Rancher, this might be a cluster you've created through the Rancher UI or API.

2. **Installing the Pulumi Rancher2 Provider**: To interact with Rancher, you'll use the Pulumi Rancher2 provider. This provider offers resources to manage Rancher itself and resources within Rancher, including Helm chart installations.

3. **Creating a Helm Release**: With the Pulumi Rancher2 provider, you can create a `HelmChart` resource. This Pulumi resource corresponds to a Helm release within the Kubernetes/Rancher environment. You'll specify the chart name (`sumologic-fluentd`), repository, and any values you want to configure.

Now let's put this into a Pulumi program using TypeScript:

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

// Note: These values are hypothetical and will need to be replaced with your actual cluster/project IDs and configurations.
const clusterId = "c-xxxxx"; // Replace with your actual cluster ID
const projectId = "p-yyyyy"; // Replace with your actual project ID within Rancher

// Create a Pulumi Kubernetes provider for the Rancher cluster. This assumes you have already set up the cluster with Rancher.
const k8sProvider = new kubernetes.Provider("k8s-provider", {
    kubeconfig: rancher2.getKubeConfigOutput({ clusterId: clusterId }).kubeConfig,
});

// Deploy the sumologic-fluentd Helm chart using the Kubernetes provider.
const sumologicFluentdChart = new kubernetes.helm.v3.Chart("sumologic-fluentd", {
    chart: "sumologic-fluentd",
    version: "1.0.0", // Specify the version you want to deploy
    fetchOpts: {
        repo: "https://sumologic.github.io/sumologic-kubernetes-collection", // Helm chart repository URL
    },
    // Provide any additional configuration values for your chart here.
    values: {
        // This is just an example, refer to the chart's documentation for actual values.
        sumologic: {
          accessId: "YOUR_SUMOLOGIC_ACCESS_ID",
          accessKey: "YOUR_SUMOLOGIC_ACCESS_KEY",
        },
        fluentd: {
          // Provide fluentd-specific settings
        },
    },
}, { provider: k8sProvider });

// Optionally, if you need an output of any detail such as a service URL for the deployed chart.
export const fluentdServiceUrl = sumologicFluentdChart.getResourceProperty("v1/Service", "sumologic-fluentd", "status").apply(status => status.loadBalancer.ingress[0].hostname);
```

Here's an explanation of the program:

- We first import the necessary Pulumi modules (`@pulumi/kubernetes` and `@pulumi/rancher2`).
- Replace `clusterId` and `projectId` with your actual Rancher cluster and project identifiers.
- We create a Pulumi Kubernetes Provider that will interact with the Rancher cluster. This is done by using Pulumi's `getKubeConfigOutput` function to retrieve the kubeconfig from Rancher and then creating a new provider with that configuration.
- Next, we define a new Helm chart resource named `sumologic-fluentd` using the Helm v3 Pulumi Package.
- We specify the chart name, version, and the repository from where to fetch the chart.
- We can also provide custom values to the Helm chart, potentially containing sensitive information or specific configurations; these are placeholders in this example and should be updated with values relevant to `sumologic-fluentd`.
- Finally, we export a Pulumi stack output, which could be something like the service URL. This is optional and depends on whether you need to access or share any resource information after the deployment.

Please make sure you've set up Pulumi CLI and have access to the Rancher cluster where you want to deploy your applications. Also, ensure that you replace placeholder values with the appropriate configuration options for your Sumo Logic account and fluentd settings, following the Helm chart documentation for `sumologic-fluentd`.