{"id":13622363,"url":"https://github.com/kubernetes-sigs/cluster-api-provider-aws","last_synced_at":"2026-02-28T21:03:53.436Z","repository":{"id":37430821,"uuid":"141609301","full_name":"kubernetes-sigs/cluster-api-provider-aws","owner":"kubernetes-sigs","description":"Kubernetes Cluster API Provider AWS provides consistent deployment and day 2 operations of \"self-managed\" and EKS Kubernetes clusters on AWS.","archived":false,"fork":false,"pushed_at":"2025-08-04T16:21:42.000Z","size":89136,"stargazers_count":676,"open_issues_count":221,"forks_count":621,"subscribers_count":34,"default_branch":"main","last_synced_at":"2025-08-04T19:56:55.847Z","etag":null,"topics":["cluster-api","k8s-sig-cluster-lifecycle","kubernetes-cluster"],"latest_commit_sha":null,"homepage":"http://cluster-api-aws.sigs.k8s.io/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kubernetes-sigs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY_CONTACTS","support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-07-19T17:10:35.000Z","updated_at":"2025-08-04T16:31:43.000Z","dependencies_parsed_at":"2023-09-26T17:15:38.593Z","dependency_job_id":"9d21d3d0-452b-44bf-9490-4b29155d0edc","html_url":"https://github.com/kubernetes-sigs/cluster-api-provider-aws","commit_stats":{"total_commits":2453,"total_committers":269,"mean_commits":9.118959107806692,"dds":0.9188748471259682,"last_synced_commit":"7eb4851dd9bdeacf039b6609176b81c068891d9a"},"previous_names":[],"tags_count":94,"template":false,"template_full_name":null,"purl":"pkg:github/kubernetes-sigs/cluster-api-provider-aws","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fcluster-api-provider-aws","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fcluster-api-provider-aws/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fcluster-api-provider-aws/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fcluster-api-provider-aws/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kubernetes-sigs","download_url":"https://codeload.github.com/kubernetes-sigs/cluster-api-provider-aws/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubernetes-sigs%2Fcluster-api-provider-aws/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269268944,"owners_count":24388572,"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","status":"online","status_checked_at":"2025-08-07T02:00:09.698Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cluster-api","k8s-sig-cluster-lifecycle","kubernetes-cluster"],"created_at":"2024-08-01T21:01:18.127Z","updated_at":"2026-01-27T23:22:40.076Z","avatar_url":"https://github.com/kubernetes-sigs.png","language":"Go","funding_links":[],"categories":["Go","Featured On"],"sub_categories":["Infrastructure"],"readme":"# Kubernetes Cluster API Provider AWS\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/kubernetes/kubernetes/raw/master/logo/logo.png\"  width=\"100x\"\u003e\u003ca href=\"https://aws.amazon.com/opensource/\"\u003e\u003cimg width=\"192x\" src=\"https://d0.awsstatic.com/logos/powered-by-aws.png\" alt=\"Powered by AWS Cloud Computing\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\u003c!-- go doc / reference card --\u003e\n\u003ca href=\"https://godoc.org/sigs.k8s.io/cluster-api-provider-aws\"\u003e\n\u003cimg src=\"https://godoc.org/sigs.k8s.io/cluster-api-provider-aws?status.svg\"\u003e\u003c/a\u003e\n\u003c!-- goreportcard badge --\u003e\n\u003ca href=\"https://goreportcard.com/report/sigs.k8s.io/cluster-api-provider-aws\"\u003e\n\u003cimg src=\"https://goreportcard.com/badge/sigs.k8s.io/cluster-api-provider-aws\"\u003e\u003c/a\u003e\n\u003c!-- join kubernetes slack channel for cluster-api-aws-provider --\u003e\n\u003ca href=\"http://slack.k8s.io/\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/join%20slack-%23cluster--api--aws-brightgreen\"\u003e\u003c/a\u003e\n\u003c!-- openssf badge --\u003e\n\u003ca href=\"https://bestpractices.coreinfrastructure.org/projects/5688\"\u003e\n\u003cimg src=\"https://bestpractices.coreinfrastructure.org/projects/5688/badge\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n------\n\nKubernetes-native declarative infrastructure for AWS.\n\n## What is the Cluster API Provider AWS\n\nThe [Cluster API][cluster_api] brings\ndeclarative, Kubernetes-style APIs to cluster creation, configuration and\nmanagement.\n\nThe API itself is shared across multiple cloud providers allowing for true AWS\nhybrid deployments of Kubernetes. It is built atop the lessons learned from\nprevious cluster managers such as [kops][kops] and\n[kubicorn][kubicorn].\n\n## Documentation\n\nPlease see our [book](https://cluster-api-aws.sigs.k8s.io) for in-depth documentation.\n\n## Launching a Kubernetes cluster on AWS\n\nCheck out the [Cluster API Quick Start](https://cluster-api.sigs.k8s.io/user/quick-start.html) for launching a\ncluster on AWS.\n\n## Features\n\n- Native Kubernetes manifests and API\n- Manages the bootstrapping of VPCs, gateways, security groups and instances.\n- Choice of Linux distribution using [pre-baked AMIs][published_amis].\n- Deploys Kubernetes control planes into private subnets with a separate\n  bastion server.\n- Doesn't use SSH for bootstrapping nodes.\n- Installs only the minimal components to bootstrap a control plane and workers.\n- Supports control planes on EC2 instances.\n- [EKS support][eks_support]\n\n------\n\n## Compatibility with Cluster API and Kubernetes Versions\n\nThis provider's versions are compatible with the following versions of Cluster API\nand support all Kubernetes versions that is supported by its compatible Cluster API version:\n\n|                             | Cluster API v1alpha4 (v0.4) | Cluster API v1beta1 (v1.x)  |\n| --------------------------- | :-------------------------: | :-------------------------: |\n| CAPA v1alpha4 `(v0.7)`      |              ✓              |              ☓              |\n| CAPA v1beta1  `(v1.x)`      |              ☓              |               ✓             |\n| CAPA v1beta2  `(v2.x, main)`|              ☓              |               ✓             |\n\n(See [Kubernetes support matrix][cluster-api-supported-v] of Cluster API versions).\n\n------\n\n## Kubernetes versions with published AMIs\n\nSee [amis] for the list of most recently published AMIs.\n\n------\n\n## clusterawsadm\n\n`clusterawsadm` CLI tool provides bootstrapping, AMI, EKS, and controller related helpers.\n\n`clusterawsadm` binaries are released with each release, can be found under [assets](https://github.com/kubernetes-sigs/cluster-api-provider-aws/releases/latest) section.\n\n`clusterawsadm` could also be installed via Homebrew on macOS and linux OS.\nInstall the latest release using homebrew:\n\n```shell\nbrew install clusterawsadm\n```\n\nTest to ensure the version you installed is up-to-date:\n\n```shell\nclusterawsadm version\n```\n\n------\n\n## Getting involved and contributing\n\nAre you interested in contributing to cluster-api-provider-aws? We, the\nmaintainers and community, would love your suggestions, contributions, and help!\nAlso, the maintainers can be contacted at any time to learn more about how to get\ninvolved.\n\nIn the interest of getting more new people involved we tag issues with\n[`good first issue`][good_first_issue].\nThese are typically issues that have smaller scope but are good ways to start\nto get acquainted with the codebase.\n\nWe also encourage ALL active community participants to act as if they are\nmaintainers, even if you don't have \"official\" write permissions. This is a\ncommunity effort, we are here to serve the Kubernetes community. If you have an\nactive interest and you want to get involved, you have real power! Don't assume\nthat the only people who can get things done around here are the \"maintainers\".\n\nWe also would love to add more \"official\" maintainers, so show us what you can\ndo!\n\nThis repository uses the Kubernetes bots.  See a full list of the commands [here][prow].\n\n### Build the images locally\n\nIf you want to just build the CAPA containers locally, run\n\n```shell\n  REGISTRY=docker.io/my-reg make docker-build\n```\n\n### Tilt-based development environment\n\nSee [development][development] section for details.\n\n### Implementer office hours\n\nMaintainers hold office hours every two weeks, with sessions open to all\ndevelopers working on this project.\n\nOffice hours are hosted on a zoom video chat every other Monday\nat 09:00 (Pacific) / 12:00 (Eastern) / 17:00 (Europe/London),\nand are published on the [Kubernetes community meetings calendar][gcal].\n\n### Other ways to communicate with the contributors\n\nPlease check in with us in the [#cluster-api-aws][slack] channel on Slack.\n\n## Github issues\n\n### Bugs\n\nIf you think you have found a bug please follow the instructions below.\n\n- Please spend a small amount of time giving due diligence to the issue tracker. Your issue might be a duplicate.\n- Get the logs from the cluster controllers. Please paste this into your issue.\n- Open a [new issue][new_issue].\n- Remember that users might be searching for your issue in the future, so please give it a meaningful title to help others.\n- Feel free to reach out to the cluster-api community on the [kubernetes slack][slack].\n\n### Tracking new features\n\nWe also use the issue tracker to track features. If you have an idea for a feature, or think you can help kops become even more awesome follow the steps below.\n\n- Open a [new issue][new_issue].\n- Remember that users might be searching for your issue in the future, so please\n  give it a meaningful title to help others.\n- Clearly define the use case, using concrete examples. EG: I type `this` and\n  cluster-api-provider-aws does `that`.\n- Some of our larger features will require some design. If you would like to\n  include a technical design for your feature please include it in the issue.\n- After the new feature is well understood, and the design agreed upon, we can\n  start coding the feature. We would love for you to code it. So please open\n  up a **WIP** *(work in progress)* pull request, and happy coding.\n\n\u003e“Amazon Web Services, AWS, and the “Powered by AWS” logo materials are\ntrademarks of Amazon.com, Inc. or its affiliates in the United States\nand/or other countries.\"\n\n## Our Contributors\n\nThank you to all contributors and a special thanks to our current maintainers \u0026 reviewers:\n\n| Maintainers                                                      | Reviewers                                                            |\n|------------------------------------------------------------------| -------------------------------------------------------------------- |\n| [@richardcase](https://github.com/richardcase) (from 2020-12-04) | [@cnmcavoy](https://github.com/cnmcavoy) (from 2023-10-16)           |\n| [@Ankitasw](https://github.com/Ankitasw) (from 2022-10-19)       | [@AverageMarcus](https://github.com/AverageMarcus) (from 2022-10-19) |\n| [@dlipovetsky](https://github.com/dlipovetsky) (from 2021-10-31) | [@luthermonson](https://github.com/luthermonson ) (from 2023-03-08)  |\n| [@nrb](https://github.com/nrb) (from 2024-05-24)                 | [@faiq](https://github.com/faiq) (from 2023-10-16)                   |\n| [@AndiDog](https://github.com/AndiDog) (from 2023-12-13)         | [@fiunchinho](https://github.com/fiunchinho) (from 2023-11-6)        |\n|                                                                  | [@damdo](https://github.com/damdo) (from 2023-03-01)                 |\n\nand the previous/emeritus maintainers \u0026 reviewers:\n\n| Emeritus Maintainers                                 | Emeritus Reviewers                                     |\n|------------------------------------------------------|--------------------------------------------------------|\n| [@chuckha](https://github.com/chuckha)               | [@ashish-amarnath](https://github.com/ashish-amarnath) |\n| [@detiber](https://github.com/detiber)               | [@davidewatson](https://github.com/davidewatson)       |\n| [@ncdc](https://github.com/ncdc)                     | [@enxebre](https://github.com/enxebre)                 |\n| [@randomvariable](https://github.com/randomvariable) | [@ingvagabund](https://github.com/ingvagabund)         |\n| [@rudoi](https://github.com/rudoi)                   | [@michaelbeaumont](https://github.com/michaelbeaumont) |\n| [@sedefsavas](https://github.com/sedefsavas)         | [@sethp-nr](https://github.com/sethp-nr)               |\n| [@Skarlso](https://github.com/Skarlso)               | [@shivi28](https://github.com/shivi28)                 |\n| [@vincepri](https://github.com/vincepri)             | [@dthorsen](https://github.com/dthorsen)               |\n|                                                      | [@pydctw](https://github.com/pydctw)                   |\n\nAll the CAPA contributors:\n\n\u003cp\u003e\n\u003ca href=\"https://github.com/kubernetes-sigs/cluster-api-provider-aws/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=kubernetes-sigs/cluster-api-provider-aws\" /\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n\u003c!-- References --\u003e\n[slack]: https://kubernetes.slack.com/messages/CD6U2V71N\n[good_first_issue]: https://github.com/kubernetes-sigs/cluster-api-provider-aws/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22good+first+issue%22\n[gcal]: https://calendar.google.com/calendar/embed?src=cgnt364vd8s86hr2phapfjc6uk%40group.calendar.google.com\n[prow]: https://go.k8s.io/bot-commands\n[new_issue]: https://github.com/kubernetes-sigs/cluster-api-provider-aws/issues/new\n[cluster_api]: https://github.com/kubernetes-sigs/cluster-api\n[kops]: https://github.com/kubernetes/kops\n[kubicorn]: http://kubicorn.io/\n[amis]: https://cluster-api-aws.sigs.k8s.io/topics/images/amis.html\n[published_amis]: https://cluster-api-aws.sigs.k8s.io/topics/images/built-amis.html\n[eks_support]: https://cluster-api-aws.sigs.k8s.io/topics/eks/index.html\n[cluster-api-supported-v]: https://cluster-api.sigs.k8s.io/reference/versions.html\n[development]: https://cluster-api-aws.sigs.k8s.io/development/development.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes-sigs%2Fcluster-api-provider-aws","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubernetes-sigs%2Fcluster-api-provider-aws","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubernetes-sigs%2Fcluster-api-provider-aws/lists"}