Deploy the gogs helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the Gogs Helm chart on Rancher using Pulumi, you'll first need to ensure you have a Kubernetes cluster managed by Rancher and proper access configured. Once you have a cluster available, you can use Pulumi to deploy the Gogs Helm chart to that cluster.

Before we dive into writing the Pulumi program, here's a high-level view of the steps we'll take:

1. Set up a Rancher2 provider that points to your Rancher-managed Kubernetes cluster.
2. Create a Pulumi Kubernetes provider that uses the credentials from your Rancher cluster.
3. Use the Pulumi Kubernetes provider to deploy the Gogs Helm chart from the stable repository.

Below is the TypeScript program that accomplishes these tasks:

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

// Step 1: Set up the Rancher2 provider
// Configure your Rancher access here with the appropriate API URL and access token.
const rancherProvider = new rancher2.Provider('my-rancher-provider', {
    apiUrl: 'https://rancher.mydomain.com/v3',
    tokenKey: 'token-abcde', // Placeholder for your Rancher Bearer Token
});

// Replace 'my-cluster-id' with your actual cluster ID from Rancher.
const cluster = rancher2.getCluster({
    id: 'c-abcde', // The cluster ID from Rancher
}, { provider: rancherProvider });

// Step 2: Create Pulumi Kubernetes provider to manage deployments on the cluster
// After retrieving cluster information, we can create a Kubernetes provider instance using the kubeconfig data.
const k8sProvider = new k8s.Provider('my-k8s-provider', {
    kubeconfig: cluster.kubeConfig, // This is the kubeconfig provided by Rancher
});

// Step 3: Deploy the Gogs Helm chart using the Pulumi Kubernetes provider
// Deploying the Gogs chart using the "helm.sh/chart" api
const gogsChart = new k8s.helm.v3.Chart('gogs', {
    // This example assumes you're using the stable repository; you may need to adjust the chart version and the values.
    chart: 'gogs',
    version: '1.12.4', // Specify the chart version you want to deploy
    fetchOpts: {
        repo: 'https://charts.gogs.io/index.yaml', // URL to Gogs Helm repository
    },
    // You can customize the values here according to Gogs Helm chart's available settings.
    values: {
        service: {
            type: 'NodePort',
        },
    },
}, { provider: k8sProvider });

// Export the app service URL by querying the deployed service endpoint
export const appUrl = gogsChart.getResourceProperty('v1/Service', 'gogs', 'status').apply(status => {
    return status.loadBalancer.ingress[0].hostname;
});
```

In this program:

- We instantiate a Rancher provider by supplying the Rancher API URL and Token key. Replace placeholder values with those specific to your Rancher setup.
- The actual Kubernetes cluster managed by Rancher is queried using the `getCluster` method from the Rancher2 provider with the cluster ID.
- A Kubernetes provider is created using the kubeconfig obtained from the Rancher cluster, allowing Pulumi to interact with the Kubernetes API server.
- A Helm chart resource is created using Pulumi’s Kubernetes provider to deploy the Gogs Helm chart. You can modify the `values` object to configure Gogs settings according to the Helm chart's documentation.
- Finally, we export the URL of the deployed Gogs application so you can easily access it once the deployment is complete.

To run this program:

1. Save the code in a file with a `.ts` extension, for example, `deployGogs.ts`.
2. Ensure Pulumi CLI is installed and you are logged in to your Pulumi account.
3. Run `npm install @pulumi/pulumi @pulumi/rancher2 @pulumi/kubernetes` to install the necessary Pulumi packages.
4. Run the command `pulumi up` to execute the Pulumi program. This will preview and then execute the deployment.
5. After the deployment is successful, Pulumi will output the exported `appUrl` which you can use to visit your Gogs instance.

Make sure to replace placeholders with your actual data, adjust the values for deployment as needed, and ensure Rancher permission and access details are correct for successful deployment.