Deploy the archiva helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the Archiva Helm chart on a Rancher-managed Kubernetes cluster, you will need to perform the following steps using Pulumi with TypeScript:

Set up the Rancher2 Provider: Ensure you have access to a Rancher instance and obtain the necessary credentials to use Rancher's API. Install the Rancher2 Pulumi provider to interact with Rancher.
Create a Kubernetes Cluster on Rancher: Define and provision a Kubernetes cluster managed by Rancher.
Set up the Helm Release: Configure Pulumi to deploy the Archiva Helm chart to the Kubernetes cluster you have set up.

Here is a Pulumi program written in TypeScript that carries out the above steps:

import * as rancher2 from "@pulumi/rancher2";
import * as k8s from "@pulumi/kubernetes";

// Step 1: Set up the Rancher2 Provider
// This requires the Rancher API URL and a token to authenticate with the Rancher API.
// Make sure to replace the placeholders with actual values.
const rancherProvider = new rancher2.Provider("rancherProvider", {
    api_url: "https://<RANCHER_API_URL>",
    token_key: "<RANCHER_API_TOKEN>"
});

// Step 2: Create a Kubernetes Cluster on Rancher
// This is an example of creating a custom cluster. You should customize the options based on your requirements.
// Make sure to add the necessary cloud provider options if you are deploying the cluster to a cloud provider.
const cluster = new rancher2.Cluster("my-cluster", {
    rkeConfig: {
        network: {
            plugin: "canal",
        },
        services: {
            kubeApi: {
                serviceNodePortRange: "30000-32767",
            },
        },
        // Add more RKE config options as needed.
    },
}, { provider: rancherProvider });

// Step 3: Install a Helm Chart onto the created Kubernetes cluster
// First, you need to obtain the kubeconfig for the newly provisioned cluster
const kubeconfig = cluster.kubeConfigRaw;

const k8sProvider = new k8s.Provider("k8s-provider", {
    kubeconfig: kubeconfig,
});

// The Helm chart for Archiva can now be deployed using the obtained kubeconfig
const archivaHelmChart = new k8s.helm.v3.Chart("archiva", {
    chart: "archiva",
    version: "0.1.0", // specify the version of the chart
    fetchOpts:{
        repo: "http://archiva-helm-repo", // specify the repository hosting Archiva chart
    },
    // Specify any values needed for the chart
    values: {
        // Add Archiva specific values here
    },
}, { provider: k8sProvider });

// Export the cluster name and kubeconfig as outputs
export const rancherClusterName = cluster.name;
export const rancherKubeconfig = kubeconfig;

In this program:

The rancher2.Provider is set up with the API URL and token required to communicate with your Rancher instance.
A new Kubernetes cluster is created using the rancher2.Cluster declaration.
The kubeconfig of the newly created cluster is used to set up a k8s.Provider.
The Archiva Helm chart is then deployed using k8s.helm.v3.Chart specifying the chart name, version, and repository. You should replace these placeholders with the appropriate values for the Archiva chart.
Finally, we export the cluster name and kubeconfig so that they can be easily retrieved using pulumi stack output.

Remember to replace <RANCHER_API_URL> with your Rancher API endpoint and <RANCHER_API_TOKEN> with your Rancher API access token. You'll also need to input the actual repository URL hosting the Archiva chart in the Helm release setup.

Make sure to run npm install to install the necessary Pulumi packages for this program:

npm install @pulumi/rancher2 @pulumi/kubernetes

Before running this Pulumi program, you should also have the Pulumi CLI installed and be logged into your Pulumi account. You can then run your program using the following CLI commands:

pulumi up

Keep in mind that each cloud provider may require additional configurations for creating clusters and nodes, which you should supply in the rkeConfig object. The above code works with a local Rancher installation. For cloud systems, you should configure cloud credentials either in the Pulumi config or as environment variables depending on the cloud provider you're using.