AWS cli documentation change
Summary
Updated AWS CLI version reference, modified blue/green deployment documentation, added lifecycle hooks documentation link, removed hookDetails field, and clarified load balancer ARN descriptions
Security assessment
The change adds a reference to lifecycle hooks documentation which is a security-related feature allowing custom logic during deployments. However, there is no evidence of addressing a specific security vulnerability. The removal of hookDetails field appears to be a documentation cleanup without security implications.
Diff
diff --git a/cli/latest/reference/ecs/update-service.md b/cli/latest/reference/ecs/update-service.md index 618ce7a08..98df02fe2 100644 --- a//cli/latest/reference/ecs/update-service.md +++ b//cli/latest/reference/ecs/update-service.md @@ -15 +15 @@ - * [AWS CLI 2.27.51 Command Reference](../../index.html) » + * [AWS CLI 2.27.54 Command Reference](../../index.html) » @@ -111,2 +110,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/ecs-20 -`update-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. - @@ -348 +346 @@ 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. @@ -354 +352 @@ 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. @@ -359,0 +358,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_ . +>>> @@ -370 +370 @@ 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_ . @@ -376 +376 @@ 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. @@ -378 +377,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. @@ -383,3 +382 @@ 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. @@ -392,4 +388,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). @@ -418,2 +411 @@ 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", ...] @@ -720 +712 @@ JSON Syntax: ->>>> 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. @@ -724 +716 @@ JSON Syntax: ->>>> 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. @@ -2371 +2363 @@ 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. @@ -2375 +2367 @@ 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. @@ -2573 +2565 @@ 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. @@ -2579 +2571 @@ 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. @@ -2584,0 +2577,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_ . +>>>> @@ -2595 +2589 @@ 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_ . @@ -2601 +2595 @@ 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. @@ -2603 +2596,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. @@ -2608,3 +2601 @@ 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. @@ -2617,4 +2607,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). @@ -2843 +2830 @@ 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. @@ -2847 +2834 @@ 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. @@ -3869 +3856 @@ service -> (structure) - * [AWS CLI 2.27.51 Command Reference](../../index.html) » + * [AWS CLI 2.27.54 Command Reference](../../index.html) »