google-cloud-run-v2 0.4.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +6 -6
  3. data/README.md +4 -4
  4. data/lib/google/cloud/run/v2/condition_pb.rb +1 -0
  5. data/lib/google/cloud/run/v2/execution_pb.rb +79 -0
  6. data/lib/google/cloud/run/v2/execution_services_pb.rb +49 -0
  7. data/lib/google/cloud/run/v2/execution_template_pb.rb +29 -0
  8. data/lib/google/cloud/run/v2/executions/client.rb +635 -0
  9. data/lib/google/cloud/run/v2/executions/credentials.rb +47 -0
  10. data/lib/google/cloud/run/v2/executions/operations.rb +778 -0
  11. data/lib/google/cloud/run/v2/executions/paths.rb +73 -0
  12. data/lib/google/cloud/run/v2/executions.rb +50 -0
  13. data/lib/google/cloud/run/v2/job_pb.rb +105 -0
  14. data/lib/google/cloud/run/v2/job_services_pb.rb +65 -0
  15. data/lib/google/cloud/run/v2/jobs/client.rb +1259 -0
  16. data/lib/google/cloud/run/v2/jobs/credentials.rb +47 -0
  17. data/lib/google/cloud/run/v2/jobs/operations.rb +778 -0
  18. data/lib/google/cloud/run/v2/jobs/paths.rb +166 -0
  19. data/lib/google/cloud/run/v2/jobs.rb +50 -0
  20. data/lib/google/cloud/run/v2/k8s.min_pb.rb +6 -0
  21. data/lib/google/cloud/run/v2/revision_pb.rb +2 -0
  22. data/lib/google/cloud/run/v2/revision_services_pb.rb +2 -2
  23. data/lib/google/cloud/run/v2/revisions/client.rb +2 -2
  24. data/lib/google/cloud/run/v2/revisions/operations.rb +8 -0
  25. data/lib/google/cloud/run/v2/revisions.rb +1 -1
  26. data/lib/google/cloud/run/v2/service_services_pb.rb +2 -2
  27. data/lib/google/cloud/run/v2/services/client.rb +13 -10
  28. data/lib/google/cloud/run/v2/services/operations.rb +8 -0
  29. data/lib/google/cloud/run/v2/services.rb +1 -1
  30. data/lib/google/cloud/run/v2/task_pb.rb +82 -0
  31. data/lib/google/cloud/run/v2/task_services_pb.rb +47 -0
  32. data/lib/google/cloud/run/v2/task_template_pb.rb +36 -0
  33. data/lib/google/cloud/run/v2/tasks/client.rb +512 -0
  34. data/lib/google/cloud/run/v2/tasks/credentials.rb +47 -0
  35. data/lib/google/cloud/run/v2/tasks/paths.rb +77 -0
  36. data/lib/google/cloud/run/v2/tasks.rb +49 -0
  37. data/lib/google/cloud/run/v2/vendor_settings_pb.rb +6 -0
  38. data/lib/google/cloud/run/v2/version.rb +1 -1
  39. data/lib/google/cloud/run/v2.rb +6 -3
  40. data/proto_docs/google/api/client.rb +318 -0
  41. data/proto_docs/google/api/launch_stage.rb +3 -3
  42. data/proto_docs/google/cloud/run/v2/condition.rb +4 -0
  43. data/proto_docs/google/cloud/run/v2/execution.rb +233 -0
  44. data/proto_docs/google/cloud/run/v2/execution_template.rb +87 -0
  45. data/proto_docs/google/cloud/run/v2/job.rb +316 -0
  46. data/proto_docs/google/cloud/run/v2/k8s.min.rb +42 -15
  47. data/proto_docs/google/cloud/run/v2/revision.rb +19 -13
  48. data/proto_docs/google/cloud/run/v2/revision_template.rb +10 -0
  49. data/proto_docs/google/cloud/run/v2/service.rb +52 -39
  50. data/proto_docs/google/cloud/run/v2/task.rb +232 -0
  51. data/proto_docs/google/cloud/run/v2/task_template.rb +66 -0
  52. data/proto_docs/google/cloud/run/v2/vendor_settings.rb +14 -1
  53. data/proto_docs/google/rpc/status.rb +4 -2
  54. metadata +35 -7
@@ -0,0 +1,87 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Cloud
22
+ module Run
23
+ module V2
24
+ # ExecutionTemplate describes the data an execution should have when created
25
+ # from a template.
26
+ # @!attribute [rw] labels
27
+ # @return [::Google::Protobuf::Map{::String => ::String}]
28
+ # KRM-style labels for the resource.
29
+ #
30
+ # <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
31
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
32
+ # namespaces, and they will be rejected. All system labels in v1 now have a
33
+ # corresponding field in v2 ExecutionTemplate.
34
+ # @!attribute [rw] annotations
35
+ # @return [::Google::Protobuf::Map{::String => ::String}]
36
+ # KRM-style annotations for the resource.
37
+ #
38
+ # <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
39
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
40
+ # namespaces, and they will be rejected. All system annotations in v1 now
41
+ # have a corresponding field in v2 ExecutionTemplate.
42
+ # @!attribute [rw] parallelism
43
+ # @return [::Integer]
44
+ # Specifies the maximum desired number of tasks the execution should run at
45
+ # given time. Must be <= task_count.
46
+ # When the job is run, if this field is 0 or unset, the maximum possible
47
+ # value will be used for that execution.
48
+ # The actual number of tasks running in steady state will be less than this
49
+ # number when there are fewer tasks waiting to be completed remaining,
50
+ # i.e. when the work left to do is less than max parallelism.
51
+ # @!attribute [rw] task_count
52
+ # @return [::Integer]
53
+ # Specifies the desired number of tasks the execution should run.
54
+ # Setting to 1 means that parallelism is limited to 1 and the success of
55
+ # that task signals the success of the execution.
56
+ # More info:
57
+ # https://kubernetes.io/docs/concepts/workloads/controllers/jobs-run-to-completion/
58
+ # @!attribute [rw] template
59
+ # @return [::Google::Cloud::Run::V2::TaskTemplate]
60
+ # Required. Describes the task(s) that will be created when executing an
61
+ # execution.
62
+ class ExecutionTemplate
63
+ include ::Google::Protobuf::MessageExts
64
+ extend ::Google::Protobuf::MessageExts::ClassMethods
65
+
66
+ # @!attribute [rw] key
67
+ # @return [::String]
68
+ # @!attribute [rw] value
69
+ # @return [::String]
70
+ class LabelsEntry
71
+ include ::Google::Protobuf::MessageExts
72
+ extend ::Google::Protobuf::MessageExts::ClassMethods
73
+ end
74
+
75
+ # @!attribute [rw] key
76
+ # @return [::String]
77
+ # @!attribute [rw] value
78
+ # @return [::String]
79
+ class AnnotationsEntry
80
+ include ::Google::Protobuf::MessageExts
81
+ extend ::Google::Protobuf::MessageExts::ClassMethods
82
+ end
83
+ end
84
+ end
85
+ end
86
+ end
87
+ end
@@ -0,0 +1,316 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2022 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Cloud
22
+ module Run
23
+ module V2
24
+ # Request message for creating a Job.
25
+ # @!attribute [rw] parent
26
+ # @return [::String]
27
+ # Required. The location and project in which this Job should be created.
28
+ # Format: projects/\\{project}/locations/\\{location}, where \\{project} can be
29
+ # project id or number.
30
+ # @!attribute [rw] job
31
+ # @return [::Google::Cloud::Run::V2::Job]
32
+ # Required. The Job instance to create.
33
+ # @!attribute [rw] job_id
34
+ # @return [::String]
35
+ # Required. The unique identifier for the Job. The name of the job becomes
36
+ # \\{parent}/jobs/\\{job_id}.
37
+ # @!attribute [rw] validate_only
38
+ # @return [::Boolean]
39
+ # Indicates that the request should be validated and default values
40
+ # populated, without persisting the request or creating any resources.
41
+ class CreateJobRequest
42
+ include ::Google::Protobuf::MessageExts
43
+ extend ::Google::Protobuf::MessageExts::ClassMethods
44
+ end
45
+
46
+ # Request message for obtaining a Job by its full name.
47
+ # @!attribute [rw] name
48
+ # @return [::String]
49
+ # Required. The full name of the Job.
50
+ # Format: projects/\\{project}/locations/\\{location}/jobs/\\{job}, where \\{project}
51
+ # can be project id or number.
52
+ class GetJobRequest
53
+ include ::Google::Protobuf::MessageExts
54
+ extend ::Google::Protobuf::MessageExts::ClassMethods
55
+ end
56
+
57
+ # Request message for updating a Job.
58
+ # @!attribute [rw] job
59
+ # @return [::Google::Cloud::Run::V2::Job]
60
+ # Required. The Job to be updated.
61
+ # @!attribute [rw] validate_only
62
+ # @return [::Boolean]
63
+ # Indicates that the request should be validated and default values
64
+ # populated, without persisting the request or updating any resources.
65
+ # @!attribute [rw] allow_missing
66
+ # @return [::Boolean]
67
+ # If set to true, and if the Job does not exist, it will create a new
68
+ # one. Caller must have both create and update permissions for this call if
69
+ # this is set to true.
70
+ class UpdateJobRequest
71
+ include ::Google::Protobuf::MessageExts
72
+ extend ::Google::Protobuf::MessageExts::ClassMethods
73
+ end
74
+
75
+ # Request message for retrieving a list of Jobs.
76
+ # @!attribute [rw] parent
77
+ # @return [::String]
78
+ # Required. The location and project to list resources on.
79
+ # Format: projects/\\{project}/locations/\\{location}, where \\{project} can be
80
+ # project id or number.
81
+ # @!attribute [rw] page_size
82
+ # @return [::Integer]
83
+ # Maximum number of Jobs to return in this call.
84
+ # @!attribute [rw] page_token
85
+ # @return [::String]
86
+ # A page token received from a previous call to ListJobs.
87
+ # All other parameters must match.
88
+ # @!attribute [rw] show_deleted
89
+ # @return [::Boolean]
90
+ # If true, returns deleted (but unexpired) resources along with active ones.
91
+ class ListJobsRequest
92
+ include ::Google::Protobuf::MessageExts
93
+ extend ::Google::Protobuf::MessageExts::ClassMethods
94
+ end
95
+
96
+ # Response message containing a list of Jobs.
97
+ # @!attribute [rw] jobs
98
+ # @return [::Array<::Google::Cloud::Run::V2::Job>]
99
+ # The resulting list of Jobs.
100
+ # @!attribute [rw] next_page_token
101
+ # @return [::String]
102
+ # A token indicating there are more items than page_size. Use it in the next
103
+ # ListJobs request to continue.
104
+ class ListJobsResponse
105
+ include ::Google::Protobuf::MessageExts
106
+ extend ::Google::Protobuf::MessageExts::ClassMethods
107
+ end
108
+
109
+ # Request message to delete a Job by its full name.
110
+ # @!attribute [rw] name
111
+ # @return [::String]
112
+ # Required. The full name of the Job.
113
+ # Format: projects/\\{project}/locations/\\{location}/jobs/\\{job}, where \\{project}
114
+ # can be project id or number.
115
+ # @!attribute [rw] validate_only
116
+ # @return [::Boolean]
117
+ # Indicates that the request should be validated without actually
118
+ # deleting any resources.
119
+ # @!attribute [rw] etag
120
+ # @return [::String]
121
+ # A system-generated fingerprint for this version of the
122
+ # resource. May be used to detect modification conflict during updates.
123
+ class DeleteJobRequest
124
+ include ::Google::Protobuf::MessageExts
125
+ extend ::Google::Protobuf::MessageExts::ClassMethods
126
+ end
127
+
128
+ # Request message to create a new Execution of a Job.
129
+ # @!attribute [rw] name
130
+ # @return [::String]
131
+ # Required. The full name of the Job.
132
+ # Format: projects/\\{project}/locations/\\{location}/jobs/\\{job}, where \\{project}
133
+ # can be project id or number.
134
+ # @!attribute [rw] validate_only
135
+ # @return [::Boolean]
136
+ # Indicates that the request should be validated without actually
137
+ # deleting any resources.
138
+ # @!attribute [rw] etag
139
+ # @return [::String]
140
+ # A system-generated fingerprint for this version of the
141
+ # resource. May be used to detect modification conflict during updates.
142
+ class RunJobRequest
143
+ include ::Google::Protobuf::MessageExts
144
+ extend ::Google::Protobuf::MessageExts::ClassMethods
145
+ end
146
+
147
+ # Job represents the configuration of a single job, which references a
148
+ # container image that is run to completion.
149
+ # @!attribute [rw] name
150
+ # @return [::String]
151
+ # The fully qualified name of this Job.
152
+ #
153
+ # Format:
154
+ # projects/\\{project}/locations/\\{location}/jobs/\\{job}
155
+ # @!attribute [r] uid
156
+ # @return [::String]
157
+ # Output only. Server assigned unique identifier for the Execution. The value
158
+ # is a UUID4 string and guaranteed to remain unchanged until the resource is
159
+ # deleted.
160
+ # @!attribute [r] generation
161
+ # @return [::Integer]
162
+ # Output only. A number that monotonically increases every time the user
163
+ # modifies the desired state.
164
+ # @!attribute [rw] labels
165
+ # @return [::Google::Protobuf::Map{::String => ::String}]
166
+ # KRM-style labels for the resource.
167
+ # User-provided labels are shared with Google's billing system, so they can
168
+ # be used to filter, or break down billing charges by team, component,
169
+ # environment, state, etc. For more information, visit
170
+ # https://cloud.google.com/resource-manager/docs/creating-managing-labels or
171
+ # https://cloud.google.com/run/docs/configuring/labels
172
+ #
173
+ # <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
174
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
175
+ # namespaces, and they will be rejected. All system labels in v1 now have a
176
+ # corresponding field in v2 Job.
177
+ # @!attribute [rw] annotations
178
+ # @return [::Google::Protobuf::Map{::String => ::String}]
179
+ # KRM-style annotations for the resource. Unstructured key value map that may
180
+ # be set by external tools to store and arbitrary metadata.
181
+ # They are not queryable and should be preserved
182
+ # when modifying objects.
183
+ #
184
+ # <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
185
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
186
+ # namespaces, and they will be rejected. All system annotations in v1 now
187
+ # have a corresponding field in v2 Job.
188
+ #
189
+ # <p>This field follows Kubernetes annotations' namespacing, limits, and
190
+ # rules. More info: https://kubernetes.io/docs/user-guide/annotations
191
+ # @!attribute [r] create_time
192
+ # @return [::Google::Protobuf::Timestamp]
193
+ # Output only. The creation time.
194
+ # @!attribute [r] update_time
195
+ # @return [::Google::Protobuf::Timestamp]
196
+ # Output only. The last-modified time.
197
+ # @!attribute [r] delete_time
198
+ # @return [::Google::Protobuf::Timestamp]
199
+ # Output only. The deletion time.
200
+ # @!attribute [r] expire_time
201
+ # @return [::Google::Protobuf::Timestamp]
202
+ # Output only. For a deleted resource, the time after which it will be
203
+ # permamently deleted.
204
+ # @!attribute [r] creator
205
+ # @return [::String]
206
+ # Output only. Email address of the authenticated creator.
207
+ # @!attribute [r] last_modifier
208
+ # @return [::String]
209
+ # Output only. Email address of the last authenticated modifier.
210
+ # @!attribute [rw] client
211
+ # @return [::String]
212
+ # Arbitrary identifier for the API client.
213
+ # @!attribute [rw] client_version
214
+ # @return [::String]
215
+ # Arbitrary version identifier for the API client.
216
+ # @!attribute [rw] launch_stage
217
+ # @return [::Google::Api::LaunchStage]
218
+ # The launch stage as defined by [Google Cloud Platform
219
+ # Launch Stages](https://cloud.google.com/terms/launch-stages).
220
+ # Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA
221
+ # is assumed.
222
+ # @!attribute [rw] binary_authorization
223
+ # @return [::Google::Cloud::Run::V2::BinaryAuthorization]
224
+ # Settings for the Binary Authorization feature.
225
+ # @!attribute [rw] template
226
+ # @return [::Google::Cloud::Run::V2::ExecutionTemplate]
227
+ # Required. The template used to create executions for this Job.
228
+ # @!attribute [r] observed_generation
229
+ # @return [::Integer]
230
+ # Output only. The generation of this Job. See comments in `reconciling` for
231
+ # additional information on reconciliation process in Cloud Run.
232
+ # @!attribute [r] terminal_condition
233
+ # @return [::Google::Cloud::Run::V2::Condition]
234
+ # Output only. The Condition of this Job, containing its readiness status,
235
+ # and detailed error information in case it did not reach the desired state.
236
+ # @!attribute [r] conditions
237
+ # @return [::Array<::Google::Cloud::Run::V2::Condition>]
238
+ # Output only. The Conditions of all other associated sub-resources. They
239
+ # contain additional diagnostics information in case the Job does not reach
240
+ # its desired state. See comments in `reconciling` for additional information
241
+ # on reconciliation process in Cloud Run.
242
+ # @!attribute [r] execution_count
243
+ # @return [::Integer]
244
+ # Output only. Number of executions created for this job.
245
+ # @!attribute [r] latest_created_execution
246
+ # @return [::Google::Cloud::Run::V2::ExecutionReference]
247
+ # Output only. Name of the last created execution.
248
+ # @!attribute [r] reconciling
249
+ # @return [::Boolean]
250
+ # Output only. Returns true if the Job is currently being acted upon by the
251
+ # system to bring it into the desired state.
252
+ #
253
+ # When a new Job is created, or an existing one is updated, Cloud Run
254
+ # will asynchronously perform all necessary steps to bring the Job to the
255
+ # desired state. This process is called reconciliation.
256
+ # While reconciliation is in process, `observed_generation` and
257
+ # `latest_succeeded_execution`, will have transient values that might
258
+ # mismatch the intended state: Once reconciliation is over (and this field is
259
+ # false), there are two possible outcomes: reconciliation succeeded and the
260
+ # state matches the Job, or there was an error, and reconciliation failed.
261
+ # This state can be found in `terminal_condition.state`.
262
+ #
263
+ # If reconciliation succeeded, the following fields will match:
264
+ # `observed_generation` and `generation`, `latest_succeeded_execution` and
265
+ # `latest_created_execution`.
266
+ #
267
+ # If reconciliation failed, `observed_generation` and
268
+ # `latest_succeeded_execution` will have the state of the last succeeded
269
+ # execution or empty for newly created Job. Additional information on the
270
+ # failure can be found in `terminal_condition` and `conditions`.
271
+ # @!attribute [r] etag
272
+ # @return [::String]
273
+ # Output only. A system-generated fingerprint for this version of the
274
+ # resource. May be used to detect modification conflict during updates.
275
+ class Job
276
+ include ::Google::Protobuf::MessageExts
277
+ extend ::Google::Protobuf::MessageExts::ClassMethods
278
+
279
+ # @!attribute [rw] key
280
+ # @return [::String]
281
+ # @!attribute [rw] value
282
+ # @return [::String]
283
+ class LabelsEntry
284
+ include ::Google::Protobuf::MessageExts
285
+ extend ::Google::Protobuf::MessageExts::ClassMethods
286
+ end
287
+
288
+ # @!attribute [rw] key
289
+ # @return [::String]
290
+ # @!attribute [rw] value
291
+ # @return [::String]
292
+ class AnnotationsEntry
293
+ include ::Google::Protobuf::MessageExts
294
+ extend ::Google::Protobuf::MessageExts::ClassMethods
295
+ end
296
+ end
297
+
298
+ # Reference to an Execution. Use /Executions.GetExecution with the given name
299
+ # to get full execution including the latest status.
300
+ # @!attribute [rw] name
301
+ # @return [::String]
302
+ # Name of the execution.
303
+ # @!attribute [rw] create_time
304
+ # @return [::Google::Protobuf::Timestamp]
305
+ # Creation timestamp of the execution.
306
+ # @!attribute [rw] completion_time
307
+ # @return [::Google::Protobuf::Timestamp]
308
+ # Creation timestamp of the execution.
309
+ class ExecutionReference
310
+ include ::Google::Protobuf::MessageExts
311
+ extend ::Google::Protobuf::MessageExts::ClassMethods
312
+ end
313
+ end
314
+ end
315
+ end
316
+ end
@@ -28,11 +28,13 @@ module Google
28
28
  # at runtime.
29
29
  # @!attribute [rw] name
30
30
  # @return [::String]
31
- # Name of the container specified as a DNS_LABEL.
31
+ # Name of the container specified as a DNS_LABEL (RFC 1123).
32
32
  # @!attribute [rw] image
33
33
  # @return [::String]
34
- # Required. URL of the Container image in Google Container Registry or Google Artifact
35
- # Registry. More info: https://kubernetes.io/docs/concepts/containers/images
34
+ # Required. Name of the container image in Dockerhub, Google Artifact
35
+ # Registry, or Google Container Registry. If the host is not provided,
36
+ # Dockerhub is assumed. More info:
37
+ # https://kubernetes.io/docs/concepts/containers/images
36
38
  # @!attribute [rw] command
37
39
  # @return [::Array<::String>]
38
40
  # Entrypoint array. Not executed within a shell.
@@ -102,9 +104,9 @@ module Google
102
104
  # @!attribute [rw] limits
103
105
  # @return [::Google::Protobuf::Map{::String => ::String}]
104
106
  # Only memory and CPU are supported. Note: The only
105
- # supported values for CPU are '1', '2', and '4'. Setting 4 CPU requires at
106
- # least 2Gi of memory.
107
- # The values of the map is string form of the 'quantity' k8s type:
107
+ # supported values for CPU are '1', '2', '4', and '8'. Setting 4 CPU
108
+ # requires at least 2Gi of memory. The values of the map is string form of
109
+ # the 'quantity' k8s type:
108
110
  # https://github.com/kubernetes/kubernetes/blob/master/staging/src/k8s.io/apimachinery/pkg/api/resource/quantity.go
109
111
  # @!attribute [rw] cpu_idle
110
112
  # @return [::Boolean]
@@ -126,8 +128,8 @@ module Google
126
128
  # EnvVar represents an environment variable present in a Container.
127
129
  # @!attribute [rw] name
128
130
  # @return [::String]
129
- # Required. Name of the environment variable. Must be a C_IDENTIFIER, and mnay not
130
- # exceed 32768 characters.
131
+ # Required. Name of the environment variable. Must be a C_IDENTIFIER, and
132
+ # mnay not exceed 32768 characters.
131
133
  # @!attribute [rw] value
132
134
  # @return [::String]
133
135
  # Variable references $(VAR_NAME) are expanded
@@ -165,7 +167,8 @@ module Google
165
167
  # @!attribute [rw] version
166
168
  # @return [::String]
167
169
  # The Cloud Secret Manager secret version.
168
- # Can be 'latest' for the latest value or an integer for a specific version.
170
+ # Can be 'latest' for the latest version, an integer for a specific version,
171
+ # or a version alias.
169
172
  class SecretKeySelector
170
173
  include ::Google::Protobuf::MessageExts
171
174
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -191,8 +194,8 @@ module Google
191
194
  # Required. This must match the Name of a Volume.
192
195
  # @!attribute [rw] mount_path
193
196
  # @return [::String]
194
- # Required. Path within the container at which the volume should be mounted. Must
195
- # not contain ':'. For Cloud SQL volumes, it can be left empty, or must
197
+ # Required. Path within the container at which the volume should be mounted.
198
+ # Must not contain ':'. For Cloud SQL volumes, it can be left empty, or must
196
199
  # otherwise be `/cloudsql`. All instances defined in the Volume will be
197
200
  # available as `/cloudsql/[instance]`. For more information on Cloud SQL
198
201
  # volumes, visit https://cloud.google.com/sql/docs/mysql/connect-run
@@ -268,7 +271,8 @@ module Google
268
271
  # @!attribute [rw] version
269
272
  # @return [::String]
270
273
  # The Cloud Secret Manager secret version.
271
- # Can be 'latest' for the latest value or an integer for a specific version.
274
+ # Can be 'latest' for the latest value, or an integer or a secret alias for a
275
+ # specific version.
272
276
  # @!attribute [rw] mode
273
277
  # @return [::Integer]
274
278
  # Integer octal mode bits to use on this file, must be a value between
@@ -291,7 +295,10 @@ module Google
291
295
  extend ::Google::Protobuf::MessageExts::ClassMethods
292
296
  end
293
297
 
294
- # Represents a specific Cloud SQL instance.
298
+ # Represents a set of Cloud SQL instances. Each one will be available under
299
+ # /cloudsql/[instance]. Visit
300
+ # https://cloud.google.com/sql/docs/mysql/connect-run for more information on
301
+ # how to connect Cloud SQL and Cloud Run.
295
302
  # @!attribute [rw] instances
296
303
  # @return [::Array<::String>]
297
304
  # The Cloud SQL instance connection names, as can be found in
@@ -334,11 +341,15 @@ module Google
334
341
  # @!attribute [rw] http_get
335
342
  # @return [::Google::Cloud::Run::V2::HTTPGetAction]
336
343
  # HTTPGet specifies the http request to perform.
337
- # Exactly one of HTTPGet or TCPSocket must be specified.
344
+ # Exactly one of httpGet, tcpSocket, or grpc must be specified.
338
345
  # @!attribute [rw] tcp_socket
339
346
  # @return [::Google::Cloud::Run::V2::TCPSocketAction]
340
347
  # TCPSocket specifies an action involving a TCP port.
341
- # Exactly one of HTTPGet or TCPSocket must be specified.
348
+ # Exactly one of httpGet, tcpSocket, or grpc must be specified.
349
+ # @!attribute [rw] grpc
350
+ # @return [::Google::Cloud::Run::V2::GRPCAction]
351
+ # GRPC specifies an action involving a gRPC port.
352
+ # Exactly one of httpGet, tcpSocket, or grpc must be specified.
342
353
  class Probe
343
354
  include ::Google::Protobuf::MessageExts
344
355
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -372,10 +383,26 @@ module Google
372
383
  # @!attribute [rw] port
373
384
  # @return [::Integer]
374
385
  # Port number to access on the container. Must be in the range 1 to 65535.
386
+ # If not specified, defaults to 8080.
375
387
  class TCPSocketAction
376
388
  include ::Google::Protobuf::MessageExts
377
389
  extend ::Google::Protobuf::MessageExts::ClassMethods
378
390
  end
391
+
392
+ # GRPCAction describes an action involving a GRPC port.
393
+ # @!attribute [rw] port
394
+ # @return [::Integer]
395
+ # Port number of the gRPC service. Number must be in the range 1 to 65535.
396
+ # If not specified, defaults to 8080.
397
+ # @!attribute [rw] service
398
+ # @return [::String]
399
+ # Service is the name of the service to place in the gRPC HealthCheckRequest
400
+ # (see https://github.com/grpc/grpc/blob/master/doc/health-checking.md). If
401
+ # this is not specified, the default behavior is defined by gRPC.
402
+ class GRPCAction
403
+ include ::Google::Protobuf::MessageExts
404
+ extend ::Google::Protobuf::MessageExts::ClassMethods
405
+ end
379
406
  end
380
407
  end
381
408
  end
@@ -96,8 +96,9 @@ module Google
96
96
  # Output only. The unique name of this Revision.
97
97
  # @!attribute [r] uid
98
98
  # @return [::String]
99
- # Output only. Server assigned unique identifier for the Revision. The value is a UUID4
100
- # string and guaranteed to remain unchanged until the resource is deleted.
99
+ # Output only. Server assigned unique identifier for the Revision. The value
100
+ # is a UUID4 string and guaranteed to remain unchanged until the resource is
101
+ # deleted.
101
102
  # @!attribute [r] generation
102
103
  # @return [::Integer]
103
104
  # Output only. A number that monotonically increases every time the user
@@ -110,9 +111,6 @@ module Google
110
111
  # environment, state, etc. For more information, visit
111
112
  # https://cloud.google.com/resource-manager/docs/creating-managing-labels or
112
113
  # https://cloud.google.com/run/docs/configuring/labels
113
- # Cloud Run will populate some labels with 'run.googleapis.com' or
114
- # 'serving.knative.dev' namespaces. Those labels are read-only, and user
115
- # changes will not be preserved.
116
114
  # @!attribute [rw] annotations
117
115
  # @return [::Google::Protobuf::Map{::String => ::String}]
118
116
  # KRM-style annotations for the resource.
@@ -173,20 +171,28 @@ module Google
173
171
  # A reference to a customer managed encryption key (CMEK) to use to encrypt
174
172
  # this container image. For more information, go to
175
173
  # https://cloud.google.com/run/docs/securing/using-cmek
174
+ # @!attribute [rw] encryption_key_revocation_action
175
+ # @return [::Google::Cloud::Run::V2::EncryptionKeyRevocationAction]
176
+ # The action to take if the encryption key is revoked.
177
+ # @!attribute [rw] encryption_key_shutdown_duration
178
+ # @return [::Google::Protobuf::Duration]
179
+ # If encryption_key_revocation_action is SHUTDOWN, the duration before
180
+ # shutting down all instances. The minimum increment is 1 hour.
176
181
  # @!attribute [r] reconciling
177
182
  # @return [::Boolean]
178
- # Output only. Indicates whether the resource's reconciliation is still in progress.
179
- # See comments in `Service.reconciling` for additional information on
180
- # reconciliation process in Cloud Run.
183
+ # Output only. Indicates whether the resource's reconciliation is still in
184
+ # progress. See comments in `Service.reconciling` for additional information
185
+ # on reconciliation process in Cloud Run.
181
186
  # @!attribute [r] conditions
182
187
  # @return [::Array<::Google::Cloud::Run::V2::Condition>]
183
- # Output only. The Condition of this Revision, containing its readiness status, and
184
- # detailed error information in case it did not reach a serving state.
188
+ # Output only. The Condition of this Revision, containing its readiness
189
+ # status, and detailed error information in case it did not reach a serving
190
+ # state.
185
191
  # @!attribute [r] observed_generation
186
192
  # @return [::Integer]
187
- # Output only. The generation of this Revision currently serving traffic. See comments in
188
- # `reconciling` for additional information on reconciliation process in Cloud
189
- # Run.
193
+ # Output only. The generation of this Revision currently serving traffic. See
194
+ # comments in `reconciling` for additional information on reconciliation
195
+ # process in Cloud Run.
190
196
  # @!attribute [r] log_uri
191
197
  # @return [::String]
192
198
  # Output only. The Google Console URI to obtain logs for the Revision.
@@ -30,9 +30,19 @@ module Google
30
30
  # @!attribute [rw] labels
31
31
  # @return [::Google::Protobuf::Map{::String => ::String}]
32
32
  # KRM-style labels for the resource.
33
+ #
34
+ # <p>Cloud Run API v2 does not support labels with `run.googleapis.com`,
35
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
36
+ # namespaces, and they will be rejected. All system labels in v1 now have a
37
+ # corresponding field in v2 RevisionTemplate.
33
38
  # @!attribute [rw] annotations
34
39
  # @return [::Google::Protobuf::Map{::String => ::String}]
35
40
  # KRM-style annotations for the resource.
41
+ #
42
+ # <p>Cloud Run API v2 does not support annotations with `run.googleapis.com`,
43
+ # `cloud.googleapis.com`, `serving.knative.dev`, or `autoscaling.knative.dev`
44
+ # namespaces, and they will be rejected. All system annotations in v1 now
45
+ # have a corresponding field in v2 RevisionTemplate.
36
46
  # @!attribute [rw] scaling
37
47
  # @return [::Google::Cloud::Run::V2::RevisionScaling]
38
48
  # Scaling settings for this Revision.