AWS emr documentation change
Summary
Added CloudFormation CLI deployment instructions and clarified environment variable retrieval
Security assessment
Similar to other EMR changes - improves deployment documentation without security-specific context.
Diff
diff --git a/emr/latest/ReleaseGuide/spark-troubleshooting-agent-setup.md b/emr/latest/ReleaseGuide/spark-troubleshooting-agent-setup.md index 3497c43fb..ac8b933c3 100644 --- a//emr/latest/ReleaseGuide/spark-troubleshooting-agent-setup.md +++ b//emr/latest/ReleaseGuide/spark-troubleshooting-agent-setup.md @@ -74 +74 @@ Proceed to the **Specify stack details** page, enter the **Stack name**. Enter a -Open the Outputs tab and copy the 1-line instruction from the CloudFormation output to set your environment variables and execute it in your local environment. Example 1-line instruction: +You may also download and review [the CloudFormation template](https://github.com/aws-samples/aws-emr-utilities/blob/03c20fece616de23ec0ea5389f0113a5bc65fc3a/utilities/apache-spark-agents/spark-troubleshooting-agent-cloudformation/spark-troubleshooting-mcp-setup.yaml), specify the options above and launch the template by yourself with CloudFormation CLI commands, see below for an example: @@ -77 +77,21 @@ Open the Outputs tab and copy the 1-line instruction from the CloudFormation out - export SMUS_MCP_REGION=us-east-1 && export IAM_ROLE=arn:aws:iam::111122223333:role/spark-troubleshooting-role-xxxxxx + # deploy the stack with CloudFormation CLI commands + aws cloudformation deploy \ + --template-file spark-troubleshooting-mcp-setup.yaml \ + --stack-name spark-troubleshooting-mcp-setup \ + --region <your Spark MCP server launch region> \ + --capabilities CAPABILITY_NAMED_IAM \ + --parameter-overrides \ + TroubleshootingRoleName=spark-troubleshooting-role + + + # retrieve the 1-line instruction to set the local environment variables, which will be used for the following MCP server configuration + aws cloudformation describe-stacks \ + --stack-name spark-troubleshooting-mcp-setup \ + --region <your Spark MCP server launch region> \ + --query "Stacks[0].Outputs[?OutputKey=='ExportCommand'].OutputValue" \ + --output text + +Open the Outputs tab (or retrieve from the CloudFormation describe-stacks CLI command above) and copy the 1-line instruction from the CloudFormation output to set your environment variables, then execute it in your local environment. Example 1-line instruction: + + + export SMUS_MCP_REGION=<your mcp server launch region> && export IAM_ROLE=arn:aws:iam::111122223333:role/spark-troubleshooting-role-xxxxxx