Kubernetes-native declarative infrastructure for AWS.
The Cluster API brings declarative, Kubernetes-style APIs to cluster creation, configuration and management.
The API itself is shared across multiple cloud providers allowing for true AWS hybrid deployments of Kubernetes. It is built atop the lessons learned from previous cluster managers such as kops and kubicorn.
Please see our book for in-depth documentation.
Check out the Cluster API Quick Start for launching a cluster on AWS.
- Native Kubernetes manifests and API
- Manages the bootstrapping of VPCs, gateways, security groups and instances.
- Choice of Linux distribution among Amazon Linux 2, CentOS 7, Ubuntu(18.04, 20.04) and Flatcar using pre-baked AMIs.
- Deploys Kubernetes control planes into private subnets with a separate bastion server.
- Doesn't use SSH for bootstrapping nodes.
- Installs only the minimal components to bootstrap a control plane and workers.
- Supports control planes on EC2 instances.
- EKS support
This provider's versions are compatible with the following versions of Cluster API and support all Kubernetes versions that is supported by its compatible Cluster API version:
| Cluster API v1alpha4 (v0.4) | Cluster API v1beta1 (v1.x) | |
|---|---|---|
CAPA v1alpha4 (v0.7) |
✓ | ☓ |
CAPA v1beta1 (v1.x) |
☓ | ✓ |
CAPA v1beta2 (v2.x, main) |
☓ | ✓ |
(See Kubernetes support matrix of Cluster API versions).
See amis for the list of most recently published AMIs.
clusterawsadm CLI tool provides bootstrapping, AMI, EKS, and controller related helpers.
clusterawsadm binaries are released with each release, can be found under assets section.
clusterawsadm could also be installed via Homebrew on macOS and linux OS.
Install the latest release using homebrew:
brew install clusterawsadmTest to ensure the version you installed is up-to-date:
clusterawsadm versionAre you interested in contributing to cluster-api-provider-aws? We, the maintainers and community, would love your suggestions, contributions, and help! Also, the maintainers can be contacted at any time to learn more about how to get involved.
In the interest of getting more new people involved we tag issues with
good first issue.
These are typically issues that have smaller scope but are good ways to start
to get acquainted with the codebase.
We also encourage ALL active community participants to act as if they are maintainers, even if you don't have "official" write permissions. This is a community effort, we are here to serve the Kubernetes community. If you have an active interest and you want to get involved, you have real power! Don't assume that the only people who can get things done around here are the "maintainers".
We also would love to add more "official" maintainers, so show us what you can do!
This repository uses the Kubernetes bots. See a full list of the commands here.
If you want to just build the CAPA containers locally, run
REGISTRY=docker.io/my-reg make docker-buildSee development section for details.
Maintainers hold office hours every two weeks, with sessions open to all developers working on this project.
Office hours are hosted on a zoom video chat every other Monday at 09:00 (Pacific) / 12:00 (Eastern) / 17:00 (Europe/London), and are published on the Kubernetes community meetings calendar.
Please check in with us in the #cluster-api-aws channel on Slack.
If you think you have found a bug please follow the instructions below.
- Please spend a small amount of time giving due diligence to the issue tracker. Your issue might be a duplicate.
- Get the logs from the cluster controllers. Please paste this into your issue.
- Open a new issue.
- Remember that users might be searching for your issue in the future, so please give it a meaningful title to help others.
- Feel free to reach out to the cluster-api community on the kubernetes slack.
We 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.
- Open a new issue.
- Remember that users might be searching for your issue in the future, so please give it a meaningful title to help others.
- Clearly define the use case, using concrete examples. EG: I type
thisand cluster-api-provider-aws doesthat. - Some of our larger features will require some design. If you would like to include a technical design for your feature please include it in the issue.
- After the new feature is well understood, and the design agreed upon, we can start coding the feature. We would love for you to code it. So please open up a WIP (work in progress) pull request, and happy coding.
“Amazon Web Services, AWS, and the “Powered by AWS” logo materials are trademarks of Amazon.com, Inc. or its affiliates in the United States and/or other countries."
Thank you to all contributors and a special thanks to our current maintainers & reviewers:
| Maintainers | Reviewers |
|---|---|
| @richardcase (from 2020-12-04) | @cnmcavoy (from 2023-10-16) |
| @Ankitasw (from 2022-10-19) | @AverageMarcus (from 2022-10-19) |
| @dlipovetsky (from 2021-10-31) | @luthermonson (from 2023-03-08) |
| @nrb (from 2024-05-24) | @faiq (from 2023-10-16) |
| @AndiDog (from 2023-12-13) | @fiunchinho (from 2023-11-6) |
| @damdo (from 2023-03-01) |
and the previous/emeritus maintainers & reviewers:
| Emeritus Maintainers | Emeritus Reviewers |
|---|---|
| @chuckha | @ashish-amarnath |
| @detiber | @davidewatson |
| @ncdc | @enxebre |
| @randomvariable | @ingvagabund |
| @rudoi | @michaelbeaumont |
| @sedefsavas | @sethp-nr |
| @Skarlso | @shivi28 |
| @vincepri | @dthorsen |
| @pydctw |
All the CAPA contributors: