Deploy the mattermost-instance helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the Mattermost instance Helm chart on Rancher, you'll need to use the `CatalogV2` resource from the `rancher2` Pulumi provider to add the Helm repository that contains the Mattermost chart. Then, you can use the `App` resource to deploy Mattermost from the chart.

The `CatalogV2` resource allows you to manage Helm chart repositories within Rancher, and the `App` resource manages the deployment of applications from Helm charts in a Rancher environment.

Below is a Pulumi program that demonstrates how to add a Helm repository to Rancher and deploy the Mattermost instance. This example assumes you have Rancher set up and that you're using Pulumi with the rancher2 provider configured.

1. **Add the Helm repository to Rancher**: This is done through the `CatalogV2` resource. You specify the Helm repository URL and a name for the catalog.
2. **Deploy Mattermost**: Once the repository is added, you can then deploy an application using the `App` resource. The `App` resource refers to the catalog you added previously and specifies the chart you want to deploy, which in this case is the Mattermost chart.

Here is the Pulumi TypeScript program that accomplishes the above steps:

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

// Step 1: Define your Rancher cluster settings
const clusterId = "your-cluster-id"; // Replace with your actual cluster ID

// Step 2: Create a namespace for the Mattermost instance
const mattermostNamespace = new rancher2.Namespace("mattermost-namespace", {
    clusterId: clusterId,
    name: "mattermost",
});

// Step 3: Add the Helm repository to Rancher using the CatalogV2 resource
const mattermostCatalog = new rancher2.CatalogV2("mattermost-catalog", {
    clusterId: clusterId,
    name: "mattermost",
    url: "https://helm.mattermost.com", // Replace with the actual chart repository if different
});

// Step 4: Deploy the Mattermost Helm chart using the App resource
const mattermostApp = new rancher2.AppV2("mattermost-instance", {
    clusterId: clusterId,
    namespace: mattermostNamespace.name,
    repoName: mattermostCatalog.name,
    chartName: "mattermost-team-edition", // Specify the chart name for Mattermost
    chartVersion: "latest", // You might want to pin this to a specific version
});

// Step 5: Export the application URL (assuming it includes an Ingress that provides an external URL)
export const mattermostUrl = mattermostApp.status.apply(status => status?.summary?.externalUrl);
```

This program performs the following actions:

- It imports the `rancher2` module, which contains the necessary resources for interacting with Rancher.
- It defines a target cluster by specifying a `clusterId`, which you need to replace with your actual Rancher cluster ID.
- It creates a new namespace in Rancher for Mattermost using the `Namespace` resource.
- It adds the Mattermost Helm chart repository to Rancher as a catalog using the `CatalogV2` resource. The `url` is set to the Mattermost Helm repository.
- It deploys Mattermost using the `AppV2` resource, referencing the catalog created earlier and setting the `chartName` to the Mattermost chart that is available in the catalog. The `chartVersion` is set to 'latest', but it could be set to a specific version if needed.
- Finally, it attempts to export the external URL where Mattermost will be accessible, by looking up the `status.summary.externalUrl` property of the deployed app. This assumes that your chart includes an Ingress that provides an external URL.

Please adjust the resource properties to match your specific Rancher configuration and naming conventions. Also, replace the placeholders (such as `'your-cluster-id'`) with actual values from your environment. If Mattermost requires additional settings, like custom values, you should include them in the `values` property of the `AppV2` resource.