/aws-controllers-k8s

AWS Controllers for Kubernetes (ACK) is a project enabling you to manage AWS services from Kubernetes

Primary LanguageGoApache License 2.0Apache-2.0

contributions welcome status is preview GitHub issues GitHub

GitHub go.mod Go version Go Report Card GitHub watchers GitHub stars GitHub forks

AWS Controllers for Kubernetes (ACK)

AWS Controllers for Kubernetes (ACK) lets you define and use AWS service resources directly from Kubernetes. With ACK, you can take advantage of AWS managed services for your Kubernetes applications without needing to define resources outside of the cluster or run services that provide supporting capabilities like databases or message queues within the cluster.

This is a new open source project built with ❤️ by AWS and available as a Developer Preview. We encourage you to try it out, provide feedback and contribute to development.

IMPORTANT Because this project is in developer preview, you may see breaking changes throughout. We encourage you to experiment with ACK but DO NOT adopt it for production use. Use of ACK controllers in preview is subject to the terms and conditions contained in the AWS Service Terms, particularly the Beta Service Participation Service Terms, and apply to any service controllers not marked as 'Generally Available'.

Overview

Kubernetes applications often require a number of supporting resources like databases, message queues, and object stores. AWS provides a set of managed services that you can use to provide these resources for your apps, but provisioning and integrating them with Kubernetes was complex and time consuming. ACK lets you define and consume AWS services and resources directly from a Kubernetes cluster. It gives you a unified way to manage your application and its dependencies.

ACK is a collection of Kubernetes custom resource definitions (CRDs) and custom controllers working together to extend the Kubernetes API and manage AWS resources on your behalf.

Getting Started

Until we've graduated ACK service controllers we ask you to test-drive them.

Help & Feedback

For help, please consider the following venues (in order):

Contributing

We welcome community contributions and pull requests. See our contribution guide for more information on how to report issues, set up a development environment, and submit code.

Check the issues list for descriptions of work items. We invite any and all feedback and contributions, so please don't hesitate to submit an issue, a pull request or comment on an existing issue.

ACK adheres to the Amazon Open Source Code of Conduct. You can also learn more about our Governance structure.

Use of Preview Service Controllers

Use of ACK controllers in preview is subject to the terms and conditions contained in the AWS Service Terms, particularly the Beta Service Participation Service Terms, located at https://aws.amazon.com/service-terms, (the “Beta Terms”) and apply to any service controllers not marked as 'Generally Available'.

License

This project is licensed under the Apache-2.0 License.