Create an AWS EKS App

This guide will walk you through creating a BYOC app using Docker, Helm, and Terraform, and deploying it to AWS EKS. At the end of this tutorial, you should know how to create a new BYOC deployment offering with your existing application.

​

Prerequisites

• Create a Nuon account. You will need a working Nuon org.
• Set up an AWS account. This is the account you will create the install in.

​

What You Will Create

This tutorial will walk you through creating the following:

• An App
• A Docker Build component
• A Terraform component
• A Helm chart component
• An Install, using our AWS EKS sandbox

​

Configure App

To configure the app, you will create a TOML config file using our CLI. In each section below we will provide you with configuration snippets for the app itself as well as it’s components.

​

Create App

Define the app itself and give it a name. This will create the app in Nuon and generate a config file named nuon.my_eks_app.toml. This file will be populated with sample config, which we will update in this guide.

nuon apps create --name=my_eks_app

​

Installer

Update the installer config. Installers provide an out-of-the-box installation flow your customers can use to install your app. You will use it later in this guide to create an install yourself.

[installer]
name              = "My EKS App"
description       = "A demo app that runs on EKS."
slug              = "my-eks-app"
documentation_url = "https://docs.nuon.co/"
community_url     = "https://join.slack.com/t/nuoncommunity/shared_invite/zt-1q323vw9z-C8ztRP~HfWjZx6AXi50VRA"
logo_url          = "https://assets-global.website-files.com/62a2c1332b518a9eedc6de2f/651df2030c43865b9b16046b_Group%2048.png"
github_url        = "https://github.com/nuonco"
homepage_url      = "https://www.nuon.co/"
demo_url          = "https://www.nuon.co/"

​

Sandbox

Update the sandbox config. The aws-eks sandbox will provide everything you need to run EKS services, from the EKS cluster down to the VPC.

[sandbox]
terraform_version = "1.5.4"
[sandbox.public_repo]
directory = "aws-eks"
repo = "nuonco/sandboxes"
branch = "main"

​

Runner

Update the runner config. The aws-eks sandbox requires that we use the aws-eks runner. The runner manages the sandbox, provisioning and deprovisioning AWS resources during deploys.

[runner]
runner_type = "aws-eks"

​

Sync App Config to Nuon

You now have a complete Nuon app config. This is a good place to stop and sync it to Nuon.

nuon apps sync

Once the config is synced, select the newly created app using the CLI. This will scope CLI commands to the new app.

nuon apps select

​

Connect Components

This app consists of three components: one to build the Docker image, one to provision the EKS service, and one to create an HTTPS certificate.

​

Docker Image

This is a Docker Build component that will build the API and create a Docker image containing it. When released, it will sync the image to each install’s ECR so Helm can pull it when creating pods.

[[components]]
name   = "docker_image"
type = "docker_build"
dockerfile = "Dockerfile"
[components.public_repo]
repo      = "nuonco/guides"
directory = "aws-eks-tutorial/components/docker-image"
branch    = "main"

​

HTTPS Certificate

This is a Terraform Module component that creates an ACM HTTPS certificate. The Helm chart will use this when creating the ALB.

[[components]]
name   = "certificate"
type = "terraform_module"
terraform_version = "1.5.3"
[components.public_repo]
repo      = "nuonco/guides"
directory = "aws-eks-tutorial/components/certificate"
branch    = "main"
[[components.var]]
name  = "domain_name"
value = "introspect.{{.nuon.install.sandbox.outputs.public_domain.name}}"
[[components.var]]
name  = "zone_id"
value = "{{.nuon.install.sandbox.outputs.public_domain.zone_id}}"

​

Helm Chart

This component will create a Helm release in EKS, pulling the Docker image and using it to create a Kubernetes pod. It will also create an ALB to expose the API to the internet.

[[components]]
name   = "helm_chart"
type = "helm_chart"
chart_name = "introspect"
[components.public_repo]
repo      = "nuonco/guides"
directory = "aws-eks-tutorial/components/helm-chart"
branch    = "main"
[[components.value]]
name  = "image.repository"
value = "{{.nuon.components.docker_image.image.repository.uri}}"
[[components.value]]
name  = "image.tag"
value = "{{.nuon.components.docker_image.image.tag}}"
[[components.value]]
name  = "api.nlbs.public_domain_certificate"
value = "{{.nuon.components.certificate.outputs.public_domain_certificate_arn}}"
[[components.value]]
name  = "api.nlbs.public_domain"
value = "introspect.{{.nuon.install.sandbox.outputs.public_domain.name}}"
[[components.value]]
name  = "app_id"
value = "{{.nuon.app.id}}"
[[components.value]]
name  = "org_id"
value = "{{.nuon.org.id}}"
[[components.value]]
name  = "install_id"
value = "{{.nuon.install.id}}"
[[components.value]]
name  = "vpc_id"
value = "{{.nuon.install.sandbox.outputs.vpc.id}}"

​

Sync Component Configs to Nuon

Now that you have the components, sync the update config to Nuon.

nuon apps sync

Just like the app, you can use the CLI to verify they were synced successfully.

nuon components list

Initial builds for each component will also have been created. Verify with the CLI that they were successful.

nuon builds list

​

Create an Install

Creating an install requires two steps: granting access to the AWS account via an IAM role, and then provisioning the install in that account. There are a few ways to do this, but the easiest is to use the installer you configured earlier. In your web browser, navigate to https://app.nuon.co/installer/your-installer-slug, and follow steps in the UI.

For other approaches, see our guides Install Access Permissions and Create Installs.

​

Monitor Install Creation

Monitor the install’s creation using the Dashboard. Scroll down, and below the settings, you should see a card for your install.

Click on the card, and in the sidebar you can verify that the components are deployed using in the Deploy History.

​

Inspect the Install

When the install has provisioned, and the deploys have completed, copy the install ID from the UI and curl the API to verify it’s running.

curl https://api.{install_id}.nuon.run/introspect/env

​

Wrapping Up and Next Steps

Congratulations, you just deployed an EKS service to AWS! A few suggestions for where to go next:

• Check out our Release Management guide to learn how to update installs.
• Dig into our App Configuration guide to learn how to configure more complex apps.
• Share your installer with a friend and have them install your app in their AWS account.