RunService


Property Value
Google Cloud Service Name Run
Google Cloud Service Documentation /run/docs/
Google Cloud REST Resource Name v2.projects.locations.services
Google Cloud REST Resource Documentation /run/docs/reference/rest/v2/projects.locations.services
Config Connector Resource Short Names gcprunservice
gcprunservices
runservice
Config Connector Service Name run.googleapis.com
Config Connector Resource Fully Qualified Name runservices.run.cnrm.cloud.google.com
Can Be Referenced by IAMPolicy/IAMPolicyMember Yes
IAMPolicy/IAMPartialPolicy Supports Conditions Yes
IAMPolicyMember Supports Conditions No
Supports IAM Audit Configs No
IAM External Reference Format

projects/{{project}}/locations/{{location}}/services/{{name}}

Config Connector Default Average Reconcile Interval In Seconds 600

Custom Resource Definition Properties

Annotations

Fields
cnrm.cloud.google.com/state-into-spec

Spec

Schema

annotations:
  string: string
binaryAuthorization:
  breakglassJustification: string
  useDefault: boolean
client: string
clientVersion: string
description: string
ingress: string
launchStage: string
location: string
projectRef:
  external: string
  name: string
  namespace: string
resourceID: string
template:
  annotations:
    string: string
  containerConcurrency: integer
  containers:
  - args:
    - string
    command:
    - string
    env:
    - name: string
      value: string
      valueSource:
        secretKeyRef:
          secretRef:
            external: string
            name: string
            namespace: string
          versionRef:
            external: string
            name: string
            namespace: string
    image: string
    name: string
    ports:
    - containerPort: integer
      name: string
    resources:
      cpuIdle: boolean
      limits:
        string: string
    volumeMounts:
    - mountPath: string
      name: string
  executionEnvironment: string
  labels:
    string: string
  revision: string
  scaling:
    maxInstanceCount: integer
    minInstanceCount: integer
  serviceAccountRef:
    external: string
    name: string
    namespace: string
  timeout: string
  volumes:
  - cloudSqlInstance:
      instances:
      - external: string
        name: string
        namespace: string
    name: string
    secret:
      defaultMode: integer
      items:
      - mode: integer
        path: string
        versionRef:
          external: string
          name: string
          namespace: string
      secretRef:
        external: string
        name: string
        namespace: string
  vpcAccess:
    connectorRef:
      external: string
      name: string
      namespace: string
    egress: string
traffic:
- percent: integer
  revision: string
  tag: string
  type: string
Fields

annotations

Optional

map (key: string, value: string)

Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects. Cloud Run will populate some annotations using 'run.googleapis.com' or 'serving.knative.dev' namespaces. This field follows Kubernetes annotations' namespacing, limits, and rules. More info: http://kubernetes.io/docs/user-guide/annotations

binaryAuthorization

Optional

object

Settings for the Binary Authorization feature.

binaryAuthorization.breakglassJustification

Optional

string

If present, indicates to use Breakglass using this justification. For more information on breakglass, see https://cloud.google.com/binary-authorization/docs/using-breakglass

binaryAuthorization.useDefault

Optional

boolean

If True, indicates to use the default project's binary authorization policy. If False, binary authorization will be disabled

client

Optional

string

Arbitrary identifier for the API client.

clientVersion

Optional

string

Arbitrary version identifier for the API client.

description

Optional

string

User-provided description of the Service.

ingress

Optional

string

Provides the ingress settings for this Service. On output, returns the currently observed ingress settings, or INGRESS_TRAFFIC_UNSPECIFIED if no revision is active.

launchStage

Optional

string

The launch stage as defined by [Google Cloud Platform Launch Stages](http://cloud.google.com/terms/launch-stages). Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA is assumed. Possible values: LAUNCH_STAGE_UNSPECIFIED, UNIMPLEMENTED, PRELAUNCH, EARLY_ACCESS, ALPHA, BETA, GA, DEPRECATED

location

Required

string

Immutable. The location for the resource

projectRef

Required

object

Immutable. The Project that this resource belongs to.

projectRef.external

Optional

string

The project for the resource Allowed value: The Google Cloud resource name of a `Project` resource (format: `projects/{{name}}`).

projectRef.name

Optional

string

Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

projectRef.namespace

Optional

string

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

resourceID

Optional

string

Immutable. Optional. The name of the resource. Used for creation and acquisition. When unset, the value of `metadata.name` is used as the default.

template

Required

object

Required. The template used to create revisions for this Service.

template.annotations

Optional

map (key: string, value: string)

KRM-style annotations for the resource.

template.containerConcurrency

Optional

integer

Sets the maximum number of requests that each serving instance can receive.

template.containers

Optional

list (object)

Holds the single container that defines the unit of execution for this Revision.

template.containers[]

Optional

object

template.containers[].args

Optional

list (string)

Arguments to the entrypoint. The docker image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

template.containers[].args[]

Optional

string

template.containers[].command

Optional

list (string)

Entrypoint array. Not executed within a shell. The docker image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. More info: https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell

template.containers[].command[]

Optional

string

template.containers[].env

Optional

list (object)

List of environment variables to set in the container.

template.containers[].env[]

Optional

object

template.containers[].env[].name

Required*

string

Required. Name of the environment variable. Must be a C_IDENTIFIER, and mnay not exceed 32768 characters.

template.containers[].env[].value

Optional

string

Variable references $(VAR_NAME) are expanded using the previous defined environment variables in the container and any route environment variables. If a variable cannot be resolved, the reference in the input string will be unchanged. The $(VAR_NAME) syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped references will never be expanded, regardless of whether the variable exists or not. Defaults to "", and the maximum length is 32768 bytes.

template.containers[].env[].valueSource

Optional

object

Source for the environment variable's value.

template.containers[].env[].valueSource.secretKeyRef

Optional

object

Selects a secret and a specific version from Cloud Secret Manager.

template.containers[].env[].valueSource.secretKeyRef.secretRef

Required*

object

template.containers[].env[].valueSource.secretKeyRef.secretRef.external

Optional

string

Required. The name of the secret in Cloud Secret Manager. Format: {secret_name} if the secret is in the same project. projects/{project}/secrets/{secret_name} if the secret is in a different project. Allowed value: The Google Cloud resource name of a `SecretManagerSecret` resource (format: `projects/{{project}}/secrets/{{name}}`).

template.containers[].env[].valueSource.secretKeyRef.secretRef.name

Optional

string

Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

template.containers[].env[].valueSource.secretKeyRef.secretRef.namespace

Optional

string

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

template.containers[].env[].valueSource.secretKeyRef.versionRef

Optional

object

template.containers[].env[].valueSource.secretKeyRef.versionRef.external

Optional

string

The Cloud Secret Manager secret version. Can be 'latest' for the latest value or an integer for a specific version. Allowed value: The Google Cloud resource name of a `SecretManagerSecretVersion` resource (format: `{{name}}`).

template.containers[].env[].valueSource.secretKeyRef.versionRef.name

Optional

string

Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

template.containers[].env[].valueSource.secretKeyRef.versionRef.namespace

Optional

string

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

template.containers[].image

Required*

string

Required. URL of the Container image in Google Container Registry or Docker More info: https://kubernetes.io/docs/concepts/containers/images

template.containers[].name

Optional

string

Name of the container specified as a DNS_LABEL.

template.containers[].ports

Optional

list (object)

List of ports to expose from the container. Only a single port can be specified. The specified ports must be listening on all interfaces (0.0.0.0) within the container to be accessible. If omitted, a port number will be chosen and passed to the container through the PORT environment variable for the container to listen on.

template.containers[].ports[]

Optional

object

template.containers[].ports[].containerPort

Optional

integer

Port number the container listens on. This must be a valid TCP port number, 0 < container_port < 65536.

template.containers[].ports[].name

Optional

string

If specified, used to specify which protocol to use. Allowed values are "http1" and "h2c".

template.containers[].resources

Optional

object

Compute Resource requirements by this container. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources

template.containers[].resources.cpuIdle

Optional

boolean

Determines whether CPU should be throttled or not outside of requests.

template.containers[].resources.limits

Optional

map (key: string, value: string)

Only memory and CPU are supported. Note: The only supported values for CPU are '1', '2', and '4'. Setting 4 CPU requires at least 2Gi of memory. The values of the map is string form of the 'quantity' k8s type: https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go

template.containers[].volumeMounts

Optional

list (object)

Volume to mount into the container's filesystem.

template.containers[].volumeMounts[]

Optional

object

template.containers[].volumeMounts[].mountPath

Required*

string

Required. Path within the container at which the volume should be mounted. Must not contain ':'. For Cloud SQL volumes, it can be left empty, or must otherwise be `/cloudsql`. All instances defined in the Volume will be available as `/cloudsql/[instance]`. For more information on Cloud SQL volumes, visit https://cloud.google.com/sql/docs/mysql/connect-run

template.containers[].volumeMounts[].name

Required*

string

Required. This must match the Name of a Volume.

template.executionEnvironment

Optional

string

The sandbox environment to host this Revision. Possible values: EXECUTION_ENVIRONMENT_UNSPECIFIED, EXECUTION_ENVIRONMENT_GEN1, EXECUTION_ENVIRONMENT_GEN2

template.labels

Optional

map (key: string, value: string)

KRM-style labels for the resource.

template.revision

Optional

string

The unique name for the revision. If this field is omitted, it will be automatically generated based on the Service name.

template.scaling

Optional

object

Scaling settings for this Revision.

template.scaling.maxInstanceCount

Optional

integer

Maximum number of serving instances that this resource should have.

template.scaling.minInstanceCount

Optional

integer

Minimum number of serving instances that this resource should have.

template.serviceAccountRef

Optional

object

template.serviceAccountRef.external

Optional

string

Email address of the IAM service account associated with the revision of the service. The service account represents the identity of the running revision, and determines what permissions the revision has. If not provided, the revision will use the project's default service account. Allowed value: The `email` field of an `IAMServiceAccount` resource.

template.serviceAccountRef.name

Optional

string

Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

template.serviceAccountRef.namespace

Optional

string

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

template.timeout

Optional

string

Max allowed time for an instance to respond to a request.

template.volumes

Optional

list (object)

A list of Volumes to make available to containers.

template.volumes[]

Optional

object

template.volumes[].cloudSqlInstance

Optional

object

For Cloud SQL volumes, contains the specific instances that should be mounted. Visit https://cloud.google.com/sql/docs/mysql/connect-run for more information on how to connect Cloud SQL and Cloud Run.

template.volumes[].cloudSqlInstance.instances

Optional

list (object)

template.volumes[].cloudSqlInstance.instances[]

Optional

object

template.volumes[].cloudSqlInstance.instances[].external

Optional

string

Allowed value: The `instanceName` field of a `SQLInstance` resource.

template.volumes[].cloudSqlInstance.instances[].name

Optional

string

Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

template.volumes[].cloudSqlInstance.instances[].namespace

Optional

string

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

template.volumes[].name

Required*

string

Required. Volume's name.

template.volumes[].secret

Optional

object

Secret represents a secret that should populate this volume. More info: https://kubernetes.io/docs/concepts/storage/volumes#secret

template.volumes[].secret.defaultMode

Optional

integer

Integer representation of mode bits to use on created files by default. Must be a value between 0000 and 0777 (octal), defaulting to 0644. Directories within the path are not affected by this setting. Notes * Internally, a umask of 0222 will be applied to any non-zero value. * This is an integer representation of the mode bits. So, the octal integer value should look exactly as the chmod numeric notation with a leading zero. Some examples: for chmod 777 (a=rwx), set to 0777 (octal) or 511 (base-10). For chmod 640 (u=rw,g=r), set to 0640 (octal) or 416 (base-10). For chmod 755 (u=rwx,g=rx,o=rx), set to 0755 (octal) or 493 (base-10). * This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set. This might be in conflict with other options that affect the file mode, like fsGroup, and as a result, other mode bits could be set.

template.volumes[].secret.items

Optional

list (object)

If unspecified, the volume will expose a file whose name is the secret, relative to VolumeMount.mount_path. If specified, the key will be used as the version to fetch from Cloud Secret Manager and the path will be the name of the file exposed in the volume. When items are defined, they must specify a path and a version.

template.volumes[].secret.items[]

Optional

object

template.volumes[].secret.items[].mode

Optional

integer

Integer octal mode bits to use on this file, must be a value between 01 and 0777 (octal). If 0 or not set, the Volume's default mode will be used. Notes * Internally, a umask of 0222 will be applied to any non-zero value. * This is an integer representation of the mode bits. So, the octal integer value should look exactly as the chmod numeric notation with a leading zero. Some examples: for chmod 777 (a=rwx), set to 0777 (octal) or 511 (base-10). For chmod 640 (u=rw,g=r), set to 0640 (octal) or 416 (base-10). For chmod 755 (u=rwx,g=rx,o=rx), set to 0755 (octal) or 493 (base-10). * This might be in conflict with other options that affect the file mode, like fsGroup, and the result can be other mode bits set.

template.volumes[].secret.items[].path

Required*

string

Required. The relative path of the secret in the container.

template.volumes[].secret.items[].versionRef

Optional

object

template.volumes[].secret.items[].versionRef.external

Optional

string

The Cloud Secret Manager secret version. Can be 'latest' for the latest value or an integer for a specific version. Allowed value: The Google Cloud resource name of a `SecretManagerSecretVersion` resource (format: `{{name}}`).

template.volumes[].secret.items[].versionRef.name

Optional

string

Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

template.volumes[].secret.items[].versionRef.namespace

Optional

string

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

template.volumes[].secret.secretRef

Required*

object

template.volumes[].secret.secretRef.external

Optional

string

Required. The name of the secret in Cloud Secret Manager. Format: {secret} if the secret is in the same project. projects/{project}/secrets/{secret} if the secret is in a different project. Allowed value: The Google Cloud resource name of a `SecretManagerSecret` resource (format: `projects/{{project}}/secrets/{{name}}`).

template.volumes[].secret.secretRef.name

Optional

string

Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

template.volumes[].secret.secretRef.namespace

Optional

string

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

template.vpcAccess

Optional

object

VPC Access configuration to use for this Revision. For more information, visit https://cloud.google.com/run/docs/configuring/connecting-vpc.

template.vpcAccess.connectorRef

Optional

object

template.vpcAccess.connectorRef.external

Optional

string

VPC Access connector name. Format: projects/{project}/locations/{location}/connectors/{connector} Allowed value: The Google Cloud resource name of a `VPCAccessConnector` resource (format: `projects/{{project}}/locations/{{location}}/connectors/{{name}}`).

template.vpcAccess.connectorRef.name

Optional

string

Name of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

template.vpcAccess.connectorRef.namespace

Optional

string

Namespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/

template.vpcAccess.egress

Optional

string

Traffic VPC egress settings. Possible values: VPC_EGRESS_UNSPECIFIED, ALL_TRAFFIC, PRIVATE_RANGES_ONLY

traffic

Optional

list (object)

Specifies how to distribute traffic over a collection of Revisions belonging to the Service. If traffic is empty or not provided, defaults to 100% traffic to the latest `Ready` Revision.

traffic[]

Optional

object

traffic[].percent

Optional

integer

Specifies percent of the traffic to this Revision. This defaults to zero if unspecified. Cloud Run currently requires 100 percent for a single TrafficTarget entry.

traffic[].revision

Optional

string

Revision to which to send this portion of traffic, if traffic allocation is by revision.

traffic[].tag

Optional

string

Indicates a string to be part of the URI to exclusively reference this target.

traffic[].type

Optional

string

The allocation type for this traffic target. Possible values: TRAFFIC_TARGET_ALLOCATION_TYPE_UNSPECIFIED, TRAFFIC_TARGET_ALLOCATION_TYPE_LATEST, TRAFFIC_TARGET_ALLOCATION_TYPE_REVISION

* Field is required when parent field is specified

Status

Schema

conditions:
- lastTransitionTime: string
  message: string
  reason: string
  status: string
  type: string
createTime: string
creator: string
deleteTime: string
etag: string
expireTime: string
labels:
  string: string
lastModifier: string
latestCreatedRevision: string
latestReadyRevision: string
observedGeneration: integer
reconciling: boolean
resourceGeneration: integer
terminalCondition:
  jobReason: string
  lastTransitionTime: string
  message: string
  reason: string
  revisionReason: string
  severity: string
  state: string
  type: string
trafficStatuses:
- percent: integer
  revision: string
  tag: string
  type: string
  uri: string
uid: string
updateTime: string
uri: string
Fields
conditions

list (object)

Conditions represent the latest available observation of the resource's current state.

conditions[]

object

conditions[].lastTransitionTime

string

Last time the condition transitioned from one status to another.

conditions[].message

string

Human-readable message indicating details about last transition.

conditions[].reason

string

Unique, one-word, CamelCase reason for the condition's last transition.

conditions[].status

string

Status is the status of the condition. Can be True, False, Unknown.

conditions[].type

string

Type is the type of the condition.

createTime

string

Output only. The creation time.

creator

string

Output only. Email address of the authenticated creator.

deleteTime

string

Output only. The deletion time.

etag

string

Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.

expireTime

string

Output only. For a deleted resource, the time after which it will be permamently deleted.

labels

map (key: string, value: string)

Map of string keys and values that can be used to organize and categorize objects. User-provided labels are shared with Google's billing system, so they can be used to filter, or break down billing charges by team, component, environment, state, etc. For more information, visit https://cloud.google.com/resource-manager/docs/creating-managing-labels or https://cloud.google.com/run/docs/configuring/labels Cloud Run will populate some labels with 'run.googleapis.com' or 'serving.knative.dev' namespaces. Those labels are read-only, and user changes will not be preserved.

lastModifier

string

Output only. Email address of the last authenticated modifier.

latestCreatedRevision

string

Output only. Name of the last created revision. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.

latestReadyRevision

string

Output only. Name of the latest revision that is serving traffic. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.

observedGeneration

integer

ObservedGeneration is the generation of the resource that was most recently observed by the Config Connector controller. If this is equal to metadata.generation, then that means that the current reported status reflects the most recent desired state of the resource.

reconciling

boolean

Output only. Returns true if the Service is currently being acted upon by the system to bring it into the desired state. When a new Service is created, or an existing one is updated, Cloud Run will asynchronously perform all necessary steps to bring the Service to the desired serving state. This process is called reconciliation. While reconciliation is in process, `observed_generation`, `latest_ready_revison`, `traffic_statuses`, and `uri` will have transient values that might mismatch the intended state: Once reconciliation is over (and this field is false), there are two possible outcomes: reconciliation succeeded and the serving state matches the Service, or there was an error, and reconciliation failed. This state can be found in `terminal_condition.state`. If reconciliation succeeded, the following fields will match: `traffic` and `traffic_statuses`, `observed_generation` and `generation`, `latest_ready_revision` and `latest_created_revision`. If reconciliation failed, `traffic_statuses`, `observed_generation`, and `latest_ready_revision` will have the state of the last serving revision, or empty for newly created Services. Additional information on the failure can be found in `terminal_condition` and `conditions`.

resourceGeneration

integer

Output only. A number that monotonically increases every time the user modifies the desired state.

terminalCondition

object

Output only. The Condition of this Service, containing its readiness status, and detailed error information in case it did not reach a serving state. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.

terminalCondition.jobReason

string

A reason for the job condition. Possible values: JOB_REASON_UNDEFINED, JOB_STATUS_SERVICE_POLLING_ERROR

terminalCondition.lastTransitionTime

string

Last time the condition transitioned from one status to another.

terminalCondition.message

string

Human readable message indicating details about the current status.

terminalCondition.reason

string

A common (service-level) reason for this condition. Possible values: COMMON_REASON_UNDEFINED, UNKNOWN, REVISION_FAILED, PROGRESS_DEADLINE_EXCEEDED, CONTAINER_MISSING, CONTAINER_PERMISSION_DENIED, CONTAINER_IMAGE_UNAUTHORIZED, CONTAINER_IMAGE_AUTHORIZATION_CHECK_FAILED, ENCRYPTION_KEY_PERMISSION_DENIED, ENCRYPTION_KEY_CHECK_FAILED, SECRETS_ACCESS_CHECK_FAILED, WAITING_FOR_OPERATION, IMMEDIATE_RETRY, POSTPONED_RETRY, INTERNAL

terminalCondition.revisionReason

string

A reason for the revision condition. Possible values: REVISION_REASON_UNDEFINED, PENDING, RESERVE, RETIRED, RETIRING, RECREATING, HEALTH_CHECK_CONTAINER_ERROR, CUSTOMIZED_PATH_RESPONSE_PENDING, MIN_INSTANCES_NOT_PROVISIONED, ACTIVE_REVISION_LIMIT_REACHED, NO_DEPLOYMENT

terminalCondition.severity

string

How to interpret failures of this condition, one of Error, Warning, Info Possible values: SEVERITY_UNSPECIFIED, ERROR, WARNING, INFO

terminalCondition.state

string

State of the condition. Possible values: STATE_UNSPECIFIED, CONDITION_PENDING, CONDITION_RECONCILING, CONDITION_FAILED, CONDITION_SUCCEEDED

terminalCondition.type

string

type is used to communicate the status of the reconciliation process. See also: https://github.com/knative/serving/blob/main/docs/spec/errors.md#error-conditions-and-reporting Types common to all resources include: * "Ready": True when the Resource is ready.

trafficStatuses

list (object)

Output only. Detailed status information for corresponding traffic targets. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.

trafficStatuses[]

object

trafficStatuses[].percent

integer

Specifies percent of the traffic to this Revision.

trafficStatuses[].revision

string

Revision to which this traffic is sent.

trafficStatuses[].tag

string

Indicates the string used in the URI to exclusively reference this target.

trafficStatuses[].type

string

The allocation type for this traffic target. Possible values: TRAFFIC_TARGET_ALLOCATION_TYPE_UNSPECIFIED, TRAFFIC_TARGET_ALLOCATION_TYPE_LATEST, TRAFFIC_TARGET_ALLOCATION_TYPE_REVISION

trafficStatuses[].uri

string

Displays the target URI.

uid

string

Output only. Server assigned unique identifier for the trigger. The value is a UUID4 string and guaranteed to remain unchanged until the resource is deleted.

updateTime

string

Output only. The last-modified time.

uri

string

Output only. The main URI in which this Service is serving traffic.

Sample YAML(s)

Typical Use Case

# Copyright 2021 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

apiVersion: run.cnrm.cloud.google.com/v1beta1
kind: RunService
metadata:
  name: runservice-sample
spec:
  ingress: "INGRESS_TRAFFIC_ALL"
  launchStage: "GA"
  location: "us-central1"
  projectRef:
    # Replace ${PROJECT_ID?} with your project ID.
    external: projects/${PROJECT_ID?}
  template:
    containers:
      - env:
          - name: "FOO"
            value: "bar]"
        image: "gcr.io/cloudrun/hello"
    scaling:
      maxInstanceCount: 2
  traffic:
    - percent: 100
      type: "TRAFFIC_TARGET_ALLOCATION_TYPE_LATEST"