Deploy the gitea-instance helm chart on AWS EKS

Question

Pulumi · Accepted Answer

To deploy the `gitea-instance` helm chart on AWS EKS, you'll need to perform a few steps:

1. First, you must set up an EKS cluster where your Helm chart will be deployed. 
2. Then, you should ensure you have an IAM role that allows EKS to manage resources on your behalf.
3. Next, you will use the `helm.sh/v3.Chart` resource from Pulumi's Kubernetes provider to deploy the Helm chart to your EKS cluster.

Below is a program written in TypeScript that shows how to accomplish this. The program uses the `@pulumi/eks` package to create an EKS cluster and the `@pulumi/kubernetes` package to deploy the `gitea-instance` helm chart.

### Detailed Explanation

Before the TypeScript code, let's break down each step:

- We will create an AWS EKS cluster using `eks.Cluster`. This cluster will be where our Helm chart will be deployed. EKS is Amazon's managed Kubernetes service, making it easier to run Kubernetes on AWS without needing to install and operate your own Kubernetes control plane.

- To manage resources on your behalf, EKS needs an IAM role that should be attached with a trust relationship to your EKS cluster.

- With an EKS cluster up and running, we will be ready to deploy the `gitea-instance` Helm chart. Helm is a package manager for Kubernetes, which allows you to define, install, and upgrade complex Kubernetes applications. Helm charts are the way Helm packages and deploys these applications.

Now, let's write the Pulumi program to achieve this.

```typescript
import * as awsx from "@pulumi/awsx";
import * as eks from "@pulumi/eks";
import * as k8s from "@pulumi/kubernetes";

// Create an EKS cluster.
const cluster = new eks.Cluster("my-cluster", {
    desiredCapacity: 2,
    minSize: 1,
    maxSize: 3,
    storageClasses: "gp2",
    instanceType: "t2.medium",
});

// Use the Pulumi Kubernetes provider to communicate with the given EKS cluster.
const provider = new k8s.Provider("provider", { kubeconfig: cluster.kubeconfig });

// Deploy the gitea-instance Helm chart.
const gitea = new k8s.helm.v3.Chart("gitea-instance", {
    chart: "gitea",
    version: "5.0.0", // specify the exact chart version you need
    fetchOpts: {
        repo: "https://dl.gitea.io/charts/", // this is the repository where gitea charts are stored
    },
}, { provider });

// Export the cluster's kubeconfig.
export const kubeconfig = cluster.kubeconfig;

// Export the public endpoint of Gitea
export const giteaEndpoint = gitea.getResourceProperty(
    "v1/Service", "gitea-instance-gitea-http", "status"
).then(status => status.loadBalancer.ingress[0].hostname);
```

#### How to Use This Program

Copy the above TypeScript code into a new file (`index.ts`) in your Pulumi project directory. Ensure that you have the AWS credentials configured in your environment to allow Pulumi to create resources on your behalf. You will also need to have Pulumi installed and set up in your local development machine.

To deploy your EKS cluster and Gitea Helm chart, navigate to your Pulumi project directory and run:

```
pulumi up
```

After confirming the preview looks correct, Pulumi will provision the EKS cluster, configure Kubernetes, and deploy the Gitea instance Helm chart. Once completed, you can get the kubeconfig for the cluster and the Gitea service endpoint from the Pulumi stack outputs.

Keep in mind, while this example provides a straightforward deployment, in a production environment, you may need additional considerations like setting up network configurations, security settings, monitoring, and logging.