Deploying to Amazon EKS with a workflow - Amazon CodeCatalyst

Deploying to Amazon EKS with a workflow

Tip

For a tutorial that shows you how to use the Deploy to Kubernetes cluster action, see Tutorial: Deploy an application to Amazon EKS.

This section describes how to deploy a containerized application into a Kubernetes cluster using a CodeCatalyst workflow. To accomplish this, you must add the Deploy to Kubernetes cluster action to your workflow. This action deploys your application to a Kubernetes cluster that you have set up in Amazon Elastic Kubernetes Service (EKS) using one or more Kubernetes manifest files. For a sample manifest, see deployment.yaml in Tutorial: Deploy an application to Amazon EKS.

For more information about Kubernetes, see the Kubernetes Documentation.

For more information about Amazon EKS, see What is Amazon EKS? in the Amazon EKS User Guide.

How the 'Deploy to Kubernetes cluster' action works

The Deploy to Kubernetes cluster works as follows:

  1. At runtime, the action installs the Kubernetes kubectl utility to the CodeCatalyst compute machine where the action is running. The action configures kubectl to point to the Amazon EKS cluster you provided when you configured the action. The kubectl utility is necessary to run the kubectl apply command, next.

  2. The action runs the kubectl apply -f my-manifest.yaml command, which carries out the instructions in my-manifest.yaml to deploy your application as a set of containers and pods into the configured cluster. For more information on this command, see the kubectl apply topic in the Kubernetes Reference Documentation.

Runtime image used by the 'Deploy to Amazon EKS' action

The Deploy to Amazon EKS action runs on a November 2022 image. For more information, see Active images.