Deploying GitLab via Helm on Rancher

Q: Deploy the gitlab-service helm chart on Rancher

Deploy the gitlab-service helm chart on Rancher

To deploy a Helm chart on Rancher using Pulumi, you will need to interact with the Rancher2 provider. The provider allows you to work with Rancher resources, such as clusters, catalogs, and helm charts. The specific resource to deploy a Helm chart is not directly available in the Pulumi Registry results, but you can use the helm.v3.Chart resource from Pulumi's Kubernetes provider, which is a common way to deploy Helm charts in a Kubernetes cluster managed by Rancher.

Here's a step-by-step guide on how to deploy the GitLab service Helm chart on Rancher:

Set up the Rancher2 Provider: You'll need to set up the Rancher2 provider to interact with your Rancher instance. This requires the Rancher API URL and access credentials.
Select or Create a Kubernetes Cluster: Ensure you have a Kubernetes cluster managed by Rancher where you will deploy the GitLab service. If you don't have one, you can use Pulumi to provision a new cluster in Rancher.
Add the GitLab Helm Chart Repository: Before deploying the chart, add the GitLab Helm chart repository to Rancher.
Deploy the Helm Chart: Use the helm.v3.Chart resource to deploy the GitLab chart to your Rancher-managed Kubernetes cluster.

Below is a Pulumi TypeScript program that demonstrates the deployment process:

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

// Create a new Rancher2 provider instance using the necessary credentials
const rancher2Provider = new rancher2.Provider('rancherProvider', {
    apiUrl: 'https://your-rancher-server.com/v3',
    accessKey: 'your-rancher-access-key',
    secretKey: 'your-rancher-secret-key',
});

// Select an existing Rancher-managed Kubernetes cluster
const cluster = rancher2.getCluster({
    name: 'your-existing-cluster-name',
}, { provider: rancher2Provider });

// Use the selected Rancher cluster kubeconfig for deploying the Helm chart
const k8sProvider = new k8s.Provider('k8sProvider', {
    kubeconfig: cluster.kubeConfig,
});

// Deploy the GitLab Helm chart
const gitlabChart = new k8s.helm.v3.Chart('gitlab-service-chart', {
    chart: 'gitlab',
    fetchOpts: {
        repo: 'https://charts.gitlab.io/',
    },
    // Specify the values for GitLab chart configuration
    values: {
        gitlabRunner: {
            runners: {
                // Provide specific GitLab Runner configuration if necessary
            },
        },
        // Additional GitLab chart values can be added here
    },
}, { provider: k8sProvider });

// Export endpoint to access the GitLab service
export const gitlabEndpoint = gitlabChart.getResourceProperty(
    'v1/Service',
    'gitlab-service-chart-gitlab',
    'status',
    'loadBalancer.ingress[0].hostname',
);

In the above program:

Replace 'https://your-rancher-server.com/v3', 'your-rancher-access-key', and 'your-rancher-secret-key' with your actual Rancher API endpoint and credentials.
Replace 'your-existing-cluster-name' with the name of the cluster where you want to deploy the GitLab service.
The gitlabChart resource uses helm.v3.Chart to deploy the GitLab service using Helm by fetching the chart from the GitLab Helm chart repository.
The values property in the gitlabChart resource allows you to configure the chart by providing your desired values for the GitLab service. You can specify GitLab Runner configurations or other service options within this property.
Finally, the gitlabEndpoint export returns the hostname of the LoadBalancer service created by the GitLab Helm chart, which can be used to access the GitLab service.