AWS step-functions documentation change
Summary
Restructured instructions for creating/running state machines, clarified template usage options ('Run a demo' vs 'Build on it'), updated deployment steps, and removed non-ASCII character warnings
Security assessment
Changes focus on workflow clarification and UI navigation improvements. Removed non-ASCII character warning relates to CloudWatch compatibility but doesn't indicate an active security vulnerability. No explicit security controls or vulnerabilities addressed.
Diff
diff --git a/step-functions/latest/dg/sample-dist-map-s3data-process.md b/step-functions/latest/dg/sample-dist-map-s3data-process.md index 7927900aa..8af0b6cea 100644 --- a/step-functions/latest/dg/sample-dist-map-s3data-process.md +++ b/step-functions/latest/dg/sample-dist-map-s3data-process.md @@ -5 +5 @@ -Step 1: Create the state machineStep 2: Run the state machine +Step 1: Create the state machineStep 2: Run the demo state machine @@ -38 +38 @@ This sample project is only available in the US East (N. Virginia) Region. - 2. Find and choose the starter template you want to work with. Choose **Next** to continue. + 2. Choose **Create from template** and find the related starter template. Choose **Next** to continue. @@ -40,18 +40 @@ This sample project is only available in the US East (N. Virginia) Region. - 3. Choose **Run a demo** to create a read-only and ready-to-deploy workflow, or choose **Build on it** to create an editable state machine definition that you can build on and later deploy. - - 4. Choose **Use template** to continue with your selection. - - - - -Next steps depend on your previous choice: - - 1. **Run a demo** – You can review the state machine before you create a **read-only** project with resources deployed by AWS CloudFormation to your AWS account. - -You can view the state machine definition, and when you are ready, choose **Deploy and run** to deploy the project and create the resources. - -Deploying can take up to 10 minutes to create resources and permissions. You can use the Stack ID link to monitor progress in AWS CloudFormation. - -After deploy completes, you should see your new state machine in the console. - - 2. **Build on it** – You can review and edit the workflow definition. You might need to set values for placeholders in the sample project before attemping to run your custom workflow. + 3. Choose how to use the template: @@ -58,0 +42 @@ After deploy completes, you should see your new state machine in the console. + 1. **Run a demo** – creates a read-only state machine. After review, you can create the workflow and all related resources. @@ -59,0 +44 @@ After deploy completes, you should see your new state machine in the console. + 2. **Build on it** – provides an editable workflow definition that you can review, customize, and deploy with your own resources. (Related resources, such as functions or queues, will **not** be created automatically.) @@ -60,0 +46 @@ After deploy completes, you should see your new state machine in the console. + 4. Choose **Use template** to continue with your selection. @@ -64,5 +50 @@ After deploy completes, you should see your new state machine in the console. - _Standard charges might apply for services deployed to your account._ - -## Step 2: Run the state machine - - 1. On the **State machines** page, choose your sample project. + _Standard charges apply for services deployed to your account._ @@ -70 +51,0 @@ After deploy completes, you should see your new state machine in the console. - 2. On the sample project page, choose **Start execution**. @@ -72 +52,0 @@ After deploy completes, you should see your new state machine in the console. - 3. In the **Start execution** dialog box, do the following: @@ -74 +53,0 @@ After deploy completes, you should see your new state machine in the console. - 1. (Optional) Enter a custom execution name to override the generated default. @@ -76 +55 @@ After deploy completes, you should see your new state machine in the console. -###### Non-ASCII names and logging +## Step 2: Run the demo state machine @@ -78 +57 @@ After deploy completes, you should see your new state machine in the console. -Step Functions accepts names for state machines, executions, activities, and labels that contain non-ASCII characters. Because such characters will not work with Amazon CloudWatch, we recommend using only ASCII characters so you can track metrics in CloudWatch. +If you chose the **Run a demo** option, all related resources will be deployed and ready to run. If you chose the **Build on it** option, you might need to set placeholder values and create additional resources before you can run your custom workflow. @@ -80 +59 @@ Step Functions accepts names for state machines, executions, activities, and lab - 2. (Optional) In the **Input** box, enter input values as JSON. You can skip this step if you are running a demo. + 1. Choose **Deploy and run**. @@ -82 +61 @@ Step Functions accepts names for state machines, executions, activities, and lab - 3. Choose **Start execution**. + 2. Wait for the AWS CloudFormation stack to deploy. This can take up to 10 minutes. @@ -84 +63 @@ Step Functions accepts names for state machines, executions, activities, and lab -The Step Functions console will direct you to an _Execution Details_ page where you can choose states in the **Graph view** to explore related information in the [Step details](./concepts-view-execution-details.html#exec-details-intf-step-details) pane. + 3. After the **Start execution** option appears, review the **Input** and choose **Start execution**. @@ -91 +70 @@ The Step Functions console will direct you to an _Execution Details_ page where -You should now have either a running demo or a state machine definition that you can customize. +You should now have a running demo of your state machine. You can choose states in the **Graph view** to review input, output, variables, definition, and events.