blob: 2ab87943b4e0d92a5a9893b1a9b70c6d741e3e1d [file] [log] [blame]
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="run_v1alpha1.html">Cloud Run API</a> . <a href="run_v1alpha1.namespaces.html">namespaces</a> . <a href="run_v1alpha1.namespaces.revisions.html">revisions</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#delete">delete(name, kind=None, propagationPolicy=None, orphanDependents=None, apiVersion=None, x__xgafv=None)</a></code></p>
79<p class="firstline">Rpc to delete a revision.</p>
80<p class="toc_element">
81 <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
82<p class="firstline">Rpc to get information about a revision.</p>
83<p class="toc_element">
84 <code><a href="#list">list(parent, labelSelector=None, includeUninitialized=None, x__xgafv=None, resourceVersion=None, limit=None, watch=None, continue=None, fieldSelector=None)</a></code></p>
85<p class="firstline">Rpc to list revisions.</p>
86<h3>Method Details</h3>
87<div class="method">
88 <code class="details" id="delete">delete(name, kind=None, propagationPolicy=None, orphanDependents=None, apiVersion=None, x__xgafv=None)</code>
89 <pre>Rpc to delete a revision.
90
91Args:
92 name: string, The name of the revision being deleted. If needed, replace
93{namespace_id} with the project ID. (required)
94 kind: string, Cloud Run currently ignores this parameter.
95 propagationPolicy: string, Specifies the propagation policy of delete. Cloud Run currently ignores
96this setting, and deletes in the background. Please see
97kubernetes.io/docs/concepts/workloads/controllers/garbage-collection/ for
98more information.
99 orphanDependents: boolean, Deprecated.
100Specifies the cascade behavior on delete.
101Cloud Run only supports cascading behavior, so this must be false.
102This attribute is deprecated, and is now replaced with PropagationPolicy
103See https://github.com/kubernetes/kubernetes/issues/46659 for more info.
104 apiVersion: string, Cloud Run currently ignores this parameter.
105 x__xgafv: string, V1 error format.
106 Allowed values
107 1 - v1 error format
108 2 - v2 error format
109
110Returns:
111 An object of the form:
112
113 { # A generic empty message that you can re-use to avoid defining duplicated
114 # empty messages in your APIs. A typical example is to use it as the request
115 # or the response type of an API method. For instance:
116 #
117 # service Foo {
118 # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
119 # }
120 #
121 # The JSON representation for `Empty` is empty JSON object `{}`.
122 }</pre>
123</div>
124
125<div class="method">
126 <code class="details" id="get">get(name, x__xgafv=None)</code>
127 <pre>Rpc to get information about a revision.
128
129Args:
130 name: string, The name of the revision being retrieved. If needed, replace
131{namespace_id} with the project ID. (required)
132 x__xgafv: string, V1 error format.
133 Allowed values
134 1 - v1 error format
135 2 - v2 error format
136
137Returns:
138 An object of the form:
139
140 { # Revision is an immutable snapshot of code and configuration. A revision
141 # references a container image. Revisions are created by updates to a
142 # Configuration.
143 #
144 # Cloud Run does not currently support referencing a build that is responsible
145 # for materializing the container image from source.
146 #
147 # See also:
148 # https://github.com/knative/serving/blob/master/docs/spec/overview.md#revision
149 "status": { # RevisionStatus communicates the observed state of the Revision (from the # Status communicates the observed state of the Revision (from the
150 # controller).
151 # controller).
152 "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Revision that
153 # was last processed by the controller.
154 #
155 # Clients polling for completed reconciliation should poll until
156 # observedGeneration = metadata.generation, and the Ready condition's status
157 # is True or False.
158 "imageDigest": "A String", # ImageDigest holds the resolved digest for the image specified
159 # within .Spec.Container.Image. The digest is resolved during the creation
160 # of Revision. This field holds the digest value regardless of whether
161 # a tag or digest was originally specified in the Container object.
162 "serviceName": "A String", # Not currently used by Cloud Run.
163 "conditions": [ # Conditions communicates information about ongoing/complete
164 # reconciliation processes that bring the "spec" inline with the observed
165 # state of the world.
166 #
167 # As a Revision is being prepared, it will incrementally
168 # update conditions "ResourcesAvailable", "ContainerHealthy", and "Active",
169 # which contribute to the overall "Ready" condition.
170 { # RevisionCondition defines a readiness condition for a Revision.
171 "status": "A String", # Status of the condition, one of True, False, Unknown.
172 "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info
173 # +optional
174 "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another.
175 # +optional
176 "reason": "A String", # One-word CamelCase reason for the condition's last transition.
177 # +optional
178 "message": "A String", # Human readable message indicating details about the current status.
179 # +optional
180 "type": "A String", # RevisionConditionType is used to communicate the status of the
181 # reconciliation process. See also:
182 # https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting
183 # Types include:
184 #
185 # * "Ready": True when the Revision is ready.
186 # * "ResourcesAvailable": True when underlying resources have been
187 # provisioned.
188 # * "ContainerHealthy": True when the Revision readiness check completes.
189 # * "Active": True when the Revision may receive traffic.
190 },
191 ],
192 "logUrl": "A String", # Specifies the generated logging url for this particular revision
193 # based on the revision url template specified in the controller's config.
194 # +optional
195 },
196 "kind": "A String", # The kind of this resource, in this case "Revision".
197 "spec": { # RevisionSpec holds the desired state of the Revision (from the client). # Spec holds the desired state of the Revision (from the client).
198 "container": { # A single application container. # Container defines the unit of execution for this Revision.
199 # In the context of a Revision, we disallow a number of the fields of
200 # this Container, including: name, ports, and volumeMounts.
201 # The runtime contract is documented here:
202 # https://github.com/knative/serving/blob/master/docs/runtime-contract.md
203 # This specifies both the container to run, the command to run in the container
204 # and the arguments to supply to it.
205 # Note that additional arguments may be supplied by the system to the container
206 # at runtime.
Dan O'Mearadd494642020-05-01 07:42:23 -0700207 "livenessProbe": { # Probe describes a health check to be performed against a container to # Periodic probe of container liveness.
208 # Container will be restarted if the probe fails.
209 # Cannot be updated.
210 # More info:
211 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
212 # +optional
213 # determine whether it is alive or ready to receive traffic.
214 "timeoutSeconds": 42, # Number of seconds after which the probe times out.
215 # Defaults to 1 second. Minimum value is 1.
216 # More info:
217 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
218 # +optional
219 "initialDelaySeconds": 42, # Number of seconds after the container has started before liveness probes
220 # are initiated. More info:
221 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
222 # +optional
223 "handler": { # Handler defines a specific action that should be taken # The action taken to determine the health of a container
224 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
225 # TCP hooks not yet supported
226 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
227 # +optional
228 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
229 # Number must be in the range 1 to 65535.
230 # Name must be an IANA_SVC_NAME.
231 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
232 # inner type. This allows you to have, for example, a JSON field that can
233 # accept a name or number.
234 "strVal": "A String", # The string value.
235 "type": 42, # The type of the value.
236 "intVal": 42, # The int value.
237 },
238 },
239 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
240 # +optional
241 "path": "A String", # Path to access on the HTTP server.
242 # +optional
243 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
244 # "Host" in httpHeaders instead.
245 # +optional
246 "scheme": "A String", # Scheme to use for connecting to the host.
247 # Defaults to HTTP.
248 # +optional
249 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
250 # Number must be in the range 1 to 65535.
251 # Name must be an IANA_SVC_NAME.
252 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
253 # inner type. This allows you to have, for example, a JSON field that can
254 # accept a name or number.
255 "strVal": "A String", # The string value.
256 "type": 42, # The type of the value.
257 "intVal": 42, # The int value.
258 },
259 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
260 # +optional
261 { # HTTPHeader describes a custom header to be used in HTTP probes
262 "name": "A String", # The header field name
263 "value": "A String", # The header field value
264 },
265 ],
266 },
267 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
268 # Exec specifies the action to take.
269 # +optional
270 "command": "A String", # Command is the command line to execute inside the container, the working
271 # directory for the command is root ('/') in the container's filesystem. The
272 # command is simply exec'd, it is not run inside a shell, so traditional
273 # shell instructions ('|', etc) won't work. To use a shell, you need to
274 # explicitly call out to that shell. Exit status of 0 is treated as
275 # live/healthy and non-zero is unhealthy. +optional
276 },
277 },
278 "periodSeconds": 42, # How often (in seconds) to perform the probe.
279 # Default to 10 seconds. Minimum value is 1.
280 # +optional
281 "successThreshold": 42, # Minimum consecutive successes for the probe to be considered successful
282 # after having failed. Defaults to 1. Must be 1 for liveness. Minimum value
283 # is 1. +optional
284 "failureThreshold": 42, # Minimum consecutive failures for the probe to be considered failed after
285 # having succeeded. Defaults to 3. Minimum value is 1. +optional
286 },
287 "args": [ # Arguments to the entrypoint.
288 # The docker image's CMD is used if this is not provided.
289 # Variable references $(VAR_NAME) are expanded using the container's
290 # environment. If a variable cannot be resolved, the reference in the input
291 # string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
292 # double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
293 # regardless of whether the variable exists or not.
294 # Cannot be updated.
295 # More info:
296 # https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
297 # +optional
298 "A String",
299 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700300 "securityContext": { # SecurityContext holds security configuration that will be applied to a # Security options the pod should run with.
301 # More info: https://kubernetes.io/docs/concepts/policy/security-context/
302 # More info:
303 # https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
304 # +optional
305 # container. Some fields are present in both SecurityContext and
306 # PodSecurityContext. When both are set, the values in SecurityContext take
307 # precedence.
308 "readOnlyRootFilesystem": True or False, # Whether this container has a read-only root filesystem.
309 # Default is false.
310 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -0700311 "runAsGroup": 42, # The GID to run the entrypoint of the container process.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700312 # Uses runtime default if unset.
313 # May also be set in PodSecurityContext. If set in both SecurityContext and
314 # PodSecurityContext, the value specified in SecurityContext takes
315 # precedence. +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700316 "allowPrivilegeEscalation": True or False, # AllowPrivilegeEscalation controls whether a process can gain more
317 # privileges than its parent process. This bool directly controls if
318 # the no_new_privs flag will be set on the container process.
319 # AllowPrivilegeEscalation is true always when the container is:
320 # 1) run as Privileged
321 # 2) has CAP_SYS_ADMIN
322 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -0700323 "runAsUser": 42, # The UID to run the entrypoint of the container process.
324 # Defaults to user specified in image metadata if unspecified.
325 # May also be set in PodSecurityContext. If set in both SecurityContext and
326 # PodSecurityContext, the value specified in SecurityContext takes
327 # precedence. +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700328 "capabilities": { # Adds and removes POSIX capabilities from running containers. # The capabilities to add/drop when running containers.
329 # Defaults to the default set of capabilities granted by the container
330 # runtime. +optional
331 "add": [ # Added capabilities
332 # +optional
333 "A String",
334 ],
335 "drop": [ # Removed capabilities
336 # +optional
337 "A String",
338 ],
339 },
340 "runAsNonRoot": True or False, # Indicates that the container must run as a non-root user.
341 # If true, the Kubelet will validate the image at runtime to ensure that it
342 # does not run as UID 0 (root) and fail to start the container if it does.
343 # If unset or false, no such validation will be performed.
344 # May also be set in PodSecurityContext. If set in both SecurityContext and
345 # PodSecurityContext, the value specified in SecurityContext takes
346 # precedence. +optional
347 "seLinuxOptions": { # SELinuxOptions are the labels to be applied to the container # The SELinux context to be applied to the container.
348 # If unspecified, the container runtime will allocate a random SELinux
349 # context for each container. May also be set in PodSecurityContext. If set
350 # in both SecurityContext and PodSecurityContext, the value specified in
351 # SecurityContext takes precedence. +optional
352 "role": "A String", # Role is a SELinux role label that applies to the container.
353 # +optional
354 "type": "A String", # Type is a SELinux type label that applies to the container.
355 # +optional
356 "user": "A String", # User is a SELinux user label that applies to the container.
357 # +optional
358 "level": "A String", # Level is SELinux level label that applies to the container.
359 # +optional
360 },
361 "privileged": True or False, # Run container in privileged mode.
362 # Processes in privileged containers are essentially equivalent to root on
363 # the host. Defaults to false. +optional
364 },
365 "name": "A String", # Name of the container specified as a DNS_LABEL.
366 # Each container must have a unique name (DNS_LABEL).
367 # Cannot be updated.
368 "envFrom": [ # List of sources to populate environment variables in the container.
369 # The keys defined within a source must be a C_IDENTIFIER. All invalid keys
370 # will be reported as an event when the container is starting. When a key
371 # exists in multiple sources, the value associated with the last source will
372 # take precedence. Values defined by an Env with a duplicate key will take
373 # precedence. Cannot be updated. +optional
374 { # EnvFromSource represents the source of a set of ConfigMaps
375 "secretRef": { # SecretEnvSource selects a Secret to populate the environment # The Secret to select from
376 # +optional
377 # variables with.
378 #
379 # The contents of the target Secret's Data field will represent the
380 # key-value pairs as environment variables.
Dan O'Mearadd494642020-05-01 07:42:23 -0700381 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
382 # directly into the message. Use the "name" field instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700383 # referenced object inside the same namespace.
384 "name": "A String", # Name of the referent.
385 # More info:
386 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
387 },
Dan O'Mearadd494642020-05-01 07:42:23 -0700388 "optional": True or False, # Cloud Run fully managed: not supported
389 #
390 # Cloud Run for Anthos: supported
391 #
392 # Specify whether the Secret must be defined
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700393 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -0700394 "name": "A String", # Cloud Run fully managed: not supported
395 #
396 # Cloud Run for Anthos: supported
397 #
398 # The Secret to select from.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700399 },
400 "configMapRef": { # ConfigMapEnvSource selects a ConfigMap to populate the environment # The ConfigMap to select from
401 # +optional
402 # variables with.
403 #
404 # The contents of the target ConfigMap's Data field will represent the
405 # key-value pairs as environment variables.
Dan O'Mearadd494642020-05-01 07:42:23 -0700406 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
407 # directly into the message. Use the "name" field instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700408 # referenced object inside the same namespace.
409 "name": "A String", # Name of the referent.
410 # More info:
411 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
412 },
Dan O'Mearadd494642020-05-01 07:42:23 -0700413 "optional": True or False, # Cloud Run fully managed: not supported
414 #
415 # Cloud Run for Anthos: supported
416 #
417 # Specify whether the ConfigMap must be defined
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700418 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -0700419 "name": "A String", # Cloud Run fully managed: not supported
420 #
421 # Cloud Run for Anthos: supported
422 #
423 # The ConfigMap to select from.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700424 },
425 "prefix": "A String", # An optional identifier to prepend to each key in the ConfigMap. Must be a
426 # C_IDENTIFIER. +optional
427 },
428 ],
Dan O'Mearadd494642020-05-01 07:42:23 -0700429 "stdinOnce": True or False, # Whether the container runtime should close the stdin channel after it has
430 # been opened by a single attach. When stdin is true the stdin stream will
431 # remain open across multiple attach sessions. If stdinOnce is set to true,
432 # stdin is opened on container start, is empty until the first client
433 # attaches to stdin, and then remains open and accepts data until the client
434 # disconnects, at which time stdin is closed and remains closed until the
435 # container is restarted. If this flag is false, a container processes that
436 # reads from stdin will never receive an EOF. Default is false +optional
437 "volumeDevices": [ # volumeDevices is the list of block devices to be used by the container.
438 # This is an alpha feature and may change in the future.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700439 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -0700440 { # volumeDevice describes a mapping of a raw block device within a container.
441 "devicePath": "A String", # devicePath is the path inside of the container that the device will be
442 # mapped to.
443 "name": "A String", # name must match the name of a persistentVolumeClaim in the pod
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700444 },
445 ],
Dan O'Mearadd494642020-05-01 07:42:23 -0700446 "stdin": True or False, # Whether this container should allocate a buffer for stdin in the container
447 # runtime. If this is not set, reads from stdin in the container will always
448 # result in EOF. Default is false. +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700449 "volumeMounts": [ # Pod volumes to mount into the container's filesystem.
450 # Cannot be updated.
451 # +optional
452 { # VolumeMount describes a mounting of a Volume within a container.
453 "readOnly": True or False, # Mounted read-only if true, read-write otherwise (false or unspecified).
454 # Defaults to false.
455 # +optional
456 "mountPropagation": "A String", # mountPropagation determines how mounts are propagated from the host
457 # to container and the other way around.
458 # When not set, MountPropagationHostToContainer is used.
459 # This field is beta in 1.10.
460 # +optional
461 "subPath": "A String", # Path within the volume from which the container's volume should be mounted.
462 # Defaults to "" (volume's root).
463 # +optional
464 "name": "A String", # This must match the Name of a Volume.
465 "mountPath": "A String", # Path within the container at which the volume should be mounted. Must
466 # not contain ':'.
467 },
468 ],
Dan O'Mearadd494642020-05-01 07:42:23 -0700469 "tty": True or False, # Whether this container should allocate a TTY for itself, also requires
470 # 'stdin' to be true. Default is false. +optional
471 "ports": [ # List of ports to expose from the container. Exposing a port here gives
472 # the system additional information about the network connections a
473 # container uses, but is primarily informational. Not specifying a port here
474 # DOES NOT prevent that port from being exposed. Any port which is
475 # listening on the default "0.0.0.0" address inside a container will be
476 # accessible from the network.
477 # Cannot be updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700478 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -0700479 { # ContainerPort represents a network port in a single container.
480 "protocol": "A String", # Protocol for port. Must be UDP or TCP.
481 # Defaults to "TCP".
482 # +optional
483 "hostIP": "A String", # What host IP to bind the external port to.
484 # +optional
485 "containerPort": 42, # Number of port to expose on the pod's IP address.
486 # This must be a valid port number, 0 &lt; x &lt; 65536.
487 "name": "A String", # If specified, this must be an IANA_SVC_NAME and unique within the pod. Each
488 # named port in a pod must have a unique name. Name for the port that can be
489 # referred to by services.
490 # +optional
491 "hostPort": 42, # Number of port to expose on the host.
492 # If specified, this must be a valid port number, 0 &lt; x &lt; 65536.
493 # If HostNetwork is specified, this must match ContainerPort.
494 # Most containers do not need this.
495 # +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700496 },
497 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700498 "terminationMessagePolicy": "A String", # Indicate how the termination message should be populated. File will use the
499 # contents of terminationMessagePath to populate the container status message
500 # on both success and failure. FallbackToLogsOnError will use the last chunk
501 # of container log output if the termination message file is empty and the
502 # container exited with an error. The log output is limited to 2048 bytes or
503 # 80 lines, whichever is smaller. Defaults to File. Cannot be updated.
504 # +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700505 "command": [ # Entrypoint array. Not executed within a shell.
506 # The docker image's ENTRYPOINT is used if this is not provided.
507 # Variable references $(VAR_NAME) are expanded using the container's
508 # environment. If a variable cannot be resolved, the reference in the input
509 # string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
510 # double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
511 # regardless of whether the variable exists or not.
512 # Cannot be updated.
513 # More info:
514 # https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
515 # +optional
516 "A String",
517 ],
Dan O'Mearadd494642020-05-01 07:42:23 -0700518 "env": [ # List of environment variables to set in the container.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700519 # Cannot be updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700520 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -0700521 { # EnvVar represents an environment variable present in a Container.
522 "valueFrom": { # Cloud Run fully managed: not supported # Cloud Run fully managed: not supported
523 #
524 # Cloud Run on GKE: supported
525 #
526 # Source for the environment variable's value. Cannot be used if value is not
527 # empty. +optional
528 #
529 # Cloud Run on GKE: supported
530 #
531 # EnvVarSource represents a source for the value of an EnvVar.
532 "secretKeyRef": { # Cloud Run fully managed: not supported # Cloud Run fully managed: not supported
533 #
534 # Cloud Run on GKE: supported
535 #
536 # Selects a key of a secret in the pod's namespace
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700537 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -0700538 #
539 # Cloud Run on GKE: supported
540 #
541 # SecretKeySelector selects a key of a Secret.
542 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
543 # directly into the message. Use the "name" field instead.
544 # referenced object inside the same namespace.
545 "name": "A String", # Name of the referent.
546 # More info:
547 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700548 },
Dan O'Mearadd494642020-05-01 07:42:23 -0700549 "optional": True or False, # Cloud Run fully managed: not supported
550 #
551 # Cloud Run on GKE: supported
552 #
553 # Specify whether the Secret or its key must be defined
554 # +optional
555 "name": "A String", # Cloud Run fully managed: not supported
556 #
557 # Cloud Run on GKE: supported
558 #
559 # The name of the secret in the pod's namespace to select from.
560 "key": "A String", # Cloud Run fully managed: not supported
561 #
562 # Cloud Run on GKE: supported
563 #
564 # The key of the secret to select from. Must be a valid secret key.
565 },
566 "configMapKeyRef": { # Cloud Run fully managed: not supported # Cloud Run fully managed: not supported
567 #
568 # Cloud Run on GKE: supported
569 #
570 # Selects a key of a ConfigMap.
571 # +optional
572 #
573 # Cloud Run on GKE: supported
574 #
575 # Selects a key from a ConfigMap.
576 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
577 # directly into the message. Use the "name" field instead.
578 # referenced object inside the same namespace.
579 "name": "A String", # Name of the referent.
580 # More info:
581 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
582 },
583 "optional": True or False, # Cloud Run fully managed: not supported
584 #
585 # Cloud Run on GKE: supported
586 #
587 # Specify whether the ConfigMap or its key must be defined
588 # +optional
589 "name": "A String", # Cloud Run fully managed: not supported
590 #
591 # Cloud Run on GKE: supported
592 #
593 # The ConfigMap to select from.
594 "key": "A String", # Cloud Run fully managed: not supported
595 #
596 # Cloud Run on GKE: supported
597 #
598 # The key to select.
599 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700600 },
Dan O'Mearadd494642020-05-01 07:42:23 -0700601 "name": "A String", # Name of the environment variable. Must be a C_IDENTIFIER.
602 "value": "A String", # Variable references $(VAR_NAME) are expanded
603 # using the previous defined environment variables in the container and
604 # any route environment variables. If a variable cannot be resolved,
605 # the reference in the input string will be unchanged. The $(VAR_NAME)
606 # syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped
607 # references will never be expanded, regardless of whether the variable
608 # exists or not.
609 # Defaults to "".
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700610 # +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700611 },
Dan O'Mearadd494642020-05-01 07:42:23 -0700612 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700613 "imagePullPolicy": "A String", # Image pull policy.
614 # One of Always, Never, IfNotPresent.
615 # Defaults to Always if :latest tag is specified, or IfNotPresent otherwise.
616 # Cannot be updated.
617 # More info:
618 # https://kubernetes.io/docs/concepts/containers/images#updating-images
619 # +optional
620 "readinessProbe": { # Probe describes a health check to be performed against a container to # Periodic probe of container service readiness.
621 # Container will be removed from service endpoints if the probe fails.
622 # Cannot be updated.
623 # More info:
624 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
625 # +optional
626 # determine whether it is alive or ready to receive traffic.
627 "timeoutSeconds": 42, # Number of seconds after which the probe times out.
628 # Defaults to 1 second. Minimum value is 1.
629 # More info:
630 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
631 # +optional
632 "initialDelaySeconds": 42, # Number of seconds after the container has started before liveness probes
633 # are initiated. More info:
634 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
635 # +optional
636 "handler": { # Handler defines a specific action that should be taken # The action taken to determine the health of a container
637 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
638 # TCP hooks not yet supported
639 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
640 # +optional
641 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
642 # Number must be in the range 1 to 65535.
643 # Name must be an IANA_SVC_NAME.
644 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
645 # inner type. This allows you to have, for example, a JSON field that can
646 # accept a name or number.
647 "strVal": "A String", # The string value.
Dan O'Mearadd494642020-05-01 07:42:23 -0700648 "type": 42, # The type of the value.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700649 "intVal": 42, # The int value.
650 },
651 },
652 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
653 # +optional
654 "path": "A String", # Path to access on the HTTP server.
655 # +optional
656 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
657 # "Host" in httpHeaders instead.
658 # +optional
659 "scheme": "A String", # Scheme to use for connecting to the host.
660 # Defaults to HTTP.
661 # +optional
662 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
663 # Number must be in the range 1 to 65535.
664 # Name must be an IANA_SVC_NAME.
665 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
666 # inner type. This allows you to have, for example, a JSON field that can
667 # accept a name or number.
668 "strVal": "A String", # The string value.
Dan O'Mearadd494642020-05-01 07:42:23 -0700669 "type": 42, # The type of the value.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700670 "intVal": 42, # The int value.
671 },
672 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
673 # +optional
674 { # HTTPHeader describes a custom header to be used in HTTP probes
675 "name": "A String", # The header field name
676 "value": "A String", # The header field value
677 },
678 ],
679 },
680 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
681 # Exec specifies the action to take.
682 # +optional
683 "command": "A String", # Command is the command line to execute inside the container, the working
684 # directory for the command is root ('/') in the container's filesystem. The
685 # command is simply exec'd, it is not run inside a shell, so traditional
686 # shell instructions ('|', etc) won't work. To use a shell, you need to
687 # explicitly call out to that shell. Exit status of 0 is treated as
688 # live/healthy and non-zero is unhealthy. +optional
689 },
690 },
691 "periodSeconds": 42, # How often (in seconds) to perform the probe.
692 # Default to 10 seconds. Minimum value is 1.
693 # +optional
694 "successThreshold": 42, # Minimum consecutive successes for the probe to be considered successful
695 # after having failed. Defaults to 1. Must be 1 for liveness. Minimum value
696 # is 1. +optional
697 "failureThreshold": 42, # Minimum consecutive failures for the probe to be considered failed after
698 # having succeeded. Defaults to 3. Minimum value is 1. +optional
699 },
700 "terminationMessagePath": "A String", # Optional: Path at which the file to which the container's termination
701 # message will be written is mounted into the container's filesystem. Message
702 # written is intended to be brief final status, such as an assertion failure
703 # message. Will be truncated by the node if greater than 4096 bytes. The
704 # total message length across all containers will be limited to 12kb.
705 # Defaults to /dev/termination-log.
706 # Cannot be updated.
707 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -0700708 "image": "A String", # Docker image name.
709 # More info: https://kubernetes.io/docs/concepts/containers/images
710 "lifecycle": { # Lifecycle describes actions that the management system should take in # Actions that the management system should take in response to container
711 # lifecycle events. Cannot be updated. +optional
712 # response to container lifecycle events. For the PostStart and PreStop
713 # lifecycle handlers, management of the container blocks until the action is
714 # complete, unless the container process fails, in which case the handler is
715 # aborted.
716 "preStop": { # Handler defines a specific action that should be taken # PreStop is called immediately before a container is terminated.
717 # The container is terminated after the handler completes.
718 # The reason for termination is passed to the handler.
719 # Regardless of the outcome of the handler, the container is eventually
720 # terminated. Other management of the container blocks until the hook
721 # completes. More info:
722 # https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
723 # +optional
724 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
725 # TCP hooks not yet supported
726 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
727 # +optional
728 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
729 # Number must be in the range 1 to 65535.
730 # Name must be an IANA_SVC_NAME.
731 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
732 # inner type. This allows you to have, for example, a JSON field that can
733 # accept a name or number.
734 "strVal": "A String", # The string value.
735 "type": 42, # The type of the value.
736 "intVal": 42, # The int value.
737 },
738 },
739 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700740 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -0700741 "path": "A String", # Path to access on the HTTP server.
742 # +optional
743 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
744 # "Host" in httpHeaders instead.
745 # +optional
746 "scheme": "A String", # Scheme to use for connecting to the host.
747 # Defaults to HTTP.
748 # +optional
749 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
750 # Number must be in the range 1 to 65535.
751 # Name must be an IANA_SVC_NAME.
752 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
753 # inner type. This allows you to have, for example, a JSON field that can
754 # accept a name or number.
755 "strVal": "A String", # The string value.
756 "type": 42, # The type of the value.
757 "intVal": 42, # The int value.
758 },
759 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
760 # +optional
761 { # HTTPHeader describes a custom header to be used in HTTP probes
762 "name": "A String", # The header field name
763 "value": "A String", # The header field value
764 },
765 ],
766 },
767 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
768 # Exec specifies the action to take.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700769 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -0700770 "command": "A String", # Command is the command line to execute inside the container, the working
771 # directory for the command is root ('/') in the container's filesystem. The
772 # command is simply exec'd, it is not run inside a shell, so traditional
773 # shell instructions ('|', etc) won't work. To use a shell, you need to
774 # explicitly call out to that shell. Exit status of 0 is treated as
775 # live/healthy and non-zero is unhealthy. +optional
776 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700777 },
Dan O'Mearadd494642020-05-01 07:42:23 -0700778 "postStart": { # Handler defines a specific action that should be taken # PostStart is called immediately after a container is created. If the
779 # handler fails, the container is terminated and restarted according to its
780 # restart policy. Other management of the container blocks until the hook
781 # completes. More info:
782 # https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
783 # +optional
784 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
785 # TCP hooks not yet supported
786 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
787 # +optional
788 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
789 # Number must be in the range 1 to 65535.
790 # Name must be an IANA_SVC_NAME.
791 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
792 # inner type. This allows you to have, for example, a JSON field that can
793 # accept a name or number.
794 "strVal": "A String", # The string value.
795 "type": 42, # The type of the value.
796 "intVal": 42, # The int value.
797 },
798 },
799 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
800 # +optional
801 "path": "A String", # Path to access on the HTTP server.
802 # +optional
803 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
804 # "Host" in httpHeaders instead.
805 # +optional
806 "scheme": "A String", # Scheme to use for connecting to the host.
807 # Defaults to HTTP.
808 # +optional
809 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
810 # Number must be in the range 1 to 65535.
811 # Name must be an IANA_SVC_NAME.
812 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
813 # inner type. This allows you to have, for example, a JSON field that can
814 # accept a name or number.
815 "strVal": "A String", # The string value.
816 "type": 42, # The type of the value.
817 "intVal": 42, # The int value.
818 },
819 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
820 # +optional
821 { # HTTPHeader describes a custom header to be used in HTTP probes
822 "name": "A String", # The header field name
823 "value": "A String", # The header field value
824 },
825 ],
826 },
827 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
828 # Exec specifies the action to take.
829 # +optional
830 "command": "A String", # Command is the command line to execute inside the container, the working
831 # directory for the command is root ('/') in the container's filesystem. The
832 # command is simply exec'd, it is not run inside a shell, so traditional
833 # shell instructions ('|', etc) won't work. To use a shell, you need to
834 # explicitly call out to that shell. Exit status of 0 is treated as
835 # live/healthy and non-zero is unhealthy. +optional
836 },
837 },
838 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700839 "resources": { # ResourceRequirements describes the compute resource requirements. # Compute Resources required by this container.
840 # Cannot be updated.
841 # More info:
842 # https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
843 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -0700844 "limitsInMap": { # Limits describes the maximum amount of compute resources allowed.
845 # This is a temporary field created to migrate away from the
846 # map&lt;string, Quantity&gt; limits field. This is done to become compliant
847 # with k8s style API.
848 # This field is deprecated in favor of limits field.
849 "a_key": { # The view model of a single quantity, e.g. "800 MiB". Corresponds to
850 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/generated.proto
851 "string": "A String", # Stringified version of the quantity, e.g., "800 MiB".
852 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700853 },
854 "requestsInMap": { # Requests describes the minimum amount of compute resources required.
855 # If Requests is omitted for a container, it defaults to Limits if that is
856 # explicitly specified, otherwise to an implementation-defined value.
857 # This is a temporary field created to migrate away from the
Dan O'Mearadd494642020-05-01 07:42:23 -0700858 # map&lt;string, Quantity&gt; requests field. This is done to become compliant
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700859 # with k8s style API.
860 # This field is deprecated in favor of requests field.
861 "a_key": { # The view model of a single quantity, e.g. "800 MiB". Corresponds to
862 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/generated.proto
863 "string": "A String", # Stringified version of the quantity, e.g., "800 MiB".
864 },
865 },
Dan O'Mearadd494642020-05-01 07:42:23 -0700866 "requests": { # Requests describes the minimum amount of compute resources required.
867 # If Requests is omitted for a container, it defaults to Limits if that is
868 # explicitly specified, otherwise to an implementation-defined value.
869 # The values of the map is string form of the 'quantity' k8s type:
870 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go
871 "a_key": "A String",
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700872 },
873 "limits": { # Limits describes the maximum amount of compute resources allowed.
874 # The values of the map is string form of the 'quantity' k8s type:
875 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go
876 "a_key": "A String",
877 },
878 },
879 "workingDir": "A String", # Container's working directory.
880 # If not specified, the container runtime's default will be used, which
881 # might be configured in the container image.
882 # Cannot be updated.
883 # +optional
884 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700885 "volumes": [
886 { # Volume represents a named volume in a container.
887 "configMap": { # Adapts a ConfigMap into a volume.
888 # The contents of the target ConfigMap's Data field will be presented in a
889 # volume as files using the keys in the Data field as the file names, unless
890 # the items element is populated with specific mappings of keys to paths.
891 "items": [ # If unspecified, each key-value pair in the Data field of the referenced
892 # Secret will be projected into the volume as a file whose name is the
893 # key and content is the value. If specified, the listed keys will be
894 # projected into the specified paths, and unlisted keys will not be
895 # present. If a key is specified which is not present in the Secret,
896 # the volume setup will error unless it is marked optional.
897 { # Maps a string key to a path within a volume.
898 "path": "A String", # The relative path of the file to map the key to.
899 # May not be an absolute path.
900 # May not contain the path element '..'.
901 # May not start with the string '..'.
902 "mode": 42, # Mode bits to use on this file, must be a value between 0 and 0777. If not
903 # specified, the volume defaultMode will be used. This might be in conflict
904 # with other options that affect the file mode, like fsGroup, and the result
905 # can be other mode bits set. +optional
906 "key": "A String", # The key to project.
907 },
908 ],
909 "optional": True or False, # Specify whether the Secret or its keys must be defined.
910 "name": "A String", # Name of the config.
911 "defaultMode": 42, # Mode bits to use on created files by default. Must be a value between 0 and
912 # 0777. Defaults to 0644. Directories within the path are not affected by
913 # this setting. This might be in conflict with other options that affect the
914 # file mode, like fsGroup, and the result can be other mode bits set.
915 },
916 "secret": { # The contents of the target Secret's Data field will be presented in a volume
917 # as files using the keys in the Data field as the file names.
918 "items": [ # If unspecified, each key-value pair in the Data field of the referenced
919 # Secret will be projected into the volume as a file whose name is the
920 # key and content is the value. If specified, the listed keys will be
921 # projected into the specified paths, and unlisted keys will not be
922 # present. If a key is specified which is not present in the Secret,
923 # the volume setup will error unless it is marked optional.
924 { # Maps a string key to a path within a volume.
925 "path": "A String", # The relative path of the file to map the key to.
926 # May not be an absolute path.
927 # May not contain the path element '..'.
928 # May not start with the string '..'.
929 "mode": 42, # Mode bits to use on this file, must be a value between 0 and 0777. If not
930 # specified, the volume defaultMode will be used. This might be in conflict
931 # with other options that affect the file mode, like fsGroup, and the result
932 # can be other mode bits set. +optional
933 "key": "A String", # The key to project.
934 },
935 ],
936 "optional": True or False, # Specify whether the Secret or its keys must be defined.
937 "defaultMode": 42, # Mode bits to use on created files by default. Must be a value between 0 and
938 # 0777. Defaults to 0644. Directories within the path are not affected by
939 # this setting. This might be in conflict with other options that affect the
940 # file mode, like fsGroup, and the result can be other mode bits set.
941 "secretName": "A String", # Name of the secret in the container's namespace to use.
942 },
943 "name": "A String", # Volume's name.
944 },
945 ],
Dan O'Mearadd494642020-05-01 07:42:23 -0700946 "timeoutSeconds": 42, # TimeoutSeconds holds the max duration the instance is allowed for
947 # responding to a request.
948 # Not currently used by Cloud Run.
949 "servingState": "A String", # ServingState holds a value describing the state the resources
950 # are in for this Revision.
951 # Users must not specify this when creating a revision. It is expected
952 # that the system will manipulate this based on routability and load.
953 #
954 # Populated by the system.
955 # Read-only.
956 "generation": 42, # Deprecated and not currently populated by Cloud Run. See
957 # metadata.generation instead, which is the sequence number containing the
958 # latest generation of the desired state.
959 #
960 # Read-only.
961 "concurrencyModel": "A String", # ConcurrencyModel specifies the desired concurrency model
962 # (Single or Multi) for the Revision. Defaults to Multi.
963 # Deprecated in favor of ContainerConcurrency.
964 # +optional
965 "containerConcurrency": 42, # (Optional)
966 #
967 # ContainerConcurrency specifies the maximum allowed in-flight (concurrent)
968 # requests per container instance of the Revision.
969 #
970 # Cloud Run fully managed: supported, defaults to 80
971 #
972 # Cloud Run on GKE: supported, defaults to 0, which means concurrency
973 # to the application is not limited, and the system decides the
974 # target concurrency for the autoscaler.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700975 "containers": [ # Containers holds the single container that defines the unit of execution
976 # for this Revision. In the context of a Revision, we disallow a number of
977 # fields on this Container, including: name and lifecycle.
Dan O'Mearadd494642020-05-01 07:42:23 -0700978 # In Cloud Run, only a single container may be provided.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700979 { # A single application container.
980 # This specifies both the container to run, the command to run in the container
981 # and the arguments to supply to it.
982 # Note that additional arguments may be supplied by the system to the container
983 # at runtime.
Dan O'Mearadd494642020-05-01 07:42:23 -0700984 "livenessProbe": { # Probe describes a health check to be performed against a container to # Periodic probe of container liveness.
985 # Container will be restarted if the probe fails.
986 # Cannot be updated.
987 # More info:
988 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
989 # +optional
990 # determine whether it is alive or ready to receive traffic.
991 "timeoutSeconds": 42, # Number of seconds after which the probe times out.
992 # Defaults to 1 second. Minimum value is 1.
993 # More info:
994 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
995 # +optional
996 "initialDelaySeconds": 42, # Number of seconds after the container has started before liveness probes
997 # are initiated. More info:
998 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
999 # +optional
1000 "handler": { # Handler defines a specific action that should be taken # The action taken to determine the health of a container
1001 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
1002 # TCP hooks not yet supported
1003 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
1004 # +optional
1005 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
1006 # Number must be in the range 1 to 65535.
1007 # Name must be an IANA_SVC_NAME.
1008 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
1009 # inner type. This allows you to have, for example, a JSON field that can
1010 # accept a name or number.
1011 "strVal": "A String", # The string value.
1012 "type": 42, # The type of the value.
1013 "intVal": 42, # The int value.
1014 },
1015 },
1016 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
1017 # +optional
1018 "path": "A String", # Path to access on the HTTP server.
1019 # +optional
1020 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
1021 # "Host" in httpHeaders instead.
1022 # +optional
1023 "scheme": "A String", # Scheme to use for connecting to the host.
1024 # Defaults to HTTP.
1025 # +optional
1026 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
1027 # Number must be in the range 1 to 65535.
1028 # Name must be an IANA_SVC_NAME.
1029 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
1030 # inner type. This allows you to have, for example, a JSON field that can
1031 # accept a name or number.
1032 "strVal": "A String", # The string value.
1033 "type": 42, # The type of the value.
1034 "intVal": 42, # The int value.
1035 },
1036 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
1037 # +optional
1038 { # HTTPHeader describes a custom header to be used in HTTP probes
1039 "name": "A String", # The header field name
1040 "value": "A String", # The header field value
1041 },
1042 ],
1043 },
1044 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
1045 # Exec specifies the action to take.
1046 # +optional
1047 "command": "A String", # Command is the command line to execute inside the container, the working
1048 # directory for the command is root ('/') in the container's filesystem. The
1049 # command is simply exec'd, it is not run inside a shell, so traditional
1050 # shell instructions ('|', etc) won't work. To use a shell, you need to
1051 # explicitly call out to that shell. Exit status of 0 is treated as
1052 # live/healthy and non-zero is unhealthy. +optional
1053 },
1054 },
1055 "periodSeconds": 42, # How often (in seconds) to perform the probe.
1056 # Default to 10 seconds. Minimum value is 1.
1057 # +optional
1058 "successThreshold": 42, # Minimum consecutive successes for the probe to be considered successful
1059 # after having failed. Defaults to 1. Must be 1 for liveness. Minimum value
1060 # is 1. +optional
1061 "failureThreshold": 42, # Minimum consecutive failures for the probe to be considered failed after
1062 # having succeeded. Defaults to 3. Minimum value is 1. +optional
1063 },
1064 "args": [ # Arguments to the entrypoint.
1065 # The docker image's CMD is used if this is not provided.
1066 # Variable references $(VAR_NAME) are expanded using the container's
1067 # environment. If a variable cannot be resolved, the reference in the input
1068 # string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
1069 # double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
1070 # regardless of whether the variable exists or not.
1071 # Cannot be updated.
1072 # More info:
1073 # https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
1074 # +optional
1075 "A String",
1076 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001077 "securityContext": { # SecurityContext holds security configuration that will be applied to a # Security options the pod should run with.
1078 # More info: https://kubernetes.io/docs/concepts/policy/security-context/
1079 # More info:
1080 # https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
1081 # +optional
1082 # container. Some fields are present in both SecurityContext and
1083 # PodSecurityContext. When both are set, the values in SecurityContext take
1084 # precedence.
1085 "readOnlyRootFilesystem": True or False, # Whether this container has a read-only root filesystem.
1086 # Default is false.
1087 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07001088 "runAsGroup": 42, # The GID to run the entrypoint of the container process.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001089 # Uses runtime default if unset.
1090 # May also be set in PodSecurityContext. If set in both SecurityContext and
1091 # PodSecurityContext, the value specified in SecurityContext takes
1092 # precedence. +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001093 "allowPrivilegeEscalation": True or False, # AllowPrivilegeEscalation controls whether a process can gain more
1094 # privileges than its parent process. This bool directly controls if
1095 # the no_new_privs flag will be set on the container process.
1096 # AllowPrivilegeEscalation is true always when the container is:
1097 # 1) run as Privileged
1098 # 2) has CAP_SYS_ADMIN
1099 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07001100 "runAsUser": 42, # The UID to run the entrypoint of the container process.
1101 # Defaults to user specified in image metadata if unspecified.
1102 # May also be set in PodSecurityContext. If set in both SecurityContext and
1103 # PodSecurityContext, the value specified in SecurityContext takes
1104 # precedence. +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001105 "capabilities": { # Adds and removes POSIX capabilities from running containers. # The capabilities to add/drop when running containers.
1106 # Defaults to the default set of capabilities granted by the container
1107 # runtime. +optional
1108 "add": [ # Added capabilities
1109 # +optional
1110 "A String",
1111 ],
1112 "drop": [ # Removed capabilities
1113 # +optional
1114 "A String",
1115 ],
1116 },
1117 "runAsNonRoot": True or False, # Indicates that the container must run as a non-root user.
1118 # If true, the Kubelet will validate the image at runtime to ensure that it
1119 # does not run as UID 0 (root) and fail to start the container if it does.
1120 # If unset or false, no such validation will be performed.
1121 # May also be set in PodSecurityContext. If set in both SecurityContext and
1122 # PodSecurityContext, the value specified in SecurityContext takes
1123 # precedence. +optional
1124 "seLinuxOptions": { # SELinuxOptions are the labels to be applied to the container # The SELinux context to be applied to the container.
1125 # If unspecified, the container runtime will allocate a random SELinux
1126 # context for each container. May also be set in PodSecurityContext. If set
1127 # in both SecurityContext and PodSecurityContext, the value specified in
1128 # SecurityContext takes precedence. +optional
1129 "role": "A String", # Role is a SELinux role label that applies to the container.
1130 # +optional
1131 "type": "A String", # Type is a SELinux type label that applies to the container.
1132 # +optional
1133 "user": "A String", # User is a SELinux user label that applies to the container.
1134 # +optional
1135 "level": "A String", # Level is SELinux level label that applies to the container.
1136 # +optional
1137 },
1138 "privileged": True or False, # Run container in privileged mode.
1139 # Processes in privileged containers are essentially equivalent to root on
1140 # the host. Defaults to false. +optional
1141 },
1142 "name": "A String", # Name of the container specified as a DNS_LABEL.
1143 # Each container must have a unique name (DNS_LABEL).
1144 # Cannot be updated.
1145 "envFrom": [ # List of sources to populate environment variables in the container.
1146 # The keys defined within a source must be a C_IDENTIFIER. All invalid keys
1147 # will be reported as an event when the container is starting. When a key
1148 # exists in multiple sources, the value associated with the last source will
1149 # take precedence. Values defined by an Env with a duplicate key will take
1150 # precedence. Cannot be updated. +optional
1151 { # EnvFromSource represents the source of a set of ConfigMaps
1152 "secretRef": { # SecretEnvSource selects a Secret to populate the environment # The Secret to select from
1153 # +optional
1154 # variables with.
1155 #
1156 # The contents of the target Secret's Data field will represent the
1157 # key-value pairs as environment variables.
Dan O'Mearadd494642020-05-01 07:42:23 -07001158 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
1159 # directly into the message. Use the "name" field instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001160 # referenced object inside the same namespace.
1161 "name": "A String", # Name of the referent.
1162 # More info:
1163 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
1164 },
Dan O'Mearadd494642020-05-01 07:42:23 -07001165 "optional": True or False, # Cloud Run fully managed: not supported
1166 #
1167 # Cloud Run for Anthos: supported
1168 #
1169 # Specify whether the Secret must be defined
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001170 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07001171 "name": "A String", # Cloud Run fully managed: not supported
1172 #
1173 # Cloud Run for Anthos: supported
1174 #
1175 # The Secret to select from.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001176 },
1177 "configMapRef": { # ConfigMapEnvSource selects a ConfigMap to populate the environment # The ConfigMap to select from
1178 # +optional
1179 # variables with.
1180 #
1181 # The contents of the target ConfigMap's Data field will represent the
1182 # key-value pairs as environment variables.
Dan O'Mearadd494642020-05-01 07:42:23 -07001183 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
1184 # directly into the message. Use the "name" field instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001185 # referenced object inside the same namespace.
1186 "name": "A String", # Name of the referent.
1187 # More info:
1188 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
1189 },
Dan O'Mearadd494642020-05-01 07:42:23 -07001190 "optional": True or False, # Cloud Run fully managed: not supported
1191 #
1192 # Cloud Run for Anthos: supported
1193 #
1194 # Specify whether the ConfigMap must be defined
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001195 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07001196 "name": "A String", # Cloud Run fully managed: not supported
1197 #
1198 # Cloud Run for Anthos: supported
1199 #
1200 # The ConfigMap to select from.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001201 },
1202 "prefix": "A String", # An optional identifier to prepend to each key in the ConfigMap. Must be a
1203 # C_IDENTIFIER. +optional
1204 },
1205 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07001206 "stdinOnce": True or False, # Whether the container runtime should close the stdin channel after it has
1207 # been opened by a single attach. When stdin is true the stdin stream will
1208 # remain open across multiple attach sessions. If stdinOnce is set to true,
1209 # stdin is opened on container start, is empty until the first client
1210 # attaches to stdin, and then remains open and accepts data until the client
1211 # disconnects, at which time stdin is closed and remains closed until the
1212 # container is restarted. If this flag is false, a container processes that
1213 # reads from stdin will never receive an EOF. Default is false +optional
1214 "volumeDevices": [ # volumeDevices is the list of block devices to be used by the container.
1215 # This is an alpha feature and may change in the future.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001216 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07001217 { # volumeDevice describes a mapping of a raw block device within a container.
1218 "devicePath": "A String", # devicePath is the path inside of the container that the device will be
1219 # mapped to.
1220 "name": "A String", # name must match the name of a persistentVolumeClaim in the pod
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001221 },
1222 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07001223 "stdin": True or False, # Whether this container should allocate a buffer for stdin in the container
1224 # runtime. If this is not set, reads from stdin in the container will always
1225 # result in EOF. Default is false. +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001226 "volumeMounts": [ # Pod volumes to mount into the container's filesystem.
1227 # Cannot be updated.
1228 # +optional
1229 { # VolumeMount describes a mounting of a Volume within a container.
1230 "readOnly": True or False, # Mounted read-only if true, read-write otherwise (false or unspecified).
1231 # Defaults to false.
1232 # +optional
1233 "mountPropagation": "A String", # mountPropagation determines how mounts are propagated from the host
1234 # to container and the other way around.
1235 # When not set, MountPropagationHostToContainer is used.
1236 # This field is beta in 1.10.
1237 # +optional
1238 "subPath": "A String", # Path within the volume from which the container's volume should be mounted.
1239 # Defaults to "" (volume's root).
1240 # +optional
1241 "name": "A String", # This must match the Name of a Volume.
1242 "mountPath": "A String", # Path within the container at which the volume should be mounted. Must
1243 # not contain ':'.
1244 },
1245 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07001246 "tty": True or False, # Whether this container should allocate a TTY for itself, also requires
1247 # 'stdin' to be true. Default is false. +optional
1248 "ports": [ # List of ports to expose from the container. Exposing a port here gives
1249 # the system additional information about the network connections a
1250 # container uses, but is primarily informational. Not specifying a port here
1251 # DOES NOT prevent that port from being exposed. Any port which is
1252 # listening on the default "0.0.0.0" address inside a container will be
1253 # accessible from the network.
1254 # Cannot be updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001255 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07001256 { # ContainerPort represents a network port in a single container.
1257 "protocol": "A String", # Protocol for port. Must be UDP or TCP.
1258 # Defaults to "TCP".
1259 # +optional
1260 "hostIP": "A String", # What host IP to bind the external port to.
1261 # +optional
1262 "containerPort": 42, # Number of port to expose on the pod's IP address.
1263 # This must be a valid port number, 0 &lt; x &lt; 65536.
1264 "name": "A String", # If specified, this must be an IANA_SVC_NAME and unique within the pod. Each
1265 # named port in a pod must have a unique name. Name for the port that can be
1266 # referred to by services.
1267 # +optional
1268 "hostPort": 42, # Number of port to expose on the host.
1269 # If specified, this must be a valid port number, 0 &lt; x &lt; 65536.
1270 # If HostNetwork is specified, this must match ContainerPort.
1271 # Most containers do not need this.
1272 # +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001273 },
1274 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001275 "terminationMessagePolicy": "A String", # Indicate how the termination message should be populated. File will use the
1276 # contents of terminationMessagePath to populate the container status message
1277 # on both success and failure. FallbackToLogsOnError will use the last chunk
1278 # of container log output if the termination message file is empty and the
1279 # container exited with an error. The log output is limited to 2048 bytes or
1280 # 80 lines, whichever is smaller. Defaults to File. Cannot be updated.
1281 # +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001282 "command": [ # Entrypoint array. Not executed within a shell.
1283 # The docker image's ENTRYPOINT is used if this is not provided.
1284 # Variable references $(VAR_NAME) are expanded using the container's
1285 # environment. If a variable cannot be resolved, the reference in the input
1286 # string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
1287 # double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
1288 # regardless of whether the variable exists or not.
1289 # Cannot be updated.
1290 # More info:
1291 # https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
1292 # +optional
1293 "A String",
1294 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07001295 "env": [ # List of environment variables to set in the container.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001296 # Cannot be updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001297 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07001298 { # EnvVar represents an environment variable present in a Container.
1299 "valueFrom": { # Cloud Run fully managed: not supported # Cloud Run fully managed: not supported
1300 #
1301 # Cloud Run on GKE: supported
1302 #
1303 # Source for the environment variable's value. Cannot be used if value is not
1304 # empty. +optional
1305 #
1306 # Cloud Run on GKE: supported
1307 #
1308 # EnvVarSource represents a source for the value of an EnvVar.
1309 "secretKeyRef": { # Cloud Run fully managed: not supported # Cloud Run fully managed: not supported
1310 #
1311 # Cloud Run on GKE: supported
1312 #
1313 # Selects a key of a secret in the pod's namespace
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001314 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07001315 #
1316 # Cloud Run on GKE: supported
1317 #
1318 # SecretKeySelector selects a key of a Secret.
1319 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
1320 # directly into the message. Use the "name" field instead.
1321 # referenced object inside the same namespace.
1322 "name": "A String", # Name of the referent.
1323 # More info:
1324 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001325 },
Dan O'Mearadd494642020-05-01 07:42:23 -07001326 "optional": True or False, # Cloud Run fully managed: not supported
1327 #
1328 # Cloud Run on GKE: supported
1329 #
1330 # Specify whether the Secret or its key must be defined
1331 # +optional
1332 "name": "A String", # Cloud Run fully managed: not supported
1333 #
1334 # Cloud Run on GKE: supported
1335 #
1336 # The name of the secret in the pod's namespace to select from.
1337 "key": "A String", # Cloud Run fully managed: not supported
1338 #
1339 # Cloud Run on GKE: supported
1340 #
1341 # The key of the secret to select from. Must be a valid secret key.
1342 },
1343 "configMapKeyRef": { # Cloud Run fully managed: not supported # Cloud Run fully managed: not supported
1344 #
1345 # Cloud Run on GKE: supported
1346 #
1347 # Selects a key of a ConfigMap.
1348 # +optional
1349 #
1350 # Cloud Run on GKE: supported
1351 #
1352 # Selects a key from a ConfigMap.
1353 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
1354 # directly into the message. Use the "name" field instead.
1355 # referenced object inside the same namespace.
1356 "name": "A String", # Name of the referent.
1357 # More info:
1358 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
1359 },
1360 "optional": True or False, # Cloud Run fully managed: not supported
1361 #
1362 # Cloud Run on GKE: supported
1363 #
1364 # Specify whether the ConfigMap or its key must be defined
1365 # +optional
1366 "name": "A String", # Cloud Run fully managed: not supported
1367 #
1368 # Cloud Run on GKE: supported
1369 #
1370 # The ConfigMap to select from.
1371 "key": "A String", # Cloud Run fully managed: not supported
1372 #
1373 # Cloud Run on GKE: supported
1374 #
1375 # The key to select.
1376 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001377 },
Dan O'Mearadd494642020-05-01 07:42:23 -07001378 "name": "A String", # Name of the environment variable. Must be a C_IDENTIFIER.
1379 "value": "A String", # Variable references $(VAR_NAME) are expanded
1380 # using the previous defined environment variables in the container and
1381 # any route environment variables. If a variable cannot be resolved,
1382 # the reference in the input string will be unchanged. The $(VAR_NAME)
1383 # syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped
1384 # references will never be expanded, regardless of whether the variable
1385 # exists or not.
1386 # Defaults to "".
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001387 # +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001388 },
Dan O'Mearadd494642020-05-01 07:42:23 -07001389 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001390 "imagePullPolicy": "A String", # Image pull policy.
1391 # One of Always, Never, IfNotPresent.
1392 # Defaults to Always if :latest tag is specified, or IfNotPresent otherwise.
1393 # Cannot be updated.
1394 # More info:
1395 # https://kubernetes.io/docs/concepts/containers/images#updating-images
1396 # +optional
1397 "readinessProbe": { # Probe describes a health check to be performed against a container to # Periodic probe of container service readiness.
1398 # Container will be removed from service endpoints if the probe fails.
1399 # Cannot be updated.
1400 # More info:
1401 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
1402 # +optional
1403 # determine whether it is alive or ready to receive traffic.
1404 "timeoutSeconds": 42, # Number of seconds after which the probe times out.
1405 # Defaults to 1 second. Minimum value is 1.
1406 # More info:
1407 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
1408 # +optional
1409 "initialDelaySeconds": 42, # Number of seconds after the container has started before liveness probes
1410 # are initiated. More info:
1411 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
1412 # +optional
1413 "handler": { # Handler defines a specific action that should be taken # The action taken to determine the health of a container
1414 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
1415 # TCP hooks not yet supported
1416 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
1417 # +optional
1418 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
1419 # Number must be in the range 1 to 65535.
1420 # Name must be an IANA_SVC_NAME.
1421 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
1422 # inner type. This allows you to have, for example, a JSON field that can
1423 # accept a name or number.
1424 "strVal": "A String", # The string value.
Dan O'Mearadd494642020-05-01 07:42:23 -07001425 "type": 42, # The type of the value.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001426 "intVal": 42, # The int value.
1427 },
1428 },
1429 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
1430 # +optional
1431 "path": "A String", # Path to access on the HTTP server.
1432 # +optional
1433 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
1434 # "Host" in httpHeaders instead.
1435 # +optional
1436 "scheme": "A String", # Scheme to use for connecting to the host.
1437 # Defaults to HTTP.
1438 # +optional
1439 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
1440 # Number must be in the range 1 to 65535.
1441 # Name must be an IANA_SVC_NAME.
1442 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
1443 # inner type. This allows you to have, for example, a JSON field that can
1444 # accept a name or number.
1445 "strVal": "A String", # The string value.
Dan O'Mearadd494642020-05-01 07:42:23 -07001446 "type": 42, # The type of the value.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001447 "intVal": 42, # The int value.
1448 },
1449 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
1450 # +optional
1451 { # HTTPHeader describes a custom header to be used in HTTP probes
1452 "name": "A String", # The header field name
1453 "value": "A String", # The header field value
1454 },
1455 ],
1456 },
1457 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
1458 # Exec specifies the action to take.
1459 # +optional
1460 "command": "A String", # Command is the command line to execute inside the container, the working
1461 # directory for the command is root ('/') in the container's filesystem. The
1462 # command is simply exec'd, it is not run inside a shell, so traditional
1463 # shell instructions ('|', etc) won't work. To use a shell, you need to
1464 # explicitly call out to that shell. Exit status of 0 is treated as
1465 # live/healthy and non-zero is unhealthy. +optional
1466 },
1467 },
1468 "periodSeconds": 42, # How often (in seconds) to perform the probe.
1469 # Default to 10 seconds. Minimum value is 1.
1470 # +optional
1471 "successThreshold": 42, # Minimum consecutive successes for the probe to be considered successful
1472 # after having failed. Defaults to 1. Must be 1 for liveness. Minimum value
1473 # is 1. +optional
1474 "failureThreshold": 42, # Minimum consecutive failures for the probe to be considered failed after
1475 # having succeeded. Defaults to 3. Minimum value is 1. +optional
1476 },
1477 "terminationMessagePath": "A String", # Optional: Path at which the file to which the container's termination
1478 # message will be written is mounted into the container's filesystem. Message
1479 # written is intended to be brief final status, such as an assertion failure
1480 # message. Will be truncated by the node if greater than 4096 bytes. The
1481 # total message length across all containers will be limited to 12kb.
1482 # Defaults to /dev/termination-log.
1483 # Cannot be updated.
1484 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07001485 "image": "A String", # Docker image name.
1486 # More info: https://kubernetes.io/docs/concepts/containers/images
1487 "lifecycle": { # Lifecycle describes actions that the management system should take in # Actions that the management system should take in response to container
1488 # lifecycle events. Cannot be updated. +optional
1489 # response to container lifecycle events. For the PostStart and PreStop
1490 # lifecycle handlers, management of the container blocks until the action is
1491 # complete, unless the container process fails, in which case the handler is
1492 # aborted.
1493 "preStop": { # Handler defines a specific action that should be taken # PreStop is called immediately before a container is terminated.
1494 # The container is terminated after the handler completes.
1495 # The reason for termination is passed to the handler.
1496 # Regardless of the outcome of the handler, the container is eventually
1497 # terminated. Other management of the container blocks until the hook
1498 # completes. More info:
1499 # https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
1500 # +optional
1501 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
1502 # TCP hooks not yet supported
1503 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
1504 # +optional
1505 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
1506 # Number must be in the range 1 to 65535.
1507 # Name must be an IANA_SVC_NAME.
1508 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
1509 # inner type. This allows you to have, for example, a JSON field that can
1510 # accept a name or number.
1511 "strVal": "A String", # The string value.
1512 "type": 42, # The type of the value.
1513 "intVal": 42, # The int value.
1514 },
1515 },
1516 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001517 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07001518 "path": "A String", # Path to access on the HTTP server.
1519 # +optional
1520 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
1521 # "Host" in httpHeaders instead.
1522 # +optional
1523 "scheme": "A String", # Scheme to use for connecting to the host.
1524 # Defaults to HTTP.
1525 # +optional
1526 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
1527 # Number must be in the range 1 to 65535.
1528 # Name must be an IANA_SVC_NAME.
1529 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
1530 # inner type. This allows you to have, for example, a JSON field that can
1531 # accept a name or number.
1532 "strVal": "A String", # The string value.
1533 "type": 42, # The type of the value.
1534 "intVal": 42, # The int value.
1535 },
1536 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
1537 # +optional
1538 { # HTTPHeader describes a custom header to be used in HTTP probes
1539 "name": "A String", # The header field name
1540 "value": "A String", # The header field value
1541 },
1542 ],
1543 },
1544 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
1545 # Exec specifies the action to take.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001546 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07001547 "command": "A String", # Command is the command line to execute inside the container, the working
1548 # directory for the command is root ('/') in the container's filesystem. The
1549 # command is simply exec'd, it is not run inside a shell, so traditional
1550 # shell instructions ('|', etc) won't work. To use a shell, you need to
1551 # explicitly call out to that shell. Exit status of 0 is treated as
1552 # live/healthy and non-zero is unhealthy. +optional
1553 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001554 },
Dan O'Mearadd494642020-05-01 07:42:23 -07001555 "postStart": { # Handler defines a specific action that should be taken # PostStart is called immediately after a container is created. If the
1556 # handler fails, the container is terminated and restarted according to its
1557 # restart policy. Other management of the container blocks until the hook
1558 # completes. More info:
1559 # https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
1560 # +optional
1561 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
1562 # TCP hooks not yet supported
1563 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
1564 # +optional
1565 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
1566 # Number must be in the range 1 to 65535.
1567 # Name must be an IANA_SVC_NAME.
1568 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
1569 # inner type. This allows you to have, for example, a JSON field that can
1570 # accept a name or number.
1571 "strVal": "A String", # The string value.
1572 "type": 42, # The type of the value.
1573 "intVal": 42, # The int value.
1574 },
1575 },
1576 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
1577 # +optional
1578 "path": "A String", # Path to access on the HTTP server.
1579 # +optional
1580 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
1581 # "Host" in httpHeaders instead.
1582 # +optional
1583 "scheme": "A String", # Scheme to use for connecting to the host.
1584 # Defaults to HTTP.
1585 # +optional
1586 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
1587 # Number must be in the range 1 to 65535.
1588 # Name must be an IANA_SVC_NAME.
1589 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
1590 # inner type. This allows you to have, for example, a JSON field that can
1591 # accept a name or number.
1592 "strVal": "A String", # The string value.
1593 "type": 42, # The type of the value.
1594 "intVal": 42, # The int value.
1595 },
1596 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
1597 # +optional
1598 { # HTTPHeader describes a custom header to be used in HTTP probes
1599 "name": "A String", # The header field name
1600 "value": "A String", # The header field value
1601 },
1602 ],
1603 },
1604 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
1605 # Exec specifies the action to take.
1606 # +optional
1607 "command": "A String", # Command is the command line to execute inside the container, the working
1608 # directory for the command is root ('/') in the container's filesystem. The
1609 # command is simply exec'd, it is not run inside a shell, so traditional
1610 # shell instructions ('|', etc) won't work. To use a shell, you need to
1611 # explicitly call out to that shell. Exit status of 0 is treated as
1612 # live/healthy and non-zero is unhealthy. +optional
1613 },
1614 },
1615 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001616 "resources": { # ResourceRequirements describes the compute resource requirements. # Compute Resources required by this container.
1617 # Cannot be updated.
1618 # More info:
1619 # https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
1620 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07001621 "limitsInMap": { # Limits describes the maximum amount of compute resources allowed.
1622 # This is a temporary field created to migrate away from the
1623 # map&lt;string, Quantity&gt; limits field. This is done to become compliant
1624 # with k8s style API.
1625 # This field is deprecated in favor of limits field.
1626 "a_key": { # The view model of a single quantity, e.g. "800 MiB". Corresponds to
1627 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/generated.proto
1628 "string": "A String", # Stringified version of the quantity, e.g., "800 MiB".
1629 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001630 },
1631 "requestsInMap": { # Requests describes the minimum amount of compute resources required.
1632 # If Requests is omitted for a container, it defaults to Limits if that is
1633 # explicitly specified, otherwise to an implementation-defined value.
1634 # This is a temporary field created to migrate away from the
Dan O'Mearadd494642020-05-01 07:42:23 -07001635 # map&lt;string, Quantity&gt; requests field. This is done to become compliant
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001636 # with k8s style API.
1637 # This field is deprecated in favor of requests field.
1638 "a_key": { # The view model of a single quantity, e.g. "800 MiB". Corresponds to
1639 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/generated.proto
1640 "string": "A String", # Stringified version of the quantity, e.g., "800 MiB".
1641 },
1642 },
Dan O'Mearadd494642020-05-01 07:42:23 -07001643 "requests": { # Requests describes the minimum amount of compute resources required.
1644 # If Requests is omitted for a container, it defaults to Limits if that is
1645 # explicitly specified, otherwise to an implementation-defined value.
1646 # The values of the map is string form of the 'quantity' k8s type:
1647 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go
1648 "a_key": "A String",
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001649 },
1650 "limits": { # Limits describes the maximum amount of compute resources allowed.
1651 # The values of the map is string form of the 'quantity' k8s type:
1652 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go
1653 "a_key": "A String",
1654 },
1655 },
1656 "workingDir": "A String", # Container's working directory.
1657 # If not specified, the container runtime's default will be used, which
1658 # might be configured in the container image.
1659 # Cannot be updated.
1660 # +optional
1661 },
1662 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07001663 "serviceAccountName": "A String", # Email address of the IAM service account associated with the revision
1664 # of the service. The service account represents the identity of the
1665 # running revision, and determines what permissions the revision has. If
1666 # not provided, the revision will use the project's default service account.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001667 },
Dan O'Mearadd494642020-05-01 07:42:23 -07001668 "apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1alpha1".
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001669 "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Revision, including name, namespace, labels,
1670 # and annotations.
1671 # all objects users must create.
1672 "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have
1673 # been deleted, this object will be garbage collected.
1674 # +optional
1675 { # OwnerReference contains enough information to let you identify an owning
1676 # object. Currently, an owning object must be in the same namespace, so there
1677 # is no namespace field.
1678 "kind": "A String", # Kind of the referent.
1679 # More info:
1680 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds
Dan O'Mearadd494642020-05-01 07:42:23 -07001681 "name": "A String", # Name of the referent.
1682 # More info: http://kubernetes.io/docs/user-guide/identifiers#names
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001683 "apiVersion": "A String", # API version of the referent.
1684 "controller": True or False, # If true, this reference points to the managing controller.
1685 # +optional
1686 "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then
1687 # the owner cannot be deleted from the key-value store until this
1688 # reference is removed.
1689 # Defaults to false.
1690 # To set this field, a user needs "delete" permission of the owner,
1691 # otherwise 422 (Unprocessable Entity) will be returned.
1692 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07001693 "uid": "A String", # UID of the referent.
1694 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001695 },
1696 ],
1697 "name": "A String", # Name must be unique within a namespace, within a Cloud Run region.
1698 # Is required when creating
1699 # resources, although some resources may allow a client to request the
1700 # generation of an appropriate name automatically. Name is primarily intended
1701 # for creation idempotence and configuration definition. Cannot be updated.
1702 # More info: http://kubernetes.io/docs/user-guide/identifiers#names
1703 # +optional
1704 "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be
1705 # deleted. This field is set by the server when a graceful deletion is
1706 # requested by the user, and is not directly settable by a client. The
1707 # resource is expected to be deleted (no longer visible from resource lists,
1708 # and not reachable by name) after the time in this field, once the
1709 # finalizers list is empty. As long as the finalizers list contains items,
1710 # deletion is blocked. Once the deletionTimestamp is set, this value may not
1711 # be unset or be set further into the future, although it may be shortened or
1712 # the resource may be deleted prior to this time. For example, a user may
1713 # request that a pod is deleted in 30 seconds. The Kubelet will react by
1714 # sending a graceful termination signal to the containers in the pod. After
1715 # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL)
1716 # to the container and after cleanup, remove the pod from the API. In the
1717 # presence of network partitions, this object may still exist after this
1718 # timestamp, until an administrator or automated process can determine the
1719 # resource is fully terminated.
1720 # If not set, graceful deletion of the object has not been requested.
1721 #
1722 # Populated by the system when a graceful deletion is requested.
1723 # Read-only.
1724 # More info:
1725 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata
1726 # +optional
1727 "clusterName": "A String", # Not currently supported by Cloud Run.
1728 #
1729 # The name of the cluster which the object belongs to.
1730 # This is used to distinguish resources with same name and namespace in
1731 # different clusters. This field is not set anywhere right now and apiserver
1732 # is going to ignore it if set in create or update request. +optional
1733 "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run.
1734 #
1735 # Number of seconds allowed for this object to gracefully terminate before
1736 # it will be removed from the system. Only set when deletionTimestamp is also
1737 # set. May only be shortened. Read-only. +optional
1738 "labels": { # Map of string keys and values that can be used to organize and categorize
1739 # (scope and select) objects. May match selectors of replication controllers
1740 # and routes.
1741 # More info: http://kubernetes.io/docs/user-guide/labels
1742 # +optional
1743 "a_key": "A String",
1744 },
1745 "namespace": "A String", # Namespace defines the space within each name must be unique, within a
1746 # Cloud Run region. In Cloud Run the namespace must be equal to either the
1747 # project ID or project number.
1748 "generation": 42, # A sequence number representing a specific generation of the desired state.
1749 # Populated by the system. Read-only.
1750 # +optional
1751 "finalizers": [ # Not currently supported by Cloud Run.
1752 #
1753 # Must be empty before the object is deleted from the registry. Each entry
1754 # is an identifier for the responsible component that will remove the entry
1755 # from the list. If the deletionTimestamp of the object is non-nil, entries
1756 # in this list can only be removed.
1757 # +optional
1758 # +patchStrategy=merge
1759 "A String",
1760 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001761 "resourceVersion": "A String", # An opaque value that represents the internal version of this object that
1762 # can be used by clients to determine when objects have changed. May be used
1763 # for optimistic concurrency, change detection, and the watch operation on a
1764 # resource or set of resources. Clients must treat these values as opaque and
1765 # passed unmodified back to the server. They may only be valid for a
1766 # particular resource or set of resources.
1767 #
1768 # Populated by the system.
1769 # Read-only.
1770 # Value must be treated as opaque by clients and .
1771 # More info:
1772 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
1773 # +optional
1774 "generateName": "A String", # Not currently supported by Cloud Run.
1775 #
1776 # GenerateName is an optional prefix, used by the server, to generate a
1777 # unique name ONLY IF the Name field has not been provided. If this field is
1778 # used, the name returned to the client will be different than the name
1779 # passed. This value will also be combined with a unique suffix. The provided
1780 # value has the same validation rules as the Name field, and may be truncated
1781 # by the length of the suffix required to make the value unique on the
1782 # server.
1783 #
1784 # If this field is specified and the generated name exists, the server will
1785 # NOT return a 409 - instead, it will either return 201 Created or 500 with
1786 # Reason ServerTimeout indicating a unique name could not be found in the
1787 # time allotted, and the client should retry (optionally after the time
1788 # indicated in the Retry-After header).
1789 #
1790 # Applied only if Name is not specified.
1791 # More info:
1792 # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency
1793 # +optional
1794 # string generateName = 2;
1795 "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this
1796 # object was created. It is not guaranteed to be set in happens-before order
1797 # across separate operations. Clients may not set this value. It is
1798 # represented in RFC3339 form and is in UTC.
1799 #
1800 # Populated by the system.
1801 # Read-only.
1802 # Null for lists.
1803 # More info:
1804 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata
1805 # +optional
1806 "annotations": { # Annotations is an unstructured key value map stored with a resource that
1807 # may be set by external tools to store and retrieve arbitrary metadata. They
1808 # are not queryable and should be preserved when modifying objects. More
1809 # info: http://kubernetes.io/docs/user-guide/annotations +optional
1810 "a_key": "A String",
1811 },
1812 "selfLink": "A String", # SelfLink is a URL representing this object.
1813 # Populated by the system.
1814 # Read-only.
1815 # +optional
1816 # string selfLink = 4;
1817 "uid": "A String", # UID is the unique in time and space value for this object. It is typically
1818 # generated by the server on successful creation of a resource and is not
1819 # allowed to change on PUT operations.
1820 #
1821 # Populated by the system.
1822 # Read-only.
1823 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids
1824 # +optional
1825 },
1826 }</pre>
1827</div>
1828
1829<div class="method">
1830 <code class="details" id="list">list(parent, labelSelector=None, includeUninitialized=None, x__xgafv=None, resourceVersion=None, limit=None, watch=None, continue=None, fieldSelector=None)</code>
1831 <pre>Rpc to list revisions.
1832
1833Args:
1834 parent: string, The project ID or project number from which the revisions should be listed. (required)
1835 labelSelector: string, Allows to filter resources based on a label. Supported operations are
1836=, !=, exists, in, and notIn.
1837 includeUninitialized: boolean, Not currently used by Cloud Run.
1838 x__xgafv: string, V1 error format.
1839 Allowed values
1840 1 - v1 error format
1841 2 - v2 error format
1842 resourceVersion: string, The baseline resource version from which the list or watch operation should
1843start. Not currently used by Cloud Run.
1844 limit: integer, The maximum number of records that should be returned.
1845 watch: boolean, Flag that indicates that the client expects to watch this resource as well.
1846Not currently used by Cloud Run.
1847 continue: string, Optional encoded string to continue paging.
1848 fieldSelector: string, Allows to filter resources based on a specific value for a field name.
1849Send this in a query string format. i.e. 'metadata.name%3Dlorem'.
1850Not currently used by Cloud Run.
1851
1852Returns:
1853 An object of the form:
1854
1855 { # ListRevisionsResponse is a list of Revision resources.
Dan O'Mearadd494642020-05-01 07:42:23 -07001856 "unreachable": [ # Locations that could not be reached.
1857 "A String",
1858 ],
1859 "kind": "A String", # The kind of this resource, in this case "RevisionList".
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001860 "items": [ # List of Revisions.
1861 { # Revision is an immutable snapshot of code and configuration. A revision
1862 # references a container image. Revisions are created by updates to a
1863 # Configuration.
1864 #
1865 # Cloud Run does not currently support referencing a build that is responsible
1866 # for materializing the container image from source.
1867 #
1868 # See also:
1869 # https://github.com/knative/serving/blob/master/docs/spec/overview.md#revision
1870 "status": { # RevisionStatus communicates the observed state of the Revision (from the # Status communicates the observed state of the Revision (from the
1871 # controller).
1872 # controller).
1873 "observedGeneration": 42, # ObservedGeneration is the 'Generation' of the Revision that
1874 # was last processed by the controller.
1875 #
1876 # Clients polling for completed reconciliation should poll until
1877 # observedGeneration = metadata.generation, and the Ready condition's status
1878 # is True or False.
1879 "imageDigest": "A String", # ImageDigest holds the resolved digest for the image specified
1880 # within .Spec.Container.Image. The digest is resolved during the creation
1881 # of Revision. This field holds the digest value regardless of whether
1882 # a tag or digest was originally specified in the Container object.
1883 "serviceName": "A String", # Not currently used by Cloud Run.
1884 "conditions": [ # Conditions communicates information about ongoing/complete
1885 # reconciliation processes that bring the "spec" inline with the observed
1886 # state of the world.
1887 #
1888 # As a Revision is being prepared, it will incrementally
1889 # update conditions "ResourcesAvailable", "ContainerHealthy", and "Active",
1890 # which contribute to the overall "Ready" condition.
1891 { # RevisionCondition defines a readiness condition for a Revision.
1892 "status": "A String", # Status of the condition, one of True, False, Unknown.
1893 "severity": "A String", # How to interpret failures of this condition, one of Error, Warning, Info
1894 # +optional
1895 "lastTransitionTime": "A String", # Last time the condition transitioned from one status to another.
1896 # +optional
1897 "reason": "A String", # One-word CamelCase reason for the condition's last transition.
1898 # +optional
1899 "message": "A String", # Human readable message indicating details about the current status.
1900 # +optional
1901 "type": "A String", # RevisionConditionType is used to communicate the status of the
1902 # reconciliation process. See also:
1903 # https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting
1904 # Types include:
1905 #
1906 # * "Ready": True when the Revision is ready.
1907 # * "ResourcesAvailable": True when underlying resources have been
1908 # provisioned.
1909 # * "ContainerHealthy": True when the Revision readiness check completes.
1910 # * "Active": True when the Revision may receive traffic.
1911 },
1912 ],
1913 "logUrl": "A String", # Specifies the generated logging url for this particular revision
1914 # based on the revision url template specified in the controller's config.
1915 # +optional
1916 },
1917 "kind": "A String", # The kind of this resource, in this case "Revision".
1918 "spec": { # RevisionSpec holds the desired state of the Revision (from the client). # Spec holds the desired state of the Revision (from the client).
1919 "container": { # A single application container. # Container defines the unit of execution for this Revision.
1920 # In the context of a Revision, we disallow a number of the fields of
1921 # this Container, including: name, ports, and volumeMounts.
1922 # The runtime contract is documented here:
1923 # https://github.com/knative/serving/blob/master/docs/runtime-contract.md
1924 # This specifies both the container to run, the command to run in the container
1925 # and the arguments to supply to it.
1926 # Note that additional arguments may be supplied by the system to the container
1927 # at runtime.
Dan O'Mearadd494642020-05-01 07:42:23 -07001928 "livenessProbe": { # Probe describes a health check to be performed against a container to # Periodic probe of container liveness.
1929 # Container will be restarted if the probe fails.
1930 # Cannot be updated.
1931 # More info:
1932 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
1933 # +optional
1934 # determine whether it is alive or ready to receive traffic.
1935 "timeoutSeconds": 42, # Number of seconds after which the probe times out.
1936 # Defaults to 1 second. Minimum value is 1.
1937 # More info:
1938 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
1939 # +optional
1940 "initialDelaySeconds": 42, # Number of seconds after the container has started before liveness probes
1941 # are initiated. More info:
1942 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
1943 # +optional
1944 "handler": { # Handler defines a specific action that should be taken # The action taken to determine the health of a container
1945 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
1946 # TCP hooks not yet supported
1947 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
1948 # +optional
1949 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
1950 # Number must be in the range 1 to 65535.
1951 # Name must be an IANA_SVC_NAME.
1952 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
1953 # inner type. This allows you to have, for example, a JSON field that can
1954 # accept a name or number.
1955 "strVal": "A String", # The string value.
1956 "type": 42, # The type of the value.
1957 "intVal": 42, # The int value.
1958 },
1959 },
1960 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
1961 # +optional
1962 "path": "A String", # Path to access on the HTTP server.
1963 # +optional
1964 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
1965 # "Host" in httpHeaders instead.
1966 # +optional
1967 "scheme": "A String", # Scheme to use for connecting to the host.
1968 # Defaults to HTTP.
1969 # +optional
1970 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
1971 # Number must be in the range 1 to 65535.
1972 # Name must be an IANA_SVC_NAME.
1973 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
1974 # inner type. This allows you to have, for example, a JSON field that can
1975 # accept a name or number.
1976 "strVal": "A String", # The string value.
1977 "type": 42, # The type of the value.
1978 "intVal": 42, # The int value.
1979 },
1980 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
1981 # +optional
1982 { # HTTPHeader describes a custom header to be used in HTTP probes
1983 "name": "A String", # The header field name
1984 "value": "A String", # The header field value
1985 },
1986 ],
1987 },
1988 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
1989 # Exec specifies the action to take.
1990 # +optional
1991 "command": "A String", # Command is the command line to execute inside the container, the working
1992 # directory for the command is root ('/') in the container's filesystem. The
1993 # command is simply exec'd, it is not run inside a shell, so traditional
1994 # shell instructions ('|', etc) won't work. To use a shell, you need to
1995 # explicitly call out to that shell. Exit status of 0 is treated as
1996 # live/healthy and non-zero is unhealthy. +optional
1997 },
1998 },
1999 "periodSeconds": 42, # How often (in seconds) to perform the probe.
2000 # Default to 10 seconds. Minimum value is 1.
2001 # +optional
2002 "successThreshold": 42, # Minimum consecutive successes for the probe to be considered successful
2003 # after having failed. Defaults to 1. Must be 1 for liveness. Minimum value
2004 # is 1. +optional
2005 "failureThreshold": 42, # Minimum consecutive failures for the probe to be considered failed after
2006 # having succeeded. Defaults to 3. Minimum value is 1. +optional
2007 },
2008 "args": [ # Arguments to the entrypoint.
2009 # The docker image's CMD is used if this is not provided.
2010 # Variable references $(VAR_NAME) are expanded using the container's
2011 # environment. If a variable cannot be resolved, the reference in the input
2012 # string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
2013 # double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
2014 # regardless of whether the variable exists or not.
2015 # Cannot be updated.
2016 # More info:
2017 # https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
2018 # +optional
2019 "A String",
2020 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002021 "securityContext": { # SecurityContext holds security configuration that will be applied to a # Security options the pod should run with.
2022 # More info: https://kubernetes.io/docs/concepts/policy/security-context/
2023 # More info:
2024 # https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
2025 # +optional
2026 # container. Some fields are present in both SecurityContext and
2027 # PodSecurityContext. When both are set, the values in SecurityContext take
2028 # precedence.
2029 "readOnlyRootFilesystem": True or False, # Whether this container has a read-only root filesystem.
2030 # Default is false.
2031 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002032 "runAsGroup": 42, # The GID to run the entrypoint of the container process.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002033 # Uses runtime default if unset.
2034 # May also be set in PodSecurityContext. If set in both SecurityContext and
2035 # PodSecurityContext, the value specified in SecurityContext takes
2036 # precedence. +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002037 "allowPrivilegeEscalation": True or False, # AllowPrivilegeEscalation controls whether a process can gain more
2038 # privileges than its parent process. This bool directly controls if
2039 # the no_new_privs flag will be set on the container process.
2040 # AllowPrivilegeEscalation is true always when the container is:
2041 # 1) run as Privileged
2042 # 2) has CAP_SYS_ADMIN
2043 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002044 "runAsUser": 42, # The UID to run the entrypoint of the container process.
2045 # Defaults to user specified in image metadata if unspecified.
2046 # May also be set in PodSecurityContext. If set in both SecurityContext and
2047 # PodSecurityContext, the value specified in SecurityContext takes
2048 # precedence. +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002049 "capabilities": { # Adds and removes POSIX capabilities from running containers. # The capabilities to add/drop when running containers.
2050 # Defaults to the default set of capabilities granted by the container
2051 # runtime. +optional
2052 "add": [ # Added capabilities
2053 # +optional
2054 "A String",
2055 ],
2056 "drop": [ # Removed capabilities
2057 # +optional
2058 "A String",
2059 ],
2060 },
2061 "runAsNonRoot": True or False, # Indicates that the container must run as a non-root user.
2062 # If true, the Kubelet will validate the image at runtime to ensure that it
2063 # does not run as UID 0 (root) and fail to start the container if it does.
2064 # If unset or false, no such validation will be performed.
2065 # May also be set in PodSecurityContext. If set in both SecurityContext and
2066 # PodSecurityContext, the value specified in SecurityContext takes
2067 # precedence. +optional
2068 "seLinuxOptions": { # SELinuxOptions are the labels to be applied to the container # The SELinux context to be applied to the container.
2069 # If unspecified, the container runtime will allocate a random SELinux
2070 # context for each container. May also be set in PodSecurityContext. If set
2071 # in both SecurityContext and PodSecurityContext, the value specified in
2072 # SecurityContext takes precedence. +optional
2073 "role": "A String", # Role is a SELinux role label that applies to the container.
2074 # +optional
2075 "type": "A String", # Type is a SELinux type label that applies to the container.
2076 # +optional
2077 "user": "A String", # User is a SELinux user label that applies to the container.
2078 # +optional
2079 "level": "A String", # Level is SELinux level label that applies to the container.
2080 # +optional
2081 },
2082 "privileged": True or False, # Run container in privileged mode.
2083 # Processes in privileged containers are essentially equivalent to root on
2084 # the host. Defaults to false. +optional
2085 },
2086 "name": "A String", # Name of the container specified as a DNS_LABEL.
2087 # Each container must have a unique name (DNS_LABEL).
2088 # Cannot be updated.
2089 "envFrom": [ # List of sources to populate environment variables in the container.
2090 # The keys defined within a source must be a C_IDENTIFIER. All invalid keys
2091 # will be reported as an event when the container is starting. When a key
2092 # exists in multiple sources, the value associated with the last source will
2093 # take precedence. Values defined by an Env with a duplicate key will take
2094 # precedence. Cannot be updated. +optional
2095 { # EnvFromSource represents the source of a set of ConfigMaps
2096 "secretRef": { # SecretEnvSource selects a Secret to populate the environment # The Secret to select from
2097 # +optional
2098 # variables with.
2099 #
2100 # The contents of the target Secret's Data field will represent the
2101 # key-value pairs as environment variables.
Dan O'Mearadd494642020-05-01 07:42:23 -07002102 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
2103 # directly into the message. Use the "name" field instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002104 # referenced object inside the same namespace.
2105 "name": "A String", # Name of the referent.
2106 # More info:
2107 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
2108 },
Dan O'Mearadd494642020-05-01 07:42:23 -07002109 "optional": True or False, # Cloud Run fully managed: not supported
2110 #
2111 # Cloud Run for Anthos: supported
2112 #
2113 # Specify whether the Secret must be defined
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002114 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002115 "name": "A String", # Cloud Run fully managed: not supported
2116 #
2117 # Cloud Run for Anthos: supported
2118 #
2119 # The Secret to select from.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002120 },
2121 "configMapRef": { # ConfigMapEnvSource selects a ConfigMap to populate the environment # The ConfigMap to select from
2122 # +optional
2123 # variables with.
2124 #
2125 # The contents of the target ConfigMap's Data field will represent the
2126 # key-value pairs as environment variables.
Dan O'Mearadd494642020-05-01 07:42:23 -07002127 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
2128 # directly into the message. Use the "name" field instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002129 # referenced object inside the same namespace.
2130 "name": "A String", # Name of the referent.
2131 # More info:
2132 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
2133 },
Dan O'Mearadd494642020-05-01 07:42:23 -07002134 "optional": True or False, # Cloud Run fully managed: not supported
2135 #
2136 # Cloud Run for Anthos: supported
2137 #
2138 # Specify whether the ConfigMap must be defined
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002139 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002140 "name": "A String", # Cloud Run fully managed: not supported
2141 #
2142 # Cloud Run for Anthos: supported
2143 #
2144 # The ConfigMap to select from.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002145 },
2146 "prefix": "A String", # An optional identifier to prepend to each key in the ConfigMap. Must be a
2147 # C_IDENTIFIER. +optional
2148 },
2149 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07002150 "stdinOnce": True or False, # Whether the container runtime should close the stdin channel after it has
2151 # been opened by a single attach. When stdin is true the stdin stream will
2152 # remain open across multiple attach sessions. If stdinOnce is set to true,
2153 # stdin is opened on container start, is empty until the first client
2154 # attaches to stdin, and then remains open and accepts data until the client
2155 # disconnects, at which time stdin is closed and remains closed until the
2156 # container is restarted. If this flag is false, a container processes that
2157 # reads from stdin will never receive an EOF. Default is false +optional
2158 "volumeDevices": [ # volumeDevices is the list of block devices to be used by the container.
2159 # This is an alpha feature and may change in the future.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002160 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002161 { # volumeDevice describes a mapping of a raw block device within a container.
2162 "devicePath": "A String", # devicePath is the path inside of the container that the device will be
2163 # mapped to.
2164 "name": "A String", # name must match the name of a persistentVolumeClaim in the pod
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002165 },
2166 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07002167 "stdin": True or False, # Whether this container should allocate a buffer for stdin in the container
2168 # runtime. If this is not set, reads from stdin in the container will always
2169 # result in EOF. Default is false. +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002170 "volumeMounts": [ # Pod volumes to mount into the container's filesystem.
2171 # Cannot be updated.
2172 # +optional
2173 { # VolumeMount describes a mounting of a Volume within a container.
2174 "readOnly": True or False, # Mounted read-only if true, read-write otherwise (false or unspecified).
2175 # Defaults to false.
2176 # +optional
2177 "mountPropagation": "A String", # mountPropagation determines how mounts are propagated from the host
2178 # to container and the other way around.
2179 # When not set, MountPropagationHostToContainer is used.
2180 # This field is beta in 1.10.
2181 # +optional
2182 "subPath": "A String", # Path within the volume from which the container's volume should be mounted.
2183 # Defaults to "" (volume's root).
2184 # +optional
2185 "name": "A String", # This must match the Name of a Volume.
2186 "mountPath": "A String", # Path within the container at which the volume should be mounted. Must
2187 # not contain ':'.
2188 },
2189 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07002190 "tty": True or False, # Whether this container should allocate a TTY for itself, also requires
2191 # 'stdin' to be true. Default is false. +optional
2192 "ports": [ # List of ports to expose from the container. Exposing a port here gives
2193 # the system additional information about the network connections a
2194 # container uses, but is primarily informational. Not specifying a port here
2195 # DOES NOT prevent that port from being exposed. Any port which is
2196 # listening on the default "0.0.0.0" address inside a container will be
2197 # accessible from the network.
2198 # Cannot be updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002199 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002200 { # ContainerPort represents a network port in a single container.
2201 "protocol": "A String", # Protocol for port. Must be UDP or TCP.
2202 # Defaults to "TCP".
2203 # +optional
2204 "hostIP": "A String", # What host IP to bind the external port to.
2205 # +optional
2206 "containerPort": 42, # Number of port to expose on the pod's IP address.
2207 # This must be a valid port number, 0 &lt; x &lt; 65536.
2208 "name": "A String", # If specified, this must be an IANA_SVC_NAME and unique within the pod. Each
2209 # named port in a pod must have a unique name. Name for the port that can be
2210 # referred to by services.
2211 # +optional
2212 "hostPort": 42, # Number of port to expose on the host.
2213 # If specified, this must be a valid port number, 0 &lt; x &lt; 65536.
2214 # If HostNetwork is specified, this must match ContainerPort.
2215 # Most containers do not need this.
2216 # +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002217 },
2218 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002219 "terminationMessagePolicy": "A String", # Indicate how the termination message should be populated. File will use the
2220 # contents of terminationMessagePath to populate the container status message
2221 # on both success and failure. FallbackToLogsOnError will use the last chunk
2222 # of container log output if the termination message file is empty and the
2223 # container exited with an error. The log output is limited to 2048 bytes or
2224 # 80 lines, whichever is smaller. Defaults to File. Cannot be updated.
2225 # +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002226 "command": [ # Entrypoint array. Not executed within a shell.
2227 # The docker image's ENTRYPOINT is used if this is not provided.
2228 # Variable references $(VAR_NAME) are expanded using the container's
2229 # environment. If a variable cannot be resolved, the reference in the input
2230 # string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
2231 # double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
2232 # regardless of whether the variable exists or not.
2233 # Cannot be updated.
2234 # More info:
2235 # https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
2236 # +optional
2237 "A String",
2238 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07002239 "env": [ # List of environment variables to set in the container.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002240 # Cannot be updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002241 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002242 { # EnvVar represents an environment variable present in a Container.
2243 "valueFrom": { # Cloud Run fully managed: not supported # Cloud Run fully managed: not supported
2244 #
2245 # Cloud Run on GKE: supported
2246 #
2247 # Source for the environment variable's value. Cannot be used if value is not
2248 # empty. +optional
2249 #
2250 # Cloud Run on GKE: supported
2251 #
2252 # EnvVarSource represents a source for the value of an EnvVar.
2253 "secretKeyRef": { # Cloud Run fully managed: not supported # Cloud Run fully managed: not supported
2254 #
2255 # Cloud Run on GKE: supported
2256 #
2257 # Selects a key of a secret in the pod's namespace
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002258 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002259 #
2260 # Cloud Run on GKE: supported
2261 #
2262 # SecretKeySelector selects a key of a Secret.
2263 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
2264 # directly into the message. Use the "name" field instead.
2265 # referenced object inside the same namespace.
2266 "name": "A String", # Name of the referent.
2267 # More info:
2268 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002269 },
Dan O'Mearadd494642020-05-01 07:42:23 -07002270 "optional": True or False, # Cloud Run fully managed: not supported
2271 #
2272 # Cloud Run on GKE: supported
2273 #
2274 # Specify whether the Secret or its key must be defined
2275 # +optional
2276 "name": "A String", # Cloud Run fully managed: not supported
2277 #
2278 # Cloud Run on GKE: supported
2279 #
2280 # The name of the secret in the pod's namespace to select from.
2281 "key": "A String", # Cloud Run fully managed: not supported
2282 #
2283 # Cloud Run on GKE: supported
2284 #
2285 # The key of the secret to select from. Must be a valid secret key.
2286 },
2287 "configMapKeyRef": { # Cloud Run fully managed: not supported # Cloud Run fully managed: not supported
2288 #
2289 # Cloud Run on GKE: supported
2290 #
2291 # Selects a key of a ConfigMap.
2292 # +optional
2293 #
2294 # Cloud Run on GKE: supported
2295 #
2296 # Selects a key from a ConfigMap.
2297 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
2298 # directly into the message. Use the "name" field instead.
2299 # referenced object inside the same namespace.
2300 "name": "A String", # Name of the referent.
2301 # More info:
2302 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
2303 },
2304 "optional": True or False, # Cloud Run fully managed: not supported
2305 #
2306 # Cloud Run on GKE: supported
2307 #
2308 # Specify whether the ConfigMap or its key must be defined
2309 # +optional
2310 "name": "A String", # Cloud Run fully managed: not supported
2311 #
2312 # Cloud Run on GKE: supported
2313 #
2314 # The ConfigMap to select from.
2315 "key": "A String", # Cloud Run fully managed: not supported
2316 #
2317 # Cloud Run on GKE: supported
2318 #
2319 # The key to select.
2320 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002321 },
Dan O'Mearadd494642020-05-01 07:42:23 -07002322 "name": "A String", # Name of the environment variable. Must be a C_IDENTIFIER.
2323 "value": "A String", # Variable references $(VAR_NAME) are expanded
2324 # using the previous defined environment variables in the container and
2325 # any route environment variables. If a variable cannot be resolved,
2326 # the reference in the input string will be unchanged. The $(VAR_NAME)
2327 # syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped
2328 # references will never be expanded, regardless of whether the variable
2329 # exists or not.
2330 # Defaults to "".
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002331 # +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002332 },
Dan O'Mearadd494642020-05-01 07:42:23 -07002333 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002334 "imagePullPolicy": "A String", # Image pull policy.
2335 # One of Always, Never, IfNotPresent.
2336 # Defaults to Always if :latest tag is specified, or IfNotPresent otherwise.
2337 # Cannot be updated.
2338 # More info:
2339 # https://kubernetes.io/docs/concepts/containers/images#updating-images
2340 # +optional
2341 "readinessProbe": { # Probe describes a health check to be performed against a container to # Periodic probe of container service readiness.
2342 # Container will be removed from service endpoints if the probe fails.
2343 # Cannot be updated.
2344 # More info:
2345 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
2346 # +optional
2347 # determine whether it is alive or ready to receive traffic.
2348 "timeoutSeconds": 42, # Number of seconds after which the probe times out.
2349 # Defaults to 1 second. Minimum value is 1.
2350 # More info:
2351 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
2352 # +optional
2353 "initialDelaySeconds": 42, # Number of seconds after the container has started before liveness probes
2354 # are initiated. More info:
2355 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
2356 # +optional
2357 "handler": { # Handler defines a specific action that should be taken # The action taken to determine the health of a container
2358 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
2359 # TCP hooks not yet supported
2360 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
2361 # +optional
2362 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
2363 # Number must be in the range 1 to 65535.
2364 # Name must be an IANA_SVC_NAME.
2365 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
2366 # inner type. This allows you to have, for example, a JSON field that can
2367 # accept a name or number.
2368 "strVal": "A String", # The string value.
Dan O'Mearadd494642020-05-01 07:42:23 -07002369 "type": 42, # The type of the value.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002370 "intVal": 42, # The int value.
2371 },
2372 },
2373 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
2374 # +optional
2375 "path": "A String", # Path to access on the HTTP server.
2376 # +optional
2377 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
2378 # "Host" in httpHeaders instead.
2379 # +optional
2380 "scheme": "A String", # Scheme to use for connecting to the host.
2381 # Defaults to HTTP.
2382 # +optional
2383 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
2384 # Number must be in the range 1 to 65535.
2385 # Name must be an IANA_SVC_NAME.
2386 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
2387 # inner type. This allows you to have, for example, a JSON field that can
2388 # accept a name or number.
2389 "strVal": "A String", # The string value.
Dan O'Mearadd494642020-05-01 07:42:23 -07002390 "type": 42, # The type of the value.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002391 "intVal": 42, # The int value.
2392 },
2393 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
2394 # +optional
2395 { # HTTPHeader describes a custom header to be used in HTTP probes
2396 "name": "A String", # The header field name
2397 "value": "A String", # The header field value
2398 },
2399 ],
2400 },
2401 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
2402 # Exec specifies the action to take.
2403 # +optional
2404 "command": "A String", # Command is the command line to execute inside the container, the working
2405 # directory for the command is root ('/') in the container's filesystem. The
2406 # command is simply exec'd, it is not run inside a shell, so traditional
2407 # shell instructions ('|', etc) won't work. To use a shell, you need to
2408 # explicitly call out to that shell. Exit status of 0 is treated as
2409 # live/healthy and non-zero is unhealthy. +optional
2410 },
2411 },
2412 "periodSeconds": 42, # How often (in seconds) to perform the probe.
2413 # Default to 10 seconds. Minimum value is 1.
2414 # +optional
2415 "successThreshold": 42, # Minimum consecutive successes for the probe to be considered successful
2416 # after having failed. Defaults to 1. Must be 1 for liveness. Minimum value
2417 # is 1. +optional
2418 "failureThreshold": 42, # Minimum consecutive failures for the probe to be considered failed after
2419 # having succeeded. Defaults to 3. Minimum value is 1. +optional
2420 },
2421 "terminationMessagePath": "A String", # Optional: Path at which the file to which the container's termination
2422 # message will be written is mounted into the container's filesystem. Message
2423 # written is intended to be brief final status, such as an assertion failure
2424 # message. Will be truncated by the node if greater than 4096 bytes. The
2425 # total message length across all containers will be limited to 12kb.
2426 # Defaults to /dev/termination-log.
2427 # Cannot be updated.
2428 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002429 "image": "A String", # Docker image name.
2430 # More info: https://kubernetes.io/docs/concepts/containers/images
2431 "lifecycle": { # Lifecycle describes actions that the management system should take in # Actions that the management system should take in response to container
2432 # lifecycle events. Cannot be updated. +optional
2433 # response to container lifecycle events. For the PostStart and PreStop
2434 # lifecycle handlers, management of the container blocks until the action is
2435 # complete, unless the container process fails, in which case the handler is
2436 # aborted.
2437 "preStop": { # Handler defines a specific action that should be taken # PreStop is called immediately before a container is terminated.
2438 # The container is terminated after the handler completes.
2439 # The reason for termination is passed to the handler.
2440 # Regardless of the outcome of the handler, the container is eventually
2441 # terminated. Other management of the container blocks until the hook
2442 # completes. More info:
2443 # https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
2444 # +optional
2445 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
2446 # TCP hooks not yet supported
2447 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
2448 # +optional
2449 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
2450 # Number must be in the range 1 to 65535.
2451 # Name must be an IANA_SVC_NAME.
2452 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
2453 # inner type. This allows you to have, for example, a JSON field that can
2454 # accept a name or number.
2455 "strVal": "A String", # The string value.
2456 "type": 42, # The type of the value.
2457 "intVal": 42, # The int value.
2458 },
2459 },
2460 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002461 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002462 "path": "A String", # Path to access on the HTTP server.
2463 # +optional
2464 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
2465 # "Host" in httpHeaders instead.
2466 # +optional
2467 "scheme": "A String", # Scheme to use for connecting to the host.
2468 # Defaults to HTTP.
2469 # +optional
2470 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
2471 # Number must be in the range 1 to 65535.
2472 # Name must be an IANA_SVC_NAME.
2473 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
2474 # inner type. This allows you to have, for example, a JSON field that can
2475 # accept a name or number.
2476 "strVal": "A String", # The string value.
2477 "type": 42, # The type of the value.
2478 "intVal": 42, # The int value.
2479 },
2480 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
2481 # +optional
2482 { # HTTPHeader describes a custom header to be used in HTTP probes
2483 "name": "A String", # The header field name
2484 "value": "A String", # The header field value
2485 },
2486 ],
2487 },
2488 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
2489 # Exec specifies the action to take.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002490 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002491 "command": "A String", # Command is the command line to execute inside the container, the working
2492 # directory for the command is root ('/') in the container's filesystem. The
2493 # command is simply exec'd, it is not run inside a shell, so traditional
2494 # shell instructions ('|', etc) won't work. To use a shell, you need to
2495 # explicitly call out to that shell. Exit status of 0 is treated as
2496 # live/healthy and non-zero is unhealthy. +optional
2497 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002498 },
Dan O'Mearadd494642020-05-01 07:42:23 -07002499 "postStart": { # Handler defines a specific action that should be taken # PostStart is called immediately after a container is created. If the
2500 # handler fails, the container is terminated and restarted according to its
2501 # restart policy. Other management of the container blocks until the hook
2502 # completes. More info:
2503 # https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
2504 # +optional
2505 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
2506 # TCP hooks not yet supported
2507 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
2508 # +optional
2509 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
2510 # Number must be in the range 1 to 65535.
2511 # Name must be an IANA_SVC_NAME.
2512 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
2513 # inner type. This allows you to have, for example, a JSON field that can
2514 # accept a name or number.
2515 "strVal": "A String", # The string value.
2516 "type": 42, # The type of the value.
2517 "intVal": 42, # The int value.
2518 },
2519 },
2520 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
2521 # +optional
2522 "path": "A String", # Path to access on the HTTP server.
2523 # +optional
2524 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
2525 # "Host" in httpHeaders instead.
2526 # +optional
2527 "scheme": "A String", # Scheme to use for connecting to the host.
2528 # Defaults to HTTP.
2529 # +optional
2530 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
2531 # Number must be in the range 1 to 65535.
2532 # Name must be an IANA_SVC_NAME.
2533 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
2534 # inner type. This allows you to have, for example, a JSON field that can
2535 # accept a name or number.
2536 "strVal": "A String", # The string value.
2537 "type": 42, # The type of the value.
2538 "intVal": 42, # The int value.
2539 },
2540 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
2541 # +optional
2542 { # HTTPHeader describes a custom header to be used in HTTP probes
2543 "name": "A String", # The header field name
2544 "value": "A String", # The header field value
2545 },
2546 ],
2547 },
2548 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
2549 # Exec specifies the action to take.
2550 # +optional
2551 "command": "A String", # Command is the command line to execute inside the container, the working
2552 # directory for the command is root ('/') in the container's filesystem. The
2553 # command is simply exec'd, it is not run inside a shell, so traditional
2554 # shell instructions ('|', etc) won't work. To use a shell, you need to
2555 # explicitly call out to that shell. Exit status of 0 is treated as
2556 # live/healthy and non-zero is unhealthy. +optional
2557 },
2558 },
2559 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002560 "resources": { # ResourceRequirements describes the compute resource requirements. # Compute Resources required by this container.
2561 # Cannot be updated.
2562 # More info:
2563 # https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
2564 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002565 "limitsInMap": { # Limits describes the maximum amount of compute resources allowed.
2566 # This is a temporary field created to migrate away from the
2567 # map&lt;string, Quantity&gt; limits field. This is done to become compliant
2568 # with k8s style API.
2569 # This field is deprecated in favor of limits field.
2570 "a_key": { # The view model of a single quantity, e.g. "800 MiB". Corresponds to
2571 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/generated.proto
2572 "string": "A String", # Stringified version of the quantity, e.g., "800 MiB".
2573 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002574 },
2575 "requestsInMap": { # Requests describes the minimum amount of compute resources required.
2576 # If Requests is omitted for a container, it defaults to Limits if that is
2577 # explicitly specified, otherwise to an implementation-defined value.
2578 # This is a temporary field created to migrate away from the
Dan O'Mearadd494642020-05-01 07:42:23 -07002579 # map&lt;string, Quantity&gt; requests field. This is done to become compliant
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002580 # with k8s style API.
2581 # This field is deprecated in favor of requests field.
2582 "a_key": { # The view model of a single quantity, e.g. "800 MiB". Corresponds to
2583 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/generated.proto
2584 "string": "A String", # Stringified version of the quantity, e.g., "800 MiB".
2585 },
2586 },
Dan O'Mearadd494642020-05-01 07:42:23 -07002587 "requests": { # Requests describes the minimum amount of compute resources required.
2588 # If Requests is omitted for a container, it defaults to Limits if that is
2589 # explicitly specified, otherwise to an implementation-defined value.
2590 # The values of the map is string form of the 'quantity' k8s type:
2591 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go
2592 "a_key": "A String",
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002593 },
2594 "limits": { # Limits describes the maximum amount of compute resources allowed.
2595 # The values of the map is string form of the 'quantity' k8s type:
2596 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go
2597 "a_key": "A String",
2598 },
2599 },
2600 "workingDir": "A String", # Container's working directory.
2601 # If not specified, the container runtime's default will be used, which
2602 # might be configured in the container image.
2603 # Cannot be updated.
2604 # +optional
2605 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002606 "volumes": [
2607 { # Volume represents a named volume in a container.
2608 "configMap": { # Adapts a ConfigMap into a volume.
2609 # The contents of the target ConfigMap's Data field will be presented in a
2610 # volume as files using the keys in the Data field as the file names, unless
2611 # the items element is populated with specific mappings of keys to paths.
2612 "items": [ # If unspecified, each key-value pair in the Data field of the referenced
2613 # Secret will be projected into the volume as a file whose name is the
2614 # key and content is the value. If specified, the listed keys will be
2615 # projected into the specified paths, and unlisted keys will not be
2616 # present. If a key is specified which is not present in the Secret,
2617 # the volume setup will error unless it is marked optional.
2618 { # Maps a string key to a path within a volume.
2619 "path": "A String", # The relative path of the file to map the key to.
2620 # May not be an absolute path.
2621 # May not contain the path element '..'.
2622 # May not start with the string '..'.
2623 "mode": 42, # Mode bits to use on this file, must be a value between 0 and 0777. If not
2624 # specified, the volume defaultMode will be used. This might be in conflict
2625 # with other options that affect the file mode, like fsGroup, and the result
2626 # can be other mode bits set. +optional
2627 "key": "A String", # The key to project.
2628 },
2629 ],
2630 "optional": True or False, # Specify whether the Secret or its keys must be defined.
2631 "name": "A String", # Name of the config.
2632 "defaultMode": 42, # Mode bits to use on created files by default. Must be a value between 0 and
2633 # 0777. Defaults to 0644. Directories within the path are not affected by
2634 # this setting. This might be in conflict with other options that affect the
2635 # file mode, like fsGroup, and the result can be other mode bits set.
2636 },
2637 "secret": { # The contents of the target Secret's Data field will be presented in a volume
2638 # as files using the keys in the Data field as the file names.
2639 "items": [ # If unspecified, each key-value pair in the Data field of the referenced
2640 # Secret will be projected into the volume as a file whose name is the
2641 # key and content is the value. If specified, the listed keys will be
2642 # projected into the specified paths, and unlisted keys will not be
2643 # present. If a key is specified which is not present in the Secret,
2644 # the volume setup will error unless it is marked optional.
2645 { # Maps a string key to a path within a volume.
2646 "path": "A String", # The relative path of the file to map the key to.
2647 # May not be an absolute path.
2648 # May not contain the path element '..'.
2649 # May not start with the string '..'.
2650 "mode": 42, # Mode bits to use on this file, must be a value between 0 and 0777. If not
2651 # specified, the volume defaultMode will be used. This might be in conflict
2652 # with other options that affect the file mode, like fsGroup, and the result
2653 # can be other mode bits set. +optional
2654 "key": "A String", # The key to project.
2655 },
2656 ],
2657 "optional": True or False, # Specify whether the Secret or its keys must be defined.
2658 "defaultMode": 42, # Mode bits to use on created files by default. Must be a value between 0 and
2659 # 0777. Defaults to 0644. Directories within the path are not affected by
2660 # this setting. This might be in conflict with other options that affect the
2661 # file mode, like fsGroup, and the result can be other mode bits set.
2662 "secretName": "A String", # Name of the secret in the container's namespace to use.
2663 },
2664 "name": "A String", # Volume's name.
2665 },
2666 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07002667 "timeoutSeconds": 42, # TimeoutSeconds holds the max duration the instance is allowed for
2668 # responding to a request.
2669 # Not currently used by Cloud Run.
2670 "servingState": "A String", # ServingState holds a value describing the state the resources
2671 # are in for this Revision.
2672 # Users must not specify this when creating a revision. It is expected
2673 # that the system will manipulate this based on routability and load.
2674 #
2675 # Populated by the system.
2676 # Read-only.
2677 "generation": 42, # Deprecated and not currently populated by Cloud Run. See
2678 # metadata.generation instead, which is the sequence number containing the
2679 # latest generation of the desired state.
2680 #
2681 # Read-only.
2682 "concurrencyModel": "A String", # ConcurrencyModel specifies the desired concurrency model
2683 # (Single or Multi) for the Revision. Defaults to Multi.
2684 # Deprecated in favor of ContainerConcurrency.
2685 # +optional
2686 "containerConcurrency": 42, # (Optional)
2687 #
2688 # ContainerConcurrency specifies the maximum allowed in-flight (concurrent)
2689 # requests per container instance of the Revision.
2690 #
2691 # Cloud Run fully managed: supported, defaults to 80
2692 #
2693 # Cloud Run on GKE: supported, defaults to 0, which means concurrency
2694 # to the application is not limited, and the system decides the
2695 # target concurrency for the autoscaler.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002696 "containers": [ # Containers holds the single container that defines the unit of execution
2697 # for this Revision. In the context of a Revision, we disallow a number of
2698 # fields on this Container, including: name and lifecycle.
Dan O'Mearadd494642020-05-01 07:42:23 -07002699 # In Cloud Run, only a single container may be provided.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002700 { # A single application container.
2701 # This specifies both the container to run, the command to run in the container
2702 # and the arguments to supply to it.
2703 # Note that additional arguments may be supplied by the system to the container
2704 # at runtime.
Dan O'Mearadd494642020-05-01 07:42:23 -07002705 "livenessProbe": { # Probe describes a health check to be performed against a container to # Periodic probe of container liveness.
2706 # Container will be restarted if the probe fails.
2707 # Cannot be updated.
2708 # More info:
2709 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
2710 # +optional
2711 # determine whether it is alive or ready to receive traffic.
2712 "timeoutSeconds": 42, # Number of seconds after which the probe times out.
2713 # Defaults to 1 second. Minimum value is 1.
2714 # More info:
2715 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
2716 # +optional
2717 "initialDelaySeconds": 42, # Number of seconds after the container has started before liveness probes
2718 # are initiated. More info:
2719 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
2720 # +optional
2721 "handler": { # Handler defines a specific action that should be taken # The action taken to determine the health of a container
2722 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
2723 # TCP hooks not yet supported
2724 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
2725 # +optional
2726 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
2727 # Number must be in the range 1 to 65535.
2728 # Name must be an IANA_SVC_NAME.
2729 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
2730 # inner type. This allows you to have, for example, a JSON field that can
2731 # accept a name or number.
2732 "strVal": "A String", # The string value.
2733 "type": 42, # The type of the value.
2734 "intVal": 42, # The int value.
2735 },
2736 },
2737 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
2738 # +optional
2739 "path": "A String", # Path to access on the HTTP server.
2740 # +optional
2741 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
2742 # "Host" in httpHeaders instead.
2743 # +optional
2744 "scheme": "A String", # Scheme to use for connecting to the host.
2745 # Defaults to HTTP.
2746 # +optional
2747 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
2748 # Number must be in the range 1 to 65535.
2749 # Name must be an IANA_SVC_NAME.
2750 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
2751 # inner type. This allows you to have, for example, a JSON field that can
2752 # accept a name or number.
2753 "strVal": "A String", # The string value.
2754 "type": 42, # The type of the value.
2755 "intVal": 42, # The int value.
2756 },
2757 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
2758 # +optional
2759 { # HTTPHeader describes a custom header to be used in HTTP probes
2760 "name": "A String", # The header field name
2761 "value": "A String", # The header field value
2762 },
2763 ],
2764 },
2765 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
2766 # Exec specifies the action to take.
2767 # +optional
2768 "command": "A String", # Command is the command line to execute inside the container, the working
2769 # directory for the command is root ('/') in the container's filesystem. The
2770 # command is simply exec'd, it is not run inside a shell, so traditional
2771 # shell instructions ('|', etc) won't work. To use a shell, you need to
2772 # explicitly call out to that shell. Exit status of 0 is treated as
2773 # live/healthy and non-zero is unhealthy. +optional
2774 },
2775 },
2776 "periodSeconds": 42, # How often (in seconds) to perform the probe.
2777 # Default to 10 seconds. Minimum value is 1.
2778 # +optional
2779 "successThreshold": 42, # Minimum consecutive successes for the probe to be considered successful
2780 # after having failed. Defaults to 1. Must be 1 for liveness. Minimum value
2781 # is 1. +optional
2782 "failureThreshold": 42, # Minimum consecutive failures for the probe to be considered failed after
2783 # having succeeded. Defaults to 3. Minimum value is 1. +optional
2784 },
2785 "args": [ # Arguments to the entrypoint.
2786 # The docker image's CMD is used if this is not provided.
2787 # Variable references $(VAR_NAME) are expanded using the container's
2788 # environment. If a variable cannot be resolved, the reference in the input
2789 # string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
2790 # double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
2791 # regardless of whether the variable exists or not.
2792 # Cannot be updated.
2793 # More info:
2794 # https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
2795 # +optional
2796 "A String",
2797 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002798 "securityContext": { # SecurityContext holds security configuration that will be applied to a # Security options the pod should run with.
2799 # More info: https://kubernetes.io/docs/concepts/policy/security-context/
2800 # More info:
2801 # https://kubernetes.io/docs/tasks/configure-pod-container/security-context/
2802 # +optional
2803 # container. Some fields are present in both SecurityContext and
2804 # PodSecurityContext. When both are set, the values in SecurityContext take
2805 # precedence.
2806 "readOnlyRootFilesystem": True or False, # Whether this container has a read-only root filesystem.
2807 # Default is false.
2808 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002809 "runAsGroup": 42, # The GID to run the entrypoint of the container process.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002810 # Uses runtime default if unset.
2811 # May also be set in PodSecurityContext. If set in both SecurityContext and
2812 # PodSecurityContext, the value specified in SecurityContext takes
2813 # precedence. +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002814 "allowPrivilegeEscalation": True or False, # AllowPrivilegeEscalation controls whether a process can gain more
2815 # privileges than its parent process. This bool directly controls if
2816 # the no_new_privs flag will be set on the container process.
2817 # AllowPrivilegeEscalation is true always when the container is:
2818 # 1) run as Privileged
2819 # 2) has CAP_SYS_ADMIN
2820 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002821 "runAsUser": 42, # The UID to run the entrypoint of the container process.
2822 # Defaults to user specified in image metadata if unspecified.
2823 # May also be set in PodSecurityContext. If set in both SecurityContext and
2824 # PodSecurityContext, the value specified in SecurityContext takes
2825 # precedence. +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002826 "capabilities": { # Adds and removes POSIX capabilities from running containers. # The capabilities to add/drop when running containers.
2827 # Defaults to the default set of capabilities granted by the container
2828 # runtime. +optional
2829 "add": [ # Added capabilities
2830 # +optional
2831 "A String",
2832 ],
2833 "drop": [ # Removed capabilities
2834 # +optional
2835 "A String",
2836 ],
2837 },
2838 "runAsNonRoot": True or False, # Indicates that the container must run as a non-root user.
2839 # If true, the Kubelet will validate the image at runtime to ensure that it
2840 # does not run as UID 0 (root) and fail to start the container if it does.
2841 # If unset or false, no such validation will be performed.
2842 # May also be set in PodSecurityContext. If set in both SecurityContext and
2843 # PodSecurityContext, the value specified in SecurityContext takes
2844 # precedence. +optional
2845 "seLinuxOptions": { # SELinuxOptions are the labels to be applied to the container # The SELinux context to be applied to the container.
2846 # If unspecified, the container runtime will allocate a random SELinux
2847 # context for each container. May also be set in PodSecurityContext. If set
2848 # in both SecurityContext and PodSecurityContext, the value specified in
2849 # SecurityContext takes precedence. +optional
2850 "role": "A String", # Role is a SELinux role label that applies to the container.
2851 # +optional
2852 "type": "A String", # Type is a SELinux type label that applies to the container.
2853 # +optional
2854 "user": "A String", # User is a SELinux user label that applies to the container.
2855 # +optional
2856 "level": "A String", # Level is SELinux level label that applies to the container.
2857 # +optional
2858 },
2859 "privileged": True or False, # Run container in privileged mode.
2860 # Processes in privileged containers are essentially equivalent to root on
2861 # the host. Defaults to false. +optional
2862 },
2863 "name": "A String", # Name of the container specified as a DNS_LABEL.
2864 # Each container must have a unique name (DNS_LABEL).
2865 # Cannot be updated.
2866 "envFrom": [ # List of sources to populate environment variables in the container.
2867 # The keys defined within a source must be a C_IDENTIFIER. All invalid keys
2868 # will be reported as an event when the container is starting. When a key
2869 # exists in multiple sources, the value associated with the last source will
2870 # take precedence. Values defined by an Env with a duplicate key will take
2871 # precedence. Cannot be updated. +optional
2872 { # EnvFromSource represents the source of a set of ConfigMaps
2873 "secretRef": { # SecretEnvSource selects a Secret to populate the environment # The Secret to select from
2874 # +optional
2875 # variables with.
2876 #
2877 # The contents of the target Secret's Data field will represent the
2878 # key-value pairs as environment variables.
Dan O'Mearadd494642020-05-01 07:42:23 -07002879 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
2880 # directly into the message. Use the "name" field instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002881 # referenced object inside the same namespace.
2882 "name": "A String", # Name of the referent.
2883 # More info:
2884 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
2885 },
Dan O'Mearadd494642020-05-01 07:42:23 -07002886 "optional": True or False, # Cloud Run fully managed: not supported
2887 #
2888 # Cloud Run for Anthos: supported
2889 #
2890 # Specify whether the Secret must be defined
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002891 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002892 "name": "A String", # Cloud Run fully managed: not supported
2893 #
2894 # Cloud Run for Anthos: supported
2895 #
2896 # The Secret to select from.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002897 },
2898 "configMapRef": { # ConfigMapEnvSource selects a ConfigMap to populate the environment # The ConfigMap to select from
2899 # +optional
2900 # variables with.
2901 #
2902 # The contents of the target ConfigMap's Data field will represent the
2903 # key-value pairs as environment variables.
Dan O'Mearadd494642020-05-01 07:42:23 -07002904 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
2905 # directly into the message. Use the "name" field instead.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002906 # referenced object inside the same namespace.
2907 "name": "A String", # Name of the referent.
2908 # More info:
2909 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
2910 },
Dan O'Mearadd494642020-05-01 07:42:23 -07002911 "optional": True or False, # Cloud Run fully managed: not supported
2912 #
2913 # Cloud Run for Anthos: supported
2914 #
2915 # Specify whether the ConfigMap must be defined
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002916 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002917 "name": "A String", # Cloud Run fully managed: not supported
2918 #
2919 # Cloud Run for Anthos: supported
2920 #
2921 # The ConfigMap to select from.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002922 },
2923 "prefix": "A String", # An optional identifier to prepend to each key in the ConfigMap. Must be a
2924 # C_IDENTIFIER. +optional
2925 },
2926 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07002927 "stdinOnce": True or False, # Whether the container runtime should close the stdin channel after it has
2928 # been opened by a single attach. When stdin is true the stdin stream will
2929 # remain open across multiple attach sessions. If stdinOnce is set to true,
2930 # stdin is opened on container start, is empty until the first client
2931 # attaches to stdin, and then remains open and accepts data until the client
2932 # disconnects, at which time stdin is closed and remains closed until the
2933 # container is restarted. If this flag is false, a container processes that
2934 # reads from stdin will never receive an EOF. Default is false +optional
2935 "volumeDevices": [ # volumeDevices is the list of block devices to be used by the container.
2936 # This is an alpha feature and may change in the future.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002937 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002938 { # volumeDevice describes a mapping of a raw block device within a container.
2939 "devicePath": "A String", # devicePath is the path inside of the container that the device will be
2940 # mapped to.
2941 "name": "A String", # name must match the name of a persistentVolumeClaim in the pod
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002942 },
2943 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07002944 "stdin": True or False, # Whether this container should allocate a buffer for stdin in the container
2945 # runtime. If this is not set, reads from stdin in the container will always
2946 # result in EOF. Default is false. +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002947 "volumeMounts": [ # Pod volumes to mount into the container's filesystem.
2948 # Cannot be updated.
2949 # +optional
2950 { # VolumeMount describes a mounting of a Volume within a container.
2951 "readOnly": True or False, # Mounted read-only if true, read-write otherwise (false or unspecified).
2952 # Defaults to false.
2953 # +optional
2954 "mountPropagation": "A String", # mountPropagation determines how mounts are propagated from the host
2955 # to container and the other way around.
2956 # When not set, MountPropagationHostToContainer is used.
2957 # This field is beta in 1.10.
2958 # +optional
2959 "subPath": "A String", # Path within the volume from which the container's volume should be mounted.
2960 # Defaults to "" (volume's root).
2961 # +optional
2962 "name": "A String", # This must match the Name of a Volume.
2963 "mountPath": "A String", # Path within the container at which the volume should be mounted. Must
2964 # not contain ':'.
2965 },
2966 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07002967 "tty": True or False, # Whether this container should allocate a TTY for itself, also requires
2968 # 'stdin' to be true. Default is false. +optional
2969 "ports": [ # List of ports to expose from the container. Exposing a port here gives
2970 # the system additional information about the network connections a
2971 # container uses, but is primarily informational. Not specifying a port here
2972 # DOES NOT prevent that port from being exposed. Any port which is
2973 # listening on the default "0.0.0.0" address inside a container will be
2974 # accessible from the network.
2975 # Cannot be updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002976 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07002977 { # ContainerPort represents a network port in a single container.
2978 "protocol": "A String", # Protocol for port. Must be UDP or TCP.
2979 # Defaults to "TCP".
2980 # +optional
2981 "hostIP": "A String", # What host IP to bind the external port to.
2982 # +optional
2983 "containerPort": 42, # Number of port to expose on the pod's IP address.
2984 # This must be a valid port number, 0 &lt; x &lt; 65536.
2985 "name": "A String", # If specified, this must be an IANA_SVC_NAME and unique within the pod. Each
2986 # named port in a pod must have a unique name. Name for the port that can be
2987 # referred to by services.
2988 # +optional
2989 "hostPort": 42, # Number of port to expose on the host.
2990 # If specified, this must be a valid port number, 0 &lt; x &lt; 65536.
2991 # If HostNetwork is specified, this must match ContainerPort.
2992 # Most containers do not need this.
2993 # +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002994 },
2995 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07002996 "terminationMessagePolicy": "A String", # Indicate how the termination message should be populated. File will use the
2997 # contents of terminationMessagePath to populate the container status message
2998 # on both success and failure. FallbackToLogsOnError will use the last chunk
2999 # of container log output if the termination message file is empty and the
3000 # container exited with an error. The log output is limited to 2048 bytes or
3001 # 80 lines, whichever is smaller. Defaults to File. Cannot be updated.
3002 # +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003003 "command": [ # Entrypoint array. Not executed within a shell.
3004 # The docker image's ENTRYPOINT is used if this is not provided.
3005 # Variable references $(VAR_NAME) are expanded using the container's
3006 # environment. If a variable cannot be resolved, the reference in the input
3007 # string will be unchanged. The $(VAR_NAME) syntax can be escaped with a
3008 # double $$, ie: $$(VAR_NAME). Escaped references will never be expanded,
3009 # regardless of whether the variable exists or not.
3010 # Cannot be updated.
3011 # More info:
3012 # https://kubernetes.io/docs/tasks/inject-data-application/define-command-argument-container/#running-a-command-in-a-shell
3013 # +optional
3014 "A String",
3015 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07003016 "env": [ # List of environment variables to set in the container.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003017 # Cannot be updated.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003018 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07003019 { # EnvVar represents an environment variable present in a Container.
3020 "valueFrom": { # Cloud Run fully managed: not supported # Cloud Run fully managed: not supported
3021 #
3022 # Cloud Run on GKE: supported
3023 #
3024 # Source for the environment variable's value. Cannot be used if value is not
3025 # empty. +optional
3026 #
3027 # Cloud Run on GKE: supported
3028 #
3029 # EnvVarSource represents a source for the value of an EnvVar.
3030 "secretKeyRef": { # Cloud Run fully managed: not supported # Cloud Run fully managed: not supported
3031 #
3032 # Cloud Run on GKE: supported
3033 #
3034 # Selects a key of a secret in the pod's namespace
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003035 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07003036 #
3037 # Cloud Run on GKE: supported
3038 #
3039 # SecretKeySelector selects a key of a Secret.
3040 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
3041 # directly into the message. Use the "name" field instead.
3042 # referenced object inside the same namespace.
3043 "name": "A String", # Name of the referent.
3044 # More info:
3045 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003046 },
Dan O'Mearadd494642020-05-01 07:42:23 -07003047 "optional": True or False, # Cloud Run fully managed: not supported
3048 #
3049 # Cloud Run on GKE: supported
3050 #
3051 # Specify whether the Secret or its key must be defined
3052 # +optional
3053 "name": "A String", # Cloud Run fully managed: not supported
3054 #
3055 # Cloud Run on GKE: supported
3056 #
3057 # The name of the secret in the pod's namespace to select from.
3058 "key": "A String", # Cloud Run fully managed: not supported
3059 #
3060 # Cloud Run on GKE: supported
3061 #
3062 # The key of the secret to select from. Must be a valid secret key.
3063 },
3064 "configMapKeyRef": { # Cloud Run fully managed: not supported # Cloud Run fully managed: not supported
3065 #
3066 # Cloud Run on GKE: supported
3067 #
3068 # Selects a key of a ConfigMap.
3069 # +optional
3070 #
3071 # Cloud Run on GKE: supported
3072 #
3073 # Selects a key from a ConfigMap.
3074 "localObjectReference": { # LocalObjectReference contains enough information to let you locate the # This field should not be used directly as it is meant to be inlined
3075 # directly into the message. Use the "name" field instead.
3076 # referenced object inside the same namespace.
3077 "name": "A String", # Name of the referent.
3078 # More info:
3079 # https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
3080 },
3081 "optional": True or False, # Cloud Run fully managed: not supported
3082 #
3083 # Cloud Run on GKE: supported
3084 #
3085 # Specify whether the ConfigMap or its key must be defined
3086 # +optional
3087 "name": "A String", # Cloud Run fully managed: not supported
3088 #
3089 # Cloud Run on GKE: supported
3090 #
3091 # The ConfigMap to select from.
3092 "key": "A String", # Cloud Run fully managed: not supported
3093 #
3094 # Cloud Run on GKE: supported
3095 #
3096 # The key to select.
3097 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003098 },
Dan O'Mearadd494642020-05-01 07:42:23 -07003099 "name": "A String", # Name of the environment variable. Must be a C_IDENTIFIER.
3100 "value": "A String", # Variable references $(VAR_NAME) are expanded
3101 # using the previous defined environment variables in the container and
3102 # any route environment variables. If a variable cannot be resolved,
3103 # the reference in the input string will be unchanged. The $(VAR_NAME)
3104 # syntax can be escaped with a double $$, ie: $$(VAR_NAME). Escaped
3105 # references will never be expanded, regardless of whether the variable
3106 # exists or not.
3107 # Defaults to "".
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003108 # +optional
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003109 },
Dan O'Mearadd494642020-05-01 07:42:23 -07003110 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003111 "imagePullPolicy": "A String", # Image pull policy.
3112 # One of Always, Never, IfNotPresent.
3113 # Defaults to Always if :latest tag is specified, or IfNotPresent otherwise.
3114 # Cannot be updated.
3115 # More info:
3116 # https://kubernetes.io/docs/concepts/containers/images#updating-images
3117 # +optional
3118 "readinessProbe": { # Probe describes a health check to be performed against a container to # Periodic probe of container service readiness.
3119 # Container will be removed from service endpoints if the probe fails.
3120 # Cannot be updated.
3121 # More info:
3122 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
3123 # +optional
3124 # determine whether it is alive or ready to receive traffic.
3125 "timeoutSeconds": 42, # Number of seconds after which the probe times out.
3126 # Defaults to 1 second. Minimum value is 1.
3127 # More info:
3128 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
3129 # +optional
3130 "initialDelaySeconds": 42, # Number of seconds after the container has started before liveness probes
3131 # are initiated. More info:
3132 # https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
3133 # +optional
3134 "handler": { # Handler defines a specific action that should be taken # The action taken to determine the health of a container
3135 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
3136 # TCP hooks not yet supported
3137 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
3138 # +optional
3139 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
3140 # Number must be in the range 1 to 65535.
3141 # Name must be an IANA_SVC_NAME.
3142 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
3143 # inner type. This allows you to have, for example, a JSON field that can
3144 # accept a name or number.
3145 "strVal": "A String", # The string value.
Dan O'Mearadd494642020-05-01 07:42:23 -07003146 "type": 42, # The type of the value.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003147 "intVal": 42, # The int value.
3148 },
3149 },
3150 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
3151 # +optional
3152 "path": "A String", # Path to access on the HTTP server.
3153 # +optional
3154 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
3155 # "Host" in httpHeaders instead.
3156 # +optional
3157 "scheme": "A String", # Scheme to use for connecting to the host.
3158 # Defaults to HTTP.
3159 # +optional
3160 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
3161 # Number must be in the range 1 to 65535.
3162 # Name must be an IANA_SVC_NAME.
3163 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
3164 # inner type. This allows you to have, for example, a JSON field that can
3165 # accept a name or number.
3166 "strVal": "A String", # The string value.
Dan O'Mearadd494642020-05-01 07:42:23 -07003167 "type": 42, # The type of the value.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003168 "intVal": 42, # The int value.
3169 },
3170 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
3171 # +optional
3172 { # HTTPHeader describes a custom header to be used in HTTP probes
3173 "name": "A String", # The header field name
3174 "value": "A String", # The header field value
3175 },
3176 ],
3177 },
3178 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
3179 # Exec specifies the action to take.
3180 # +optional
3181 "command": "A String", # Command is the command line to execute inside the container, the working
3182 # directory for the command is root ('/') in the container's filesystem. The
3183 # command is simply exec'd, it is not run inside a shell, so traditional
3184 # shell instructions ('|', etc) won't work. To use a shell, you need to
3185 # explicitly call out to that shell. Exit status of 0 is treated as
3186 # live/healthy and non-zero is unhealthy. +optional
3187 },
3188 },
3189 "periodSeconds": 42, # How often (in seconds) to perform the probe.
3190 # Default to 10 seconds. Minimum value is 1.
3191 # +optional
3192 "successThreshold": 42, # Minimum consecutive successes for the probe to be considered successful
3193 # after having failed. Defaults to 1. Must be 1 for liveness. Minimum value
3194 # is 1. +optional
3195 "failureThreshold": 42, # Minimum consecutive failures for the probe to be considered failed after
3196 # having succeeded. Defaults to 3. Minimum value is 1. +optional
3197 },
3198 "terminationMessagePath": "A String", # Optional: Path at which the file to which the container's termination
3199 # message will be written is mounted into the container's filesystem. Message
3200 # written is intended to be brief final status, such as an assertion failure
3201 # message. Will be truncated by the node if greater than 4096 bytes. The
3202 # total message length across all containers will be limited to 12kb.
3203 # Defaults to /dev/termination-log.
3204 # Cannot be updated.
3205 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07003206 "image": "A String", # Docker image name.
3207 # More info: https://kubernetes.io/docs/concepts/containers/images
3208 "lifecycle": { # Lifecycle describes actions that the management system should take in # Actions that the management system should take in response to container
3209 # lifecycle events. Cannot be updated. +optional
3210 # response to container lifecycle events. For the PostStart and PreStop
3211 # lifecycle handlers, management of the container blocks until the action is
3212 # complete, unless the container process fails, in which case the handler is
3213 # aborted.
3214 "preStop": { # Handler defines a specific action that should be taken # PreStop is called immediately before a container is terminated.
3215 # The container is terminated after the handler completes.
3216 # The reason for termination is passed to the handler.
3217 # Regardless of the outcome of the handler, the container is eventually
3218 # terminated. Other management of the container blocks until the hook
3219 # completes. More info:
3220 # https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
3221 # +optional
3222 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
3223 # TCP hooks not yet supported
3224 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
3225 # +optional
3226 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
3227 # Number must be in the range 1 to 65535.
3228 # Name must be an IANA_SVC_NAME.
3229 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
3230 # inner type. This allows you to have, for example, a JSON field that can
3231 # accept a name or number.
3232 "strVal": "A String", # The string value.
3233 "type": 42, # The type of the value.
3234 "intVal": 42, # The int value.
3235 },
3236 },
3237 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003238 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07003239 "path": "A String", # Path to access on the HTTP server.
3240 # +optional
3241 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
3242 # "Host" in httpHeaders instead.
3243 # +optional
3244 "scheme": "A String", # Scheme to use for connecting to the host.
3245 # Defaults to HTTP.
3246 # +optional
3247 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
3248 # Number must be in the range 1 to 65535.
3249 # Name must be an IANA_SVC_NAME.
3250 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
3251 # inner type. This allows you to have, for example, a JSON field that can
3252 # accept a name or number.
3253 "strVal": "A String", # The string value.
3254 "type": 42, # The type of the value.
3255 "intVal": 42, # The int value.
3256 },
3257 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
3258 # +optional
3259 { # HTTPHeader describes a custom header to be used in HTTP probes
3260 "name": "A String", # The header field name
3261 "value": "A String", # The header field value
3262 },
3263 ],
3264 },
3265 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
3266 # Exec specifies the action to take.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003267 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07003268 "command": "A String", # Command is the command line to execute inside the container, the working
3269 # directory for the command is root ('/') in the container's filesystem. The
3270 # command is simply exec'd, it is not run inside a shell, so traditional
3271 # shell instructions ('|', etc) won't work. To use a shell, you need to
3272 # explicitly call out to that shell. Exit status of 0 is treated as
3273 # live/healthy and non-zero is unhealthy. +optional
3274 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003275 },
Dan O'Mearadd494642020-05-01 07:42:23 -07003276 "postStart": { # Handler defines a specific action that should be taken # PostStart is called immediately after a container is created. If the
3277 # handler fails, the container is terminated and restarted according to its
3278 # restart policy. Other management of the container blocks until the hook
3279 # completes. More info:
3280 # https://kubernetes.io/docs/concepts/containers/container-lifecycle-hooks/#container-hooks
3281 # +optional
3282 "tcpSocket": { # TCPSocketAction describes an action based on opening a socket # TCPSocket specifies an action involving a TCP port.
3283 # TCP hooks not yet supported
3284 "host": "A String", # Optional: Host name to connect to, defaults to the pod IP.
3285 # +optional
3286 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Number or name of the port to access on the container.
3287 # Number must be in the range 1 to 65535.
3288 # Name must be an IANA_SVC_NAME.
3289 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
3290 # inner type. This allows you to have, for example, a JSON field that can
3291 # accept a name or number.
3292 "strVal": "A String", # The string value.
3293 "type": 42, # The type of the value.
3294 "intVal": 42, # The int value.
3295 },
3296 },
3297 "httpGet": { # HTTPGetAction describes an action based on HTTP Get requests. # HTTPGet specifies the http request to perform.
3298 # +optional
3299 "path": "A String", # Path to access on the HTTP server.
3300 # +optional
3301 "host": "A String", # Host name to connect to, defaults to the pod IP. You probably want to set
3302 # "Host" in httpHeaders instead.
3303 # +optional
3304 "scheme": "A String", # Scheme to use for connecting to the host.
3305 # Defaults to HTTP.
3306 # +optional
3307 "port": { # IntOrString is a type that can hold an int32 or a string. When used in # Name or number of the port to access on the container.
3308 # Number must be in the range 1 to 65535.
3309 # Name must be an IANA_SVC_NAME.
3310 # JSON or YAML marshalling and unmarshalling, it produces or consumes the
3311 # inner type. This allows you to have, for example, a JSON field that can
3312 # accept a name or number.
3313 "strVal": "A String", # The string value.
3314 "type": 42, # The type of the value.
3315 "intVal": 42, # The int value.
3316 },
3317 "httpHeaders": [ # Custom headers to set in the request. HTTP allows repeated headers.
3318 # +optional
3319 { # HTTPHeader describes a custom header to be used in HTTP probes
3320 "name": "A String", # The header field name
3321 "value": "A String", # The header field value
3322 },
3323 ],
3324 },
3325 "exec": { # ExecAction describes a "run in container" action. # One and only one of the following should be specified.
3326 # Exec specifies the action to take.
3327 # +optional
3328 "command": "A String", # Command is the command line to execute inside the container, the working
3329 # directory for the command is root ('/') in the container's filesystem. The
3330 # command is simply exec'd, it is not run inside a shell, so traditional
3331 # shell instructions ('|', etc) won't work. To use a shell, you need to
3332 # explicitly call out to that shell. Exit status of 0 is treated as
3333 # live/healthy and non-zero is unhealthy. +optional
3334 },
3335 },
3336 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003337 "resources": { # ResourceRequirements describes the compute resource requirements. # Compute Resources required by this container.
3338 # Cannot be updated.
3339 # More info:
3340 # https://kubernetes.io/docs/concepts/storage/persistent-volumes#resources
3341 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07003342 "limitsInMap": { # Limits describes the maximum amount of compute resources allowed.
3343 # This is a temporary field created to migrate away from the
3344 # map&lt;string, Quantity&gt; limits field. This is done to become compliant
3345 # with k8s style API.
3346 # This field is deprecated in favor of limits field.
3347 "a_key": { # The view model of a single quantity, e.g. "800 MiB". Corresponds to
3348 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/generated.proto
3349 "string": "A String", # Stringified version of the quantity, e.g., "800 MiB".
3350 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003351 },
3352 "requestsInMap": { # Requests describes the minimum amount of compute resources required.
3353 # If Requests is omitted for a container, it defaults to Limits if that is
3354 # explicitly specified, otherwise to an implementation-defined value.
3355 # This is a temporary field created to migrate away from the
Dan O'Mearadd494642020-05-01 07:42:23 -07003356 # map&lt;string, Quantity&gt; requests field. This is done to become compliant
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003357 # with k8s style API.
3358 # This field is deprecated in favor of requests field.
3359 "a_key": { # The view model of a single quantity, e.g. "800 MiB". Corresponds to
3360 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/generated.proto
3361 "string": "A String", # Stringified version of the quantity, e.g., "800 MiB".
3362 },
3363 },
Dan O'Mearadd494642020-05-01 07:42:23 -07003364 "requests": { # Requests describes the minimum amount of compute resources required.
3365 # If Requests is omitted for a container, it defaults to Limits if that is
3366 # explicitly specified, otherwise to an implementation-defined value.
3367 # The values of the map is string form of the 'quantity' k8s type:
3368 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go
3369 "a_key": "A String",
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003370 },
3371 "limits": { # Limits describes the maximum amount of compute resources allowed.
3372 # The values of the map is string form of the 'quantity' k8s type:
3373 # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go
3374 "a_key": "A String",
3375 },
3376 },
3377 "workingDir": "A String", # Container's working directory.
3378 # If not specified, the container runtime's default will be used, which
3379 # might be configured in the container image.
3380 # Cannot be updated.
3381 # +optional
3382 },
3383 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07003384 "serviceAccountName": "A String", # Email address of the IAM service account associated with the revision
3385 # of the service. The service account represents the identity of the
3386 # running revision, and determines what permissions the revision has. If
3387 # not provided, the revision will use the project's default service account.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003388 },
Dan O'Mearadd494642020-05-01 07:42:23 -07003389 "apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1alpha1".
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003390 "metadata": { # ObjectMeta is metadata that all persisted resources must have, which includes # Metadata associated with this Revision, including name, namespace, labels,
3391 # and annotations.
3392 # all objects users must create.
3393 "ownerReferences": [ # List of objects that own this object. If ALL objects in the list have
3394 # been deleted, this object will be garbage collected.
3395 # +optional
3396 { # OwnerReference contains enough information to let you identify an owning
3397 # object. Currently, an owning object must be in the same namespace, so there
3398 # is no namespace field.
3399 "kind": "A String", # Kind of the referent.
3400 # More info:
3401 # https://git.k8s.io/community/contributors/devel/api-conventions.md#types-kinds
Dan O'Mearadd494642020-05-01 07:42:23 -07003402 "name": "A String", # Name of the referent.
3403 # More info: http://kubernetes.io/docs/user-guide/identifiers#names
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003404 "apiVersion": "A String", # API version of the referent.
3405 "controller": True or False, # If true, this reference points to the managing controller.
3406 # +optional
3407 "blockOwnerDeletion": True or False, # If true, AND if the owner has the "foregroundDeletion" finalizer, then
3408 # the owner cannot be deleted from the key-value store until this
3409 # reference is removed.
3410 # Defaults to false.
3411 # To set this field, a user needs "delete" permission of the owner,
3412 # otherwise 422 (Unprocessable Entity) will be returned.
3413 # +optional
Dan O'Mearadd494642020-05-01 07:42:23 -07003414 "uid": "A String", # UID of the referent.
3415 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003416 },
3417 ],
3418 "name": "A String", # Name must be unique within a namespace, within a Cloud Run region.
3419 # Is required when creating
3420 # resources, although some resources may allow a client to request the
3421 # generation of an appropriate name automatically. Name is primarily intended
3422 # for creation idempotence and configuration definition. Cannot be updated.
3423 # More info: http://kubernetes.io/docs/user-guide/identifiers#names
3424 # +optional
3425 "deletionTimestamp": "A String", # DeletionTimestamp is RFC 3339 date and time at which this resource will be
3426 # deleted. This field is set by the server when a graceful deletion is
3427 # requested by the user, and is not directly settable by a client. The
3428 # resource is expected to be deleted (no longer visible from resource lists,
3429 # and not reachable by name) after the time in this field, once the
3430 # finalizers list is empty. As long as the finalizers list contains items,
3431 # deletion is blocked. Once the deletionTimestamp is set, this value may not
3432 # be unset or be set further into the future, although it may be shortened or
3433 # the resource may be deleted prior to this time. For example, a user may
3434 # request that a pod is deleted in 30 seconds. The Kubelet will react by
3435 # sending a graceful termination signal to the containers in the pod. After
3436 # that 30 seconds, the Kubelet will send a hard termination signal (SIGKILL)
3437 # to the container and after cleanup, remove the pod from the API. In the
3438 # presence of network partitions, this object may still exist after this
3439 # timestamp, until an administrator or automated process can determine the
3440 # resource is fully terminated.
3441 # If not set, graceful deletion of the object has not been requested.
3442 #
3443 # Populated by the system when a graceful deletion is requested.
3444 # Read-only.
3445 # More info:
3446 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata
3447 # +optional
3448 "clusterName": "A String", # Not currently supported by Cloud Run.
3449 #
3450 # The name of the cluster which the object belongs to.
3451 # This is used to distinguish resources with same name and namespace in
3452 # different clusters. This field is not set anywhere right now and apiserver
3453 # is going to ignore it if set in create or update request. +optional
3454 "deletionGracePeriodSeconds": 42, # Not currently supported by Cloud Run.
3455 #
3456 # Number of seconds allowed for this object to gracefully terminate before
3457 # it will be removed from the system. Only set when deletionTimestamp is also
3458 # set. May only be shortened. Read-only. +optional
3459 "labels": { # Map of string keys and values that can be used to organize and categorize
3460 # (scope and select) objects. May match selectors of replication controllers
3461 # and routes.
3462 # More info: http://kubernetes.io/docs/user-guide/labels
3463 # +optional
3464 "a_key": "A String",
3465 },
3466 "namespace": "A String", # Namespace defines the space within each name must be unique, within a
3467 # Cloud Run region. In Cloud Run the namespace must be equal to either the
3468 # project ID or project number.
3469 "generation": 42, # A sequence number representing a specific generation of the desired state.
3470 # Populated by the system. Read-only.
3471 # +optional
3472 "finalizers": [ # Not currently supported by Cloud Run.
3473 #
3474 # Must be empty before the object is deleted from the registry. Each entry
3475 # is an identifier for the responsible component that will remove the entry
3476 # from the list. If the deletionTimestamp of the object is non-nil, entries
3477 # in this list can only be removed.
3478 # +optional
3479 # +patchStrategy=merge
3480 "A String",
3481 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003482 "resourceVersion": "A String", # An opaque value that represents the internal version of this object that
3483 # can be used by clients to determine when objects have changed. May be used
3484 # for optimistic concurrency, change detection, and the watch operation on a
3485 # resource or set of resources. Clients must treat these values as opaque and
3486 # passed unmodified back to the server. They may only be valid for a
3487 # particular resource or set of resources.
3488 #
3489 # Populated by the system.
3490 # Read-only.
3491 # Value must be treated as opaque by clients and .
3492 # More info:
3493 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
3494 # +optional
3495 "generateName": "A String", # Not currently supported by Cloud Run.
3496 #
3497 # GenerateName is an optional prefix, used by the server, to generate a
3498 # unique name ONLY IF the Name field has not been provided. If this field is
3499 # used, the name returned to the client will be different than the name
3500 # passed. This value will also be combined with a unique suffix. The provided
3501 # value has the same validation rules as the Name field, and may be truncated
3502 # by the length of the suffix required to make the value unique on the
3503 # server.
3504 #
3505 # If this field is specified and the generated name exists, the server will
3506 # NOT return a 409 - instead, it will either return 201 Created or 500 with
3507 # Reason ServerTimeout indicating a unique name could not be found in the
3508 # time allotted, and the client should retry (optionally after the time
3509 # indicated in the Retry-After header).
3510 #
3511 # Applied only if Name is not specified.
3512 # More info:
3513 # https://git.k8s.io/community/contributors/devel/api-conventions.md#idempotency
3514 # +optional
3515 # string generateName = 2;
3516 "creationTimestamp": "A String", # CreationTimestamp is a timestamp representing the server time when this
3517 # object was created. It is not guaranteed to be set in happens-before order
3518 # across separate operations. Clients may not set this value. It is
3519 # represented in RFC3339 form and is in UTC.
3520 #
3521 # Populated by the system.
3522 # Read-only.
3523 # Null for lists.
3524 # More info:
3525 # https://git.k8s.io/community/contributors/devel/api-conventions.md#metadata
3526 # +optional
3527 "annotations": { # Annotations is an unstructured key value map stored with a resource that
3528 # may be set by external tools to store and retrieve arbitrary metadata. They
3529 # are not queryable and should be preserved when modifying objects. More
3530 # info: http://kubernetes.io/docs/user-guide/annotations +optional
3531 "a_key": "A String",
3532 },
3533 "selfLink": "A String", # SelfLink is a URL representing this object.
3534 # Populated by the system.
3535 # Read-only.
3536 # +optional
3537 # string selfLink = 4;
3538 "uid": "A String", # UID is the unique in time and space value for this object. It is typically
3539 # generated by the server on successful creation of a resource and is not
3540 # allowed to change on PUT operations.
3541 #
3542 # Populated by the system.
3543 # Read-only.
3544 # More info: http://kubernetes.io/docs/user-guide/identifiers#uids
3545 # +optional
3546 },
3547 },
3548 ],
Dan O'Mearadd494642020-05-01 07:42:23 -07003549 "apiVersion": "A String", # The API version for this call such as "serving.knative.dev/v1alpha1".
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07003550 "metadata": { # ListMeta describes metadata that synthetic resources must have, including # Metadata associated with this revision list.
3551 # lists and various status objects. A resource may have only one of
3552 # {ObjectMeta, ListMeta}.
3553 "continue": "A String", # continue may be set if the user set a limit on the number of items
3554 # returned, and indicates that the server has more data available. The value
3555 # is opaque and may be used to issue another request to the endpoint that
3556 # served this list to retrieve the next set of available objects. Continuing
3557 # a list may not be possible if the server configuration has changed or more
3558 # than a few minutes have passed. The resourceVersion field returned when
3559 # using this continue value will be identical to the value in the first
3560 # response.
3561 "selfLink": "A String", # SelfLink is a URL representing this object.
3562 # Populated by the system.
3563 # Read-only.
3564 # +optional
3565 "resourceVersion": "A String", # String that identifies the server's internal version of this object that
3566 # can be used by clients to determine when objects have changed. Value must
3567 # be treated as opaque by clients and passed unmodified back to the server.
3568 # Populated by the system.
3569 # Read-only.
3570 # More info:
3571 # https://git.k8s.io/community/contributors/devel/api-conventions.md#concurrency-control-and-consistency
3572 # +optional
3573 },
3574 }</pre>
3575</div>
3576
3577</body></html>