aws-sdk-ecs 1.196.0 → 1.198.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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-ecs/client.rb +268 -61
- data/lib/aws-sdk-ecs/client_api.rb +55 -0
- data/lib/aws-sdk-ecs/types.rb +482 -40
- data/lib/aws-sdk-ecs.rb +1 -1
- data/sig/client.rbs +62 -7
- data/sig/types.rbs +50 -0
- metadata +1 -1
data/lib/aws-sdk-ecs/types.rb
CHANGED
@@ -16,6 +16,52 @@ module Aws::ECS
|
|
16
16
|
#
|
17
17
|
class AccessDeniedException < Aws::EmptyStructure; end
|
18
18
|
|
19
|
+
# The advanced settings for a load balancer used in blue/green
|
20
|
+
# deployments. Specify the alternate target group, listener rules, and
|
21
|
+
# IAM role required for traffic shifting during blue/green deployments.
|
22
|
+
# For more information, see [Required resources for Amazon ECS
|
23
|
+
# blue/green deployments][1] in the *Amazon Elastic Container Service
|
24
|
+
# Developer Guide*.
|
25
|
+
#
|
26
|
+
#
|
27
|
+
#
|
28
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/blue-green-deployment-implementation.html
|
29
|
+
#
|
30
|
+
# @!attribute [rw] alternate_target_group_arn
|
31
|
+
# The Amazon Resource Name (ARN) of the alternate target group for
|
32
|
+
# Amazon ECS blue/green deployments.
|
33
|
+
# @return [String]
|
34
|
+
#
|
35
|
+
# @!attribute [rw] production_listener_rule
|
36
|
+
# The Amazon Resource Name (ARN) that that identifies the production
|
37
|
+
# listener rule (in the case of an Application Load Balancer) or
|
38
|
+
# listener (in the case for an Network Load Balancer) for routing
|
39
|
+
# production traffic.
|
40
|
+
# @return [String]
|
41
|
+
#
|
42
|
+
# @!attribute [rw] test_listener_rule
|
43
|
+
# The Amazon Resource Name (ARN) that identifies ) that identifies the
|
44
|
+
# test listener rule (in the case of an Application Load Balancer) or
|
45
|
+
# listener (in the case for an Network Load Balancer) for routing test
|
46
|
+
# traffic.
|
47
|
+
# @return [String]
|
48
|
+
#
|
49
|
+
# @!attribute [rw] role_arn
|
50
|
+
# The Amazon Resource Name (ARN) of the IAM role that grants Amazon
|
51
|
+
# ECS permission to call the Elastic Load Balancing APIs for you.
|
52
|
+
# @return [String]
|
53
|
+
#
|
54
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/AdvancedConfiguration AWS API Documentation
|
55
|
+
#
|
56
|
+
class AdvancedConfiguration < Struct.new(
|
57
|
+
:alternate_target_group_arn,
|
58
|
+
:production_listener_rule,
|
59
|
+
:test_listener_rule,
|
60
|
+
:role_arn)
|
61
|
+
SENSITIVE = []
|
62
|
+
include Aws::Structure
|
63
|
+
end
|
64
|
+
|
19
65
|
# An object representing a container instance or task attachment.
|
20
66
|
#
|
21
67
|
# @!attribute [rw] id
|
@@ -2951,7 +2997,7 @@ module Aws::ECS
|
|
2951
2997
|
# ECS resources][1] in the *Amazon Elastic Container Service Developer
|
2952
2998
|
# Guide*.
|
2953
2999
|
#
|
2954
|
-
# When you use Amazon ECS managed tags, you
|
3000
|
+
# When you use Amazon ECS managed tags, you must set the
|
2955
3001
|
# `propagateTags` request parameter.
|
2956
3002
|
#
|
2957
3003
|
#
|
@@ -3730,7 +3776,7 @@ module Aws::ECS
|
|
3730
3776
|
# your service to the last completed deployment after a failure.
|
3731
3777
|
#
|
3732
3778
|
# You can only use the `DeploymentAlarms` method to detect failures when
|
3733
|
-
# the `DeploymentController` is set to `ECS
|
3779
|
+
# the `DeploymentController` is set to `ECS`.
|
3734
3780
|
#
|
3735
3781
|
# For more information, see [Rolling update][1] in the <i> <i>Amazon
|
3736
3782
|
# Elastic Container Service Developer Guide</i> </i>.
|
@@ -3966,13 +4012,49 @@ module Aws::ECS
|
|
3966
4012
|
# Information about the CloudWatch alarms.
|
3967
4013
|
# @return [Types::DeploymentAlarms]
|
3968
4014
|
#
|
4015
|
+
# @!attribute [rw] strategy
|
4016
|
+
# The deployment strategy for the service. Choose from these valid
|
4017
|
+
# values:
|
4018
|
+
#
|
4019
|
+
# * `ROLLING` - When you create a service which uses the rolling
|
4020
|
+
# update (`ROLLING`) deployment strategy, the Amazon ECS service
|
4021
|
+
# scheduler replaces the currently running tasks with new tasks. The
|
4022
|
+
# number of tasks that Amazon ECS adds or removes from the service
|
4023
|
+
# during a rolling update is controlled by the service deployment
|
4024
|
+
# configuration.
|
4025
|
+
#
|
4026
|
+
# * `BLUE_GREEN` - A blue/green deployment strategy (`BLUE_GREEN`) is
|
4027
|
+
# a release methodology that reduces downtime and risk by running
|
4028
|
+
# two identical production environments called blue and green. With
|
4029
|
+
# Amazon ECS blue/green deployments, you can validate new service
|
4030
|
+
# revisions before directing production traffic to them. This
|
4031
|
+
# approach provides a safer way to deploy changes with the ability
|
4032
|
+
# to quickly roll back if needed.
|
4033
|
+
# @return [String]
|
4034
|
+
#
|
4035
|
+
# @!attribute [rw] bake_time_in_minutes
|
4036
|
+
# The time period when both blue and green service revisions are
|
4037
|
+
# running simultaneously after the production traffic has shifted.
|
4038
|
+
#
|
4039
|
+
# You must provide this parameter when you use the `BLUE_GREEN`
|
4040
|
+
# deployment strategy.
|
4041
|
+
# @return [Integer]
|
4042
|
+
#
|
4043
|
+
# @!attribute [rw] lifecycle_hooks
|
4044
|
+
# An array of deployment lifecycle hook objects to run custom logic at
|
4045
|
+
# specific stages of the deployment lifecycle.
|
4046
|
+
# @return [Array<Types::DeploymentLifecycleHook>]
|
4047
|
+
#
|
3969
4048
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeploymentConfiguration AWS API Documentation
|
3970
4049
|
#
|
3971
4050
|
class DeploymentConfiguration < Struct.new(
|
3972
4051
|
:deployment_circuit_breaker,
|
3973
4052
|
:maximum_percent,
|
3974
4053
|
:minimum_healthy_percent,
|
3975
|
-
:alarms
|
4054
|
+
:alarms,
|
4055
|
+
:strategy,
|
4056
|
+
:bake_time_in_minutes,
|
4057
|
+
:lifecycle_hooks)
|
3976
4058
|
SENSITIVE = []
|
3977
4059
|
include Aws::Structure
|
3978
4060
|
end
|
@@ -3982,49 +4064,92 @@ module Aws::ECS
|
|
3982
4064
|
# @!attribute [rw] type
|
3983
4065
|
# The deployment controller type to use.
|
3984
4066
|
#
|
3985
|
-
#
|
4067
|
+
# The deployment controller is the mechanism that determines how tasks
|
4068
|
+
# are deployed for your service. The valid options are:
|
3986
4069
|
#
|
3987
|
-
# ECS
|
4070
|
+
# * ECS
|
3988
4071
|
#
|
3989
|
-
#
|
3990
|
-
#
|
3991
|
-
#
|
3992
|
-
# service during a rolling update is controlled by adjusting the
|
3993
|
-
# minimum and maximum number of healthy tasks allowed during a
|
3994
|
-
# service deployment, as specified in the
|
3995
|
-
# [DeploymentConfiguration][1].
|
4072
|
+
# When you create a service which uses the `ECS` deployment
|
4073
|
+
# controller, you can choose between the following deployment
|
4074
|
+
# strategies:
|
3996
4075
|
#
|
3997
|
-
#
|
3998
|
-
#
|
3999
|
-
#
|
4076
|
+
# * `ROLLING`: When you create a service which uses the *rolling
|
4077
|
+
# update* (`ROLLING`) deployment strategy, the Amazon ECS service
|
4078
|
+
# scheduler replaces the currently running tasks with new tasks.
|
4079
|
+
# The number of tasks that Amazon ECS adds or removes from the
|
4080
|
+
# service during a rolling update is controlled by the service
|
4081
|
+
# deployment configuration.
|
4082
|
+
#
|
4083
|
+
# Rolling update deployments are best suited for the following
|
4084
|
+
# scenarios:
|
4085
|
+
#
|
4086
|
+
# * Gradual service updates: You need to update your service
|
4087
|
+
# incrementally without taking the entire service offline at
|
4088
|
+
# once.
|
4089
|
+
#
|
4090
|
+
# * Limited resource requirements: You want to avoid the
|
4091
|
+
# additional resource costs of running two complete environments
|
4092
|
+
# simultaneously (as required by blue/green deployments).
|
4093
|
+
#
|
4094
|
+
# * Acceptable deployment time: Your application can tolerate a
|
4095
|
+
# longer deployment process, as rolling updates replace tasks
|
4096
|
+
# one by one.
|
4000
4097
|
#
|
4001
|
-
#
|
4098
|
+
# * No need for instant roll back: Your service can tolerate a
|
4099
|
+
# rollback process that takes minutes rather than seconds.
|
4002
4100
|
#
|
4003
|
-
#
|
4004
|
-
#
|
4005
|
-
#
|
4006
|
-
# it.
|
4101
|
+
# * Simple deployment process: You prefer a straightforward
|
4102
|
+
# deployment approach without the complexity of managing
|
4103
|
+
# multiple environments, target groups, and listeners.
|
4007
4104
|
#
|
4008
|
-
#
|
4009
|
-
#
|
4010
|
-
#
|
4105
|
+
# * No load balancer requirement: Your service doesn't use or
|
4106
|
+
# require a load balancer, Application Load Balancer, Network
|
4107
|
+
# Load Balancer, or Service Connect (which are required for
|
4108
|
+
# blue/green deployments).
|
4011
4109
|
#
|
4012
|
-
#
|
4110
|
+
# * Stateful applications: Your application maintains state that
|
4111
|
+
# makes it difficult to run two parallel environments.
|
4013
4112
|
#
|
4014
|
-
#
|
4015
|
-
#
|
4016
|
-
#
|
4113
|
+
# * Cost sensitivity: You want to minimize deployment costs by not
|
4114
|
+
# running duplicate environments during deployment.
|
4115
|
+
# Rolling updates are the default deployment strategy for services
|
4116
|
+
# and provide a balance between deployment safety and resource
|
4117
|
+
# efficiency for many common application scenarios.
|
4017
4118
|
#
|
4018
|
-
#
|
4019
|
-
#
|
4020
|
-
#
|
4119
|
+
# * `BLUE_GREEN`: A *blue/green* deployment strategy (`BLUE_GREEN`)
|
4120
|
+
# is a release methodology that reduces downtime and risk by
|
4121
|
+
# running two identical production environments called blue and
|
4122
|
+
# green. With Amazon ECS blue/green deployments, you can validate
|
4123
|
+
# new service revisions before directing production traffic to
|
4124
|
+
# them. This approach provides a safer way to deploy changes with
|
4125
|
+
# the ability to quickly roll back if needed.
|
4021
4126
|
#
|
4127
|
+
# Amazon ECS blue/green deployments are best suited for the
|
4128
|
+
# following scenarios:
|
4022
4129
|
#
|
4130
|
+
# * Service validation: When you need to validate new service
|
4131
|
+
# revisions before directing production traffic to them
|
4023
4132
|
#
|
4024
|
-
#
|
4025
|
-
#
|
4026
|
-
#
|
4027
|
-
#
|
4133
|
+
# * Zero downtime: When your service requires zero-downtime
|
4134
|
+
# deployments
|
4135
|
+
#
|
4136
|
+
# * Instant roll back: When you need the ability to quickly roll
|
4137
|
+
# back if issues are detected
|
4138
|
+
#
|
4139
|
+
# * Load balancer requirement: When your service uses Application
|
4140
|
+
# Load Balancer, Network Load Balancer, or Service Connect
|
4141
|
+
# * External
|
4142
|
+
#
|
4143
|
+
# Use a third-party deployment controller.
|
4144
|
+
#
|
4145
|
+
# * Blue/green deployment (powered by CodeDeploy)
|
4146
|
+
#
|
4147
|
+
# CodeDeploy installs an updated version of the application as a new
|
4148
|
+
# replacement task set and reroutes production traffic from the
|
4149
|
+
# original application task set to the replacement task set. The
|
4150
|
+
# original task set is terminated after a successful deployment. Use
|
4151
|
+
# this deployment controller to verify a new deployment of a service
|
4152
|
+
# before sending production traffic to it.
|
4028
4153
|
# @return [String]
|
4029
4154
|
#
|
4030
4155
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeploymentController AWS API Documentation
|
@@ -4050,6 +4175,110 @@ module Aws::ECS
|
|
4050
4175
|
include Aws::Structure
|
4051
4176
|
end
|
4052
4177
|
|
4178
|
+
# A deployment lifecycle hook runs custom logic at specific stages of
|
4179
|
+
# the deployment process. Currently, you can use Lambda functions as
|
4180
|
+
# hook targets.
|
4181
|
+
#
|
4182
|
+
# For more information, see [Lifecycle hooks for Amazon ECS service
|
4183
|
+
# deployments][1] in the <i> Amazon Elastic Container Service Developer
|
4184
|
+
# Guide</i>.
|
4185
|
+
#
|
4186
|
+
#
|
4187
|
+
#
|
4188
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-lifecycle-hooks.html
|
4189
|
+
#
|
4190
|
+
# @!attribute [rw] hook_target_arn
|
4191
|
+
# The Amazon Resource Name (ARN) of the hook target. Currently, only
|
4192
|
+
# Lambda function ARNs are supported.
|
4193
|
+
#
|
4194
|
+
# You must provide this parameter when configuring a deployment
|
4195
|
+
# lifecycle hook.
|
4196
|
+
# @return [String]
|
4197
|
+
#
|
4198
|
+
# @!attribute [rw] role_arn
|
4199
|
+
# The Amazon Resource Name (ARN) of the IAM role that grants Amazon
|
4200
|
+
# ECS permission to call Lambda functions on your behalf.
|
4201
|
+
#
|
4202
|
+
# For more information, see [Permissions required for Lambda functions
|
4203
|
+
# in Amazon ECS blue/green deployments][1] in the <i> Amazon Elastic
|
4204
|
+
# Container Service Developer Guide</i>.
|
4205
|
+
#
|
4206
|
+
#
|
4207
|
+
#
|
4208
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/blue-green-permissions.html
|
4209
|
+
# @return [String]
|
4210
|
+
#
|
4211
|
+
# @!attribute [rw] lifecycle_stages
|
4212
|
+
# The lifecycle stages at which to run the hook. Choose from these
|
4213
|
+
# valid values:
|
4214
|
+
#
|
4215
|
+
# * RECONCILE\_SERVICE
|
4216
|
+
#
|
4217
|
+
# The reconciliation stage that only happens when you start a new
|
4218
|
+
# service deployment with more than 1 service revision in an ACTIVE
|
4219
|
+
# state.
|
4220
|
+
#
|
4221
|
+
# You can use a lifecycle hook for this stage.
|
4222
|
+
#
|
4223
|
+
# * PRE\_SCALE\_UP
|
4224
|
+
#
|
4225
|
+
# The green service revision has not started. The blue service
|
4226
|
+
# revision is handling 100% of the production traffic. There is no
|
4227
|
+
# test traffic.
|
4228
|
+
#
|
4229
|
+
# You can use a lifecycle hook for this stage.
|
4230
|
+
#
|
4231
|
+
# * POST\_SCALE\_UP
|
4232
|
+
#
|
4233
|
+
# The green service revision has started. The blue service revision
|
4234
|
+
# is handling 100% of the production traffic. There is no test
|
4235
|
+
# traffic.
|
4236
|
+
#
|
4237
|
+
# You can use a lifecycle hook for this stage.
|
4238
|
+
#
|
4239
|
+
# * TEST\_TRAFFIC\_SHIFT
|
4240
|
+
#
|
4241
|
+
# The blue and green service revisions are running. The blue service
|
4242
|
+
# revision handles 100% of the production traffic. The green service
|
4243
|
+
# revision is migrating from 0% to 100% of test traffic.
|
4244
|
+
#
|
4245
|
+
# You can use a lifecycle hook for this stage.
|
4246
|
+
#
|
4247
|
+
# * POST\_TEST\_TRAFFIC\_SHIFT
|
4248
|
+
#
|
4249
|
+
# The test traffic shift is complete. The green service revision
|
4250
|
+
# handles 100% of the test traffic.
|
4251
|
+
#
|
4252
|
+
# You can use a lifecycle hook for this stage.
|
4253
|
+
#
|
4254
|
+
# * PRODUCTION\_TRAFFIC\_SHIFT
|
4255
|
+
#
|
4256
|
+
# Production traffic is shifting to the green service revision. The
|
4257
|
+
# green service revision is migrating from 0% to 100% of production
|
4258
|
+
# traffic.
|
4259
|
+
#
|
4260
|
+
# You can use a lifecycle hook for this stage.
|
4261
|
+
#
|
4262
|
+
# * POST\_PRODUCTION\_TRAFFIC\_SHIFT
|
4263
|
+
#
|
4264
|
+
# The production traffic shift is complete.
|
4265
|
+
#
|
4266
|
+
# You can use a lifecycle hook for this stage.
|
4267
|
+
#
|
4268
|
+
# You must provide this parameter when configuring a deployment
|
4269
|
+
# lifecycle hook.
|
4270
|
+
# @return [Array<String>]
|
4271
|
+
#
|
4272
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/DeploymentLifecycleHook AWS API Documentation
|
4273
|
+
#
|
4274
|
+
class DeploymentLifecycleHook < Struct.new(
|
4275
|
+
:hook_target_arn,
|
4276
|
+
:role_arn,
|
4277
|
+
:lifecycle_stages)
|
4278
|
+
SENSITIVE = []
|
4279
|
+
include Aws::Structure
|
4280
|
+
end
|
4281
|
+
|
4053
4282
|
# @!attribute [rw] cluster
|
4054
4283
|
# The short name or full Amazon Resource Name (ARN) of the cluster
|
4055
4284
|
# that hosts the container instance to deregister. If you do not
|
@@ -4546,8 +4775,8 @@ module Aws::ECS
|
|
4546
4775
|
# @!attribute [rw] cluster
|
4547
4776
|
# The short name or full Amazon Resource Name (ARN) of the cluster
|
4548
4777
|
# that hosts the task or tasks to describe. If you do not specify a
|
4549
|
-
# cluster, the default cluster is assumed.
|
4550
|
-
#
|
4778
|
+
# cluster, the default cluster is assumed. If you do not specify a
|
4779
|
+
# value, the `default` cluster is used.
|
4551
4780
|
# @return [String]
|
4552
4781
|
#
|
4553
4782
|
# @!attribute [rw] tasks
|
@@ -6837,13 +7066,21 @@ module Aws::ECS
|
|
6837
7066
|
# traffic on the `hostPort` of the port mapping.
|
6838
7067
|
# @return [Integer]
|
6839
7068
|
#
|
7069
|
+
# @!attribute [rw] advanced_configuration
|
7070
|
+
# The advanced settings for the load balancer used in blue/green
|
7071
|
+
# deployments. Specify the alternate target group, listener rules, and
|
7072
|
+
# IAM role required for traffic shifting during blue/green
|
7073
|
+
# deployments.
|
7074
|
+
# @return [Types::AdvancedConfiguration]
|
7075
|
+
#
|
6840
7076
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/LoadBalancer AWS API Documentation
|
6841
7077
|
#
|
6842
7078
|
class LoadBalancer < Struct.new(
|
6843
7079
|
:target_group_arn,
|
6844
7080
|
:load_balancer_name,
|
6845
7081
|
:container_name,
|
6846
|
-
:container_port
|
7082
|
+
:container_port,
|
7083
|
+
:advanced_configuration)
|
6847
7084
|
SENSITIVE = []
|
6848
7085
|
include Aws::Structure
|
6849
7086
|
end
|
@@ -8937,6 +9174,24 @@ module Aws::ECS
|
|
8937
9174
|
include Aws::Structure
|
8938
9175
|
end
|
8939
9176
|
|
9177
|
+
# The resolved configuration for a service revision, which contains the
|
9178
|
+
# actual resources your service revision uses, such as which target
|
9179
|
+
# groups serve traffic.
|
9180
|
+
#
|
9181
|
+
# @!attribute [rw] load_balancers
|
9182
|
+
# The resolved load balancer configuration for the service revision.
|
9183
|
+
# This includes information about which target groups serve traffic
|
9184
|
+
# and which listener rules direct traffic to them.
|
9185
|
+
# @return [Array<Types::ServiceRevisionLoadBalancer>]
|
9186
|
+
#
|
9187
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ResolvedConfiguration AWS API Documentation
|
9188
|
+
#
|
9189
|
+
class ResolvedConfiguration < Struct.new(
|
9190
|
+
:load_balancers)
|
9191
|
+
SENSITIVE = []
|
9192
|
+
include Aws::Structure
|
9193
|
+
end
|
9194
|
+
|
8940
9195
|
# Describes the resources available for a container instance.
|
8941
9196
|
#
|
8942
9197
|
# @!attribute [rw] name
|
@@ -9855,11 +10110,19 @@ module Aws::ECS
|
|
9855
10110
|
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html
|
9856
10111
|
# @return [String]
|
9857
10112
|
#
|
10113
|
+
# @!attribute [rw] test_traffic_rules
|
10114
|
+
# The configuration for test traffic routing rules used during
|
10115
|
+
# blue/green deployments with Amazon ECS Service Connect. This allows
|
10116
|
+
# you to route a portion of traffic to the new service revision of
|
10117
|
+
# your service for testing before shifting all production traffic.
|
10118
|
+
# @return [Types::ServiceConnectTestTrafficRules]
|
10119
|
+
#
|
9858
10120
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ServiceConnectClientAlias AWS API Documentation
|
9859
10121
|
#
|
9860
10122
|
class ServiceConnectClientAlias < Struct.new(
|
9861
10123
|
:port,
|
9862
|
-
:dns_name
|
10124
|
+
:dns_name,
|
10125
|
+
:test_traffic_rules)
|
9863
10126
|
SENSITIVE = []
|
9864
10127
|
include Aws::Structure
|
9865
10128
|
end
|
@@ -10076,7 +10339,7 @@ module Aws::ECS
|
|
10076
10339
|
# @return [String]
|
10077
10340
|
#
|
10078
10341
|
# @!attribute [rw] discovery_arn
|
10079
|
-
# The Amazon Resource Name (ARN) for the
|
10342
|
+
# The Amazon Resource Name (ARN) for the service in Cloud Map that
|
10080
10343
|
# matches the discovery name for this Service Connect resource. You
|
10081
10344
|
# can use this ARN in other integrations with Cloud Map. However,
|
10082
10345
|
# Service Connect can't ensure connectivity outside of Amazon ECS.
|
@@ -10091,6 +10354,87 @@ module Aws::ECS
|
|
10091
10354
|
include Aws::Structure
|
10092
10355
|
end
|
10093
10356
|
|
10357
|
+
# The header matching rules for test traffic routing in Amazon ECS
|
10358
|
+
# blue/green deployments. These rules determine how incoming requests
|
10359
|
+
# are matched based on HTTP headers to route test traffic to the new
|
10360
|
+
# service revision.
|
10361
|
+
#
|
10362
|
+
# @!attribute [rw] exact
|
10363
|
+
# The exact value that the HTTP header must match for the test traffic
|
10364
|
+
# routing rule to apply. This provides precise control over which
|
10365
|
+
# requests are routed to the new service revision during blue/green
|
10366
|
+
# deployments.
|
10367
|
+
# @return [String]
|
10368
|
+
#
|
10369
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ServiceConnectTestTrafficHeaderMatchRules AWS API Documentation
|
10370
|
+
#
|
10371
|
+
class ServiceConnectTestTrafficHeaderMatchRules < Struct.new(
|
10372
|
+
:exact)
|
10373
|
+
SENSITIVE = []
|
10374
|
+
include Aws::Structure
|
10375
|
+
end
|
10376
|
+
|
10377
|
+
# The HTTP header rules used to identify and route test traffic during
|
10378
|
+
# Amazon ECS blue/green deployments. These rules specify which HTTP
|
10379
|
+
# headers to examine and what values to match for routing decisions.
|
10380
|
+
#
|
10381
|
+
# For more information, see [Service Connect for Amazon ECS blue/green
|
10382
|
+
# deployments][1] in the <i> Amazon Elastic Container Service Developer
|
10383
|
+
# Guide</i>.
|
10384
|
+
#
|
10385
|
+
#
|
10386
|
+
#
|
10387
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect-blue-green.html
|
10388
|
+
#
|
10389
|
+
# @!attribute [rw] name
|
10390
|
+
# The name of the HTTP header to examine for test traffic routing.
|
10391
|
+
# Common examples include custom headers like `X-Test-Version` or
|
10392
|
+
# `X-Canary-Request` that can be used to identify test traffic.
|
10393
|
+
# @return [String]
|
10394
|
+
#
|
10395
|
+
# @!attribute [rw] value
|
10396
|
+
# The header value matching configuration that determines how the HTTP
|
10397
|
+
# header value is evaluated for test traffic routing decisions.
|
10398
|
+
# @return [Types::ServiceConnectTestTrafficHeaderMatchRules]
|
10399
|
+
#
|
10400
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ServiceConnectTestTrafficHeaderRules AWS API Documentation
|
10401
|
+
#
|
10402
|
+
class ServiceConnectTestTrafficHeaderRules < Struct.new(
|
10403
|
+
:name,
|
10404
|
+
:value)
|
10405
|
+
SENSITIVE = []
|
10406
|
+
include Aws::Structure
|
10407
|
+
end
|
10408
|
+
|
10409
|
+
# The test traffic routing configuration for Amazon ECS blue/green
|
10410
|
+
# deployments. This configuration allows you to define rules for routing
|
10411
|
+
# specific traffic to the new service revision during the deployment
|
10412
|
+
# process, allowing for safe testing before full production traffic
|
10413
|
+
# shift.
|
10414
|
+
#
|
10415
|
+
# For more information, see [Service Connect for Amazon ECS blue/green
|
10416
|
+
# deployments][1] in the <i> Amazon Elastic Container Service Developer
|
10417
|
+
# Guide</i>.
|
10418
|
+
#
|
10419
|
+
#
|
10420
|
+
#
|
10421
|
+
# [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect-blue-green.html
|
10422
|
+
#
|
10423
|
+
# @!attribute [rw] header
|
10424
|
+
# The HTTP header-based routing rules that determine which requests
|
10425
|
+
# should be routed to the new service version during blue/green
|
10426
|
+
# deployment testing. These rules provide fine-grained control over
|
10427
|
+
# test traffic routing based on request headers.
|
10428
|
+
# @return [Types::ServiceConnectTestTrafficHeaderRules]
|
10429
|
+
#
|
10430
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ServiceConnectTestTrafficRules AWS API Documentation
|
10431
|
+
#
|
10432
|
+
class ServiceConnectTestTrafficRules < Struct.new(
|
10433
|
+
:header)
|
10434
|
+
SENSITIVE = []
|
10435
|
+
include Aws::Structure
|
10436
|
+
end
|
10437
|
+
|
10094
10438
|
# The certificate root authority that secures your service.
|
10095
10439
|
#
|
10096
10440
|
# @!attribute [rw] aws_pca_authority_arn
|
@@ -10206,6 +10550,67 @@ module Aws::ECS
|
|
10206
10550
|
# status. For example, the circuit breaker detected a failure.
|
10207
10551
|
# @return [String]
|
10208
10552
|
#
|
10553
|
+
# @!attribute [rw] lifecycle_stage
|
10554
|
+
# The current lifecycle stage of the deployment. Possible values
|
10555
|
+
# include:
|
10556
|
+
#
|
10557
|
+
# * RECONCILE\_SERVICE
|
10558
|
+
#
|
10559
|
+
# The reconciliation stage that only happens when you start a new
|
10560
|
+
# service deployment with more than 1 service revision in an ACTIVE
|
10561
|
+
# state.
|
10562
|
+
#
|
10563
|
+
# * PRE\_SCALE\_UP
|
10564
|
+
#
|
10565
|
+
# The green service revision has not started. The blue service
|
10566
|
+
# revision is handling 100% of the production traffic. There is no
|
10567
|
+
# test traffic.
|
10568
|
+
#
|
10569
|
+
# * SCALE\_UP
|
10570
|
+
#
|
10571
|
+
# The stage when the green service revision scales up to 100% and
|
10572
|
+
# launches new tasks. The green service revision is not serving any
|
10573
|
+
# traffic at this point.
|
10574
|
+
#
|
10575
|
+
# * POST\_SCALE\_UP
|
10576
|
+
#
|
10577
|
+
# The green service revision has started. The blue service revision
|
10578
|
+
# is handling 100% of the production traffic. There is no test
|
10579
|
+
# traffic.
|
10580
|
+
#
|
10581
|
+
# * TEST\_TRAFFIC\_SHIFT
|
10582
|
+
#
|
10583
|
+
# The blue and green service revisions are running. The blue service
|
10584
|
+
# revision handles 100% of the production traffic. The green service
|
10585
|
+
# revision is migrating from 0% to 100% of test traffic.
|
10586
|
+
#
|
10587
|
+
# * POST\_TEST\_TRAFFIC\_SHIFT
|
10588
|
+
#
|
10589
|
+
# The test traffic shift is complete. The green service revision
|
10590
|
+
# handles 100% of the test traffic.
|
10591
|
+
#
|
10592
|
+
# * PRODUCTION\_TRAFFIC\_SHIFT
|
10593
|
+
#
|
10594
|
+
# Production traffic is shifting to the green service revision. The
|
10595
|
+
# green service revision is migrating from 0% to 100% of production
|
10596
|
+
# traffic.
|
10597
|
+
#
|
10598
|
+
# * POST\_PRODUCTION\_TRAFFIC\_SHIFT
|
10599
|
+
#
|
10600
|
+
# The production traffic shift is complete.
|
10601
|
+
#
|
10602
|
+
# * BAKE\_TIME
|
10603
|
+
#
|
10604
|
+
# The stage when both blue and green service revisions are running
|
10605
|
+
# simultaneously after the production traffic has shifted.
|
10606
|
+
#
|
10607
|
+
# * CLEAN\_UP
|
10608
|
+
#
|
10609
|
+
# The stage when the blue service revision has completely scaled
|
10610
|
+
# down to 0 running tasks. The green service revision is now the
|
10611
|
+
# production service revision after this stage.
|
10612
|
+
# @return [String]
|
10613
|
+
#
|
10209
10614
|
# @!attribute [rw] deployment_configuration
|
10210
10615
|
# Optional deployment parameters that control how many tasks run
|
10211
10616
|
# during a deployment and the ordering of stopping and starting tasks.
|
@@ -10241,6 +10646,7 @@ module Aws::ECS
|
|
10241
10646
|
:target_service_revision,
|
10242
10647
|
:status,
|
10243
10648
|
:status_reason,
|
10649
|
+
:lifecycle_stage,
|
10244
10650
|
:deployment_configuration,
|
10245
10651
|
:rollback,
|
10246
10652
|
:deployment_circuit_breaker,
|
@@ -10837,6 +11243,12 @@ module Aws::ECS
|
|
10837
11243
|
# The VPC Lattice configuration for the service revision.
|
10838
11244
|
# @return [Array<Types::VpcLatticeConfiguration>]
|
10839
11245
|
#
|
11246
|
+
# @!attribute [rw] resolved_configuration
|
11247
|
+
# The resolved configuration for the service revision which contains
|
11248
|
+
# the actual resources your service revision uses, such as which
|
11249
|
+
# target groups serve traffic.
|
11250
|
+
# @return [Types::ResolvedConfiguration]
|
11251
|
+
#
|
10840
11252
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ServiceRevision AWS API Documentation
|
10841
11253
|
#
|
10842
11254
|
class ServiceRevision < Struct.new(
|
@@ -10857,7 +11269,32 @@ module Aws::ECS
|
|
10857
11269
|
:volume_configurations,
|
10858
11270
|
:fargate_ephemeral_storage,
|
10859
11271
|
:created_at,
|
10860
|
-
:vpc_lattice_configurations
|
11272
|
+
:vpc_lattice_configurations,
|
11273
|
+
:resolved_configuration)
|
11274
|
+
SENSITIVE = []
|
11275
|
+
include Aws::Structure
|
11276
|
+
end
|
11277
|
+
|
11278
|
+
# The resolved load balancer configuration for a service revision. This
|
11279
|
+
# includes information about which target groups serve traffic and which
|
11280
|
+
# listener rules direct traffic to them.
|
11281
|
+
#
|
11282
|
+
# @!attribute [rw] target_group_arn
|
11283
|
+
# The Amazon Resource Name (ARN) of the target group associated with
|
11284
|
+
# the service revision.
|
11285
|
+
# @return [String]
|
11286
|
+
#
|
11287
|
+
# @!attribute [rw] production_listener_rule
|
11288
|
+
# The Amazon Resource Name (ARN) of the production listener rule or
|
11289
|
+
# listener that directs traffic to the target group associated with
|
11290
|
+
# the service revision.
|
11291
|
+
# @return [String]
|
11292
|
+
#
|
11293
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ecs-2014-11-13/ServiceRevisionLoadBalancer AWS API Documentation
|
11294
|
+
#
|
11295
|
+
class ServiceRevisionLoadBalancer < Struct.new(
|
11296
|
+
:target_group_arn,
|
11297
|
+
:production_listener_rule)
|
10861
11298
|
SENSITIVE = []
|
10862
11299
|
include Aws::Structure
|
10863
11300
|
end
|
@@ -13544,6 +13981,10 @@ module Aws::ECS
|
|
13544
13981
|
# and stopping them before they have time to come up.
|
13545
13982
|
# @return [Integer]
|
13546
13983
|
#
|
13984
|
+
# @!attribute [rw] deployment_controller
|
13985
|
+
# The deployment controller to use for the service.
|
13986
|
+
# @return [Types::DeploymentController]
|
13987
|
+
#
|
13547
13988
|
# @!attribute [rw] enable_execute_command
|
13548
13989
|
# If `true`, this enables execute command functionality on all task
|
13549
13990
|
# containers.
|
@@ -13699,6 +14140,7 @@ module Aws::ECS
|
|
13699
14140
|
:platform_version,
|
13700
14141
|
:force_new_deployment,
|
13701
14142
|
:health_check_grace_period_seconds,
|
14143
|
+
:deployment_controller,
|
13702
14144
|
:enable_execute_command,
|
13703
14145
|
:enable_ecs_managed_tags,
|
13704
14146
|
:load_balancers,
|