Environment
Environment
A deployment lifecycle boundary, for example Development, Staging, or Production.
It provisions a GCP folder under the parent OrganizationalUnit. Its direct children, Secret and Project manifests, inherit its permissions, hibernation schedules, and domain segments.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be Environment. |
| metadata | map | The engine reads the reserved keys name, organizational-unit, and organization to resolve the identity and the parent OrganizationalUnit. |
| spec | EnvironmentDefinition | Desired environment configuration. Child Projects inherit its permissions, hibernation schedule, and domain segment. See EnvironmentDefinition. |
EnvironmentDefinition
Definition of an Environment, for example staging or prod.
It maps to a GCP folder under the parent OU folder and sets defaults for the projects in it.
| Property | Type | Description |
|---|---|---|
| displayName | string | Display name of the GCP folder. Same rules as OrganizationalUnitDefinition.display_name. |
| description | string | Free-text description. |
| hibernation | HibernationConfig | Default hibernation schedule for the environment. It overrides the schedule of the parent OrganizationalUnit. Child Project manifests inherit it. |
| permissions | AccessPermissions | Default permissions for the environment. Child Project manifests inherit them. The engine combines them with the permissions of the parent OrganizationalUnit. |
| network | EnvironmentNetwork | NOT YET IMPLEMENTED. The engine ignores this field. See EnvironmentNetwork. |
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. |
EnvironmentNetwork
VPC flow log settings for an Environment.
NOT YET IMPLEMENTED. The engine ignores this message.
| Property | Type | Description |
|---|---|---|
| logs | NetworkLogs | NOT YET IMPLEMENTED. The engine ignores this field. See NetworkLogs. |
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 |
NetworkLogs
VPC Flow Logs export settings.
NOT YET IMPLEMENTED. The engine ignores this message. Intended use: set the aggregation interval and sampling rate of flow logs.
| Property | Type | Description |
|---|---|---|
| interval | string | Aggregation interval. One of the INTERVAL_* values, from INTERVAL_5_SEC to INTERVAL_15_MIN. |
| sampling | double | Fraction of connections to capture, from 0.0 (no logs) to 1.0 (all logs). |
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. |