Deploy the orientdb helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the OrientDB Helm chart on a Kubernetes cluster managed by Rancher, you'll need to complete a few steps:

1. Set up a Rancher-managed Kubernetes cluster.
2. Install the Rancher2 provider plugin for Pulumi.
3. Add the appropriate Helm chart repository that contains OrientDB.
4. Use Pulumi to deploy the OrientDB Helm chart.

For this program, I'll assume that you already have a Rancher-managed Kubernetes cluster and that you have `kubectl` access configured to communicate with the cluster. I'll provide you with a Pulumi TypeScript program that will:

- Instantiate the Rancher2 provider.
- Deploy the OrientDB Helm chart using the rancher2.CatalogV2 resource that allows us to add a new Helm chart repository to Rancher.
- Use the `helm.v3.Chart` resource from Pulumi to deploy a chart from the added catalog.

Before you run the Pulumi program, ensure that you have installed Pulumi and configured it with your cloud provider credentials. You should also have an existing Rancher cluster with Kubernetes and `kubectl` configured to connect to that cluster.

Below is a detailed Pulumi TypeScript program that accomplishes the deployment of the OrientDB Helm chart:

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

// Initialize a new Pulumi project by selecting the appropriate stack.
const rancherStack = new pulumi.StackReference("my-org/my-rancher-cluster-stack");

// Retrieve the cluster ID from the stack outputs
const clusterId = rancherStack.getOutput("clusterId");

// Configure the rancher2 provider with the retrieved cluster ID
const rancherProvider = new rancher2.Provider("rancher", {
    clusterId: clusterId,
});

// Add the Helm chart repository that contains OrientDB to the Rancher instance
const catalog = new rancher2.CatalogV2("orientdb-catalog", {
    clusterId: clusterId,
    url: "https://helm.orientdb.com/",
    gitBranch: "master", // Use the default branch of the repository.
    gitRepo: "https://github.com/orientechnologies/orientdb-kubernetes", // Example repo URL
}, { provider: rancherProvider });

// Deploy the OrientDB Helm chart into the Rancher-managed Kubernetes cluster
const orientDbHelmChart = new k8s.helm.v3.Chart("orientdb", {
    repo: "orientdb", // The alias of the chart repository within Helm
    chart: "orientdb", // The name of the chart
    version: "3.2.3", // Specify the version of the OrientDB chart you wish to deploy
    // Values for the Helm chart are supplied like this:
    values: {
        // Custom OrientDB values can be set here
        // For example, to set the number of nodes in the OrientDB cluster:
        // cluster:
        //   size: 3
    },
    namespace: "orientdb", // Namespace to deploy into, it must exist or be created separately.
}, { provider: rancherProvider, dependsOn: [catalog] }); // Ensure the catalog has been added before deploying the chart

export const orientDbChartVersion = orientDbHelmChart.version; // Exporting the version as an output
```

This program does the following:

1. It uses the `@pulumi/rancher2` package to interact with Rancher and manage Kubernetes resources through Rancher.
2. It creates a new Helm chart repository resource (`rancher2.CatalogV2`) that points to the OrientDB chart repository - this allows Rancher to recognize and manage deployments from this repository.
3. It deploys the OrientDB chart using the `@pulumi/kubernetes` package and specifically the `helm.v3.Chart` class, which is a Pulumi resource that allows you to deploy Helm charts in a Kubernetes cluster.
4. The `dependsOn` option is used to sequence the creation of resources, so the Helm chart will be deployed only after the catalog is successfully added.

Make sure to update the repository Pulumi resources (`rancher2.CatalogV2`) with the correct information, such as the URL to the OrientDB Helm charts repository if different from the example provided.

Replace `"my-org/my-rancher-cluster-stack"` with the reference to your Rancher cluster stack to pull the configuration needed to deploy resources on it.

To run the program, you will execute standard Pulumi commands in your terminal:

```sh
pulumi up
```

This will start the deployment process, where Pulumi will display a preview of the changes it will make and ask you for confirmation before proceeding. After deployment, you'll see any export values that you set, such as the OrientDB chart version in this case.

Pulumi programs are declarative; specifying the desired state of the infrastructure means Pulumi understands what changes need to be made to achieve that state. The Pulumi engine calls into the cloud provider APIs to achieve this desired state. In this case, it interacts with Rancher to deploy a Kubernetes Helm chart.