google-cloud-deploy-v1 0.5.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.
@@ -134,6 +134,10 @@ module Google
134
134
  # @return [::Google::Cloud::Deploy::V1::Standard]
135
135
  # Standard deployment strategy executes a single deploy and allows
136
136
  # verifying the deployment.
137
+ # @!attribute [rw] canary
138
+ # @return [::Google::Cloud::Deploy::V1::Canary]
139
+ # Canary deployment strategy provides progressive percentage based
140
+ # deployments to a Target.
137
141
  class Strategy
138
142
  include ::Google::Protobuf::MessageExts
139
143
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -148,6 +152,141 @@ module Google
148
152
  extend ::Google::Protobuf::MessageExts::ClassMethods
149
153
  end
150
154
 
155
+ # Canary represents the canary deployment strategy.
156
+ # @!attribute [rw] runtime_config
157
+ # @return [::Google::Cloud::Deploy::V1::RuntimeConfig]
158
+ # Optional. Runtime specific configurations for the deployment strategy. The
159
+ # runtime configuration is used to determine how Cloud Deploy will split
160
+ # traffic to enable a progressive deployment.
161
+ # @!attribute [rw] canary_deployment
162
+ # @return [::Google::Cloud::Deploy::V1::CanaryDeployment]
163
+ # Configures the progressive based deployment for a Target.
164
+ # @!attribute [rw] custom_canary_deployment
165
+ # @return [::Google::Cloud::Deploy::V1::CustomCanaryDeployment]
166
+ # Configures the progressive based deployment for a Target, but allows
167
+ # customizing at the phase level where a phase represents each of the
168
+ # percentage deployments.
169
+ class Canary
170
+ include ::Google::Protobuf::MessageExts
171
+ extend ::Google::Protobuf::MessageExts::ClassMethods
172
+ end
173
+
174
+ # CanaryDeployment represents the canary deployment configuration
175
+ # @!attribute [rw] percentages
176
+ # @return [::Array<::Integer>]
177
+ # Required. The percentage based deployments that will occur as a part of a
178
+ # `Rollout`. List is expected in ascending order and each integer n is
179
+ # 0 <= n < 100.
180
+ # @!attribute [rw] verify
181
+ # @return [::Boolean]
182
+ # Whether to run verify tests after each percentage deployment.
183
+ class CanaryDeployment
184
+ include ::Google::Protobuf::MessageExts
185
+ extend ::Google::Protobuf::MessageExts::ClassMethods
186
+ end
187
+
188
+ # CustomCanaryDeployment represents the custom canary deployment
189
+ # configuration.
190
+ # @!attribute [rw] phase_configs
191
+ # @return [::Array<::Google::Cloud::Deploy::V1::CustomCanaryDeployment::PhaseConfig>]
192
+ # Required. Configuration for each phase in the canary deployment in the
193
+ # order executed.
194
+ class CustomCanaryDeployment
195
+ include ::Google::Protobuf::MessageExts
196
+ extend ::Google::Protobuf::MessageExts::ClassMethods
197
+
198
+ # PhaseConfig represents the configuration for a phase in the custom
199
+ # canary deployment.
200
+ # @!attribute [rw] phase_id
201
+ # @return [::String]
202
+ # Required. The ID to assign to the `Rollout` phase.
203
+ # This value must consist of lower-case letters, numbers, and hyphens,
204
+ # start with a letter and end with a letter or a number, and have a max
205
+ # length of 63 characters. In other words, it must match the following
206
+ # regex: `^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$`.
207
+ # @!attribute [rw] percentage
208
+ # @return [::Integer]
209
+ # Required. Percentage deployment for the phase.
210
+ # @!attribute [rw] profiles
211
+ # @return [::Array<::String>]
212
+ # Skaffold profiles to use when rendering the manifest for this phase.
213
+ # These are in addition to the profiles list specified in the
214
+ # `DeliveryPipeline` stage.
215
+ # @!attribute [rw] verify
216
+ # @return [::Boolean]
217
+ # Whether to run verify tests after the deployment.
218
+ class PhaseConfig
219
+ include ::Google::Protobuf::MessageExts
220
+ extend ::Google::Protobuf::MessageExts::ClassMethods
221
+ end
222
+ end
223
+
224
+ # KubernetesConfig contains the Kubernetes runtime configuration.
225
+ # @!attribute [rw] gateway_service_mesh
226
+ # @return [::Google::Cloud::Deploy::V1::KubernetesConfig::GatewayServiceMesh]
227
+ # Kubernetes Gateway API service mesh configuration.
228
+ # @!attribute [rw] service_networking
229
+ # @return [::Google::Cloud::Deploy::V1::KubernetesConfig::ServiceNetworking]
230
+ # Kubernetes Service networking configuration.
231
+ class KubernetesConfig
232
+ include ::Google::Protobuf::MessageExts
233
+ extend ::Google::Protobuf::MessageExts::ClassMethods
234
+
235
+ # Information about the Kubernetes Gateway API service mesh configuration.
236
+ # @!attribute [rw] http_route
237
+ # @return [::String]
238
+ # Required. Name of the Gateway API HTTPRoute.
239
+ # @!attribute [rw] service
240
+ # @return [::String]
241
+ # Required. Name of the Kubernetes Service.
242
+ # @!attribute [rw] deployment
243
+ # @return [::String]
244
+ # Required. Name of the Kubernetes Deployment whose traffic is managed by
245
+ # the specified HTTPRoute and Service.
246
+ class GatewayServiceMesh
247
+ include ::Google::Protobuf::MessageExts
248
+ extend ::Google::Protobuf::MessageExts::ClassMethods
249
+ end
250
+
251
+ # Information about the Kubernetes Service networking configuration.
252
+ # @!attribute [rw] service
253
+ # @return [::String]
254
+ # Required. Name of the Kubernetes Service.
255
+ # @!attribute [rw] deployment
256
+ # @return [::String]
257
+ # Required. Name of the Kubernetes Deployment whose traffic is managed by
258
+ # the specified Service.
259
+ class ServiceNetworking
260
+ include ::Google::Protobuf::MessageExts
261
+ extend ::Google::Protobuf::MessageExts::ClassMethods
262
+ end
263
+ end
264
+
265
+ # CloudRunConfig contains the Cloud Run runtime configuration.
266
+ # @!attribute [rw] automatic_traffic_control
267
+ # @return [::Boolean]
268
+ # Whether Cloud Deploy should update the traffic stanza in a Cloud Run
269
+ # Service on the user's behalf to facilitate traffic splitting. This is
270
+ # required to be true for CanaryDeployments, but optional for
271
+ # CustomCanaryDeployments.
272
+ class CloudRunConfig
273
+ include ::Google::Protobuf::MessageExts
274
+ extend ::Google::Protobuf::MessageExts::ClassMethods
275
+ end
276
+
277
+ # RuntimeConfig contains the runtime specific configurations for a deployment
278
+ # strategy.
279
+ # @!attribute [rw] kubernetes
280
+ # @return [::Google::Cloud::Deploy::V1::KubernetesConfig]
281
+ # Kubernetes runtime configuration.
282
+ # @!attribute [rw] cloud_run
283
+ # @return [::Google::Cloud::Deploy::V1::CloudRunConfig]
284
+ # Cloud Run runtime configuration.
285
+ class RuntimeConfig
286
+ include ::Google::Protobuf::MessageExts
287
+ extend ::Google::Protobuf::MessageExts::ClassMethods
288
+ end
289
+
151
290
  # PipelineReadyCondition contains information around the status of the
152
291
  # Pipeline.
153
292
  # @!attribute [rw] status
@@ -171,7 +310,7 @@ module Google
171
310
  # True if there aren't any missing Targets.
172
311
  # @!attribute [rw] missing_targets
173
312
  # @return [::Array<::String>]
174
- # The list of Target names that are missing. For example,
313
+ # The list of Target names that do not exist. For example,
175
314
  # projects/\\{project_id}/locations/\\{location_name}/targets/\\{target_name}.
176
315
  # @!attribute [rw] update_time
177
316
  # @return [::Google::Protobuf::Timestamp]
@@ -181,13 +320,32 @@ module Google
181
320
  extend ::Google::Protobuf::MessageExts::ClassMethods
182
321
  end
183
322
 
323
+ # TargetsTypeCondition contains information on whether the Targets defined in
324
+ # the Delivery Pipeline are of the same type.
325
+ # @!attribute [rw] status
326
+ # @return [::Boolean]
327
+ # True if the targets are all a comparable type. For example this is true if
328
+ # all targets are GKE clusters. This is false if some targets are Cloud Run
329
+ # targets and others are GKE clusters.
330
+ # @!attribute [rw] error_details
331
+ # @return [::String]
332
+ # Human readable error message.
333
+ class TargetsTypeCondition
334
+ include ::Google::Protobuf::MessageExts
335
+ extend ::Google::Protobuf::MessageExts::ClassMethods
336
+ end
337
+
184
338
  # PipelineCondition contains all conditions relevant to a Delivery Pipeline.
185
339
  # @!attribute [rw] pipeline_ready_condition
186
340
  # @return [::Google::Cloud::Deploy::V1::PipelineReadyCondition]
187
341
  # Details around the Pipeline's overall status.
188
342
  # @!attribute [rw] targets_present_condition
189
343
  # @return [::Google::Cloud::Deploy::V1::TargetsPresentCondition]
190
- # Detalis around targets enumerated in the pipeline.
344
+ # Details around targets enumerated in the pipeline.
345
+ # @!attribute [rw] targets_type_condition
346
+ # @return [::Google::Cloud::Deploy::V1::TargetsTypeCondition]
347
+ # Details on the whether the targets enumerated in the pipeline are of the
348
+ # same type.
191
349
  class PipelineCondition
192
350
  include ::Google::Protobuf::MessageExts
193
351
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -196,8 +354,8 @@ module Google
196
354
  # The request object for `ListDeliveryPipelines`.
197
355
  # @!attribute [rw] parent
198
356
  # @return [::String]
199
- # Required. The parent, which owns this collection of pipelines. Format must be
200
- # projects/\\{project_id}/locations/\\{location_name}.
357
+ # Required. The parent, which owns this collection of pipelines. Format must
358
+ # be projects/\\{project_id}/locations/\\{location_name}.
201
359
  # @!attribute [rw] page_size
202
360
  # @return [::Integer]
203
361
  # The maximum number of pipelines to return. The service may return
@@ -252,8 +410,8 @@ module Google
252
410
  # The request object for `CreateDeliveryPipeline`.
253
411
  # @!attribute [rw] parent
254
412
  # @return [::String]
255
- # Required. The parent collection in which the `DeliveryPipeline` should be created.
256
- # Format should be projects/\\{project_id}/locations/\\{location_name}.
413
+ # Required. The parent collection in which the `DeliveryPipeline` should be
414
+ # created. Format should be projects/\\{project_id}/locations/\\{location_name}.
257
415
  # @!attribute [rw] delivery_pipeline_id
258
416
  # @return [::String]
259
417
  # Required. ID of the `DeliveryPipeline`.
@@ -277,8 +435,8 @@ module Google
277
435
  # not supported (00000000-0000-0000-0000-000000000000).
278
436
  # @!attribute [rw] validate_only
279
437
  # @return [::Boolean]
280
- # Optional. If set to true, the request is validated and the user is provided with
281
- # an expected result, but no actual change is made.
438
+ # Optional. If set to true, the request is validated and the user is provided
439
+ # with an expected result, but no actual change is made.
282
440
  class CreateDeliveryPipelineRequest
283
441
  include ::Google::Protobuf::MessageExts
284
442
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -312,12 +470,12 @@ module Google
312
470
  # not supported (00000000-0000-0000-0000-000000000000).
313
471
  # @!attribute [rw] allow_missing
314
472
  # @return [::Boolean]
315
- # Optional. If set to true, updating a `DeliveryPipeline` that does not exist will
316
- # result in the creation of a new `DeliveryPipeline`.
473
+ # Optional. If set to true, updating a `DeliveryPipeline` that does not exist
474
+ # will result in the creation of a new `DeliveryPipeline`.
317
475
  # @!attribute [rw] validate_only
318
476
  # @return [::Boolean]
319
- # Optional. If set to true, the request is validated and the user is provided with
320
- # an expected result, but no actual change is made.
477
+ # Optional. If set to true, the request is validated and the user is provided
478
+ # with an expected result, but no actual change is made.
321
479
  class UpdateDeliveryPipelineRequest
322
480
  include ::Google::Protobuf::MessageExts
323
481
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -349,17 +507,17 @@ module Google
349
507
  # `DeliveryPipeline` will succeed.
350
508
  # @!attribute [rw] validate_only
351
509
  # @return [::Boolean]
352
- # Optional. If set, validate the request and preview the review, but do not actually
353
- # post it.
510
+ # Optional. If set, validate the request and preview the review, but do not
511
+ # actually post it.
354
512
  # @!attribute [rw] force
355
513
  # @return [::Boolean]
356
- # Optional. If set to true, all child resources under this pipeline will also be
357
- # deleted. Otherwise, the request will only work if the pipeline has
358
- # no child resources.
514
+ # Optional. If set to true, all child resources under this pipeline will also
515
+ # be deleted. Otherwise, the request will only work if the pipeline has no
516
+ # child resources.
359
517
  # @!attribute [rw] etag
360
518
  # @return [::String]
361
- # Optional. This checksum is computed by the server based on the value of other
362
- # fields, and may be sent on update and delete requests to ensure the
519
+ # Optional. This checksum is computed by the server based on the value of
520
+ # other fields, and may be sent on update and delete requests to ensure the
363
521
  # client has an up-to-date value before proceeding.
364
522
  class DeleteDeliveryPipelineRequest
365
523
  include ::Google::Protobuf::MessageExts
@@ -385,8 +543,8 @@ module Google
385
543
  # Optional. Description of the `Target`. Max length is 255 characters.
386
544
  # @!attribute [rw] annotations
387
545
  # @return [::Google::Protobuf::Map{::String => ::String}]
388
- # Optional. User annotations. These attributes can only be set and used by the
389
- # user, and not by Google Cloud Deploy. See
546
+ # Optional. User annotations. These attributes can only be set and used by
547
+ # the user, and not by Google Cloud Deploy. See
390
548
  # https://google.aip.dev/128#annotations for more details such as format and
391
549
  # size limitations.
392
550
  # @!attribute [rw] labels
@@ -421,10 +579,13 @@ module Google
421
579
  # @!attribute [rw] run
422
580
  # @return [::Google::Cloud::Deploy::V1::CloudRunLocation]
423
581
  # Information specifying a Cloud Run deployment target.
582
+ # @!attribute [rw] multi_target
583
+ # @return [::Google::Cloud::Deploy::V1::MultiTarget]
584
+ # Information specifying a multiTarget.
424
585
  # @!attribute [rw] etag
425
586
  # @return [::String]
426
- # Optional. This checksum is computed by the server based on the value of other
427
- # fields, and may be sent on update and delete requests to ensure the
587
+ # Optional. This checksum is computed by the server based on the value of
588
+ # other fields, and may be sent on update and delete requests to ensure the
428
589
  # client has an up-to-date value before proceeding.
429
590
  # @!attribute [rw] execution_configs
430
591
  # @return [::Array<::Google::Cloud::Deploy::V1::ExecutionConfig>]
@@ -481,15 +642,15 @@ module Google
481
642
  # (<PROJECT_NUMBER>-compute@developer.gserviceaccount.com) is used.
482
643
  # @!attribute [rw] artifact_storage
483
644
  # @return [::String]
484
- # Optional. Cloud Storage location in which to store execution outputs. This can
485
- # either be a bucket ("gs://my-bucket") or a path within a bucket
645
+ # Optional. Cloud Storage location in which to store execution outputs. This
646
+ # can either be a bucket ("gs://my-bucket") or a path within a bucket
486
647
  # ("gs://my-bucket/my-dir").
487
648
  # If unspecified, a default bucket located in the same region will be used.
488
649
  # @!attribute [rw] execution_timeout
489
650
  # @return [::Google::Protobuf::Duration]
490
- # Optional. Execution timeout for a Cloud Build Execution. This must be between 10m and
491
- # 24h in seconds format.
492
- # If unspecified, a default timeout of 1h is used.
651
+ # Optional. Execution timeout for a Cloud Build Execution. This must be
652
+ # between 10m and 24h in seconds format. If unspecified, a default timeout of
653
+ # 1h is used.
493
654
  class ExecutionConfig
494
655
  include ::Google::Protobuf::MessageExts
495
656
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -518,8 +679,8 @@ module Google
518
679
  # (<PROJECT_NUMBER>-compute@developer.gserviceaccount.com) will be used.
519
680
  # @!attribute [rw] artifact_storage
520
681
  # @return [::String]
521
- # Optional. Cloud Storage location where execution outputs should be stored. This can
522
- # either be a bucket ("gs://my-bucket") or a path within a bucket
682
+ # Optional. Cloud Storage location where execution outputs should be stored.
683
+ # This can either be a bucket ("gs://my-bucket") or a path within a bucket
523
684
  # ("gs://my-bucket/my-dir").
524
685
  # If unspecified, a default bucket located in the same region will be used.
525
686
  class DefaultPool
@@ -530,8 +691,8 @@ module Google
530
691
  # Execution using a private Cloud Build pool.
531
692
  # @!attribute [rw] worker_pool
532
693
  # @return [::String]
533
- # Required. Resource name of the Cloud Build worker pool to use. The format is
534
- # `projects/{project}/locations/{location}/workerPools/{pool}`.
694
+ # Required. Resource name of the Cloud Build worker pool to use. The format
695
+ # is `projects/{project}/locations/{location}/workerPools/{pool}`.
535
696
  # @!attribute [rw] service_account
536
697
  # @return [::String]
537
698
  # Optional. Google service account to use for execution. If unspecified,
@@ -539,8 +700,8 @@ module Google
539
700
  # (<PROJECT_NUMBER>-compute@developer.gserviceaccount.com) will be used.
540
701
  # @!attribute [rw] artifact_storage
541
702
  # @return [::String]
542
- # Optional. Cloud Storage location where execution outputs should be stored. This can
543
- # either be a bucket ("gs://my-bucket") or a path within a bucket
703
+ # Optional. Cloud Storage location where execution outputs should be stored.
704
+ # This can either be a bucket ("gs://my-bucket") or a path within a bucket
544
705
  # ("gs://my-bucket/my-dir").
545
706
  # If unspecified, a default bucket located in the same region will be used.
546
707
  class PrivatePool
@@ -555,11 +716,11 @@ module Google
555
716
  # `projects/{project_id}/locations/{location_id}/clusters/{cluster_id}.
556
717
  # @!attribute [rw] internal_ip
557
718
  # @return [::Boolean]
558
- # Optional. If true, `cluster` is accessed using the private IP address of the control
559
- # plane endpoint. Otherwise, the default IP address of the control plane
560
- # endpoint is used. The default IP address is the private IP address for
561
- # clusters with private control-plane endpoints and the public IP address
562
- # otherwise.
719
+ # Optional. If true, `cluster` is accessed using the private IP address of
720
+ # the control plane endpoint. Otherwise, the default IP address of the
721
+ # control plane endpoint is used. The default IP address is the private IP
722
+ # address for clusters with private control-plane endpoints and the public IP
723
+ # address otherwise.
563
724
  #
564
725
  # Only specify this option when `cluster` is a [private GKE
565
726
  # cluster](https://cloud.google.com/kubernetes-engine/docs/concepts/private-cluster-concept).
@@ -589,6 +750,15 @@ module Google
589
750
  extend ::Google::Protobuf::MessageExts::ClassMethods
590
751
  end
591
752
 
753
+ # Information specifying a multiTarget.
754
+ # @!attribute [rw] target_ids
755
+ # @return [::Array<::String>]
756
+ # Required. The target_ids of this multiTarget.
757
+ class MultiTarget
758
+ include ::Google::Protobuf::MessageExts
759
+ extend ::Google::Protobuf::MessageExts::ClassMethods
760
+ end
761
+
592
762
  # The request object for `ListTargets`.
593
763
  # @!attribute [rw] parent
594
764
  # @return [::String]
@@ -596,9 +766,10 @@ module Google
596
766
  # projects/\\{project_id}/locations/\\{location_name}.
597
767
  # @!attribute [rw] page_size
598
768
  # @return [::Integer]
599
- # Optional. The maximum number of `Target` objects to return. The service may return
600
- # fewer than this value. If unspecified, at most 50 `Target` objects will be
601
- # returned. The maximum value is 1000; values above 1000 will be set to 1000.
769
+ # Optional. The maximum number of `Target` objects to return. The service may
770
+ # return fewer than this value. If unspecified, at most 50 `Target` objects
771
+ # will be returned. The maximum value is 1000; values above 1000 will be set
772
+ # to 1000.
602
773
  # @!attribute [rw] page_token
603
774
  # @return [::String]
604
775
  # Optional. A page token, received from a previous `ListTargets` call.
@@ -608,11 +779,12 @@ module Google
608
779
  # the call that provided the page token.
609
780
  # @!attribute [rw] filter
610
781
  # @return [::String]
611
- # Optional. Filter targets to be returned. See https://google.aip.dev/160 for more
612
- # details.
782
+ # Optional. Filter targets to be returned. See https://google.aip.dev/160 for
783
+ # more details.
613
784
  # @!attribute [rw] order_by
614
785
  # @return [::String]
615
- # Optional. Field to sort by. See https://google.aip.dev/132#ordering for more details.
786
+ # Optional. Field to sort by. See https://google.aip.dev/132#ordering for
787
+ # more details.
616
788
  class ListTargetsRequest
617
789
  include ::Google::Protobuf::MessageExts
618
790
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -673,8 +845,8 @@ module Google
673
845
  # not supported (00000000-0000-0000-0000-000000000000).
674
846
  # @!attribute [rw] validate_only
675
847
  # @return [::Boolean]
676
- # Optional. If set to true, the request is validated and the user is provided with
677
- # an expected result, but no actual change is made.
848
+ # Optional. If set to true, the request is validated and the user is provided
849
+ # with an expected result, but no actual change is made.
678
850
  class CreateTargetRequest
679
851
  include ::Google::Protobuf::MessageExts
680
852
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -712,8 +884,8 @@ module Google
712
884
  # result in the creation of a new `Target`.
713
885
  # @!attribute [rw] validate_only
714
886
  # @return [::Boolean]
715
- # Optional. If set to true, the request is validated and the user is provided with
716
- # an expected result, but no actual change is made.
887
+ # Optional. If set to true, the request is validated and the user is provided
888
+ # with an expected result, but no actual change is made.
717
889
  class UpdateTargetRequest
718
890
  include ::Google::Protobuf::MessageExts
719
891
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -745,12 +917,12 @@ module Google
745
917
  # DeliveryPipeline will succeed.
746
918
  # @!attribute [rw] validate_only
747
919
  # @return [::Boolean]
748
- # Optional. If set, validate the request and preview the review, but do not actually
749
- # post it.
920
+ # Optional. If set, validate the request and preview the review, but do not
921
+ # actually post it.
750
922
  # @!attribute [rw] etag
751
923
  # @return [::String]
752
- # Optional. This checksum is computed by the server based on the value of other
753
- # fields, and may be sent on update and delete requests to ensure the
924
+ # Optional. This checksum is computed by the server based on the value of
925
+ # other fields, and may be sent on update and delete requests to ensure the
754
926
  # client has an up-to-date value before proceeding.
755
927
  class DeleteTargetRequest
756
928
  include ::Google::Protobuf::MessageExts
@@ -815,7 +987,8 @@ module Google
815
987
  # List of artifacts to pass through to Skaffold command.
816
988
  # @!attribute [r] delivery_pipeline_snapshot
817
989
  # @return [::Google::Cloud::Deploy::V1::DeliveryPipeline]
818
- # Output only. Snapshot of the parent pipeline taken at release creation time.
990
+ # Output only. Snapshot of the parent pipeline taken at release creation
991
+ # time.
819
992
  # @!attribute [r] target_snapshots
820
993
  # @return [::Array<::Google::Cloud::Deploy::V1::Target>]
821
994
  # Output only. Snapshot of the targets taken at release creation time.
@@ -840,7 +1013,11 @@ module Google
840
1013
  # during the render operation.
841
1014
  # @!attribute [r] target_renders
842
1015
  # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Deploy::V1::Release::TargetRender}]
843
- # Output only. Map from target ID to details of the render operation for that target.
1016
+ # Output only. Map from target ID to details of the render operation for that
1017
+ # target.
1018
+ # @!attribute [r] condition
1019
+ # @return [::Google::Cloud::Deploy::V1::Release::ReleaseCondition]
1020
+ # Output only. Information around the state of the Release.
844
1021
  class Release
845
1022
  include ::Google::Protobuf::MessageExts
846
1023
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -848,19 +1025,23 @@ module Google
848
1025
  # Details of rendering for a single target.
849
1026
  # @!attribute [r] rendering_build
850
1027
  # @return [::String]
851
- # Output only. The resource name of the Cloud Build `Build` object that is used to
852
- # render the manifest for this target. Format is
1028
+ # Output only. The resource name of the Cloud Build `Build` object that is
1029
+ # used to render the manifest for this target. Format is
853
1030
  # `projects/{project}/locations/{location}/builds/{build}`.
854
1031
  # @!attribute [r] rendering_state
855
1032
  # @return [::Google::Cloud::Deploy::V1::Release::TargetRender::TargetRenderState]
856
1033
  # Output only. Current state of the render operation for this Target.
1034
+ # @!attribute [r] metadata
1035
+ # @return [::Google::Cloud::Deploy::V1::RenderMetadata]
1036
+ # Output only. Metadata related to the `Release` render for this Target.
857
1037
  # @!attribute [r] failure_cause
858
1038
  # @return [::Google::Cloud::Deploy::V1::Release::TargetRender::FailureCause]
859
- # Output only. Reason this render failed. This will always be unspecified while the
860
- # render in progress.
1039
+ # Output only. Reason this render failed. This will always be unspecified
1040
+ # while the render in progress.
861
1041
  # @!attribute [r] failure_message
862
1042
  # @return [::String]
863
- # Output only. Additional information about the render failure, if available.
1043
+ # Output only. Additional information about the render failure, if
1044
+ # available.
864
1045
  class TargetRender
865
1046
  include ::Google::Protobuf::MessageExts
866
1047
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -893,9 +1074,61 @@ module Google
893
1074
  # The render operation did not complete successfully; check Cloud Build
894
1075
  # logs.
895
1076
  EXECUTION_FAILED = 2
1077
+
1078
+ # Cloud Build failed to fulfill Google Cloud Deploy's request. See
1079
+ # failure_message for additional details.
1080
+ CLOUD_BUILD_REQUEST_FAILED = 3
896
1081
  end
897
1082
  end
898
1083
 
1084
+ # ReleaseReadyCondition contains information around the status of the
1085
+ # Release. If a release is not ready, you cannot create a rollout with the
1086
+ # release.
1087
+ # @!attribute [rw] status
1088
+ # @return [::Boolean]
1089
+ # True if the Release is in a valid state. Otherwise at least one condition
1090
+ # in `ReleaseCondition` is in an invalid state. Iterate over those
1091
+ # conditions and see which condition(s) has status = false to find out what
1092
+ # is wrong with the Release.
1093
+ class ReleaseReadyCondition
1094
+ include ::Google::Protobuf::MessageExts
1095
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1096
+ end
1097
+
1098
+ # SkaffoldSupportedCondition contains information about when support for the
1099
+ # release's version of skaffold ends.
1100
+ # @!attribute [rw] status
1101
+ # @return [::Boolean]
1102
+ # True if the version of skaffold used by this release is supported.
1103
+ # @!attribute [rw] skaffold_support_state
1104
+ # @return [::Google::Cloud::Deploy::V1::SkaffoldSupportState]
1105
+ # The skaffold support state for this release's version of skaffold.
1106
+ # @!attribute [rw] maintenance_mode_time
1107
+ # @return [::Google::Protobuf::Timestamp]
1108
+ # The time at which this release's version of skaffold will enter
1109
+ # maintenance mode.
1110
+ # @!attribute [rw] support_expiration_time
1111
+ # @return [::Google::Protobuf::Timestamp]
1112
+ # The time at which this release's version of skaffold will no longer be
1113
+ # supported.
1114
+ class SkaffoldSupportedCondition
1115
+ include ::Google::Protobuf::MessageExts
1116
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1117
+ end
1118
+
1119
+ # ReleaseCondition contains all conditions relevant to a Release.
1120
+ # @!attribute [rw] release_ready_condition
1121
+ # @return [::Google::Cloud::Deploy::V1::Release::ReleaseReadyCondition]
1122
+ # Details around the Releases's overall status.
1123
+ # @!attribute [rw] skaffold_supported_condition
1124
+ # @return [::Google::Cloud::Deploy::V1::Release::SkaffoldSupportedCondition]
1125
+ # Details around the support state of the release's skaffold
1126
+ # version.
1127
+ class ReleaseCondition
1128
+ include ::Google::Protobuf::MessageExts
1129
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1130
+ end
1131
+
899
1132
  # @!attribute [rw] key
900
1133
  # @return [::String]
901
1134
  # @!attribute [rw] value
@@ -970,24 +1203,72 @@ module Google
970
1203
  # paths are relative to this location.
971
1204
  # @!attribute [r] skaffold_config_path
972
1205
  # @return [::String]
973
- # Output only. File path of the resolved Skaffold configuration relative to the URI.
1206
+ # Output only. File path of the resolved Skaffold configuration relative to
1207
+ # the URI.
974
1208
  # @!attribute [r] manifest_path
975
1209
  # @return [::String]
976
1210
  # Output only. File path of the rendered manifest relative to the URI.
1211
+ # @!attribute [r] phase_artifacts
1212
+ # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Deploy::V1::TargetArtifact::PhaseArtifact}]
1213
+ # Output only. Map from the phase ID to the phase artifacts for the `Target`.
977
1214
  class TargetArtifact
978
1215
  include ::Google::Protobuf::MessageExts
979
1216
  extend ::Google::Protobuf::MessageExts::ClassMethods
1217
+
1218
+ # Contains the paths to the artifacts, relative to the URI, for a phase.
1219
+ # @!attribute [r] skaffold_config_path
1220
+ # @return [::String]
1221
+ # Output only. File path of the resolved Skaffold configuration relative to
1222
+ # the URI.
1223
+ # @!attribute [r] manifest_path
1224
+ # @return [::String]
1225
+ # Output only. File path of the rendered manifest relative to the URI.
1226
+ class PhaseArtifact
1227
+ include ::Google::Protobuf::MessageExts
1228
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1229
+ end
1230
+
1231
+ # @!attribute [rw] key
1232
+ # @return [::String]
1233
+ # @!attribute [rw] value
1234
+ # @return [::Google::Cloud::Deploy::V1::TargetArtifact::PhaseArtifact]
1235
+ class PhaseArtifactsEntry
1236
+ include ::Google::Protobuf::MessageExts
1237
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1238
+ end
1239
+ end
1240
+
1241
+ # CloudRunRenderMetadata contains Cloud Run information associated with a
1242
+ # `Release` render.
1243
+ # @!attribute [r] service
1244
+ # @return [::String]
1245
+ # Output only. The name of the Cloud Run Service in the rendered manifest.
1246
+ # Format is projects/\\{project}/locations/\\{location}/services/\\{service}.
1247
+ class CloudRunRenderMetadata
1248
+ include ::Google::Protobuf::MessageExts
1249
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1250
+ end
1251
+
1252
+ # RenderMetadata includes information associated with a `Release` render.
1253
+ # @!attribute [r] cloud_run
1254
+ # @return [::Google::Cloud::Deploy::V1::CloudRunRenderMetadata]
1255
+ # Output only. Metadata associated with rendering for Cloud Run.
1256
+ class RenderMetadata
1257
+ include ::Google::Protobuf::MessageExts
1258
+ extend ::Google::Protobuf::MessageExts::ClassMethods
980
1259
  end
981
1260
 
982
1261
  # The request object for `ListReleases`.
983
1262
  # @!attribute [rw] parent
984
1263
  # @return [::String]
985
- # Required. The `DeliveryPipeline` which owns this collection of `Release` objects.
1264
+ # Required. The `DeliveryPipeline` which owns this collection of `Release`
1265
+ # objects.
986
1266
  # @!attribute [rw] page_size
987
1267
  # @return [::Integer]
988
- # Optional. The maximum number of `Release` objects to return. The service may return
989
- # fewer than this value. If unspecified, at most 50 `Release` objects will be
990
- # returned. The maximum value is 1000; values above 1000 will be set to 1000.
1268
+ # Optional. The maximum number of `Release` objects to return. The service
1269
+ # may return fewer than this value. If unspecified, at most 50 `Release`
1270
+ # objects will be returned. The maximum value is 1000; values above 1000 will
1271
+ # be set to 1000.
991
1272
  # @!attribute [rw] page_token
992
1273
  # @return [::String]
993
1274
  # Optional. A page token, received from a previous `ListReleases` call.
@@ -997,11 +1278,12 @@ module Google
997
1278
  # the call that provided the page token.
998
1279
  # @!attribute [rw] filter
999
1280
  # @return [::String]
1000
- # Optional. Filter releases to be returned. See https://google.aip.dev/160 for more
1001
- # details.
1281
+ # Optional. Filter releases to be returned. See https://google.aip.dev/160
1282
+ # for more details.
1002
1283
  # @!attribute [rw] order_by
1003
1284
  # @return [::String]
1004
- # Optional. Field to sort by. See https://google.aip.dev/132#ordering for more details.
1285
+ # Optional. Field to sort by. See https://google.aip.dev/132#ordering for
1286
+ # more details.
1005
1287
  class ListReleasesRequest
1006
1288
  include ::Google::Protobuf::MessageExts
1007
1289
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1062,8 +1344,8 @@ module Google
1062
1344
  # not supported (00000000-0000-0000-0000-000000000000).
1063
1345
  # @!attribute [rw] validate_only
1064
1346
  # @return [::Boolean]
1065
- # Optional. If set to true, the request is validated and the user is provided with
1066
- # an expected result, but no actual change is made.
1347
+ # Optional. If set to true, the request is validated and the user is provided
1348
+ # with an expected result, but no actual change is made.
1067
1349
  class CreateReleaseRequest
1068
1350
  include ::Google::Protobuf::MessageExts
1069
1351
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1130,11 +1412,12 @@ module Google
1130
1412
  # Output only. Current state of the `Rollout`.
1131
1413
  # @!attribute [r] failure_reason
1132
1414
  # @return [::String]
1133
- # Output only. Additional information about the rollout failure, if available.
1415
+ # Output only. Additional information about the rollout failure, if
1416
+ # available.
1134
1417
  # @!attribute [r] deploying_build
1135
1418
  # @return [::String]
1136
- # Output only. The resource name of the Cloud Build `Build` object that is used to deploy
1137
- # the Rollout. Format is
1419
+ # Output only. The resource name of the Cloud Build `Build` object that is
1420
+ # used to deploy the Rollout. Format is
1138
1421
  # `projects/{project}/locations/{location}/builds/{build}`.
1139
1422
  # @!attribute [rw] etag
1140
1423
  # @return [::String]
@@ -1143,14 +1426,19 @@ module Google
1143
1426
  # client has an up-to-date value before proceeding.
1144
1427
  # @!attribute [r] deploy_failure_cause
1145
1428
  # @return [::Google::Cloud::Deploy::V1::Rollout::FailureCause]
1146
- # Output only. The reason this rollout failed. This will always be unspecified while the
1147
- # rollout is in progress.
1429
+ # Output only. The reason this rollout failed. This will always be
1430
+ # unspecified while the rollout is in progress.
1148
1431
  # @!attribute [r] phases
1149
1432
  # @return [::Array<::Google::Cloud::Deploy::V1::Phase>]
1150
1433
  # Output only. The phases that represent the workflows of this `Rollout`.
1151
1434
  # @!attribute [r] metadata
1152
1435
  # @return [::Google::Cloud::Deploy::V1::Metadata]
1153
1436
  # Output only. Metadata contains information about the rollout.
1437
+ # @!attribute [r] controller_rollout
1438
+ # @return [::String]
1439
+ # Output only. Name of the `ControllerRollout`. Format is projects/\\{project}/
1440
+ # locations/\\{location}/deliveryPipelines/\\{deliveryPipeline}/
1441
+ # releases/\\{release}/rollouts/[a-z][a-z0-9\-]\\{0,62}.
1154
1442
  class Rollout
1155
1443
  include ::Google::Protobuf::MessageExts
1156
1444
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1217,6 +1505,15 @@ module Google
1217
1505
 
1218
1506
  # The `Rollout` is waiting for the `Release` to be fully rendered.
1219
1507
  PENDING_RELEASE = 7
1508
+
1509
+ # The `Rollout` is in the process of being cancelled.
1510
+ CANCELLING = 8
1511
+
1512
+ # The `Rollout` has been cancelled.
1513
+ CANCELLED = 9
1514
+
1515
+ # The `Rollout` is halted.
1516
+ HALTED = 10
1220
1517
  end
1221
1518
 
1222
1519
  # Well-known rollout failures.
@@ -1244,13 +1541,18 @@ module Google
1244
1541
 
1245
1542
  # No skaffold verify configuration was found.
1246
1543
  VERIFICATION_CONFIG_NOT_FOUND = 6
1544
+
1545
+ # Cloud Build failed to fulfill Google Cloud Deploy's request. See
1546
+ # failure_message for additional details.
1547
+ CLOUD_BUILD_REQUEST_FAILED = 7
1247
1548
  end
1248
1549
  end
1249
1550
 
1250
1551
  # Metadata includes information associated with a `Rollout`.
1251
1552
  # @!attribute [r] cloud_run
1252
1553
  # @return [::Google::Cloud::Deploy::V1::CloudRunMetadata]
1253
- # Output only. The name of the Cloud Run Service that is associated with a `Rollout`.
1554
+ # Output only. The name of the Cloud Run Service that is associated with a
1555
+ # `Rollout`.
1254
1556
  class Metadata
1255
1557
  include ::Google::Protobuf::MessageExts
1256
1558
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1260,7 +1562,8 @@ module Google
1260
1562
  # the user.
1261
1563
  # @!attribute [r] cloud_run
1262
1564
  # @return [::Google::Cloud::Deploy::V1::CloudRunMetadata]
1263
- # Output only. The name of the Cloud Run Service that is associated with a `DeployJobRun`.
1565
+ # Output only. The name of the Cloud Run Service that is associated with a
1566
+ # `DeployJobRun`.
1264
1567
  class DeployJobRunMetadata
1265
1568
  include ::Google::Protobuf::MessageExts
1266
1569
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1269,11 +1572,13 @@ module Google
1269
1572
  # CloudRunMetadata contains information from a Cloud Run deployment.
1270
1573
  # @!attribute [r] service
1271
1574
  # @return [::String]
1272
- # Output only. The name of the Cloud Run Service that is associated with a `Rollout`.
1273
- # Format is projects/\\{project}/locations/\\{location}/services/\\{service}.
1575
+ # Output only. The name of the Cloud Run Service that is associated with a
1576
+ # `Rollout`. Format is
1577
+ # projects/\\{project}/locations/\\{location}/services/\\{service}.
1274
1578
  # @!attribute [r] service_urls
1275
1579
  # @return [::Array<::String>]
1276
- # Output only. The Cloud Run Service urls that are associated with a `Rollout`.
1580
+ # Output only. The Cloud Run Service urls that are associated with a
1581
+ # `Rollout`.
1277
1582
  # @!attribute [r] revision
1278
1583
  # @return [::String]
1279
1584
  # Output only. The Cloud Run Revision id associated with a `Rollout`.
@@ -1290,9 +1595,16 @@ module Google
1290
1595
  # @!attribute [r] state
1291
1596
  # @return [::Google::Cloud::Deploy::V1::Phase::State]
1292
1597
  # Output only. Current state of the Phase.
1598
+ # @!attribute [r] skip_message
1599
+ # @return [::String]
1600
+ # Output only. Additional information on why the Phase was skipped, if
1601
+ # available.
1293
1602
  # @!attribute [r] deployment_jobs
1294
1603
  # @return [::Google::Cloud::Deploy::V1::DeploymentJobs]
1295
1604
  # Output only. Deployment job composition.
1605
+ # @!attribute [r] child_rollout_jobs
1606
+ # @return [::Google::Cloud::Deploy::V1::ChildRolloutJobs]
1607
+ # Output only. ChildRollout job composition.
1296
1608
  class Phase
1297
1609
  include ::Google::Protobuf::MessageExts
1298
1610
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1316,6 +1628,9 @@ module Google
1316
1628
 
1317
1629
  # The Phase was aborted.
1318
1630
  ABORTED = 5
1631
+
1632
+ # The Phase was skipped.
1633
+ SKIPPED = 6
1319
1634
  end
1320
1635
  end
1321
1636
 
@@ -1331,6 +1646,18 @@ module Google
1331
1646
  extend ::Google::Protobuf::MessageExts::ClassMethods
1332
1647
  end
1333
1648
 
1649
+ # ChildRollouts job composition
1650
+ # @!attribute [r] create_rollout_jobs
1651
+ # @return [::Array<::Google::Cloud::Deploy::V1::Job>]
1652
+ # Output only. List of CreateChildRolloutJobs
1653
+ # @!attribute [r] advance_rollout_jobs
1654
+ # @return [::Array<::Google::Cloud::Deploy::V1::Job>]
1655
+ # Output only. List of AdvanceChildRolloutJobs
1656
+ class ChildRolloutJobs
1657
+ include ::Google::Protobuf::MessageExts
1658
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1659
+ end
1660
+
1334
1661
  # Job represents an operation for a `Rollout`.
1335
1662
  # @!attribute [r] id
1336
1663
  # @return [::String]
@@ -1338,16 +1665,26 @@ module Google
1338
1665
  # @!attribute [r] state
1339
1666
  # @return [::Google::Cloud::Deploy::V1::Job::State]
1340
1667
  # Output only. The current state of the Job.
1668
+ # @!attribute [r] skip_message
1669
+ # @return [::String]
1670
+ # Output only. Additional information on why the Job was skipped, if
1671
+ # available.
1341
1672
  # @!attribute [r] job_run
1342
1673
  # @return [::String]
1343
- # Output only. The name of the `JobRun` responsible for the most recent invocation of this
1344
- # Job.
1674
+ # Output only. The name of the `JobRun` responsible for the most recent
1675
+ # invocation of this Job.
1345
1676
  # @!attribute [r] deploy_job
1346
1677
  # @return [::Google::Cloud::Deploy::V1::DeployJob]
1347
1678
  # Output only. A deploy Job.
1348
1679
  # @!attribute [r] verify_job
1349
1680
  # @return [::Google::Cloud::Deploy::V1::VerifyJob]
1350
1681
  # Output only. A verify Job.
1682
+ # @!attribute [r] create_child_rollout_job
1683
+ # @return [::Google::Cloud::Deploy::V1::CreateChildRolloutJob]
1684
+ # Output only. A createChildRollout Job.
1685
+ # @!attribute [r] advance_child_rollout_job
1686
+ # @return [::Google::Cloud::Deploy::V1::AdvanceChildRolloutJob]
1687
+ # Output only. An advanceChildRollout Job.
1351
1688
  class Job
1352
1689
  include ::Google::Protobuf::MessageExts
1353
1690
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1374,6 +1711,12 @@ module Google
1374
1711
 
1375
1712
  # The Job was aborted.
1376
1713
  ABORTED = 6
1714
+
1715
+ # The Job was skipped.
1716
+ SKIPPED = 7
1717
+
1718
+ # The Job was ignored.
1719
+ IGNORED = 8
1377
1720
  end
1378
1721
  end
1379
1722
 
@@ -1389,15 +1732,28 @@ module Google
1389
1732
  extend ::Google::Protobuf::MessageExts::ClassMethods
1390
1733
  end
1391
1734
 
1735
+ # A createChildRollout Job.
1736
+ class CreateChildRolloutJob
1737
+ include ::Google::Protobuf::MessageExts
1738
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1739
+ end
1740
+
1741
+ # An advanceChildRollout Job.
1742
+ class AdvanceChildRolloutJob
1743
+ include ::Google::Protobuf::MessageExts
1744
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1745
+ end
1746
+
1392
1747
  # ListRolloutsRequest is the request object used by `ListRollouts`.
1393
1748
  # @!attribute [rw] parent
1394
1749
  # @return [::String]
1395
1750
  # Required. The `Release` which owns this collection of `Rollout` objects.
1396
1751
  # @!attribute [rw] page_size
1397
1752
  # @return [::Integer]
1398
- # Optional. The maximum number of `Rollout` objects to return. The service may return
1399
- # fewer than this value. If unspecified, at most 50 `Rollout` objects will be
1400
- # returned. The maximum value is 1000; values above 1000 will be set to 1000.
1753
+ # Optional. The maximum number of `Rollout` objects to return. The service
1754
+ # may return fewer than this value. If unspecified, at most 50 `Rollout`
1755
+ # objects will be returned. The maximum value is 1000; values above 1000 will
1756
+ # be set to 1000.
1401
1757
  # @!attribute [rw] page_token
1402
1758
  # @return [::String]
1403
1759
  # Optional. A page token, received from a previous `ListRollouts` call.
@@ -1407,11 +1763,12 @@ module Google
1407
1763
  # the call that provided the page token.
1408
1764
  # @!attribute [rw] filter
1409
1765
  # @return [::String]
1410
- # Optional. Filter rollouts to be returned. See https://google.aip.dev/160 for more
1411
- # details.
1766
+ # Optional. Filter rollouts to be returned. See https://google.aip.dev/160
1767
+ # for more details.
1412
1768
  # @!attribute [rw] order_by
1413
1769
  # @return [::String]
1414
- # Optional. Field to sort by. See https://google.aip.dev/132#ordering for more details.
1770
+ # Optional. Field to sort by. See https://google.aip.dev/132#ordering for
1771
+ # more details.
1415
1772
  class ListRolloutsRequest
1416
1773
  include ::Google::Protobuf::MessageExts
1417
1774
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1472,8 +1829,12 @@ module Google
1472
1829
  # not supported (00000000-0000-0000-0000-000000000000).
1473
1830
  # @!attribute [rw] validate_only
1474
1831
  # @return [::Boolean]
1475
- # Optional. If set to true, the request is validated and the user is provided with
1476
- # an expected result, but no actual change is made.
1832
+ # Optional. If set to true, the request is validated and the user is provided
1833
+ # with an expected result, but no actual change is made.
1834
+ # @!attribute [rw] starting_phase_id
1835
+ # @return [::String]
1836
+ # Optional. The starting phase ID for the `Rollout`. If empty the `Rollout`
1837
+ # will start at the first phase.
1477
1838
  class CreateRolloutRequest
1478
1839
  include ::Google::Protobuf::MessageExts
1479
1840
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1499,8 +1860,9 @@ module Google
1499
1860
  # @return [::Boolean]
1500
1861
  # Output only. Identifies whether the user has requested cancellation
1501
1862
  # of the operation. Operations that have successfully been cancelled
1502
- # have [Operation.error][] value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
1503
- # corresponding to `Code.CANCELLED`.
1863
+ # have [Operation.error][] value with a
1864
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of 1, corresponding to
1865
+ # `Code.CANCELLED`.
1504
1866
  # @!attribute [r] api_version
1505
1867
  # @return [::String]
1506
1868
  # Output only. API version used to start the operation.
@@ -1529,6 +1891,66 @@ module Google
1529
1891
  extend ::Google::Protobuf::MessageExts::ClassMethods
1530
1892
  end
1531
1893
 
1894
+ # The request object used by `AdvanceRollout`.
1895
+ # @!attribute [rw] name
1896
+ # @return [::String]
1897
+ # Required. Name of the Rollout. Format is
1898
+ # projects/\\{project}/locations/\\{location}/deliveryPipelines/\\{deliveryPipeline}/
1899
+ # releases/\\{release}/rollouts/\\{rollout}.
1900
+ # @!attribute [rw] phase_id
1901
+ # @return [::String]
1902
+ # Required. The phase ID to advance the `Rollout` to.
1903
+ class AdvanceRolloutRequest
1904
+ include ::Google::Protobuf::MessageExts
1905
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1906
+ end
1907
+
1908
+ # The response object from `AdvanceRollout`.
1909
+ class AdvanceRolloutResponse
1910
+ include ::Google::Protobuf::MessageExts
1911
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1912
+ end
1913
+
1914
+ # The request object used by `CancelRollout`.
1915
+ # @!attribute [rw] name
1916
+ # @return [::String]
1917
+ # Required. Name of the Rollout. Format is
1918
+ # projects/\\{project}/locations/\\{location}/deliveryPipelines/\\{deliveryPipeline}/
1919
+ # releases/\\{release}/rollouts/\\{rollout}.
1920
+ class CancelRolloutRequest
1921
+ include ::Google::Protobuf::MessageExts
1922
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1923
+ end
1924
+
1925
+ # The response object from `CancelRollout`.
1926
+ class CancelRolloutResponse
1927
+ include ::Google::Protobuf::MessageExts
1928
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1929
+ end
1930
+
1931
+ # The request object used by `IgnoreJob`.
1932
+ # @!attribute [rw] rollout
1933
+ # @return [::String]
1934
+ # Required. Name of the Rollout. Format is
1935
+ # projects/\\{project}/locations/\\{location}/deliveryPipelines/\\{deliveryPipeline}/
1936
+ # releases/\\{release}/rollouts/\\{rollout}.
1937
+ # @!attribute [rw] phase_id
1938
+ # @return [::String]
1939
+ # Required. The phase ID the Job to ignore belongs to.
1940
+ # @!attribute [rw] job_id
1941
+ # @return [::String]
1942
+ # Required. The job ID for the Job to ignore.
1943
+ class IgnoreJobRequest
1944
+ include ::Google::Protobuf::MessageExts
1945
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1946
+ end
1947
+
1948
+ # The response object from `IgnoreJob`.
1949
+ class IgnoreJobResponse
1950
+ include ::Google::Protobuf::MessageExts
1951
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1952
+ end
1953
+
1532
1954
  # RetryJobRequest is the request object used by `RetryJob`.
1533
1955
  # @!attribute [rw] rollout
1534
1956
  # @return [::String]
@@ -1574,7 +1996,8 @@ module Google
1574
1996
  # A `JobRun` contains information of a single `Rollout` job evaluation.
1575
1997
  # @!attribute [rw] name
1576
1998
  # @return [::String]
1577
- # Optional. Name of the `JobRun`. Format is projects/\\{project}/locations/\\{location}/
1999
+ # Optional. Name of the `JobRun`. Format is
2000
+ # projects/\\{project}/locations/\\{location}/
1578
2001
  # deliveryPipelines/\\{deliveryPipeline}/releases/\\{releases}/rollouts/
1579
2002
  # \\{rollouts}/jobRuns/\\{uuid}.
1580
2003
  # @!attribute [r] uid
@@ -1604,10 +2027,16 @@ module Google
1604
2027
  # @!attribute [r] verify_job_run
1605
2028
  # @return [::Google::Cloud::Deploy::V1::VerifyJobRun]
1606
2029
  # Output only. Information specific to a verify `JobRun`.
2030
+ # @!attribute [r] create_child_rollout_job_run
2031
+ # @return [::Google::Cloud::Deploy::V1::CreateChildRolloutJobRun]
2032
+ # Output only. Information specific to a createChildRollout `JobRun`.
2033
+ # @!attribute [r] advance_child_rollout_job_run
2034
+ # @return [::Google::Cloud::Deploy::V1::AdvanceChildRolloutJobRun]
2035
+ # Output only. Information specific to an advanceChildRollout `JobRun`
1607
2036
  # @!attribute [r] etag
1608
2037
  # @return [::String]
1609
- # Output only. This checksum is computed by the server based on the value of other
1610
- # fields, and may be sent on update and delete requests to ensure the
2038
+ # Output only. This checksum is computed by the server based on the value of
2039
+ # other fields, and may be sent on update and delete requests to ensure the
1611
2040
  # client has an up-to-date value before proceeding.
1612
2041
  class JobRun
1613
2042
  include ::Google::Protobuf::MessageExts
@@ -1626,18 +2055,25 @@ module Google
1626
2055
 
1627
2056
  # The `JobRun` has failed.
1628
2057
  FAILED = 3
2058
+
2059
+ # The `JobRun` is terminating.
2060
+ TERMINATING = 4
2061
+
2062
+ # The `JobRun` was terminated.
2063
+ TERMINATED = 5
1629
2064
  end
1630
2065
  end
1631
2066
 
1632
2067
  # DeployJobRun contains information specific to a deploy `JobRun`.
1633
2068
  # @!attribute [r] build
1634
2069
  # @return [::String]
1635
- # Output only. The resource name of the Cloud Build `Build` object that is used to deploy.
1636
- # Format is projects/\\{project}/locations/\\{location}/builds/\\{build}.
2070
+ # Output only. The resource name of the Cloud Build `Build` object that is
2071
+ # used to deploy. Format is
2072
+ # projects/\\{project}/locations/\\{location}/builds/\\{build}.
1637
2073
  # @!attribute [r] failure_cause
1638
2074
  # @return [::Google::Cloud::Deploy::V1::DeployJobRun::FailureCause]
1639
- # Output only. The reason the deploy failed. This will always be unspecified while the
1640
- # deploy is in progress or if it succeeded.
2075
+ # Output only. The reason the deploy failed. This will always be unspecified
2076
+ # while the deploy is in progress or if it succeeded.
1641
2077
  # @!attribute [r] failure_message
1642
2078
  # @return [::String]
1643
2079
  # Output only. Additional information about the deploy failure, if available.
@@ -1664,25 +2100,35 @@ module Google
1664
2100
 
1665
2101
  # The deploy build did not complete within the alloted time.
1666
2102
  DEADLINE_EXCEEDED = 3
2103
+
2104
+ # There were missing resources in the runtime environment required for a
2105
+ # canary deployment. Check the Cloud Build logs for more information.
2106
+ MISSING_RESOURCES_FOR_CANARY = 4
2107
+
2108
+ # Cloud Build failed to fulfill Google Cloud Deploy's request. See
2109
+ # failure_message for additional details.
2110
+ CLOUD_BUILD_REQUEST_FAILED = 5
1667
2111
  end
1668
2112
  end
1669
2113
 
1670
2114
  # VerifyJobRun contains information specific to a verify `JobRun`.
1671
2115
  # @!attribute [r] build
1672
2116
  # @return [::String]
1673
- # Output only. The resource name of the Cloud Build `Build` object that is used to verify.
1674
- # Format is projects/\\{project}/locations/\\{location}/builds/\\{build}.
2117
+ # Output only. The resource name of the Cloud Build `Build` object that is
2118
+ # used to verify. Format is
2119
+ # projects/\\{project}/locations/\\{location}/builds/\\{build}.
1675
2120
  # @!attribute [r] artifact_uri
1676
2121
  # @return [::String]
1677
- # Output only. URI of a directory containing the verify artifacts. This contains the
1678
- # Skaffold event log.
2122
+ # Output only. URI of a directory containing the verify artifacts. This
2123
+ # contains the Skaffold event log.
1679
2124
  # @!attribute [r] event_log_path
1680
2125
  # @return [::String]
1681
- # Output only. File path of the Skaffold event log relative to the artifact URI.
2126
+ # Output only. File path of the Skaffold event log relative to the artifact
2127
+ # URI.
1682
2128
  # @!attribute [r] failure_cause
1683
2129
  # @return [::Google::Cloud::Deploy::V1::VerifyJobRun::FailureCause]
1684
- # Output only. The reason the verify failed. This will always be unspecified while the
1685
- # verify is in progress or if it succeeded.
2130
+ # Output only. The reason the verify failed. This will always be unspecified
2131
+ # while the verify is in progress or if it succeeded.
1686
2132
  # @!attribute [r] failure_message
1687
2133
  # @return [::String]
1688
2134
  # Output only. Additional information about the verify failure, if available.
@@ -1709,32 +2155,68 @@ module Google
1709
2155
 
1710
2156
  # No Skaffold verify configuration was found.
1711
2157
  VERIFICATION_CONFIG_NOT_FOUND = 4
2158
+
2159
+ # Cloud Build failed to fulfill Google Cloud Deploy's request. See
2160
+ # failure_message for additional details.
2161
+ CLOUD_BUILD_REQUEST_FAILED = 5
1712
2162
  end
1713
2163
  end
1714
2164
 
2165
+ # CreateChildRolloutJobRun contains information specific to a
2166
+ # createChildRollout `JobRun`.
2167
+ # @!attribute [r] rollout
2168
+ # @return [::String]
2169
+ # Output only. Name of the `ChildRollout`. Format is projects/\\{project}/
2170
+ # locations/\\{location}/deliveryPipelines/\\{deliveryPipeline}/
2171
+ # releases/\\{release}/rollouts/[a-z][a-z0-9\-]\\{0,62}.
2172
+ # @!attribute [r] rollout_phase_id
2173
+ # @return [::String]
2174
+ # Output only. The ID of the childRollout Phase initiated by this JobRun.
2175
+ class CreateChildRolloutJobRun
2176
+ include ::Google::Protobuf::MessageExts
2177
+ extend ::Google::Protobuf::MessageExts::ClassMethods
2178
+ end
2179
+
2180
+ # AdvanceChildRolloutJobRun contains information specific to a
2181
+ # advanceChildRollout `JobRun`.
2182
+ # @!attribute [r] rollout
2183
+ # @return [::String]
2184
+ # Output only. Name of the `ChildRollout`. Format is projects/\\{project}/
2185
+ # locations/\\{location}/deliveryPipelines/\\{deliveryPipeline}/
2186
+ # releases/\\{release}/rollouts/[a-z][a-z0-9\-]\\{0,62}.
2187
+ # @!attribute [r] rollout_phase_id
2188
+ # @return [::String]
2189
+ # Output only. the ID of the ChildRollout's Phase.
2190
+ class AdvanceChildRolloutJobRun
2191
+ include ::Google::Protobuf::MessageExts
2192
+ extend ::Google::Protobuf::MessageExts::ClassMethods
2193
+ end
2194
+
1715
2195
  # ListJobRunsRequest is the request object used by `ListJobRuns`.
1716
2196
  # @!attribute [rw] parent
1717
2197
  # @return [::String]
1718
2198
  # Required. The `Rollout` which owns this collection of `JobRun` objects.
1719
2199
  # @!attribute [rw] page_size
1720
2200
  # @return [::Integer]
1721
- # Optional. The maximum number of `JobRun` objects to return. The service may return
1722
- # fewer than this value. If unspecified, at most 50 `JobRun` objects will be
1723
- # returned. The maximum value is 1000; values above 1000 will be set to 1000.
2201
+ # Optional. The maximum number of `JobRun` objects to return. The service may
2202
+ # return fewer than this value. If unspecified, at most 50 `JobRun` objects
2203
+ # will be returned. The maximum value is 1000; values above 1000 will be set
2204
+ # to 1000.
1724
2205
  # @!attribute [rw] page_token
1725
2206
  # @return [::String]
1726
- # Optional. A page token, received from a previous `ListJobRuns` call. Provide this
1727
- # to retrieve the subsequent page.
2207
+ # Optional. A page token, received from a previous `ListJobRuns` call.
2208
+ # Provide this to retrieve the subsequent page.
1728
2209
  #
1729
2210
  # When paginating, all other provided parameters match the call that provided
1730
2211
  # the page token.
1731
2212
  # @!attribute [rw] filter
1732
2213
  # @return [::String]
1733
- # Optional. Filter results to be returned. See https://google.aip.dev/160 for more
1734
- # details.
2214
+ # Optional. Filter results to be returned. See https://google.aip.dev/160 for
2215
+ # more details.
1735
2216
  # @!attribute [rw] order_by
1736
2217
  # @return [::String]
1737
- # Optional. Field to sort by. See https://google.aip.dev/132#ordering for more details.
2218
+ # Optional. Field to sort by. See https://google.aip.dev/132#ordering for
2219
+ # more details.
1738
2220
  class ListJobRunsRequest
1739
2221
  include ::Google::Protobuf::MessageExts
1740
2222
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1766,16 +2248,33 @@ module Google
1766
2248
  extend ::Google::Protobuf::MessageExts::ClassMethods
1767
2249
  end
1768
2250
 
2251
+ # The request object used by `TerminateJobRun`.
2252
+ # @!attribute [rw] name
2253
+ # @return [::String]
2254
+ # Required. Name of the `JobRun`. Format must be
2255
+ # projects/\\{project}/locations/\\{location}/deliveryPipelines/\\{deliveryPipeline}/
2256
+ # releases/\\{release}/rollouts/\\{rollout}/jobRuns/\\{jobRun}.
2257
+ class TerminateJobRunRequest
2258
+ include ::Google::Protobuf::MessageExts
2259
+ extend ::Google::Protobuf::MessageExts::ClassMethods
2260
+ end
2261
+
2262
+ # The response object from `TerminateJobRun`.
2263
+ class TerminateJobRunResponse
2264
+ include ::Google::Protobuf::MessageExts
2265
+ extend ::Google::Protobuf::MessageExts::ClassMethods
2266
+ end
2267
+
1769
2268
  # Service-wide configuration.
1770
2269
  # @!attribute [rw] name
1771
2270
  # @return [::String]
1772
2271
  # Name of the configuration.
1773
- # @!attribute [r] supported_versions
2272
+ # @!attribute [rw] supported_versions
1774
2273
  # @return [::Array<::Google::Cloud::Deploy::V1::SkaffoldVersion>]
1775
- # Output only. All supported versions of Skaffold.
1776
- # @!attribute [r] default_skaffold_version
2274
+ # All supported versions of Skaffold.
2275
+ # @!attribute [rw] default_skaffold_version
1777
2276
  # @return [::String]
1778
- # Output only. Default Skaffold version that is assigned when a Release is created without
2277
+ # Default Skaffold version that is assigned when a Release is created without
1779
2278
  # specifying a Skaffold version.
1780
2279
  class Config
1781
2280
  include ::Google::Protobuf::MessageExts
@@ -1786,6 +2285,12 @@ module Google
1786
2285
  # @!attribute [rw] version
1787
2286
  # @return [::String]
1788
2287
  # Release version number. For example, "1.20.3".
2288
+ # @!attribute [rw] maintenance_mode_time
2289
+ # @return [::Google::Protobuf::Timestamp]
2290
+ # The time at which this version of skaffold will enter maintenance mode.
2291
+ # @!attribute [rw] support_expiration_time
2292
+ # @return [::Google::Protobuf::Timestamp]
2293
+ # The time at which this version of skaffold will no longer be supported.
1789
2294
  # @!attribute [rw] support_end_date
1790
2295
  # @return [::Google::Type::Date]
1791
2296
  # Date when this version is expected to no longer be supported.
@@ -1802,6 +2307,21 @@ module Google
1802
2307
  include ::Google::Protobuf::MessageExts
1803
2308
  extend ::Google::Protobuf::MessageExts::ClassMethods
1804
2309
  end
2310
+
2311
+ # The support state of a specific Skaffold version.
2312
+ module SkaffoldSupportState
2313
+ # Default value. This value is unused.
2314
+ SKAFFOLD_SUPPORT_STATE_UNSPECIFIED = 0
2315
+
2316
+ # This skaffold version is currently supported.
2317
+ SKAFFOLD_SUPPORT_STATE_SUPPORTED = 1
2318
+
2319
+ # This skaffold version is in maintenance mode.
2320
+ SKAFFOLD_SUPPORT_STATE_MAINTENANCE_MODE = 2
2321
+
2322
+ # This skaffold version is no longer supported.
2323
+ SKAFFOLD_SUPPORT_STATE_UNSUPPORTED = 3
2324
+ end
1805
2325
  end
1806
2326
  end
1807
2327
  end