Organization
An Organization is the top-level grouping mechanism in OpenChoreo. It represents a logical boundary for users and resources, typically aligned to a company, business unit, or team. Organizations provide namespace isolation and serve as the container for all projects and platform resources.
API Version
openchoreo.dev/v1alpha1
Resource Definition
Metadata
Organizations are cluster-scoped resources, meaning they exist at the cluster level rather than within a namespace.
apiVersion: openchoreo.dev/v1alpha1
kind: Organization
metadata:
name: <organization-name>
Spec Fields
The Organization spec is currently empty. Organizations are provisioned based on their metadata alone.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| - | - | - | - | No spec fields defined |
Status Fields
| Field | Type | Default | Description |
|---|---|---|---|
observedGeneration |
integer | 0 | The generation observed by the controller |
namespace |
string | ”” | The namespace provisioned for this organization |
conditions |
[]Condition | [] | Standard Kubernetes conditions tracking the organization state |
Condition Types
Common condition types for Organization resources:
Ready- Indicates if the organization is fully provisioned and readyNamespaceProvisioned- Indicates if the organization namespace has been created
Examples
Basic Organization
apiVersion: openchoreo.dev/v1alpha1
kind: Organization
metadata:
name: default-organization
annotations:
openchoreo.dev/display-name: Default Organization
openchoreo.dev/description: This is the default organization for this setup
spec: { }
Annotations
Organizations support the following annotations:
| Annotation | Description |
|---|---|
openchoreo.dev/display-name |
Human-readable name for UI display |
openchoreo.dev/description |
Detailed description of the organization |
Related Resources
- Project - Cloud-native applications within an organization
- DataPlane - Kubernetes clusters managed by the organization
- Environment - Runtime environments for the organization