Deploy the zotero helm chart on Google Kubernetes Engine (GKE)

Question

Pulumi · Accepted Answer

To deploy the Zotero Helm chart on Google Kubernetes Engine (GKE), you'll need to follow a few steps:

Set up a GKE cluster: Instantiate a GKE cluster where you will deploy the Helm chart. You will need to define the desired settings for the cluster, such as the location, machine types, and the number of nodes.
Install and Configure Helm in your local environment: Helm is a package manager for Kubernetes, which simplifies the process of managing Kubernetes applications. You'd usually need to install Helm locally and configure it to interact with your Kubernetes cluster.
Deploy the Helm chart: With Helm and your Kubernetes cluster setup, you can deploy the Zotero Helm chart. This involves adding the repository containing the chart, updating the Helm repository, and finally, running the helm install command.

Below is a Pulumi program in TypeScript to provision a GKE cluster. Afterwards, an example of the Helm chart deployment using the Pulumi and the harness.service.Helm resource is shown. Please replace <insert-your-project-id-here> with your actual GCP Project ID:

import * as gcp from "@pulumi/gcp";
import * as k8s from "@pulumi/kubernetes";
import * as pulumi from "@pulumi/pulumi";
import * as harness from "@pulumi/harness";

// Create a GKE cluster
const cluster = new gcp.container.Cluster("my-cluster", {
  initialNodeCount: 2,
  nodeVersion: "latest",
  minMasterVersion: "latest",
  nodeConfig: {
      machineType: "e2-standard-2",
      oauthScopes: [
          "https://www.googleapis.com/auth/compute",
          "https://www.googleapis.com/auth/devstorage.read_only",
          "https://www.googleapis.com/auth/logging.write",
          "https://www.googleapis.com/auth/monitoring"
      ],
  },
});

// Export the Cluster name
export const clusterName = cluster.name;

// Export the Kubeconfig to access the cluster with kubectl
export const kubeconfig = pulumi.all([cluster.name, cluster.endpoint, cluster.masterAuth]).apply(([name, endpoint, masterAuth]) => {
  const context = `${gcp.config.project}_${gcp.config.zone}_${name}`;
  return `apiVersion: v1
clusters:
- cluster:
    certificate-authority-data: ${masterAuth.clusterCaCertificate}
    server: https://${endpoint}
  name: ${context}
contexts:
- context:
    cluster: ${context}
    user: ${context}
  name: ${context}
current-context: ${context}
kind: Config
preferences: {}
users:
- name: ${context}
  user:
    auth-provider:
      config:
        cmd-args: config config-helper --format=json
        cmd-path: gcloud
        expiry-key: '{.credential.token_expiry}'
        token-key: '{.credential.access_token}'
      name: gcp
`;
});

// Create a Kubernetes Provider pointing to the created cluster
const k8sProvider = new k8s.Provider("gkeK8s", {
  kubeconfig: kubeconfig,
});

// Instantiate the Helm chart for Zotero
const zoteroHelmChart = new harness.service.Helm("zotero", {
  chart: "zotero",
  repositoryOpts: {
    repo: "https://<zotero-helm-chart-repo>", // Replace with the Zotero Helm chart repository URL
  },
  values: {
    // Define any values required for the Helm chart
  },
  namespace: "default",
}, { provider: k8sProvider });

// You can export this if the Helm chart contains any ingress controllers that create external IP
export const zoteroIngress = zoteroHelmChart.getResourceProperty("v1/Service", "zotero", "status").apply(status => status.loadBalancer.ingress[0]);

Detailed Explanation:

First, we're importing the necessary Pulumi and other associated modules.
We then create a GKE cluster using the gcp.container.Cluster class with a basic configuration.
We export the Kubernetes configuration kubeconfig for the GKE cluster, which will be used to configure our k8s.Provider. This allows Pulumi to communicate with our GKE cluster.
Using the k8s.Provider, we tell Pulumi how to communicate with the GKE cluster, using the previously exported kubeconfig.
We define the zoteroHelmChart where we specify the location of the Helm Chart repository. Please note that you need the actual URL of the Zotero Helm Chart repository to replace the placeholder.
Finally, we have an optional export for zoteroIngress, if the Helm chart sets up an Ingress controller with external access. It extracts the ingress details from the deployed service so that they can be accessed later, for example, to know the URL to access the Zotero service.

Make sure to replace the placeholder values with actual values specific to your deployment. Additionally, you might need to include more configurations specific to your Zotero chart deployment requirements.