Deploy the rabbitmq-observability helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the RabbitMQ Observability Helm chart on a Rancher-managed Kubernetes cluster, you'll need to take the following steps:

1. Set up your Rancher environment and ensure that you have access to a Kubernetes cluster managed by Rancher. This means having proper access credentials and permissions.

2. Install and configure Pulumi on your local machine. Ensure you are logged into your Pulumi account and have selected the correct stack for deployment.

3. Choose the appropriate Helm chart for RabbitMQ Observability. This typically involves finding a chart repository that includes the RabbitMQ Observability chart and adding that repository to your configuration.

4. Use Pulumi's Rancher 2 package to manage resources within Rancher. Although the current Pulumi Registry results do not include any direct support for deploying Helm charts via Rancher2 resources in Pulumi, you would typically use the `rancher2.App` resource type for this task. Since this type is not listed in the results, the following code block assumes that such a resource exists, but you should check the actual documentation or seek the relevant resources available at the time of your work.

Below is a TypeScript program that demonstrates what the Pulumi code might resemble when deploying a Helm chart on Rancher. Note that you will have to replace placeholder values with actual values from your environment:

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

// Initialize a new Rancher2 provider instance.
// Note: Ensure you have set the necessary environmental variables for the Rancher2 provider authentication.
const rancherProvider = new rancher2.Provider('rancherProvider', {
  api_url: 'https://your-rancher-instance.com/v3',
  accessKey: 'your-access-key',
  secretKey: 'your-secret-key',
  // More configurations can go here depending on your Rancher setup.
});

// Deploy the RabbitMQ Observability Helm chart.
const rabbitmqObservabilityApp = new rancher2.App('rabbitmq-observability-app', {
  catalogName: 'helm', // Replace with the name of the catalog containing the chart.
  projectName: 'your-project-id', // The Rancher Project ID where the Kubernetes cluster is located.
  targetNamespace: 'rabbitmq-observability', // The target Kubernetes namespace for the RabbitMQ deployment.
  externalId: 'catalog://?catalog=helm&template=rabbitmq-observability&version=0.1.0', // The identifier of the Helm chart to deploy.
  // Include additional values for the Helm chart as needed.
  values: `
    rabbitmq:
      replicas: 3
      resources:
        requests:
          cpu: "100m"
          memory: "256Mi"
        limits:
          cpu: "100m"
          memory: "256Mi"
    `
}, {provider: rancherProvider}); // Specify the provider if not using the default provider.

// Export the app name.
export const appName = rabbitmqObservabilityApp.metadata.apply(m => m.name);

```

This code creates a new instance of the Rancher2 provider, which points to your Rancher server's API endpoint. This provider instance uses access keys that you must provide, allowing Pulumi to communicate with your Rancher API.

Next, we define a `rancher2.App` resource named `rabbitmq-observability-app`, which tells Rancher to deploy a Helm chart from a specified catalog source. `catalogName` refers to your Helm chart catalog name on Rancher, `projectName` is the ID of the Rancher project containing the cluster, and `targetNamespace` is the namespace the app will be installed within.

The `externalId` field is crucial as it specifies the catalog source and version of the RabbitMQ Observability Helm chart you want to deploy. This line needs to be adjusted with the correct Helm repository and chart details specific to your Helm chart source.

Finally, we use the `values` property to provide custom values to configure the RabbitMQ chart, which is specified as a YAML string. You can add any valid Helm values here to configure your RabbitMQ Observability deployment according to your needs.

The `provider` option for the `rabbitmqObservabilityApp` ensures that it uses the `rancherProvider` we've configured earlier, in case you have multiple providers or are not using the default one.

The provided example is rudimentary and likely needs to be adapted to fit the exact parameters and settings of your Rancher and RabbitMQ setup.

Remember to replace all the placeholder data like API URLs, access keys, project IDs, and Rancher details with appropriate values. Before running this program, ensure that you have permission to create and manage resources in your target Rancher environment.

Keep in mind that Pulumi can work with myriad cloud services, tools, and providers; always check the official Pulumi [documentation](https://www.pulumi.com/docs/) or packages on their [registry](https://www.pulumi.com/registry/) for the most up-to-date and accurate resources and information for your deployments.