Skip to main content

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.

PropertyTypeDescription
apiVersionstringAPI schema version. Must be lowops.manifests.v1.
kindstringResource kind. Must be Kubernetes.
metadatamapThe engine reads the reserved keys name and project to resolve the identity and the parent Project.
specSpecDesired cluster configuration. See Spec.

ApplicationsEntry​

PropertyTypeDescription
keystring
valueComputedApplication

ServiceAccountsEntry​

PropertyTypeDescription
keystring
valueComputedIamServiceAccount

Spec​

User-provided cluster configuration.

Region and maintenance settings. Child KubernetesNodePool manifests define the nodes.

PropertyTypeDescription
descriptionstringOptional description of the cluster. The engine copies it to the GKE cluster.
regionstringGCP region of the cluster. Defaults to the computed region of the parent Project.
maintenanceMaintenanceTime 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.

PropertyTypeDescription
namestringResolved application name.
meshStrategystringService mesh strategy, for example SIDECAR, PROXYLESS, DISABLED, or EXCLUDED. It controls traffic routes and service URLs.
containerComputedContainerDefinitionResolved container image of the application.

ComputedIamServiceAccount​

Computed Google Cloud service account.

The engine uses it to create IAM bindings and Kubernetes Workload Identity bindings.

PropertyTypeDescription
namestringName of the service account, usually from the name of the Application manifest.
createboolWhether the platform creates the service account. Usually true, unless the application uses an account that already exists.
rolesComputedIamServiceAccountPermissionsResolved IAM roles, derived from the accessControl block of the Application manifest.
k8sNamestringName of the Kubernetes service account bound to this account. Relevant for applications on GKE.
k8sNamespacestringNamespace 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.

PropertyTypeDescription
startstringRFC3339 timestamp. Its time of day and day of week set the start of the weekly window. RFC3339
endstringRFC3339 timestamp for the end of the weekly window. RFC3339
exclusionslist of MaintenanceExclusionOne-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.

PropertyTypeDescription
sourceRegistryComputedAccessibleRegistryArtifact Registry that stores the image.
imagestringAbsolute 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.

PropertyTypeDescription
organizationlist of stringRoles at the GCP organization level.
projectlist of stringRoles at the GCP project level.
artifactRegistrylist of stringRoles for specific Artifact Registry repositories.

MaintenanceExclusion​

One-time window in which platform maintenance must not run.

It overrides the weekly maintenance window.

PropertyTypeDescription
namestringUnique label for the reason, for example black-friday-freeze.
startstringWindow start, in RFC3339 format. RFC3339
endstringWindow end, in RFC3339 format. RFC3339

ComputedAccessibleRegistry​

Computed Artifact Registry repository.

Holds the name and location that resolve image paths.

PropertyTypeDescription
namestringName of the Artifact Registry repository.
locationstringGCP region or multi-region of the registry. It forms part of the image path.
trustedRepositorieslist of stringTrusted repository children of an external registry. Binary Authorization allows each one separately, not the whole registry. Empty for internal repositories, which use attestation.