AWS Golang EKS cluster

This example lives in the pulumi/examples repository. Check out just this directory to use it:

$ git clone --filter=blob:none --sparse https://github.com/pulumi/examples pulumi-examples
$ git -C pulumi-examples sparse-checkout set aws-go-eks
$ cd pulumi-examples/aws-go-eks

This example creates an AWS EKS Cluster and deploys a sample container application to it.

Prerequisites#

1. Install Pulumi
2. Configure AWS credentials
3. Install Go
4. Install aws-iam-authenticator
5. Install kubectl

Deploying the example#

1. Create a new stack, which is an isolated deployment target for this example:

   pulumi stack init dev

2. Set the AWS region to deploy into:

   pulumi config set aws:region us-east-1 # any valid AWS region will work

3. Install dependencies:

   go mod download

4. Deploy the stack:

   pulumi up

5. After 10-15 minutes, your cluster will be ready, and the kubeconfig JSON you’ll use to connect to the cluster will be available as an output. You can save this kubeconfig to a file like so:

   pulumi stack output kubeconfig --show-secrets >kubeconfig.json

   Once you have this file in hand, you can interact with your new cluster as usual via kubectl:

   KUBECONFIG=./kubeconfig.json kubectl get nodes

6. Ensure that the application is running as expected:

   curl $(pulumi stack output url)

Cleaning up#

Once you’re finished experimenting, tear down your stack’s resources by destroying and removing it:

pulumi destroy
pulumi stack rm