AWS AWSCloudFormation documentation change
Summary
Updated documentation to replace 'AWS CloudFormation' with 'CloudFormation' throughout the text for consistency and branding alignment. Adjusted links and references to match the simplified naming convention.
Security assessment
The changes are purely branding/naming adjustments (removing 'AWS' from 'AWS CloudFormation') and link updates. No new security-related content was added, and no existing security guidance was modified except for minor phrasing (e.g., retaining the warning about restricting access to template configuration files with sensitive information). There is no evidence of addressing a specific security vulnerability or weakness.
Diff
diff --git a/AWSCloudFormation/latest/UserGuide/continuous-delivery-codepipeline-action-reference.md b/AWSCloudFormation/latest/UserGuide/continuous-delivery-codepipeline-action-reference.md index 6de656a89..649d6eba3 100644 --- a//AWSCloudFormation/latest/UserGuide/continuous-delivery-codepipeline-action-reference.md +++ b//AWSCloudFormation/latest/UserGuide/continuous-delivery-codepipeline-action-reference.md @@ -7 +7 @@ Configuration properties (console)Configuration properties (JSON object)See also -# AWS CloudFormation configuration properties reference +# CloudFormation configuration properties reference @@ -9 +9 @@ Configuration properties (console)Configuration properties (JSON object)See also -When you build a CodePipeline pipeline, you add a `Deploy` action to the pipeline with AWS CloudFormation as a provider. You then must specify which AWS CloudFormation action the pipeline invokes and the action's settings. This topic describes the AWS CloudFormation configuration properties. To specify properties, you can use the CodePipeline console, or you can create a JSON object to use for the AWS CLI, CodePipeline API, or AWS CloudFormation templates. +When you build a CodePipeline pipeline, you add a `Deploy` action to the pipeline with CloudFormation as a provider. You then must specify which CloudFormation action the pipeline invokes and the action's settings. This topic describes the CloudFormation configuration properties. To specify properties, you can use the CodePipeline console, or you can create a JSON object to use for the AWS CLI, CodePipeline API, or CloudFormation templates. @@ -33 +33 @@ When you create a pipeline, you can specify the **Create or update a stack** or -The AWS CloudFormation action that CodePipeline invokes when processing the associated stage. Choose one of the following action modes: +The CloudFormation action that CodePipeline invokes when processing the associated stage. Choose one of the following action modes: @@ -35 +35 @@ The AWS CloudFormation action that CodePipeline invokes when processing the asso - * **Create or replace a change set** creates the change set if it doesn't exist based on the stack name and template that you submit. If the change set exists, AWS CloudFormation deletes it, and then creates a new one. + * **Create or replace a change set** creates the change set if it doesn't exist based on the stack name and template that you submit. If the change set exists, CloudFormation deletes it, and then creates a new one. @@ -37 +37 @@ The AWS CloudFormation action that CodePipeline invokes when processing the asso - * **Create or update a stack** creates the stack if the specified stack doesn't exist. If the stack exists, AWS CloudFormation updates the stack. Use this action to update existing stacks. CodePipeline won't replace the stack. + * **Create or update a stack** creates the stack if the specified stack doesn't exist. If the stack exists, CloudFormation updates the stack. Use this action to update existing stacks. CodePipeline won't replace the stack. @@ -43 +43 @@ The AWS CloudFormation action that CodePipeline invokes when processing the asso - * **Replace a failed stack** creates the stack if the specified stack doesn't exist. If the stack exists and is in a failed state (reported as `ROLLBACK_COMPLETE`, `ROLLBACK_FAILED`, `CREATE_FAILED`, `DELETE_FAILED`, or `UPDATE_ROLLBACK_FAILED`), AWS CloudFormation deletes the stack and then creates a new one. If the stack isn't in a failed state, AWS CloudFormation updates it. Use this action to replace failed stacks without recovering or troubleshooting them. You would typically choose this mode for testing. + * **Replace a failed stack** creates the stack if the specified stack doesn't exist. If the stack exists and is in a failed state (reported as `ROLLBACK_COMPLETE`, `ROLLBACK_FAILED`, `CREATE_FAILED`, `DELETE_FAILED`, or `UPDATE_ROLLBACK_FAILED`), CloudFormation deletes the stack and then creates a new one. If the stack isn't in a failed state, CloudFormation updates it. Use this action to replace failed stacks without recovering or troubleshooting them. You would typically choose this mode for testing. @@ -65 +65 @@ The name of an existing change set or a new change set that you want to create f -The location of an AWS CloudFormation template file, which follows the format ``ArtifactName`::`TemplateFileName``. +The location of an CloudFormation template file, which follows the format ``ArtifactName`::`TemplateFileName``. @@ -70 +70 @@ The location of an AWS CloudFormation template file, which follows the format `` -The location of a template configuration file, which follows the format ``ArtifactName`::`TemplateConfigurationFileName``. The template configuration file can contain template parameter values, a stack policy, and tags. If you include sensitive information, such as passwords, restrict access to this file. For more information, see [AWS CloudFormation artifacts](./continuous-delivery-codepipeline-cfn-artifacts.html). +The location of a template configuration file, which follows the format ``ArtifactName`::`TemplateConfigurationFileName``. The template configuration file can contain template parameter values, a stack policy, and tags. If you include sensitive information, such as passwords, restrict access to this file. For more information, see [CloudFormation artifacts](./continuous-delivery-codepipeline-cfn-artifacts.html). @@ -75 +75 @@ The location of a template configuration file, which follows the format ``Artifa -For stacks that contain certain resources, explicit acknowledgment that AWS CloudFormation might create or update those resources. For example, you must specify `CAPABILITY_IAM` if your stack template contains AWS Identity and Access Management (IAM) resources. For more information, see [CreateStack](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateStack.html) API operation request parameters. +For stacks that contain certain resources, explicit acknowledgment that CloudFormation might create or update those resources. For example, you must specify `CAPABILITY_IAM` if your stack template contains AWS Identity and Access Management (IAM) resources. For more information, see [CreateStack](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateStack.html) API operation request parameters. @@ -84 +84 @@ You can specify more than one capability. -The name of the IAM service role that AWS CloudFormation assumes when it operates on resources in the specified stack. +The name of the IAM service role that CloudFormation assumes when it operates on resources in the specified stack. @@ -89 +89 @@ The name of the IAM service role that AWS CloudFormation assumes when it operate -In the **Advanced** section, you can specify an output file name, such as `CreateStackOutput.json`, that CodePipeline adds to the [output artifact](https://docs.aws.amazon.com/codepipeline/latest/userguide/concepts.html#concepts-artifacts) after it performs the specified action. The output artifact contains a JSON file with the contents of the `Outputs` section of the AWS CloudFormation template. +In the **Advanced** section, you can specify an output file name, such as `CreateStackOutput.json`, that CodePipeline adds to the [output artifact](https://docs.aws.amazon.com/codepipeline/latest/userguide/concepts.html#concepts-artifacts) after it performs the specified action. The output artifact contains a JSON file with the contents of the `Outputs` section of the CloudFormation template. @@ -113 +113 @@ The following example defines a value for the `ParameterName` parameter by using -When you specify `CloudFormation` as a provider for a stage action, define the following properties in the `Configuration` property. Use the JSON object for the AWS CLI, CodePipeline API, or AWS CloudFormation templates. For examples, see [Walkthrough: Building a pipeline for test and production stacks](./continuous-delivery-codepipeline-basic-walkthrough.html) and [AWS CloudFormation configuration properties reference](./continuous-delivery-codepipeline-action-reference.html). +When you specify `CloudFormation` as a provider for a stage action, define the following properties in the `Configuration` property. Use the JSON object for the AWS CLI, CodePipeline API, or CloudFormation templates. For examples, see [Walkthrough: Building a pipeline for test and production stacks](./continuous-delivery-codepipeline-basic-walkthrough.html) and [CloudFormation configuration properties reference](./continuous-delivery-codepipeline-action-reference.html). @@ -118 +118 @@ When you specify `CloudFormation` as a provider for a stage action, define the f -The AWS CloudFormation action that CodePipeline invokes when it processes the associated stage. Specify only one of the following action modes: +The CloudFormation action that CodePipeline invokes when it processes the associated stage. Specify only one of the following action modes: @@ -122 +122 @@ The AWS CloudFormation action that CodePipeline invokes when it processes the as - * `CHANGE_SET_REPLACE` creates the change set, if it doesn't exist, based on the stack name and template that you submit. If the change set exists, AWS CloudFormation deletes it, and then creates a new one. + * `CHANGE_SET_REPLACE` creates the change set, if it doesn't exist, based on the stack name and template that you submit. If the change set exists, CloudFormation deletes it, and then creates a new one. @@ -124 +124 @@ The AWS CloudFormation action that CodePipeline invokes when it processes the as - * `CREATE_UPDATE` creates the stack if the specified stack doesn't exist. If the stack exists, AWS CloudFormation updates the stack. Use this action to update existing stacks. CodePipeline won't replace the stack. + * `CREATE_UPDATE` creates the stack if the specified stack doesn't exist. If the stack exists, CloudFormation updates the stack. Use this action to update existing stacks. CodePipeline won't replace the stack. @@ -128 +128 @@ The AWS CloudFormation action that CodePipeline invokes when it processes the as - * `REPLACE_ON_FAILURE` creates a stack, if the specified stack doesn't exist. If the stack exists and is in a failed state (reported as `ROLLBACK_COMPLETE`, `ROLLBACK_FAILED`, `CREATE_FAILED`, `DELETE_FAILED`, or `UPDATE_ROLLBACK_FAILED`), AWS CloudFormation deletes the stack and then creates a new stack. If the stack isn't in a failed state, AWS CloudFormation updates it. Use this action to automatically replace failed stacks without recovering or troubleshooting them. You would typically choose this mode for testing. + * `REPLACE_ON_FAILURE` creates a stack, if the specified stack doesn't exist. If the stack exists and is in a failed state (reported as `ROLLBACK_COMPLETE`, `ROLLBACK_FAILED`, `CREATE_FAILED`, `DELETE_FAILED`, or `UPDATE_ROLLBACK_FAILED`), CloudFormation deletes the stack and then creates a new stack. If the stack isn't in a failed state, CloudFormation updates it. Use this action to automatically replace failed stacks without recovering or troubleshooting them. You would typically choose this mode for testing. @@ -138 +138 @@ This property is required. -For stacks that contain certain resources, explicit acknowledgment that AWS CloudFormation might create or update those resources. For example, you must specify `CAPABILITY_IAM` if your stack template contains AWS Identity and Access Management (IAM) resources. For more information, see [CreateStack](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateStack.html) API operation request parameters. +For stacks that contain certain resources, explicit acknowledgment that CloudFormation might create or update those resources. For example, you must specify `CAPABILITY_IAM` if your stack template contains AWS Identity and Access Management (IAM) resources. For more information, see [CreateStack](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_CreateStack.html) API operation request parameters. @@ -181 +181 @@ This property is required for the following action modes: `CHANGE_SET_REPLACE` a -A name for the output file, such as `CreateStackOutput.json`. CodePipeline adds the file to the [output artifact](https://docs.aws.amazon.com/codepipeline/latest/userguide/concepts.html#concepts-artifacts) after it performs the specified action. The output artifact contains a JSON file with the contents of the `Outputs` section of the AWS CloudFormation template. +A name for the output file, such as `CreateStackOutput.json`. CodePipeline adds the file to the [output artifact](https://docs.aws.amazon.com/codepipeline/latest/userguide/concepts.html#concepts-artifacts) after it performs the specified action. The output artifact contains a JSON file with the contents of the `Outputs` section of the CloudFormation template. @@ -240 +240 @@ This property is optional. -The Amazon Resource Name (ARN) of the IAM service role that AWS CloudFormation assumes when it operates on resources in a stack. +The Amazon Resource Name (ARN) of the IAM service role that CloudFormation assumes when it operates on resources in a stack. @@ -263 +263 @@ This property is required for all action modes. -The template configuration file can contain template parameter values and a stack policy. If you include sensitive information, such as passwords, restrict access to this file. For an example template configuration file, see [AWS CloudFormation artifacts](./continuous-delivery-codepipeline-cfn-artifacts.html). +The template configuration file can contain template parameter values and a stack policy. If you include sensitive information, such as passwords, restrict access to this file. For an example template configuration file, see [CloudFormation artifacts](./continuous-delivery-codepipeline-cfn-artifacts.html). @@ -270 +270 @@ This property is optional. -`TemplatePath` represents the AWS CloudFormation template file. You include the file in an input artifact to this action. The file name follows this format: +`TemplatePath` represents the CloudFormation template file. You include the file in an input artifact to this action. The file name follows this format: @@ -285 +285 @@ The following related resources can help you as you work with these parameters. - * For more information about the CloudFormation action parameters in CodePipeline, see the [AWS CloudFormation deploy action configuration reference](https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-CloudFormation.html) in the _AWS CodePipeline User Guide_. + * For more information about the CloudFormation action parameters in CodePipeline, see the [CloudFormation deploy action configuration reference](https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-CloudFormation.html) in the _AWS CodePipeline User Guide_. @@ -289 +289 @@ The following related resources can help you as you work with these parameters. - * To download example pipeline stack templates in YAML or JSON format, see [Tutorial: Create a pipeline with AWS CloudFormation](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-cloudformation.html) in the _AWS CodePipeline User Guide_. + * To download example pipeline stack templates in YAML or JSON format, see [Tutorial: Create a pipeline with CloudFormation](https://docs.aws.amazon.com/codepipeline/latest/userguide/tutorials-cloudformation.html) in the _AWS CodePipeline User Guide_. @@ -302 +302 @@ Walkthrough: Building a pipeline for test and production stacks -AWS CloudFormation artifacts +CloudFormation artifacts