AWS EKS Orb 
A CircleCI Orb to simplify deployments to Amazon Elastic Container Service for Kubernetes (Amazon EKS).
Here are some features that the AWS EKS orb provides:
- Setting up and tearing down of EKS clusters via the
create-clusteranddelete-clustercommands / jobs - Allowing
kubectland other tools that accesskubeconfig(likehelm) to work with an EKS cluster via theupdate-kubeconfig-with-authenticatorcommand - Updating deployments with container image updates via the
update-container-imagejob - Installing helm and helm charts (See:
install-helm-on-clusterandinstall-helm-chart)
Usage
See the orb registry listing for usage guidelines.
Requirements
-
AWS credential information should be accessible to the AWS CLI. The easiest way to provide the information would be to configure
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEYandAWS_DEFAULT_REGIONas CircleCI project or context environment variables. -
curlshould be present inPATH. -
A
pythoninstallation present inPATHthat supports running the AWS CLI -
pipif the AWS CLI needs to be installed
Examples
Full usage examples can be found on the AWS EKS orb's page in the orb registry, here.
A demo project is also available here.
version: 2.1
orbs:
aws-eks: circleci/[email protected]
kubernetes: circleci/[email protected]
jobs:
create-deployment:
executor: aws-eks/python3
parameters:
cluster-name:
description: |
Name of the EKS cluster
type: string
steps:
- checkout
- aws-eks/update-kubeconfig-with-authenticator:
cluster-name: << parameters.cluster-name >>
install-kubectl: true
- kubernetes/create-or-update-resource:
resource-file-path: "tests/nginx-deployment/deployment.yaml"
resource-name: "deployment/nginx-deployment"
get-rollout-status: true
show-kubectl-command: true
workflows:
deployment:
jobs:
- aws-eks/create-cluster:
cluster-name: eks-demo-deployment
- create-deployment:
cluster-name: eks-demo-deployment
requires:
- aws-eks/create-cluster
- aws-eks/update-container-image:
cluster-name: eks-demo-deployment
resource-name: "deployment/nginx-deployment"
container-image-updates: "nginx=nginx:1.9.1"
requires:
- create-deployment
- aws-eks/delete-cluster:
cluster-name: eks-demo-deployment
requires:
- aws-eks/update-container-image
Contributing
We welcome issues to and pull requests against this repository!
For further questions/comments about this or other orbs, visit CircleCI's orbs discussion forum.