Deploy the sonatype-nexus3 helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the Sonatype Nexus 3 Helm chart on a Rancher-managed Kubernetes cluster, you'll need to follow several steps. First, you'll need to have a Rancher Kubernetes cluster up and running. Then you will need to install and configure the Rancher2 provider in your Pulumi program to interact with your Rancher setup.

Here's a detailed breakdown of the steps you'll take in the Pulumi program:

1. **Set up the Rancher2 provider**: This involves configuring Pulumi to use the credentials for Rancher. The provider allows Pulumi to manage resources within your Rancher setup.
   
2. **Add a Catalog**: Rancher can install applications from Helm charts. To do this, you need to add a Catalog resource to your Rancher cluster that points to the Helm chart repository containing the Nexus 3 chart.

3. **Deploy the Helm Chart**: Once the Catalog is set up, you can deploy the Helm chart to your cluster. You will define a `rancher2.App` and refer to the chart from the Catalog.

Please replace `your-cluster-id` with the actual ID of the configured Rancher Kubernetes cluster you intend to deploy to.

Below is the Pulumi TypeScript program that performs these actions:

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

// Create a new rancher2 catalog to add Helm chart repository
const catalog = new rancher2.Catalog("sonatype-nexus3", {
    clusterId: "your-cluster-id", // Replace with your actual Rancher cluster ID
    url: "https://sonatype.github.io/helm3-charts/", // The repository URL where the chart is located
    // Specify any additional settings if necessary
});

// Deploy Sonatype Nexus 3 Helm chart using a rancher2 App
const nexusApp = new rancher2.App("sonatype-nexus", {
    clusterId: catalog.clusterId,
    projectId: "your-project-id", // Replace with your actual Rancher project ID within the cluster
    namespace: "nexus", // Specify the namespace where the app should be deployed, or create a new one
    repoName: catalog.name,
    chart: "sonatype-nexus", // The chart name from catalog
    // You may have to specify the chart version and values in accordance with the Helm chart you are deploying
    // valuesYaml is used to provide custom values for the chart. Replace or extend this with any values required by the Nexus chart
    // For example:
    /* valuesYaml: `
        nexus:
          persistence:
            enabled: true
            storageClassName: standard
            accessMode: ReadWriteOnce
        `
    */
});

// Export the URL to access the deployed Nexus instance
export const nexusUrl = nexusApp.status.appliedBaseUrl;
```

In this program:
- You import the `rancher2` package which includes the necessary resources to interact with Rancher.
- You create a new Catalog that points to the Helm chart repository containing Sonatype Nexus 3.
- You then create an `App` resource that deploys the Helm chart to your Rancher-managed cluster. The `App` uses the Catalog you declared.
- The cluster ID and project ID are specific to your Rancher setup, so you'll need to replace the placeholders with actual values from your Rancher environment.
- The `valuesYaml` can be customized to suit the specific requirements of your Nexus deployment. It is commented out here because these will vary based on your use case, version of Nexus, and any custom configuration you may need.

Make sure to consult the Helm chart documentation for Nexus to determine what configuration options are available and which ones you should specify for your deployment.

Lastly, we export a `nexusUrl` which will be the URL under which the Nexus service will be available, exposing the necessary information to access the newly deployed Nexus instance.