Skip to content

CAAPH uses Helm charts to manage the installation and lifecycle of Cluster API add-ons.

License

Notifications You must be signed in to change notification settings

kubernetes-sigs/cluster-api-addon-provider-helm

capi

Cluster API Add-on Provider for Helm

👋 Welcome to CAAPH! Here are some links to help you get started:

✨ What is Cluster API Add-on Provider for Helm?

Cluster API Add-on Provider for Helm extends Cluster API by managing the installation, configuration, upgrade, and deletion of cluster add-ons using Helm charts. CAAPH is based on the Cluster API Add-on Orchestration Proposal, a larger effort to bring orchestration for add-ons to CAPI by using existing package management tools.

This project is a concrete implementation of a ClusterAddonProvider, a pluggable component to be deployed on the Management Cluster. An add-on provider component acts as a broker between Cluster API and a package management tool. CAAPH is the first concrete implementation of a ClusterAddonProvider and can serve as a reference implementation.

The aims of the ClusterAddonProvider project are as follows:

Goals

  • Design a solution for orchestrating Cluster add-ons.
  • Leverage the capabilities of existing package management tools, such as an add-on package repository, templating, creation, upgrade, and deletion.
  • Make add-on management in Cluster API modular and pluggable.
  • Make it clear for developers how to build a Cluster API Add-on Provider based on any package management tool.

Non-goals

  • Implement a new, full-fledged package management tool in Cluster API.
  • Provide a mechanism for altering, customizing, or dealing with single Kubernetes resources defining a Cluster add-on, i.e. Deployments, Services, ServiceAccounts. Cluster API should treat add-ons as opaque components and delegate all the operations impacting add-on internals to the package management tool.
  • Expect users to use a specific package management tool.
  • Implement a solution for installing add-ons on the management cluster itself.

🤗 Community, discussion, contribution, and support

Cluster API Add-on Provider for Helm is developed as a part of the Cluster API project. As such, it will share the same communication channels and meeting as Cluster API.

This work is made possible due to the efforts of users, contributors, and maintainers. If you have questions or want to get the latest project news, you can connect with us in the following ways:

Pull Requests and feedback on issues are very welcome! See the issue tracker if you're unsure where to start, especially the Good first issue and Help wanted tags, and also feel free to reach out to discuss.

See also our contributor guide and the Kubernetes community page for more details on how to get involved.

Code of conduct

Participation in the Kubernetes community is governed by the Kubernetes Code of Conduct.