Home

Awesome

<p align="left"> <img src="https://img.shields.io/github/license/clastix/capsule"/> <img src="https://img.shields.io/github/go-mod/go-version/clastix/capsule"/> <a href="https://github.com/projectcapsule/capsule/releases"> <img src="https://img.shields.io/github/v/release/clastix/capsule"/> </a> <a href="https://charmhub.io/capsule-k8s"> <img src="https://charmhub.io/capsule-k8s/badge.svg"/> </a> <a href="https://www.bestpractices.dev/projects/5601"> <img src="https://www.bestpractices.dev/projects/5601/badge"/> </a> <a href="https://api.securityscorecards.dev/projects/github.com/projectcapsule/capsule/badge"> <img src="https://api.securityscorecards.dev/projects/github.com/projectcapsule/capsule/badge"/> </a> <a href="https://artifacthub.io/packages/search?repo=projectcapsule"> <img src="https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/projectcapsule"/> </a> <a href="https://app.fossa.com/projects/git%2Bgithub.com%2Fprojectcapsule%2Fcapsule?ref=badge_shield&issueType=license" alt="FOSSA Status"> <img src="https://app.fossa.com/api/projects/git%2Bgithub.com%2Fprojectcapsule%2Fcapsule.svg?type=shield&issueType=license"/> </a> </p> <p align="center"> <img src="assets/logo/capsule_medium.png" /> </p>

Join the community on the #capsule channel in the Kubernetes Slack.

Kubernetes multi-tenancy made easy

Capsule implements a multi-tenant and policy-based environment in your Kubernetes cluster. It is designed as a micro-services-based ecosystem with the minimalist approach, leveraging only on upstream Kubernetes.

What's the problem with the current status?

Kubernetes introduces the Namespace object type to create logical partitions of the cluster as isolated slices. However, implementing advanced multi-tenancy scenarios, it soon becomes complicated because of the flat structure of Kubernetes namespaces and the impossibility to share resources among namespaces belonging to the same tenant. To overcome this, cluster admins tend to provision a dedicated cluster for each groups of users, teams, or departments. As an organization grows, the number of clusters to manage and keep aligned becomes an operational nightmare, described as the well known phenomena of the clusters sprawl.

Entering Capsule

Capsule takes a different approach. In a single cluster, the Capsule Controller aggregates multiple namespaces in a lightweight abstraction called Tenant, basically a grouping of Kubernetes Namespaces. Within each tenant, users are free to create their namespaces and share all the assigned resources.

On the other side, the Capsule Policy Engine keeps the different tenants isolated from each other. Network and Security Policies, Resource Quota, Limit Ranges, RBAC, and other policies defined at the tenant level are automatically inherited by all the namespaces in the tenant. Then users are free to operate their tenants in autonomy, without the intervention of the cluster administrator.

Features

Self-Service

Leave developers the freedom to self-provision their cluster resources according to the assigned boundaries.

Preventing Clusters Sprawl

Share a single cluster with multiple teams, groups of users, or departments by saving operational and management efforts.

Governance

Leverage Kubernetes Admission Controllers to enforce the industry security best practices and meet policy requirements.

Resources Control

Take control of the resources consumed by users while preventing them to overtake.

Native Experience

Provide multi-tenancy with a native Kubernetes experience without introducing additional management layers, plugins, or customized binaries.

GitOps ready

Capsule is completely declarative and GitOps ready.

Bring your own device (BYOD)

Assign to tenants a dedicated set of compute, storage, and network resources and avoid the noisy neighbors' effect.

Documentation

Please, check the project documentation for the cool things you can do with Capsule.

Contributions

Capsule is Open Source with Apache 2 license and any contribution is welcome.

Chart Development

Chart Linting

The chart is linted with ct. You can run the linter locally with this command:

make helm-lint

Chart Documentation

The documentation for each chart is done with helm-docs. This way we can ensure that values are consistent with the chart documentation. Run this anytime you make changes to a values.yaml file:

make helm-docs

Community meeting

Join the community, share and learn from it. You can find all the resources to how to contribute code and docs, connect with people in the community repository.

Please read the code of conduct.

Adopters

See the ADOPTERS.md file for a list of companies that are using Capsule.

Governance

You can find how the Capsule project is governed here.

Maintainers

Please, refer to the maintainers file available here.

Release process

Please, refer to the documentation page.

Changelog

Read how we log changes here

Software Bill of Materials

All OCI release artifacts include a Software Bill of Materials (SBOM) in CycloneDX JSON format. More information on this is available here

FAQ