Deliver services to tenants
This section covers how one platform serves several organizations. Each organization is a tenant. Inside a tenant, projects group users and teams, and templates decide which clusters, apps, and Stacks they can create. Platform admins, tenant admins, and project admins all work here, each at a different level.
A tenant is the boundary that separates one customer from another inside vCluster Platform, and it sits above projects.
For an AI cloud operator, a tenant is the customer account. For an internal platform, it's the business unit or the subsidiary. Everything that customer can see, provision, and configure is decided by the platform admin, individually per tenant.
A tenant is an organization. A cluster is the Kubernetes environment a project user creates. They're different things, and a tenant contains many clusters.
Tenants in the hierarchy​
Platform hands responsibility down a chain. Each role delegates a narrower boundary to the next.
| Step | Who | What they do |
|---|---|---|
| 1 | System admin | Installs Platform onto a Kubernetes cluster. That cluster becomes the control plane cluster. |
| 2 | Platform admin | Creates tenants and grants each one the inventory it may consume. |
| 3 | Tenant admin | Uses the tenant's assigned machines and networks, and divides its grant across projects. |
| 4 | Project admin | Manages the project's members and resources. |
| 5 | Project user | Creates clusters inside a project. |
A platform admin never hands a customer raw infrastructure. They grant a tenant a slice of what the platform already has, and the tenant admin decides how to split that slice across their own teams.
Tenants are optional​
A platform with no tenants behaves exactly as it did before tenants existed. Projects remain the organizing unit, and project permissions still scope project admins and members. Platform admins aren't constrained by a tenant boundary.
Create tenants when more than one organization shares your platform and those organizations shouldn't see each other. If you're running a single internal platform where every admin is trusted with the whole inventory, projects alone are enough.
How the tenant boundary works​
Every tenant starts with no access to platform inventory. A platform admin grants each one capabilities, such as the control plane clusters, node types, OS images, and templates it may use. They can also assign a resource such as a physical machine or a network environment to one tenant exclusively.
A user's effective access is the intersection of their role, the tenant boundary, and the project boundary. A tenant admin holds broad rights, but those rights stop at the edge of their tenant.
Read the details in What are tenants →
Work in this section​
The rest of this section follows the same handoff. A platform admin creates tenants and sets their boundaries. A tenant admin organizes projects, users, and teams inside one tenant. Project admins then decide what their members can create, through templates, quotas, and project secrets. If you're new to the model, read what projects are and how users and teams work next.