AWS cli documentation change
Summary
Updated documentation for ECS deployment configurations, clarified load balancer ARN requirements, revised lifecycle hook descriptions, and fixed formatting issues
Security assessment
Changes include clarifications about deployment strategies and load balancer ARN specifications, but no explicit security vulnerabilities or mitigations are mentioned. The removal of 'hookDetails' field documentation and lifecycle stage adjustments appear to be feature refinements rather than security fixes.
Diff
diff --git a/cli/latest/reference/ecs/create-service.md b/cli/latest/reference/ecs/create-service.md index 61c6f543e..3f9ab5553 100644 --- a//cli/latest/reference/ecs/create-service.md +++ b//cli/latest/reference/ecs/create-service.md @@ -15 +15 @@ - * [AWS CLI 2.27.51 Command Reference](../../index.html) » + * [AWS CLI 2.27.54 Command Reference](../../index.html) » @@ -85 +85 @@ The deployment controller is the mechanism that determines how tasks are deploye - * ECS When you create a service which uses the `ECS` deployment controller, you can choose between the following deployment strategies: + * ECS When you create a service which uses the `ECS` deployment controller, you can choose between the following deployment strategies (which you can set in the “`strategy` ” field in “`deploymentConfiguration` ”): : @@ -117,2 +116,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/ecs-20 -`create-service` uses document type values. Document types follow the JSON data model where valid values are: strings, numbers, booleans, null, arrays, and objects. For command input, options and nested parameters that are labeled with the type `document` must be provided as JSON. Shorthand syntax does not support document types. - @@ -268 +266 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/ecs-20 ->>>> The Amazon Resource Name (ARN) that identifies the production listener rule for routing production traffic. +>>>> The Amazon Resource Name (ARN) that that identifies the production listener rule (in the case of an Application Load Balancer) or listener (in the case for an Network Load Balancer) for routing production traffic. @@ -272 +270 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/ecs-20 ->>>> The Amazon Resource Name (ARN) that identifies the test listener rule or listener for routing test traffic. +>>>> The Amazon Resource Name (ARN) that identifies ) that identifies the test listener rule (in the case of an Application Load Balancer) or listener (in the case for an Network Load Balancer) for routing test traffic. @@ -557 +555 @@ JSON Syntax: ->> The duration when both blue and green service revisions are running simultaneously after the production traffic has shifted. +>> The time period when both blue and green service revisions are running simultaneously after the production traffic has shifted. @@ -563 +561 @@ JSON Syntax: ->> An array of deployment lifecycle hook objects to run custom logic at specific stages of the deployment lifecycle. These hooks allow you to run custom logic at key points during the deployment process. +>> An array of deployment lifecycle hook objects to run custom logic at specific stages of the deployment lifecycle. @@ -568,0 +567,2 @@ JSON Syntax: +>>> For more information, see [Lifecycle hooks for Amazon ECS service deployments](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-lifecycle-hooks.html) in the _Amazon Elastic Container Service Developer Guide_ . +>>> @@ -579 +579 @@ JSON Syntax: ->>>> For more information, see [Permissions required for Lambda functions in Amazon ECS blue/green deployments](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/blue-green-permissions.html) in the*Amazon Elastic Container Service Developer Guide* . +>>>> For more information, see [Permissions required for Lambda functions in Amazon ECS blue/green deployments](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/blue-green-permissions.html) in the _Amazon Elastic Container Service Developer Guide_ . @@ -585 +585 @@ JSON Syntax: ->>>> * RECONCILE_SERVICE This stage only happens when you start a new service deployment with more than 1 service revision in an ACTIVE state. You can use a lifecycle hook for this stage. +>>>> * RECONCILE_SERVICE The reconciliation stage that only happens when you start a new service deployment with more than 1 service revision in an ACTIVE state. You can use a lifecycle hook for this stage. @@ -587 +586,0 @@ JSON Syntax: ->>>> * SCALE_UP The time when the green service revision scales up to 100% and launches new tasks. The green service revision is not serving any traffic at this point. You can’t use a lifecycle hook for this stage. @@ -592,3 +591 @@ JSON Syntax: ->>>> * POST_PRODUCTION_TRAFFIC_SHIFT The production traffic shift is complete. Yes ->>>> * BAKE_TIME The duration when both blue and green service revisions are running simultaneously. You can’t use a lifecycle hook for this stage. ->>>> * CLEAN_UP The blue service revision has completely scaled down to 0 running tasks. The green service revision is now the production service revision after this stage. You can’t use a lifecycle hook for this stage. +>>>> * POST_PRODUCTION_TRAFFIC_SHIFT The production traffic shift is complete. You can use a lifecycle hook for this stage. @@ -601,4 +597,0 @@ JSON Syntax: ->>> ->>> hookDetails -> (document) ->>> ->>>> Optionally provide details about the hook. Use this field to pass custom parameters to your hook target (such as a Lambda function). @@ -627,2 +620 @@ JSON Syntax: - "lifecycleStages": ["RECONCILE_SERVICE"|"PRE_SCALE_UP"|"POST_SCALE_UP"|"TEST_TRAFFIC_SHIFT"|"POST_TEST_TRAFFIC_SHIFT"|"PRODUCTION_TRAFFIC_SHIFT"|"POST_PRODUCTION_TRAFFIC_SHIFT", ...], - "hookDetails": {...} + "lifecycleStages": ["RECONCILE_SERVICE"|"PRE_SCALE_UP"|"POST_SCALE_UP"|"TEST_TRAFFIC_SHIFT"|"POST_TEST_TRAFFIC_SHIFT"|"PRODUCTION_TRAFFIC_SHIFT"|"POST_PRODUCTION_TRAFFIC_SHIFT", ...] @@ -2121 +2113 @@ service -> (structure) ->>>>> The Amazon Resource Name (ARN) that identifies the production listener rule for routing production traffic. +>>>>> The Amazon Resource Name (ARN) that that identifies the production listener rule (in the case of an Application Load Balancer) or listener (in the case for an Network Load Balancer) for routing production traffic. @@ -2125 +2117 @@ service -> (structure) ->>>>> The Amazon Resource Name (ARN) that identifies the test listener rule or listener for routing test traffic. +>>>>> The Amazon Resource Name (ARN) that identifies ) that identifies the test listener rule (in the case of an Application Load Balancer) or listener (in the case for an Network Load Balancer) for routing test traffic. @@ -2323 +2315 @@ service -> (structure) ->>> The duration when both blue and green service revisions are running simultaneously after the production traffic has shifted. +>>> The time period when both blue and green service revisions are running simultaneously after the production traffic has shifted. @@ -2329 +2321 @@ service -> (structure) ->>> An array of deployment lifecycle hook objects to run custom logic at specific stages of the deployment lifecycle. These hooks allow you to run custom logic at key points during the deployment process. +>>> An array of deployment lifecycle hook objects to run custom logic at specific stages of the deployment lifecycle. @@ -2334,0 +2327,2 @@ service -> (structure) +>>>> For more information, see [Lifecycle hooks for Amazon ECS service deployments](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-lifecycle-hooks.html) in the _Amazon Elastic Container Service Developer Guide_ . +>>>> @@ -2345 +2339 @@ service -> (structure) ->>>>> For more information, see [Permissions required for Lambda functions in Amazon ECS blue/green deployments](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/blue-green-permissions.html) in the*Amazon Elastic Container Service Developer Guide* . +>>>>> For more information, see [Permissions required for Lambda functions in Amazon ECS blue/green deployments](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/blue-green-permissions.html) in the _Amazon Elastic Container Service Developer Guide_ . @@ -2351 +2345 @@ service -> (structure) ->>>>> * RECONCILE_SERVICE This stage only happens when you start a new service deployment with more than 1 service revision in an ACTIVE state. You can use a lifecycle hook for this stage. +>>>>> * RECONCILE_SERVICE The reconciliation stage that only happens when you start a new service deployment with more than 1 service revision in an ACTIVE state. You can use a lifecycle hook for this stage. @@ -2353 +2346,0 @@ service -> (structure) ->>>>> * SCALE_UP The time when the green service revision scales up to 100% and launches new tasks. The green service revision is not serving any traffic at this point. You can’t use a lifecycle hook for this stage. @@ -2358,3 +2351 @@ service -> (structure) ->>>>> * POST_PRODUCTION_TRAFFIC_SHIFT The production traffic shift is complete. Yes ->>>>> * BAKE_TIME The duration when both blue and green service revisions are running simultaneously. You can’t use a lifecycle hook for this stage. ->>>>> * CLEAN_UP The blue service revision has completely scaled down to 0 running tasks. The green service revision is now the production service revision after this stage. You can’t use a lifecycle hook for this stage. +>>>>> * POST_PRODUCTION_TRAFFIC_SHIFT The production traffic shift is complete. You can use a lifecycle hook for this stage. @@ -2367,4 +2357,0 @@ service -> (structure) ->>>> ->>>> hookDetails -> (document) ->>>> ->>>>> Optionally provide details about the hook. Use this field to pass custom parameters to your hook target (such as a Lambda function). @@ -2593 +2580 @@ service -> (structure) ->>>>>>> The Amazon Resource Name (ARN) that identifies the production listener rule for routing production traffic. +>>>>>>> The Amazon Resource Name (ARN) that that identifies the production listener rule (in the case of an Application Load Balancer) or listener (in the case for an Network Load Balancer) for routing production traffic. @@ -2597 +2584 @@ service -> (structure) ->>>>>>> The Amazon Resource Name (ARN) that identifies the test listener rule or listener for routing test traffic. +>>>>>>> The Amazon Resource Name (ARN) that identifies ) that identifies the test listener rule (in the case of an Application Load Balancer) or listener (in the case for an Network Load Balancer) for routing test traffic. @@ -3619 +3606 @@ service -> (structure) - * [AWS CLI 2.27.51 Command Reference](../../index.html) » + * [AWS CLI 2.27.54 Command Reference](../../index.html) »