\n \n \n \n \n \n

\n\n

\n \n

\n\n---\n\n# Kubernetes multi-tenancy made easy\n\n**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.\n\n# What's the problem with the current status?\n\nKubernetes 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 know phenomena of the _clusters sprawl_.\n\n# Entering Capsule\n\nCapsule 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. \n\nOn 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. \n\n# Features\n\n## Self-Service\n\nLeave developers the freedom to self-provision their cluster resources according to the assigned boundaries.\n\n## Preventing Clusters Sprawl\n\nShare a single cluster with multiple teams, groups of users, or departments by saving operational and management efforts.\n\n## Governance\n\nLeverage Kubernetes Admission Controllers to enforce the industry security best practices and meet policy requirements.\n\n## Resources Control\n\nTake control of the resources consumed by users while preventing them to overtake.\n\n## Native Experience\n\nProvide multi-tenancy with a native Kubernetes experience without introducing additional management layers, plugins, or customized binaries.\n\n## GitOps ready\n\nCapsule is completely declarative and GitOps ready.\n\n## Bring your own device (BYOD)\n\nAssign to tenants a dedicated set of compute, storage, and network resources and avoid the noisy neighbors' effect.\n\n# Documentation\n\nPlease, check the project [documentation](https://capsule.clastix.io) for the cool things you can do with Capsule.\n\n# Contributions\n\nCapsule is Open Source with Apache 2 license and any contribution is welcome.\n\n## Community\n\nJoin 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](https://github.com/clastix/capsule-community).\n\n# Governance\n\nYou can find how the Capsule project is governed [here](https://capsule.clastix.io/docs/contributing/governance).\n\n# FAQ\n\n- Q. How to pronounce Capsule?\n\n A. It should be pronounced as `/ˈkæpsjuːl/`.\n\n- Q. Is it production grade?\n\n A. Although under frequent development and improvements, Capsule is ready to be used in production environments as currently, people are using it in public and private deployments. Check out the [release](https://github.com/clastix/capsule/releases) page for a detailed list of available versions.\n\n- Q. Does it work with my Kubernetes XYZ distribution?\n\n A. We tested Capsule with vanilla Kubernetes 1.16+ on private environments and public clouds. We expect it to work smoothly on any other Kubernetes distribution. Please, let us know if you find it doesn't.\n\n- Q. Do you provide commercial support?\n\n A. Yes, we're available to help and provide commercial support. [Clastix](https://clastix.io) is the company behind Capsule. Please, contact us for a quote. \n","has_starred","hub_user","immutable_tags_settings",{"_186":11,"_187":188},"enabled","rules",[189],".*","is_automated","permissions",{"_193":21,"_194":11,"_195":11},"read","write","admin","user","storage_size",1617392806,"isOrg","reponame","tag","canDeleteTags","isHubSbxKitsEnabled","currentTab","tagAttestations","displaySecurityMetadata","showSbxLogoOverride","routes/_layout.layers.$namespace.$reponame.$tag.(images).($imageUrlDigest)._index",{"_27":28,"_146":-7,"_144":-7,"_145":-7,"_29":210,"_35":46,"_218":219,"_226":11},{"_31":32,"_33":34,"_35":36,"_37":38,"_39":40,"_41":211,"_85":86,"_87":34,"_88":89,"_90":91,"_92":93,"_94":95,"_96":83,"_97":86,"_98":59,"_99":21},[212,213,214,215,216,217],{"_44":45,"_35":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":-5,"_57":38,"_58":59,"_60":-5},{"_44":62,"_35":63,"_47":48,"_49":64,"_51":52,"_53":54,"_55":48,"_56":-5,"_57":65,"_58":59,"_60":-5},{"_44":67,"_35":68,"_47":48,"_49":69,"_51":52,"_53":54,"_55":48,"_56":-5,"_57":70,"_58":59,"_60":71},{"_44":73,"_35":74,"_47":48,"_49":75,"_51":52,"_53":73,"_55":48,"_56":-5,"_57":76,"_58":59,"_60":-5},{"_44":73,"_35":78,"_47":48,"_49":79,"_51":80,"_53":73,"_55":48,"_56":-5,"_57":76,"_58":59,"_60":-5},{"_44":73,"_35":82,"_47":48,"_49":83,"_51":80,"_53":73,"_55":48,"_56":-5,"_57":84,"_58":59,"_60":-5},"imageWithLayers",{"_44":45,"_35":46,"_47":48,"_49":50,"_51":52,"_104":220,"_53":54,"_55":48,"_56":-5,"_57":38,"_58":59,"_60":-5},[221,222,223,224,225],{"_35":107,"_57":108,"_109":110},{"_57":112,"_109":113,"_35":48},{"_35":115,"_57":116,"_109":117},{"_57":112,"_109":119,"_35":48},{"_57":112,"_109":121,"_35":48},"hasPermissionToViewRepoSettings","actionData","errors"]

clastix/capsule:v0.2.1