Organization
Organization
Represents the root of the Infrastream resource hierarchy.
It contains all OrganizationalUnits, GitHub connections, identity providers and global users. It sets the global baselines for GCP and GitHub.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be Organization. |
| metadata | map | The engine reads the reserved key name to resolve the identity of this manifest. An Organization is the hierarchy root, so it has no parent. |
| spec | Spec | Desired configuration. See Spec. |
CodeOwnersEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | string |
HibernationScheduleCronsEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | string |
Spec
User-authored organization configuration.
It sets the description, domains, default region, GitHub organization, hibernation schedule and workforce federation.
| Property | Type | Description |
|---|---|---|
| description | string | Optional free text. The engine copies it to the core organization-manifests repository description. AI assistants use it as context. |
| domain | Domain | Internal and external base domains. Required. See Domain. |
| defaultRegion | string | Default GCP region for organization resources. Required. An OrganizationalUnit, Environment or Project can override it. It also sets the location of the core infrastream-docker-mirror Artifact Registry and the region of the private Certificate Authority pool. |
| github | GithubConfig | Primary GitHub organization. Required. It owns the central GitOps repository with the hydrated organization manifests. Its name sets the repository name (<org>-infrastream-organization-manifests) and the code owners. For application source code, use GithubConnection. |
| permissions | AccessPermissions | Administrators and contributors that own the organization. They cascade to every descendant as code owners. They also set the global * default in the CODEOWNERS of the core organization-manifests repository, so they review any file with no more specific owner. Optional. If unset, the engine emits no default code owner. |
| hibernation | HibernationConfig | Default active-hours schedule for all resources in the organization. A lower level can override it. |
| workforceFederation | WorkforceFederation | Identity source for the users of the organization. Required. See WorkforceFederation. |
Domain
Internal and external DNS domains for the organization.
The engine derives environment and project hostnames from these base domains. Each must be a lowercase FQDN: two or more dot-separated labels of 1-63 characters from [a-z0-9-], with no hyphen at the start or end.
| Property | Type | Description |
|---|---|---|
| internal | string | Base domain for private, in-cluster service names. Must be a lowercase FQDN (see Domain). Recommended: define a *.internal hostname. |
| external | string | Base domain for public hostnames. Child OrganizationalUnits, Environments and Projects prefix their name onto it. Must be a lowercase FQDN (see Domain). |
| registryAliases | list of string | Additional domains that also serve the managed proxy registries. The managed proxy registries (types BUF and DART) have the address <registry>.pkg.<external>. Each alias adds <registry>.pkg.<alias>. A registry then gets a new address without a change to external. Such a change would move the portal host and every unit, environment and project zone. |
WorkforceFederation
Workforce identity-federation strategy.
It selects the source of the human users of the organization. Set exactly one backend in the federation oneof.
| Property | Type | Description |
|---|---|---|
| googleWorkspace | GoogleWorkspace | Google Workspace backend. See GoogleWorkspace. |
| microsoftEntraId | MicrosoftEntraId | Microsoft Entra ID backend. See MicrosoftEntraId. |
| infrastreamManaged | InfrastreamManaged | Infrastream-managed backend. See InfrastreamManaged. |
GoogleWorkspace
Google Workspace federation backend.
Federates workforce identities from a Google Workspace directory through domain-wide delegation.
| Property | Type | Description |
|---|---|---|
| domain | string | Primary domain of the Google Workspace directory. Required. |
| customerId | string | Customer ID of the Google Workspace account. It scopes the directory API calls. Required. |
| impersonatedEmail | string | Admin email that the engine impersonates through domain-wide delegation to read and provision directory identities. Required. |
InfrastreamManaged
Infrastream-managed workforce backend.
Users bring their own Google accounts, declared in OrganizationUser spec.primaryEmail. Infrastream allowlists each address and binds it as an IAM principal. This backend has no configuration.
MicrosoftEntraId
Microsoft Entra ID federation backend.
Federates workforce identities from a Microsoft Entra ID (formerly Azure AD) tenant.
| Property | Type | Description |
|---|---|---|
| issuerUri | string | OIDC issuer URI of the Entra ID tenant. It sets the federation trust. Required. |
GithubConfig
Configuration for the central GitOps repository on GitHub.
The engine pushes hydrated infrastructure state and application configs to it.
| Property | Type | Description |
|---|---|---|
| organization | string | Name of the GitHub organization that owns the central GitOps repository. Required. |
| administrators | list of string | NOT YET IMPLEMENTED. The engine ignores this field. Intended use: GitHub usernames with admin access on the managed repositories. |
HibernationConfig
Hibernation schedule configuration.
The engine combines windows and exclusions from the OU, Environment and Project into the final state.
| Property | Type | Description |
|---|---|---|
| hibernate | bool | If true, the resource hibernates immediately and overrides all windows and exclusions. Defaults to false. |
| windows | list of WindowsEntry | Time windows that repeat, in which the resource hibernates. The map key is a unique name. |
| exclusions | list of ExclusionsEntry | One-time windows that suspend hibernation, even if a window is active. Use them for planned maintenance or high-traffic periods. The map key is a unique name. |
AccessPermissions
Administrator, contributor, and viewer privileges for an asset.
The engine aggregates the users and groups into IAM policies.
| Property | Type | Description |
|---|---|---|
| administrators | DetailedAccessPermissions | Users and groups with administrative privileges, usually full control. |
| contributors | DetailedAccessPermissions | Users and groups with contributor privileges, usually read and write access. |
| viewers | DetailedAccessPermissions | Users and groups with viewer privileges, usually read-only access. |
DetailedAccessPermissions
User and group access definitions.
The engine resolves the listed manifests to Google Workspace identity emails for IAM bindings.
| Property | Type | Description |
|---|---|---|
| members | list of string | Names of OrganizationUser manifests. |
| groups | list of string | Names of OrganizationUserGroup manifests. |
WindowsEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | HibernationWindow |
ExclusionsEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | HibernationExclusion |
HibernationExclusion
Suspension of the hibernation schedule.
Workloads stay active in the given time frame.
| Property | Type | Description |
|---|---|---|
| start | string | Window start, in RFC3339 format. RFC3339 |
| end | string | Window end, in RFC3339 format. RFC3339 |
HibernationWindow
Period when an asset scales down.
Cron strings tell the control plane when to stop virtual machines or scale Cloud Run instances to zero.
| Property | Type | Description |
|---|---|---|
| start | string | Cron expression for the start of the window. |
| end | string | Cron expression for the end of the window. |