{"id":20491009,"url":"https://github.com/circleci-public/aws-eks-orb","last_synced_at":"2025-04-13T16:34:56.455Z","repository":{"id":36025788,"uuid":"170963464","full_name":"CircleCI-Public/aws-eks-orb","owner":"CircleCI-Public","description":"An orb to simplify deployments to Amazon Elastic Container Service for Kubernetes (Amazon EKS)","archived":false,"fork":false,"pushed_at":"2024-01-16T22:29:59.000Z","size":288,"stargazers_count":17,"open_issues_count":0,"forks_count":29,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-27T07:35:47.550Z","etag":null,"topics":["aws-eks","circleci-orbs","eks","helm","k8s","kubernetes","kubernetes-deployment"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CircleCI-Public.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-02-16T04:44:04.000Z","updated_at":"2022-11-18T11:27:11.000Z","dependencies_parsed_at":"2024-01-16T23:24:48.746Z","dependency_job_id":"72c52309-57fc-4e5f-a5b1-4fa3f68344e3","html_url":"https://github.com/CircleCI-Public/aws-eks-orb","commit_stats":null,"previous_names":[],"tags_count":112,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CircleCI-Public%2Faws-eks-orb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CircleCI-Public%2Faws-eks-orb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CircleCI-Public%2Faws-eks-orb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CircleCI-Public%2Faws-eks-orb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CircleCI-Public","download_url":"https://codeload.github.com/CircleCI-Public/aws-eks-orb/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248744548,"owners_count":21154880,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws-eks","circleci-orbs","eks","helm","k8s","kubernetes","kubernetes-deployment"],"created_at":"2024-11-15T17:19:28.327Z","updated_at":"2025-04-13T16:34:56.427Z","avatar_url":"https://github.com/CircleCI-Public.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS EKS Orb [![CircleCI status](https://circleci.com/gh/CircleCI-Public/aws-eks-orb.svg \"CircleCI status\")](https://circleci.com/gh/CircleCI-Public/aws-eks-orb) [![CircleCI Orb Version](https://img.shields.io/badge/endpoint.svg?url=https://badges.circleci.io/orb/circleci/aws-eks)](https://circleci.com/orbs/registry/orb/circleci/aws-eks) [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/circleci-public/aws-eks-orb/master/LICENSE) [![CircleCI Community](https://img.shields.io/badge/community-CircleCI%20Discuss-343434.svg)](https://discuss.circleci.com/c/ecosystem/orbs)\n\nA CircleCI Orb to simplify deployments to Amazon Elastic Container Service for Kubernetes (Amazon EKS).\n\nHere are some features that the AWS EKS orb provides:\n\n- Setting up and tearing down of EKS clusters via the `create-cluster` and `delete-cluster` commands / jobs\n- Allowing `kubectl` and other tools that access `kubeconfig` (like `helm`) to work with an EKS cluster via the `update-kubeconfig-with-authenticator` command\n- Updating deployments with container image updates via the `update-container-image` job\n- Installing helm and helm charts (See: `install-helm-on-cluster` and `install-helm-chart`)\n\n## Usage\n\nSee the [orb registry listing](http://circleci.com/orbs/registry/orb/circleci/aws-eks) for usage guidelines.\n\n## Requirements\n\n- AWS credential information should be accessible to the [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html). The easiest way to provide the information would be to configure [`AWS_ACCESS_KEY_ID`](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html), [`AWS_SECRET_ACCESS_KEY`](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html) and [`AWS_DEFAULT_REGION`](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-envvars.html) as CircleCI [project](https://circleci.com/docs/2.0/env-vars/#setting-an-environment-variable-in-a-project) or [context](https://circleci.com/docs/2.0/env-vars/#setting-an-environment-variable-in-a-context) environment variables.\n\n- `curl` should be present in `PATH`.\n\n- A `python` installation present in `PATH` that supports running the AWS CLI\n\n- `pip` if the AWS CLI needs to be installed\n\n## Examples\n\nFull usage examples can be found on the AWS EKS orb's page in the orb registry, [here](https://circleci.com/orbs/registry/orb/circleci/aws-eks#usage-examples).\n\nA demo project is also available [here](https://github.com/CircleCI-Public/circleci-demo-aws-eks).\n\n```\nversion: 2.1\n\norbs:\n  aws-eks: circleci/aws-eks@x.y\n  kubernetes: circleci/kubernetes@0.4.0\n\njobs:\n  create-deployment:\n    executor: aws-eks/python3\n    parameters:\n      cluster-name:\n        description: |\n          Name of the EKS cluster\n        type: string\n    steps:\n      - checkout\n      - aws-eks/update-kubeconfig-with-authenticator:\n          cluster-name: \u003c\u003c parameters.cluster-name \u003e\u003e\n          install-kubectl: true\n      - kubernetes/create-or-update-resource:\n          resource-file-path: \"tests/nginx-deployment/deployment.yaml\"\n          resource-name: \"deployment/nginx-deployment\"\n          get-rollout-status: true\n          show-kubectl-command: true\n\nworkflows:\n  deployment:\n    jobs:\n      - aws-eks/create-cluster:\n          cluster-name: eks-demo-deployment\n      - create-deployment:\n          cluster-name: eks-demo-deployment\n          requires:\n            - aws-eks/create-cluster\n      - aws-eks/update-container-image:\n          cluster-name: eks-demo-deployment\n          resource-name: \"deployment/nginx-deployment\"\n          container-image-updates: \"nginx=nginx:1.9.1\"\n          requires:\n            - create-deployment\n      - aws-eks/delete-cluster:\n          cluster-name: eks-demo-deployment\n          requires:\n              - aws-eks/update-container-image\n```\n\n\n## Contributing\n\nWe welcome [issues](https://github.com/CircleCI-Public/aws-eks-orb/issues) to and [pull requests](https://github.com/CircleCI-Public/aws-eks-orb/pulls) against this repository!\n\nFor further questions/comments about this or other orbs, visit [CircleCI's orbs discussion forum](https://discuss.circleci.com/c/orbs).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcircleci-public%2Faws-eks-orb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcircleci-public%2Faws-eks-orb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcircleci-public%2Faws-eks-orb/lists"}