google-cloud-deploy-v1 0.5.0 → 0.6.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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