Service

Service acts as a top-level container that manages a set of Routes and Configurations which implement a network service. Service exists to provide a singular abstraction which can be access controlled, reasoned about, and which encapsulates software lifecycle decisions such as rollout policy and team resource ownership. Service acts only as an orchestrator of the underlying Routes and Configurations (much as a kubernetes Deployment orchestrates ReplicaSets).

The Service’s controller will track the statuses of its owned Configuration and Route, reflecting their statuses and conditions as its own.

To get more information about Service, see:

API documentation
How-to Guides
- Official Documentation

Create a Service Resource

new Service(name: string, args: ServiceArgs, opts?: CustomResourceOptions);

def Service(resource_name, opts=None, autogenerate_revision_name=None, location=None, metadata=None, name=None, project=None, template=None, traffics=None, __props__=None);

func NewService(ctx *Context, name string, args ServiceArgs, opts ...ResourceOption) (*Service, error)

public Service(string name, ServiceArgs args, CustomResourceOptions? opts = null)

name string: The unique name of the resource.
args ServiceArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
opts ResourceOptions: A bag of options that control this resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args ServiceArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args ServiceArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

Service Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Programming Model docs.

Inputs

The Service resource accepts the following input properties:

Location string: The location of the cloud run instance. eg us-central1
AutogenerateRevisionName bool: If set to true, the revision name (template.metadata.name) will be omitted and autogenerated by Cloud Run. This cannot be set to true while template.metadata.name is also set. (For legacy support, if template.metadata.name is unset in state while this field is set to false, the revision name will still autogenerate.)
Metadata ServiceMetadataArgs: Metadata associated with this Service, including name, namespace, labels, and annotations. Structure is documented below.
Name string: Name of the environment variable.
Project string: The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
Template ServiceTemplateArgs: template holds the latest specification for the Revision to be stamped out. The template references the container image, and may also include labels and annotations that should be attached to the Revision. To correlate a Revision, and/or to force a Revision to be created when the spec doesn’t otherwise change, a nonce label may be provided in the template metadata. For more details, see: https://github.com/knative/serving/blob/master/docs/client-conventions.md#associate-modifications-with-revisions Cloud Run does not currently support referencing a build that is responsible for materializing the container image from source. Structure is documented below.
Traffics List<ServiceTrafficArgs>: Traffic specifies how to distribute traffic over a collection of Knative Revisions and Configurations Structure is documented below.

Location string: The location of the cloud run instance. eg us-central1
AutogenerateRevisionName bool: If set to true, the revision name (template.metadata.name) will be omitted and autogenerated by Cloud Run. This cannot be set to true while template.metadata.name is also set. (For legacy support, if template.metadata.name is unset in state while this field is set to false, the revision name will still autogenerate.)
Metadata ServiceMetadata: Metadata associated with this Service, including name, namespace, labels, and annotations. Structure is documented below.
Name string: Name of the environment variable.
Project string: The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
Template ServiceTemplate: template holds the latest specification for the Revision to be stamped out. The template references the container image, and may also include labels and annotations that should be attached to the Revision. To correlate a Revision, and/or to force a Revision to be created when the spec doesn’t otherwise change, a nonce label may be provided in the template metadata. For more details, see: https://github.com/knative/serving/blob/master/docs/client-conventions.md#associate-modifications-with-revisions Cloud Run does not currently support referencing a build that is responsible for materializing the container image from source. Structure is documented below.
Traffics []ServiceTraffic: Traffic specifies how to distribute traffic over a collection of Knative Revisions and Configurations Structure is documented below.

location string: The location of the cloud run instance. eg us-central1
autogenerateRevisionName boolean: If set to true, the revision name (template.metadata.name) will be omitted and autogenerated by Cloud Run. This cannot be set to true while template.metadata.name is also set. (For legacy support, if template.metadata.name is unset in state while this field is set to false, the revision name will still autogenerate.)
metadata ServiceMetadata: Metadata associated with this Service, including name, namespace, labels, and annotations. Structure is documented below.
name string: Name of the environment variable.
project string: The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
template ServiceTemplate: template holds the latest specification for the Revision to be stamped out. The template references the container image, and may also include labels and annotations that should be attached to the Revision. To correlate a Revision, and/or to force a Revision to be created when the spec doesn’t otherwise change, a nonce label may be provided in the template metadata. For more details, see: https://github.com/knative/serving/blob/master/docs/client-conventions.md#associate-modifications-with-revisions Cloud Run does not currently support referencing a build that is responsible for materializing the container image from source. Structure is documented below.
traffics ServiceTraffic[]: Traffic specifies how to distribute traffic over a collection of Knative Revisions and Configurations Structure is documented below.

location str: The location of the cloud run instance. eg us-central1
autogenerate_revision_name bool: If set to true, the revision name (template.metadata.name) will be omitted and autogenerated by Cloud Run. This cannot be set to true while template.metadata.name is also set. (For legacy support, if template.metadata.name is unset in state while this field is set to false, the revision name will still autogenerate.)
metadata Dict[ServiceMetadata]: Metadata associated with this Service, including name, namespace, labels, and annotations. Structure is documented below.
name str: Name of the environment variable.
project str: The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
template Dict[ServiceTemplate]: template holds the latest specification for the Revision to be stamped out. The template references the container image, and may also include labels and annotations that should be attached to the Revision. To correlate a Revision, and/or to force a Revision to be created when the spec doesn’t otherwise change, a nonce label may be provided in the template metadata. For more details, see: https://github.com/knative/serving/blob/master/docs/client-conventions.md#associate-modifications-with-revisions Cloud Run does not currently support referencing a build that is responsible for materializing the container image from source. Structure is documented below.
traffics List[ServiceTraffic]: Traffic specifies how to distribute traffic over a collection of Knative Revisions and Configurations Structure is documented below.

Outputs

All input properties are implicitly available as output properties. Additionally, the Service resource produces the following output properties:

Id string: The provider-assigned unique ID for this managed resource.
Status ServiceStatus: The current status of the Service.

Id string: The provider-assigned unique ID for this managed resource.
Status ServiceStatus: The current status of the Service.

id string: The provider-assigned unique ID for this managed resource.
status ServiceStatus: The current status of the Service.

id str: The provider-assigned unique ID for this managed resource.
status Dict[ServiceStatus]: The current status of the Service.

Look up an Existing Service Resource

Get an existing Service resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: ServiceState, opts?: CustomResourceOptions): Service

static get(resource_name, id, opts=None, autogenerate_revision_name=None, location=None, metadata=None, name=None, project=None, status=None, template=None, traffics=None, __props__=None);

func GetService(ctx *Context, name string, id IDInput, state *ServiceState, opts ...ResourceOption) (*Service, error)

public static Service Get(string name, Input<string> id, ServiceState? state, CustomResourceOptions? opts = null)

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

resource_name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

The following state arguments are supported:

AutogenerateRevisionName bool: If set to true, the revision name (template.metadata.name) will be omitted and autogenerated by Cloud Run. This cannot be set to true while template.metadata.name is also set. (For legacy support, if template.metadata.name is unset in state while this field is set to false, the revision name will still autogenerate.)
Location string: The location of the cloud run instance. eg us-central1
Metadata ServiceMetadataArgs: Metadata associated with this Service, including name, namespace, labels, and annotations. Structure is documented below.
Name string: Name of the environment variable.
Project string: The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
Status ServiceStatusArgs: The current status of the Service.
Template ServiceTemplateArgs: template holds the latest specification for the Revision to be stamped out. The template references the container image, and may also include labels and annotations that should be attached to the Revision. To correlate a Revision, and/or to force a Revision to be created when the spec doesn’t otherwise change, a nonce label may be provided in the template metadata. For more details, see: https://github.com/knative/serving/blob/master/docs/client-conventions.md#associate-modifications-with-revisions Cloud Run does not currently support referencing a build that is responsible for materializing the container image from source. Structure is documented below.
Traffics List<ServiceTrafficArgs>: Traffic specifies how to distribute traffic over a collection of Knative Revisions and Configurations Structure is documented below.

AutogenerateRevisionName bool: If set to true, the revision name (template.metadata.name) will be omitted and autogenerated by Cloud Run. This cannot be set to true while template.metadata.name is also set. (For legacy support, if template.metadata.name is unset in state while this field is set to false, the revision name will still autogenerate.)
Location string: The location of the cloud run instance. eg us-central1
Metadata ServiceMetadata: Metadata associated with this Service, including name, namespace, labels, and annotations. Structure is documented below.
Name string: Name of the environment variable.
Project string: The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
Status ServiceStatus: The current status of the Service.
Template ServiceTemplate: template holds the latest specification for the Revision to be stamped out. The template references the container image, and may also include labels and annotations that should be attached to the Revision. To correlate a Revision, and/or to force a Revision to be created when the spec doesn’t otherwise change, a nonce label may be provided in the template metadata. For more details, see: https://github.com/knative/serving/blob/master/docs/client-conventions.md#associate-modifications-with-revisions Cloud Run does not currently support referencing a build that is responsible for materializing the container image from source. Structure is documented below.
Traffics []ServiceTraffic: Traffic specifies how to distribute traffic over a collection of Knative Revisions and Configurations Structure is documented below.

autogenerateRevisionName boolean: If set to true, the revision name (template.metadata.name) will be omitted and autogenerated by Cloud Run. This cannot be set to true while template.metadata.name is also set. (For legacy support, if template.metadata.name is unset in state while this field is set to false, the revision name will still autogenerate.)
location string: The location of the cloud run instance. eg us-central1
metadata ServiceMetadata: Metadata associated with this Service, including name, namespace, labels, and annotations. Structure is documented below.
name string: Name of the environment variable.
project string: The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
status ServiceStatus: The current status of the Service.
template ServiceTemplate: template holds the latest specification for the Revision to be stamped out. The template references the container image, and may also include labels and annotations that should be attached to the Revision. To correlate a Revision, and/or to force a Revision to be created when the spec doesn’t otherwise change, a nonce label may be provided in the template metadata. For more details, see: https://github.com/knative/serving/blob/master/docs/client-conventions.md#associate-modifications-with-revisions Cloud Run does not currently support referencing a build that is responsible for materializing the container image from source. Structure is documented below.
traffics ServiceTraffic[]: Traffic specifies how to distribute traffic over a collection of Knative Revisions and Configurations Structure is documented below.

autogenerate_revision_name bool: If set to true, the revision name (template.metadata.name) will be omitted and autogenerated by Cloud Run. This cannot be set to true while template.metadata.name is also set. (For legacy support, if template.metadata.name is unset in state while this field is set to false, the revision name will still autogenerate.)
location str: The location of the cloud run instance. eg us-central1
metadata Dict[ServiceMetadata]: Metadata associated with this Service, including name, namespace, labels, and annotations. Structure is documented below.
name str: Name of the environment variable.
project str: The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
status Dict[ServiceStatus]: The current status of the Service.
template Dict[ServiceTemplate]: template holds the latest specification for the Revision to be stamped out. The template references the container image, and may also include labels and annotations that should be attached to the Revision. To correlate a Revision, and/or to force a Revision to be created when the spec doesn’t otherwise change, a nonce label may be provided in the template metadata. For more details, see: https://github.com/knative/serving/blob/master/docs/client-conventions.md#associate-modifications-with-revisions Cloud Run does not currently support referencing a build that is responsible for materializing the container image from source. Structure is documented below.
traffics List[ServiceTraffic]: Traffic specifies how to distribute traffic over a collection of Knative Revisions and Configurations Structure is documented below.

Supporting Types

ServiceMetadata

Annotations Dictionary<string, string>: Annotations is a key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. More info: http://kubernetes.io/docs/user-guide/annotations
Generation int: - A sequence number representing a specific generation of the desired state.
Labels Dictionary<string, string>: Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and routes. More info: http://kubernetes.io/docs/user-guide/labels
Namespace string: In Cloud Run the namespace must be equal to either the project ID or project number.
ResourceVersion string: - An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. They may only be valid for a particular resource or set of resources. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
SelfLink string: - SelfLink is a URL representing this object.
Uid string: - UID is a unique id generated by the server on successful creation of a resource and is not allowed to change on PUT operations. More info: http://kubernetes.io/docs/user-guide/identifiers#uids

Annotations map[string]string: Annotations is a key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. More info: http://kubernetes.io/docs/user-guide/annotations
Generation int: - A sequence number representing a specific generation of the desired state.
Labels map[string]string: Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and routes. More info: http://kubernetes.io/docs/user-guide/labels
Namespace string: In Cloud Run the namespace must be equal to either the project ID or project number.
ResourceVersion string: - An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. They may only be valid for a particular resource or set of resources. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
SelfLink string: - SelfLink is a URL representing this object.
Uid string: - UID is a unique id generated by the server on successful creation of a resource and is not allowed to change on PUT operations. More info: http://kubernetes.io/docs/user-guide/identifiers#uids

annotations {[key: string]: string}: Annotations is a key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. More info: http://kubernetes.io/docs/user-guide/annotations
generation number: - A sequence number representing a specific generation of the desired state.
labels {[key: string]: string}: Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and routes. More info: http://kubernetes.io/docs/user-guide/labels
namespace string: In Cloud Run the namespace must be equal to either the project ID or project number.
resourceVersion string: - An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. They may only be valid for a particular resource or set of resources. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
selfLink string: - SelfLink is a URL representing this object.
uid string: - UID is a unique id generated by the server on successful creation of a resource and is not allowed to change on PUT operations. More info: http://kubernetes.io/docs/user-guide/identifiers#uids

annotations Dict[str, str]: Annotations is a key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. More info: http://kubernetes.io/docs/user-guide/annotations
generation float: - A sequence number representing a specific generation of the desired state.
labels Dict[str, str]: Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and routes. More info: http://kubernetes.io/docs/user-guide/labels
namespace str: In Cloud Run the namespace must be equal to either the project ID or project number.
resourceVersion str: - An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. They may only be valid for a particular resource or set of resources. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
self_link str: - SelfLink is a URL representing this object.
uid str: - UID is a unique id generated by the server on successful creation of a resource and is not allowed to change on PUT operations. More info: http://kubernetes.io/docs/user-guide/identifiers#uids

ServiceStatus

Conditions List<ServiceStatusConditionArgs>
LatestCreatedRevisionName string
LatestReadyRevisionName string
ObservedGeneration int
Url string

Conditions []ServiceStatusCondition
LatestCreatedRevisionName string
LatestReadyRevisionName string
ObservedGeneration int
Url string

conditions ServiceStatusCondition[]
latestCreatedRevisionName string
latestReadyRevisionName string
observedGeneration number
url string

conditions List[ServiceStatusCondition]
latestCreatedRevisionName str
latestReadyRevisionName str
observedGeneration float
url str

ServiceStatusCondition

Message string
Reason string
Status string
Type string

Message string
Reason string
Status string
Type string

message string
reason string
status string
type string

message str
reason str
status str
type str

ServiceTemplate

Metadata ServiceTemplateMetadataArgs: Metadata associated with this Service, including name, namespace, labels, and annotations. Structure is documented below.
Spec ServiceTemplateSpecArgs: RevisionSpec holds the desired state of the Revision (from the client). Structure is documented below.

Metadata ServiceTemplateMetadata: Metadata associated with this Service, including name, namespace, labels, and annotations. Structure is documented below.
Spec ServiceTemplateSpec: RevisionSpec holds the desired state of the Revision (from the client). Structure is documented below.

metadata ServiceTemplateMetadata: Metadata associated with this Service, including name, namespace, labels, and annotations. Structure is documented below.
spec ServiceTemplateSpec: RevisionSpec holds the desired state of the Revision (from the client). Structure is documented below.

metadata Dict[ServiceTemplateMetadata]: Metadata associated with this Service, including name, namespace, labels, and annotations. Structure is documented below.
spec Dict[ServiceTemplateSpec]: RevisionSpec holds the desired state of the Revision (from the client). Structure is documented below.

ServiceTemplateMetadata

Annotations Dictionary<string, string>: Annotations is a key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. More info: http://kubernetes.io/docs/user-guide/annotations
Generation int: - A sequence number representing a specific generation of the desired state.
Labels Dictionary<string, string>: Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and routes. More info: http://kubernetes.io/docs/user-guide/labels
Name string: Name of the environment variable.
Namespace string: In Cloud Run the namespace must be equal to either the project ID or project number.
ResourceVersion string: - An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. They may only be valid for a particular resource or set of resources. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
SelfLink string: - SelfLink is a URL representing this object.
Uid string: - UID is a unique id generated by the server on successful creation of a resource and is not allowed to change on PUT operations. More info: http://kubernetes.io/docs/user-guide/identifiers#uids

Annotations map[string]string: Annotations is a key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. More info: http://kubernetes.io/docs/user-guide/annotations
Generation int: - A sequence number representing a specific generation of the desired state.
Labels map[string]string: Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and routes. More info: http://kubernetes.io/docs/user-guide/labels
Name string: Name of the environment variable.
Namespace string: In Cloud Run the namespace must be equal to either the project ID or project number.
ResourceVersion string: - An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. They may only be valid for a particular resource or set of resources. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
SelfLink string: - SelfLink is a URL representing this object.
Uid string: - UID is a unique id generated by the server on successful creation of a resource and is not allowed to change on PUT operations. More info: http://kubernetes.io/docs/user-guide/identifiers#uids

annotations {[key: string]: string}: Annotations is a key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. More info: http://kubernetes.io/docs/user-guide/annotations
generation number: - A sequence number representing a specific generation of the desired state.
labels {[key: string]: string}: Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and routes. More info: http://kubernetes.io/docs/user-guide/labels
name string: Name of the environment variable.
namespace string: In Cloud Run the namespace must be equal to either the project ID or project number.
resourceVersion string: - An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. They may only be valid for a particular resource or set of resources. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
selfLink string: - SelfLink is a URL representing this object.
uid string: - UID is a unique id generated by the server on successful creation of a resource and is not allowed to change on PUT operations. More info: http://kubernetes.io/docs/user-guide/identifiers#uids

annotations Dict[str, str]: Annotations is a key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. More info: http://kubernetes.io/docs/user-guide/annotations
generation float: - A sequence number representing a specific generation of the desired state.
labels Dict[str, str]: Map of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and routes. More info: http://kubernetes.io/docs/user-guide/labels
name str: Name of the environment variable.
namespace str: In Cloud Run the namespace must be equal to either the project ID or project number.
resourceVersion str: - An opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and the watch operation on a resource or set of resources. They may only be valid for a particular resource or set of resources. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
self_link str: - SelfLink is a URL representing this object.
uid str: - UID is a unique id generated by the server on successful creation of a resource and is not allowed to change on PUT operations. More info: http://kubernetes.io/docs/user-guide/identifiers#uids

ServiceTemplateSpec

ContainerConcurrency int

ContainerConcurrency specifies the maximum allowed in-flight (concurrent) requests per container of the Revision. Values are: - 0 thread-safe, the system should manage the max concurrency. This is the default value. - 1 not-thread-safe. Single concurrency - 2-N thread-safe, max concurrency of N

Containers List<ServiceTemplateSpecContainerArgs>

Container defines the unit of execution for this Revision. In the context of a Revision, we disallow a number of the fields of this Container, including: name, ports, and volumeMounts. The runtime contract is documented here: https://github.com/knative/serving/blob/master/docs/runtime-contract.md Structure is documented below.

ServiceAccountName 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.

ServingState string

- ServingState holds a value describing the state the resources are in for this Revision. It is expected that the system will manipulate this based on routability and load.

Deprecated: Not supported by Cloud Run fully managed

TimeoutSeconds int

TimeoutSeconds holds the max duration the instance is allowed for responding to a request.

ContainerConcurrency int

Containers []ServiceTemplateSpecContainer

ServiceAccountName string

ServingState string

- ServingState holds a value describing the state the resources are in for this Revision. It is expected that the system will manipulate this based on routability and load.

Deprecated: Not supported by Cloud Run fully managed

TimeoutSeconds int

TimeoutSeconds holds the max duration the instance is allowed for responding to a request.

containerConcurrency number

containers ServiceTemplateSpecContainer[]

serviceAccountName string

servingState string

- ServingState holds a value describing the state the resources are in for this Revision. It is expected that the system will manipulate this based on routability and load.

Deprecated: Not supported by Cloud Run fully managed

timeoutSeconds number

TimeoutSeconds holds the max duration the instance is allowed for responding to a request.

containerConcurrency float

containers List[ServiceTemplateSpecContainer]

service_account_name str

servingState str

- ServingState holds a value describing the state the resources are in for this Revision. It is expected that the system will manipulate this based on routability and load.

Deprecated: Not supported by Cloud Run fully managed

timeoutSeconds float

TimeoutSeconds holds the max duration the instance is allowed for responding to a request.

ServiceTemplateSpecContainer

Image string

Docker image name. This is most often a reference to a container located in the container registry, such as gcr.io/cloudrun/hello More info: https://kubernetes.io/docs/concepts/containers/images

Args 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

Commands 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

EnvFroms List<ServiceTemplateSpecContainerEnvFromArgs>

- (Optional, Deprecated) List of sources to populate environment variables in the container. All invalid keys will be reported as an event when the container is starting. When a key exists in multiple sources, the value associated with the last source will take precedence. Values defined by an Env with a duplicate key will take precedence. Structure is documented below.

Deprecated: Not supported by Cloud Run fully managed

Envs List<ServiceTemplateSpecContainerEnvArgs>

List of environment variables to set in the container. Structure is documented below.

Resources ServiceTemplateSpecContainerResourcesArgs

Compute Resources required by this container. Used to set values such as max memory More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources Structure is documented below.

WorkingDir string

- (Optional, Deprecated) Container’s working directory. If not specified, the container runtime’s default will be used, which might be configured in the container image.

Deprecated: Not supported by Cloud Run fully managed

Image string

Docker image name. This is most often a reference to a container located in the container registry, such as gcr.io/cloudrun/hello More info: https://kubernetes.io/docs/concepts/containers/images

Args []string

Commands []string

EnvFroms []ServiceTemplateSpecContainerEnvFrom

Deprecated: Not supported by Cloud Run fully managed

Envs []ServiceTemplateSpecContainerEnv

List of environment variables to set in the container. Structure is documented below.

Resources ServiceTemplateSpecContainerResources

Compute Resources required by this container. Used to set values such as max memory More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources Structure is documented below.

WorkingDir string

- (Optional, Deprecated) Container’s working directory. If not specified, the container runtime’s default will be used, which might be configured in the container image.

Deprecated: Not supported by Cloud Run fully managed

image string

Docker image name. This is most often a reference to a container located in the container registry, such as gcr.io/cloudrun/hello More info: https://kubernetes.io/docs/concepts/containers/images

args string[]

commands string[]

envFroms ServiceTemplateSpecContainerEnvFrom[]

Deprecated: Not supported by Cloud Run fully managed

envs ServiceTemplateSpecContainerEnv[]

List of environment variables to set in the container. Structure is documented below.

resources ServiceTemplateSpecContainerResources

Compute Resources required by this container. Used to set values such as max memory More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources Structure is documented below.

workingDir string

- (Optional, Deprecated) Container’s working directory. If not specified, the container runtime’s default will be used, which might be configured in the container image.

Deprecated: Not supported by Cloud Run fully managed

image str

Docker image name. This is most often a reference to a container located in the container registry, such as gcr.io/cloudrun/hello More info: https://kubernetes.io/docs/concepts/containers/images

args List[str]

commands List[str]

envFroms List[ServiceTemplateSpecContainerEnvFrom]

Deprecated: Not supported by Cloud Run fully managed

envs List[ServiceTemplateSpecContainerEnv]

List of environment variables to set in the container. Structure is documented below.

resources Dict[ServiceTemplateSpecContainerResources]

Compute Resources required by this container. Used to set values such as max memory More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources Structure is documented below.

workingDir str

- (Optional, Deprecated) Container’s working directory. If not specified, the container runtime’s default will be used, which might be configured in the container image.

Deprecated: Not supported by Cloud Run fully managed

ServiceTemplateSpecContainerEnv

Name string: Name of the environment variable.
Value 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 “”.

Name string: Name of the environment variable.
Value 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 “”.

name string: Name of the environment variable.
value 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 “”.

name str: Name of the environment variable.
value str: 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 “”.

ServiceTemplateSpecContainerEnvFrom

ConfigMapRef ServiceTemplateSpecContainerEnvFromConfigMapRefArgs: The ConfigMap to select from. Structure is documented below.
Prefix string: An optional identifier to prepend to each key in the ConfigMap.
SecretRef ServiceTemplateSpecContainerEnvFromSecretRefArgs: The Secret to select from. Structure is documented below.

ConfigMapRef ServiceTemplateSpecContainerEnvFromConfigMapRef: The ConfigMap to select from. Structure is documented below.
Prefix string: An optional identifier to prepend to each key in the ConfigMap.
SecretRef ServiceTemplateSpecContainerEnvFromSecretRef: The Secret to select from. Structure is documented below.

configMapRef ServiceTemplateSpecContainerEnvFromConfigMapRef: The ConfigMap to select from. Structure is documented below.
prefix string: An optional identifier to prepend to each key in the ConfigMap.
secretRef ServiceTemplateSpecContainerEnvFromSecretRef: The Secret to select from. Structure is documented below.

configMapRef Dict[ServiceTemplateSpecContainerEnvFromConfigMapRef]: The ConfigMap to select from. Structure is documented below.
prefix str: An optional identifier to prepend to each key in the ConfigMap.
secretRef Dict[ServiceTemplateSpecContainerEnvFromSecretRef]: The Secret to select from. Structure is documented below.

ServiceTemplateSpecContainerEnvFromConfigMapRef

LocalObjectReference ServiceTemplateSpecContainerEnvFromConfigMapRefLocalObjectReferenceArgs: The Secret to select from. Structure is documented below.
Optional bool: Specify whether the Secret must be defined

LocalObjectReference ServiceTemplateSpecContainerEnvFromConfigMapRefLocalObjectReference: The Secret to select from. Structure is documented below.
Optional bool: Specify whether the Secret must be defined

localObjectReference ServiceTemplateSpecContainerEnvFromConfigMapRefLocalObjectReference: The Secret to select from. Structure is documented below.
optional boolean: Specify whether the Secret must be defined

localObjectReference Dict[ServiceTemplateSpecContainerEnvFromConfigMapRefLocalObjectReference]: The Secret to select from. Structure is documented below.
optional bool: Specify whether the Secret must be defined

ServiceTemplateSpecContainerEnvFromConfigMapRefLocalObjectReference

Name string: Name of the environment variable.

Name string: Name of the environment variable.

name string: Name of the environment variable.

name str: Name of the environment variable.

ServiceTemplateSpecContainerEnvFromSecretRef

LocalObjectReference ServiceTemplateSpecContainerEnvFromSecretRefLocalObjectReferenceArgs: The Secret to select from. Structure is documented below.
Optional bool: Specify whether the Secret must be defined

LocalObjectReference ServiceTemplateSpecContainerEnvFromSecretRefLocalObjectReference: The Secret to select from. Structure is documented below.
Optional bool: Specify whether the Secret must be defined

localObjectReference ServiceTemplateSpecContainerEnvFromSecretRefLocalObjectReference: The Secret to select from. Structure is documented below.
optional boolean: Specify whether the Secret must be defined

localObjectReference Dict[ServiceTemplateSpecContainerEnvFromSecretRefLocalObjectReference]: The Secret to select from. Structure is documented below.
optional bool: Specify whether the Secret must be defined

ServiceTemplateSpecContainerEnvFromSecretRefLocalObjectReference

Name string: Name of the environment variable.

Name string: Name of the environment variable.

name string: Name of the environment variable.

name str: Name of the environment variable.

ServiceTemplateSpecContainerResources

Limits Dictionary<string, string>: Limits describes the maximum amount of compute resources allowed. 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
Requests Dictionary<string, string>: Requests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. 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

Limits map[string]string: Limits describes the maximum amount of compute resources allowed. 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
Requests map[string]string: Requests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. 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

limits {[key: string]: string}: Limits describes the maximum amount of compute resources allowed. 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
requests {[key: string]: string}: Requests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. 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

limits Dict[str, str]: Limits describes the maximum amount of compute resources allowed. 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
requests Dict[str, str]: Requests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an implementation-defined value. 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

ServiceTraffic

Percent int: Percent specifies percent of the traffic to this Revision or Configuration.
LatestRevision bool: LatestRevision may be optionally provided to indicate that the latest ready Revision of the Configuration should be used for this traffic target. When provided LatestRevision must be true if RevisionName is empty; it must be false when RevisionName is non-empty.
RevisionName string: RevisionName of a specific revision to which to send this portion of traffic.

Percent int: Percent specifies percent of the traffic to this Revision or Configuration.
LatestRevision bool: LatestRevision may be optionally provided to indicate that the latest ready Revision of the Configuration should be used for this traffic target. When provided LatestRevision must be true if RevisionName is empty; it must be false when RevisionName is non-empty.
RevisionName string: RevisionName of a specific revision to which to send this portion of traffic.

percent number: Percent specifies percent of the traffic to this Revision or Configuration.
latestRevision boolean: LatestRevision may be optionally provided to indicate that the latest ready Revision of the Configuration should be used for this traffic target. When provided LatestRevision must be true if RevisionName is empty; it must be false when RevisionName is non-empty.
revisionName string: RevisionName of a specific revision to which to send this portion of traffic.

percent float: Percent specifies percent of the traffic to this Revision or Configuration.
latestRevision bool: LatestRevision may be optionally provided to indicate that the latest ready Revision of the Configuration should be used for this traffic target. When provided LatestRevision must be true if RevisionName is empty; it must be false when RevisionName is non-empty.
revisionName str: RevisionName of a specific revision to which to send this portion of traffic.

Package Details

Repository: https://github.com/pulumi/pulumi-gcp
License: Apache-2.0
Notes: This Pulumi package is based on the google-beta Terraform Provider.

The Pulumi Platform

Get Started

Migrate to Pulumi

Solutions for All Teams and Engineers

Any Code

Any Cloud

Service

Create a Service Resource

Service Resource Properties

Inputs

Outputs

Look up an Existing Service Resource

Supporting Types

ServiceMetadata

ServiceStatus

ServiceStatusCondition

ServiceTemplate

ServiceTemplateMetadata

ServiceTemplateSpec

ServiceTemplateSpecContainer

ServiceTemplateSpecContainerEnv

ServiceTemplateSpecContainerEnvFrom

ServiceTemplateSpecContainerEnvFromConfigMapRef

ServiceTemplateSpecContainerEnvFromConfigMapRefLocalObjectReference

ServiceTemplateSpecContainerEnvFromSecretRef

ServiceTemplateSpecContainerEnvFromSecretRefLocalObjectReference

ServiceTemplateSpecContainerResources

ServiceTraffic

Package Details

On This Page