Repository files navigation

An example workflow that usesGitHub Actions to builda static website into a Docker container, push that image to Amazon Elastic Container Registry, and usesFlux to automatically update an existing Amazon Elastic Kubernetes Service cluster with that image.

See thistechnical blog post which uses this code for full step-by-step instructions.

1. Create an EKS cluster, e.g. usingeksctl create cluster
2. Set up Flux on the cluster, e.g. usingthis guide. Note that you must set--git-path to point to where your manifests are. For example:

export GHOWNER=<github user or organization account where your fork lives>export GHREPO=example-actions-flux-ekskubectl create ns fluxfluxctl install \    --git-user=${GHUSER} \    --git-email=${GHUSER}@users.noreply.github.com \    --git-url=git@github.com:${GHOWNER}/${GHREPO} \    --git-path=manifests \    --namespace=flux| kubectl apply -f -

3. Give Flux read/write access to the GitHub repositoryusing a deploy key
4. Create a repository calledexample-eks inAmazon Elastic Container Registry, in the same AWS region as the EKS cluster
5. Update the image indeployment.yml to use yourREGISTRY,IMAGE, andTAG.TAG will be replaced by Flux as new images are available in the registry.

The following secrets are required to be set on the repository:

1. AWS_ACCOUNT_ID: The AWS account ID that owns the EKS cluster
2. AWS_ACCESS_KEY_ID: An AWS access key ID for an account having theEKS IAM role
3. AWS_SECRET_ACCESS_KEY: An AWS secret sccess key for an account having theEKS IAM role

Theexample workflow will trigger on every push to this repo.

Forpull requests, the workflow will:

1. Build and tagthe Docker image
   • The image will be tagged with the feature branch's HEAD commit SHA

Forpushes to the default branch (master), in addition to the above, the workflow will:

1. Push the image to Amazon Elastic Container Registry

Flux watches ECR for changes to the image listed in ourdeployment configuration. When it detects a change, it updates the EKS cluster with the new image, no manualkubectl apply needed!

We welcome contributions! Seehow to contribute.

MIT