Kubernetes
Kubernetes
A managed Kubernetes cluster.
It defines the region and maintenance window of a cluster. The platform configures VPC peering, authorized networks for the control plane, and IAM bindings for workload identity. Node pools are child KubernetesNodePool manifests.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be Kubernetes. |
| metadata | map | The engine reads the reserved keys name and project to resolve the identity and the parent Project. |
| spec | Spec | Desired cluster configuration. See Spec. |
ApplicationsEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | ComputedApplication |
ServiceAccountsEntry
| Property | Type | Description |
|---|---|---|
| key | string | |
| value | ComputedIamServiceAccount |
Spec
User-provided cluster configuration.
Region and maintenance settings. Child KubernetesNodePool manifests define the nodes.
| Property | Type | Description |
|---|---|---|
| description | string | Optional description of the cluster. The engine copies it to the GKE cluster. |
| region | string | GCP region of the cluster. Defaults to the computed region of the parent Project. |
| maintenance | Maintenance | Time windows for automated maintenance and upgrades. Defaults to the schedule of the parent Project. See Maintenance. |
ComputedApplication
Computed deployment configuration of an application.
Holds the mesh strategy, the migration requirements, and the container image layout.
| Property | Type | Description |
|---|---|---|
| name | string | Resolved application name. |
| meshStrategy | string | Service mesh strategy, for example SIDECAR, PROXYLESS, DISABLED, or EXCLUDED. It controls traffic routes and service URLs. |
| container | ComputedContainerDefinition | Resolved container image of the application. |
ComputedIamServiceAccount
Computed Google Cloud service account.
The engine uses it to create IAM bindings and Kubernetes Workload Identity bindings.
| Property | Type | Description |
|---|---|---|
| name | string | Name of the service account, usually from the name of the Application manifest. |
| create | bool | Whether the platform creates the service account. Usually true, unless the application uses an account that already exists. |
| roles | ComputedIamServiceAccountPermissions | Resolved IAM roles, derived from the accessControl block of the Application manifest. |
| k8sName | string | Name of the Kubernetes service account bound to this account. Relevant for applications on GKE. |
| k8sNamespace | string | Namespace of the Kubernetes service account. |
Maintenance
Weekly maintenance window and exclusions for resource upgrades.
It controls when Google Cloud upgrades resources, such as GKE clusters and Cloud SQL instances.
| Property | Type | Description |
|---|---|---|
| start | string | RFC3339 timestamp. Its time of day and day of week set the start of the weekly window. RFC3339 |
| end | string | RFC3339 timestamp for the end of the weekly window. RFC3339 |
| exclusions | list of MaintenanceExclusion | One-time windows in which maintenance must not run, even inside the weekly window. Use them for business-critical periods. |
ComputedContainerDefinition
Computed container image source of a deployment.
Gives the image URL for the deployment API.
| Property | Type | Description |
|---|---|---|
| sourceRegistry | ComputedAccessibleRegistry | Artifact Registry that stores the image. |
| image | string | Absolute image reference, with registry host and repository path. |
ComputedIamServiceAccountPermissions
Computed IAM roles for a service account.
The engine derives them from the accessControl blocks of the application.
| Property | Type | Description |
|---|---|---|
| organization | list of string | Roles at the GCP organization level. |
| project | list of string | Roles at the GCP project level. |
| artifactRegistry | list of string | Roles for specific Artifact Registry repositories. |
MaintenanceExclusion
One-time window in which platform maintenance must not run.
It overrides the weekly maintenance window.
| Property | Type | Description |
|---|---|---|
| name | string | Unique label for the reason, for example black-friday-freeze. |
| start | string | Window start, in RFC3339 format. RFC3339 |
| end | string | Window end, in RFC3339 format. RFC3339 |
ComputedAccessibleRegistry
Computed Artifact Registry repository.
Holds the name and location that resolve image paths.
| Property | Type | Description |
|---|---|---|
| name | string | Name of the Artifact Registry repository. |
| location | string | GCP region or multi-region of the registry. It forms part of the image path. |
| trustedRepositories | list of string | Trusted repository children of an external registry. Binary Authorization allows each one separately, not the whole registry. Empty for internal repositories, which use attestation. |