@cdklabs/cdk-ssm-documents 0.0.21 → 0.0.22

package/.jsii

@@ -2798,7 +2798,7 @@
   },
   "name": "@cdklabs/cdk-ssm-documents",
   "readme": {
-    "markdown": "# SSM Document CDK\nThis library provides a code-based utility for implementing SSM Documents. The SSM Document objects can be used to print YAML/JSON documents and to mimic document processing locally.\n\nThis library abstracts SSM Documents at a high level, with each step as well as the document itself being objects. The properties needed to build these objects correlate to the settings that apply to them, making them simple to make.\nThis library can be used to test your document locally before deploying it to SSM.\n\nSince the library is written in JSII, it can be exported to other languages that support JSII (Java, Python).\n\nThis is what you'd use if you wanted to:\n1. The ability to test without deploying resources or executing an actual SSM on AWS.\n2. Reusability of steps between documents by reusing existing items\n3. Create logical higher-level groupings of reusable groups of steps (\"Patterns\")\n4. Simple to use interface for writing documents\n5. Import existing documents from a file (or string) and mimic them locally to test them.\n\n## Usage\n\n### Document Creation\n\nTypescript usage (Execute AWS API Step)...\nThe below creates the AutomationDocument in an AWS CDK stack.\n```ts\nimport { AutomationDocument } from './automation-document';\n\nexport class HelloWorld extends Stack {\n  constructor(app: Construct, id: string) {\n    super(app, id);\n\n    // Create AutomationDocument\n    const myDoc = new AutomationDocument(this, \"MyDoc\", {\n      documentFormat: DocumentFormat.JSON,\n      documentName: \"MyDoc\",\n      docInputs: [Input.ofTypeString('MyInput', { defaultValue: 'a' })],\n    });\n\n    // Define your steps...\n    myDoc.addStep(new PauseStep(this, \"MyPauseStep\", {\n      name: \"MyPauseStep\",\n      explicitNextStep: StepRef.fromName(\"step1\") // Optional (will default to next added step)\n    }));\n\n    myDoc.addStep(new ExecuteScriptStep(this, \"MyExecuteStep\", {\n      name: \"step1\",\n      handlerName: \"my_func\",\n      language: ScriptLanguage.PYTHON,\n      fullPathToCode: resolve(\"test/test_file.py\"),\n      // OR .inlineCode(\"def my_func(args, context):\\n  return {'MyReturn': args['MyInput'] + '-suffix'}\\n\")\n      outputs: [{\n        outputType: DataTypeEnum.STRING,\n        name: \"MyFuncOut\",\n        selector: \"$.Payload.MyReturn\"\n      }],\n      onFailure: OnFailure.abort(),\n      inputs: [\"MyInput\"]\n    }));\n  }\n}\n```\n\n### Document JSON/YAML Export as YAML/JSON\n\nYou can deploy the above document using CDK.\nTo print the above document object as a JSON (or YAML), do the following:\n\n```ts\nconst myDocJson = myDoc.print(); // Print YAML by setting the documentFormat to YAML\n```\n\n\n### Document Simulation\n\nTo run the document object in simulation mode, use the below. Simulation mode does NOT hit the SSM API, rather it mimics the execution that will happen in an SSM execution. The run happens locally and allows you to mock the calls to external services (AWS APIs for example) or to invoke those services using your local credentials.\n\n```ts\nimport { Simulation } from './simulation';\n\nconst myDocJson = Simulation.ofAutomation(myDoc, {}).simulate({ MyInput: \"FooBar\" });\n```\n\n### Command Documents\n\nBelow is an example of how to use the library to create Command documents.\nSimulation for command documents is not yet supported for all command plugins.\nYou can use a Docker image/container as a playground for testing the Command document execution for the supported plugins.\n\nIn this example there is a complete CDK stack. Notice that the `CommandDocument` is saved as a field so that it can be tested from the test code.\n```typescript\nexport class HelloCdkStack extends Stack {\n  readonly myCommandDoc: CommandDocument;\n  constructor(scope: Construct, id: string, props?: StackProps) {\n    super(scope, id, props);\n    this.myCommandDoc = new CommandDocument(this, \"MyCommandDoc\", {\n      docInputs: [Input.ofTypeString('FirstCommand', { defaultValue: 'a' })],\n    })\n    const runScriptStep = new RunShellScriptStep(this, \"MyShellScript\", {\n      runCommand: [\n        StringVariable.of(\"FirstCommand\"),\n        HardCodedString.of(\"mkdir asdf\"),\n      ],\n    });\n    this.myCommandDoc.addStep(runScriptStep);\n  }\n}\n```\n\nBelow is an example of how you would run a simulation against the above `CommandDocument`.\n\nCurrently, `bash` must be available in the container or the executions against the docker will not succeed.\n\n```typescript\ntest('Test command doc', () => {\n  const app = new cdk.App();\n  const stack = new HelloCdk.HelloCdkStack(app, 'MyTestStack');\n  // 1. $ docker pull amazonlinux\n  // 2. $ docker run -di amazonlinux\n  const simulation = Simulation.ofCommand(stack.myCommandDoc, {\n    simulationPlatform: Platform.LINUX,\n    environment: DockerEnvironment.fromContainer('MY_CONTAINER_ID')\n  });\n  simulation.simulate({FirstCommand: 'mkdir foobar'})\n  // 3. The document should run the first command (create 'foobar') and create file 'asdf'\n  // 4. $ docker exec -it <container name> bash\n  // 5. Ensure that 'asdf' and 'foobar' were written to /tmp\n});\n```\n\n## Patterns (High-Level Constructs)\n\nIn typical CDK style, you can assemble often used groups of steps into higher level Constructs.\n\nConsider if you typically create AutomationDocuments that start with logging the time and end with logging the total time taken. You can create a high-level Automation Document and extend that when you implement an Automation.\n\nSee the `TimedDocument` class to see such implementation.\n\nOr consider the case of multiple steps that are always run together such as rebooting and instance and waiting for it to be active.\n\nThe below example is copied from the `RebootInstanceAndWait` class:\n\n```ts\nexport class RebootInstanceAndWait extends CompositeAutomationStep {\n\n  readonly reboot: AwsApiStep;\n  readonly describe: WaitForResourceStep;\n\n  constructor(scope: Construct, id: string, instanceId: IStringVariable) {\n    super(scope, id);\n    this.reboot = new AwsApiStep(this, 'RebootInstances', {\n      service: 'ec2',\n      pascalCaseApi: 'RebootInstances',\n      apiParams: { InstanceIds: [instanceId] },\n      outputs: [],\n    });\n    this.describe = new WaitForResourceStep(this, 'DescribeInstances', {\n      service: 'ec2',\n      pascalCaseApi: 'DescribeInstances',\n      apiParams: { InstanceIds: [instanceId] },\n      selector: '$.Reservations[0].Instances[0].State.Name',\n      desiredValues: ['running'],\n    });\n  }\n\n  addToDocument(doc: AutomationDocumentBuilder): void {\n    doc.addStep(this.reboot);\n    doc.addStep(this.describe);\n  }\n}\n\n```\n\nNow, you can use `RebootInstanceAndWait` as a step in a document and the child steps will be included.\n\n## Existing Documents\n\nDo you have an existing document that you want to convert to code and/or test locally using the simulation?\n\n### Import Existing Document\n\nHere is an example of how you can import an existing document and then simulate it locally with mocked AWS resources:\n\n```ts\n// Initialize Mocks\nconst sleeper = new MockSleep();\nconst awsInvoker = new MockAwsInvoker();\nawsInvoker.whenThen(\n    // when invoked with...\n    {awsApi: 'listBuckets', awsParams: {}, service: 'S3'},\n    // then response with...\n    {Owner: {ID: \"BUCKET_ID\"}})\n\n// ======> Create document from file <=======\nconst stack: Stack = new Stack();\nconst myAutomationDoc = StringDocument.fromFile(stack, \"MyAutomationDoc\", 'test/myAutomation.json', {\n                                                                        // ======================\n});\n\n// Execute simulation\nconst simOutput = Simulation.ofAutomation(myAutomationDoc, {\n  sleepHook: sleeper,\n  awsInvoker: awsInvoker\n}).simulate({});\n\n// Assert simulation result\nassert.deepEqual(awsInvoker.previousInvocations, [\n    { awsApi: 'listBuckets', awsParams: {}, service: 'S3' }]);\nassert.deepEqual(sleeper.sleepMilliInvocations, [3000]);\nassert.deepEqual(simOutput.outputs['simulationSteps'], ['MySleep', 'GetBucketId']);\n```\n\n### Import Existing Steps\n\nYou can also grab a string step (or steps) and import them as CDK step constructs.\nThis can be used to convert existing documents into CDK with each step defined separately.\nDoing so will allow you do modify steps and reuse them in other documents.\n\nHere's a simple example of a sleep step copy and pasted from its original yaml:\n\n```ts\nStringStep.fromYaml(this, `\n    name: sleep\n    action: aws:sleep\n    inputs:\n      Duration: PT0M\n`, {});\n```\n\nThe above will return the CDK construct SleepStep.\n\n## What is Planned?\n\nThis library currently contains AutomationDocument steps.\n\nAlso planned is the ability to run Command documents.\n\nStay tuned!\n\n## Related Projects\n\n- https://github.com/udondan/cdk-ssm-document\n\n## Security\nSee [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information.\n\n## License\nThis project is licensed under the Apache-2.0 License.\n\n"
+    "markdown": "# SSM Document CDK\nThis library provides a code-based utility for implementing SSM Documents. The SSM Document objects can be used to print YAML/JSON documents and to mimic document processing locally.\n\nThis library abstracts SSM Documents at a high level, with each step as well as the document itself being objects. The properties needed to build these objects correlate to the settings that apply to them, making them simple to make.\nThis library can be used to test your document locally before deploying it to SSM.\n\nSince the library is written in JSII, it can be exported to other languages that support JSII (Java, Python).\n\nThis is what you'd use if you wanted to:\n1. The ability to test without deploying resources or executing an actual SSM on AWS.\n2. Reusability of steps between documents by reusing existing items\n3. Create logical higher-level groupings of reusable groups of steps (\"Patterns\")\n4. Simple to use interface for writing documents\n5. Import existing documents from a file (or string) and mimic them locally to test them.\n\n## Usage\n\n### Document Creation\n\nTypescript usage (Execute AWS API Step)...\nThe below creates the AutomationDocument in an AWS CDK stack.\n```ts\nimport { AutomationDocument } from './automation-document';\n\nexport class HelloWorld extends Stack {\n  constructor(app: Construct, id: string) {\n    super(app, id);\n\n    // Create AutomationDocument\n    const myDoc = new AutomationDocument(this, \"MyDoc\", {\n      documentFormat: DocumentFormat.JSON,\n      documentName: \"MyDoc\",\n      docInputs: [Input.ofTypeString('MyInput', { defaultValue: 'a' })],\n    });\n\n    // Define your steps...\n    myDoc.addStep(new PauseStep(this, \"MyPauseStep\", {\n      name: \"MyPauseStep\",\n      explicitNextStep: StepRef.fromName(\"step1\") // Optional (will default to next added step)\n    }));\n\n    myDoc.addStep(new ExecuteScriptStep(this, \"MyExecuteStep\", {\n      name: \"step1\",\n      language: ScriptLanguage.python(PythonVersion.VERSION_3_6, 'my_func'),\n      code: ScriptCode.fromFile(resolve(\"test/test_file.py\")),\n      // OR ScriptCode.inline(\"def my_func(args, context):\\n  return {'MyReturn': args['MyInput'] + '-suffix'}\\n\"),\n      outputs: [{\n        outputType: DataTypeEnum.STRING,\n        name: \"MyFuncOut\",\n        selector: \"$.Payload.MyReturn\"\n      }],\n      onFailure: OnFailure.abort(),\n      inputPayload: { MyInput: StringVariable.of('MyInput') },\n    }));\n  }\n}\n```\n\n### Document JSON/YAML Export as YAML/JSON\n\nYou can deploy the above document using CDK.\nTo print the above document object as a JSON (or YAML), do the following:\n\n```ts\nconst myDocJson = myDoc.print(); // Print YAML by setting the documentFormat to YAML\n```\n\n\n### Document Simulation\n\nTo run the document object in simulation mode, use the below. Simulation mode does NOT hit the SSM API, rather it mimics the execution that will happen in an SSM execution. The run happens locally and allows you to mock the calls to external services (AWS APIs for example) or to invoke those services using your local credentials.\n\n```ts\nimport { Simulation } from './simulation';\n\nconst myDocJson = Simulation.ofAutomation(myDoc, {}).simulate({ MyInput: \"FooBar\" });\n```\n\n### Command Documents\n\nBelow is an example of how to use the library to create Command documents.\nSimulation for command documents is not yet supported for all command plugins.\nYou can use a Docker image/container as a playground for testing the Command document execution for the supported plugins.\n\nIn this example there is a complete CDK stack. Notice that the `CommandDocument` is saved as a field so that it can be tested from the test code.\n```typescript\nexport class HelloCdkStack extends Stack {\n  readonly myCommandDoc: CommandDocument;\n  constructor(scope: Construct, id: string, props?: StackProps) {\n    super(scope, id, props);\n    this.myCommandDoc = new CommandDocument(this, \"MyCommandDoc\", {\n      docInputs: [Input.ofTypeString('FirstCommand', { defaultValue: 'a' })],\n    })\n    const runScriptStep = new RunShellScriptStep(this, \"MyShellScript\", {\n      runCommand: [\n        StringVariable.of(\"FirstCommand\"),\n        HardCodedString.of(\"mkdir asdf\"),\n      ],\n    });\n    this.myCommandDoc.addStep(runScriptStep);\n  }\n}\n```\n\nBelow is an example of how you would run a simulation against the above `CommandDocument`.\n\nCurrently, `bash` must be available in the container or the executions against the docker will not succeed.\n\n```typescript\ntest('Test command doc', () => {\n  const app = new cdk.App();\n  const stack = new HelloCdk.HelloCdkStack(app, 'MyTestStack');\n  // 1. $ docker pull amazonlinux\n  // 2. $ docker run -di amazonlinux\n  const simulation = Simulation.ofCommand(stack.myCommandDoc, {\n    simulationPlatform: Platform.LINUX,\n    environment: DockerEnvironment.fromContainer('MY_CONTAINER_ID')\n  });\n  simulation.simulate({FirstCommand: 'mkdir foobar'})\n  // 3. The document should run the first command (create 'foobar') and create file 'asdf'\n  // 4. $ docker exec -it <container name> bash\n  // 5. Ensure that 'asdf' and 'foobar' were written to /tmp\n});\n```\n\n## Patterns (High-Level Constructs)\n\nIn typical CDK style, you can assemble often used groups of steps into higher level Constructs.\n\nConsider if you typically create AutomationDocuments that start with logging the time and end with logging the total time taken. You can create a high-level Automation Document and extend that when you implement an Automation.\n\nSee the `TimedDocument` class to see such implementation.\n\nOr consider the case of multiple steps that are always run together such as rebooting and instance and waiting for it to be active.\n\nThe below example is copied from the `RebootInstanceAndWait` class:\n\n```ts\nexport class RebootInstanceAndWait extends CompositeAutomationStep {\n\n  readonly reboot: AwsApiStep;\n  readonly describe: WaitForResourceStep;\n\n  constructor(scope: Construct, id: string, instanceId: IStringVariable) {\n    super(scope, id);\n    this.reboot = new AwsApiStep(this, 'RebootInstances', {\n      service: 'ec2',\n      pascalCaseApi: 'RebootInstances',\n      apiParams: { InstanceIds: [instanceId] },\n      outputs: [],\n    });\n    this.describe = new WaitForResourceStep(this, 'DescribeInstances', {\n      service: 'ec2',\n      pascalCaseApi: 'DescribeInstances',\n      apiParams: { InstanceIds: [instanceId] },\n      selector: '$.Reservations[0].Instances[0].State.Name',\n      desiredValues: ['running'],\n    });\n  }\n\n  addToDocument(doc: AutomationDocumentBuilder): void {\n    doc.addStep(this.reboot);\n    doc.addStep(this.describe);\n  }\n}\n\n```\n\nNow, you can use `RebootInstanceAndWait` as a step in a document and the child steps will be included.\n\n## Existing Documents\n\nDo you have an existing document that you want to convert to code and/or test locally using the simulation?\n\n### Import Existing Document\n\nHere is an example of how you can import an existing document and then simulate it locally with mocked AWS resources:\n\n```ts\n// Initialize Mocks\nconst sleeper = new MockSleep();\nconst awsInvoker = new MockAwsInvoker();\nawsInvoker.whenThen(\n    // when invoked with...\n    {awsApi: 'listBuckets', awsParams: {}, service: 'S3'},\n    // then response with...\n    {Owner: {ID: \"BUCKET_ID\"}})\n\n// ======> Create document from file <=======\nconst stack: Stack = new Stack();\nconst myAutomationDoc = StringDocument.fromFile(stack, \"MyAutomationDoc\", 'test/myAutomation.json', {\n                                                                        // ======================\n});\n\n// Execute simulation\nconst simOutput = Simulation.ofAutomation(myAutomationDoc, {\n  sleepHook: sleeper,\n  awsInvoker: awsInvoker\n}).simulate({});\n\n// Assert simulation result\nassert.deepEqual(awsInvoker.previousInvocations, [\n    { awsApi: 'listBuckets', awsParams: {}, service: 'S3' }]);\nassert.deepEqual(sleeper.sleepMilliInvocations, [3000]);\nassert.deepEqual(simOutput.outputs['simulationSteps'], ['MySleep', 'GetBucketId']);\n```\n\n### Import Existing Steps\n\nYou can also grab a string step (or steps) and import them as CDK step constructs.\nThis can be used to convert existing documents into CDK with each step defined separately.\nDoing so will allow you do modify steps and reuse them in other documents.\n\nHere's a simple example of a sleep step copy and pasted from its original yaml:\n\n```ts\nStringStep.fromYaml(this, `\n    name: sleep\n    action: aws:sleep\n    inputs:\n      Duration: PT0M\n`, {});\n```\n\nThe above will return the CDK construct SleepStep.\n\n## What is Planned?\n\nThis library currently contains AutomationDocument steps.\n\nAlso planned is the ability to run Command documents.\n\nStay tuned!\n\n## Related Projects\n\n- https://github.com/udondan/cdk-ssm-document\n\n## Security\nSee [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information.\n\n## License\nThis project is licensed under the Apache-2.0 License.\n\n"
   },
   "repository": {
     "type": "git",
@@ -13890,7 +13890,7 @@
         },
         "locationInModule": {
           "filename": "src/simulation/automation/execute-script-simulation.ts",
-          "line": 13
+          "line": 12
         },
         "parameters": [
           {
@@ -13904,7 +13904,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/simulation/automation/execute-script-simulation.ts",
-        "line": 9
+        "line": 8
       },
       "methods": [
         {
@@ -13915,7 +13915,7 @@
           },
           "locationInModule": {
             "filename": "src/simulation/automation/execute-script-simulation.ts",
-            "line": 22
+            "line": 21
           },
           "name": "executeStep",
           "overrides": "@cdklabs/cdk-ssm-documents.AutomationSimulationBase",
@@ -13953,7 +13953,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/simulation/automation/execute-script-simulation.ts",
-            "line": 11
+            "line": 10
           },
           "name": "action",
           "type": {
@@ -13967,7 +13967,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/simulation/automation/execute-script-simulation.ts",
-            "line": 12
+            "line": 11
           },
           "name": "executeScriptStep",
           "type": {
@@ -13991,7 +13991,7 @@
         },
         "locationInModule": {
           "filename": "src/parent-steps/automation/execute-script-step.ts",
-          "line": 85
+          "line": 242
         },
         "parameters": [
           {
@@ -14017,33 +14017,9 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/parent-steps/automation/execute-script-step.ts",
-        "line": 62
+        "line": 234
       },
       "methods": [
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "locationInModule": {
-            "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 64
-          },
-          "name": "getLanguage",
-          "parameters": [
-            {
-              "name": "runtime",
-              "type": {
-                "primitive": "string"
-              }
-            }
-          ],
-          "returns": {
-            "type": {
-              "fqn": "@cdklabs/cdk-ssm-documents.ScriptLanguage"
-            }
-          },
-          "static": true
-        },
         {
           "docs": {
             "stability": "stable",
@@ -14051,7 +14027,7 @@
           },
           "locationInModule": {
             "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 124
+            "line": 259
           },
           "name": "listInputs",
           "overrides": "@cdklabs/cdk-ssm-documents.Step",
@@ -14073,7 +14049,7 @@
           },
           "locationInModule": {
             "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 120
+            "line": 255
           },
           "name": "listOutputs",
           "overrides": "@cdklabs/cdk-ssm-documents.Step",
@@ -14095,7 +14071,7 @@
           },
           "locationInModule": {
             "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 128
+            "line": 263
           },
           "name": "toSsmEntry",
           "overrides": "@cdklabs/cdk-ssm-documents.Step",
@@ -14120,7 +14096,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 82
+            "line": 240
           },
           "name": "action",
           "overrides": "@cdklabs/cdk-ssm-documents.Step",
@@ -14135,25 +14111,11 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 78
-          },
-          "name": "fullPathToCode",
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 79
+            "line": 237
           },
-          "name": "handlerName",
+          "name": "code",
           "type": {
-            "primitive": "string"
+            "fqn": "@cdklabs/cdk-ssm-documents.ScriptCode"
           }
         },
         {
@@ -14163,15 +14125,15 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 81
+            "line": 239
           },
           "name": "inputs",
           "type": {
             "collection": {
               "elementtype": {
-                "primitive": "string"
+                "fqn": "@cdklabs/cdk-ssm-documents.IGenericVariable"
               },
-              "kind": "array"
+              "kind": "map"
             }
           }
         },
@@ -14182,7 +14144,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 77
+            "line": 236
           },
           "name": "language",
           "type": {
@@ -14196,7 +14158,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 80
+            "line": 238
           },
           "name": "outputs",
           "type": {
@@ -14225,100 +14187,63 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/parent-steps/automation/execute-script-step.ts",
-        "line": 17
+        "line": 201
       },
       "name": "ExecuteScriptStepProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "default": "[]",
-            "stability": "stable",
-            "summary": "(Optional) Inputs that the function needs in order to execute."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 55
-          },
-          "name": "inputs",
-          "type": {
-            "collection": {
-              "elementtype": {
-                "primitive": "string"
-              },
-              "kind": "array"
-            }
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable",
-            "summary": "(Required) Language used to execute the script."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 22
-          },
-          "name": "language",
-          "type": {
-            "fqn": "@cdklabs/cdk-ssm-documents.ScriptLanguage"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "remarks": "File is parsed to produce yaml/json.\nSimulation will execute this file using the language specified.\nEither this OR inclineCode must be provided.",
+            "remarks": "String will be used to produce function in yaml/json.\nSimulation will execute the function in this code using the language specified.",
             "stability": "stable",
-            "summary": "Full path to the code to execute."
+            "summary": "Inline code to be executed."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 29
+            "line": 212
           },
-          "name": "fullPathToCode",
-          "optional": true,
+          "name": "code",
           "type": {
-            "primitive": "string"
+            "fqn": "@cdklabs/cdk-ssm-documents.ScriptCode"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "script_handler",
+            "remarks": "This can be used to pass input data to the script.\nThe key of this dict is the variable name that will be available to the code.\nThe value is the Variable object.",
             "stability": "stable",
-            "summary": "(Optional) Function name in fullPathToCode file to use as entry point for script handler."
+            "summary": "InputPayload that will be passed to the first parameter of the handler."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 42
+            "line": 227
           },
-          "name": "handlerName",
-          "optional": true,
+          "name": "inputPayload",
           "type": {
-            "primitive": "string"
+            "collection": {
+              "elementtype": {
+                "fqn": "@cdklabs/cdk-ssm-documents.IGenericVariable"
+              },
+              "kind": "map"
+            }
           }
         },
         {
           "abstract": true,
           "docs": {
-            "remarks": "String will be used to produce function in yaml/json.\nSimulation will execute the function in this string using the language specified.\nEither this OR fullPathToCode must be provided.",
             "stability": "stable",
-            "summary": "Inline code to be executed."
+            "summary": "(Required) Language used to execute the script."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 36
+            "line": 206
           },
-          "name": "inlineCode",
-          "optional": true,
+          "name": "language",
           "type": {
-            "primitive": "string"
+            "fqn": "@cdklabs/cdk-ssm-documents.ScriptLanguage"
           }
         },
         {
@@ -14332,7 +14257,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/parent-steps/automation/execute-script-step.ts",
-            "line": 49
+            "line": 219
           },
           "name": "outputs",
           "optional": true,
@@ -14713,6 +14638,98 @@
       ],
       "symbolId": "src/parent-steps/automation/execute-state-machine-step:ExecuteStateMachineStepProps"
     },
+    "@cdklabs/cdk-ssm-documents.FileScriptCode": {
+      "assembly": "@cdklabs/cdk-ssm-documents",
+      "base": "@cdklabs/cdk-ssm-documents.ScriptCode",
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@cdklabs/cdk-ssm-documents.FileScriptCode",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/parent-steps/automation/execute-script-step.ts",
+          "line": 75
+        },
+        "parameters": [
+          {
+            "name": "fullPath",
+            "type": {
+              "primitive": "string"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/parent-steps/automation/execute-script-step.ts",
+        "line": 73
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 79
+          },
+          "name": "codeAsString",
+          "overrides": "@cdklabs/cdk-ssm-documents.ScriptCode",
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          }
+        },
+        {
+          "docs": {
+            "remarks": "Otherwise, create a file with the specified suffix.",
+            "stability": "stable",
+            "summary": "If there is a file for this code, return it."
+          },
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 83
+          },
+          "name": "createOrGetFile",
+          "overrides": "@cdklabs/cdk-ssm-documents.ScriptCode",
+          "parameters": [
+            {
+              "name": "_suffix",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          }
+        }
+      ],
+      "name": "FileScriptCode",
+      "properties": [
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 74
+          },
+          "name": "fullPath",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/parent-steps/automation/execute-script-step:FileScriptCode"
+    },
     "@cdklabs/cdk-ssm-documents.GenericVariable": {
       "abstract": true,
       "assembly": "@cdklabs/cdk-ssm-documents",
@@ -17148,7 +17165,7 @@
         },
         "locationInModule": {
           "filename": "src/samples/hello-world.ts",
-          "line": 11
+          "line": 16
         },
         "parameters": [
           {
@@ -17168,7 +17185,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/samples/hello-world.ts",
-        "line": 10
+        "line": 15
       },
       "name": "HelloWorld",
       "symbolId": "src/samples/hello-world:HelloWorld"
@@ -18558,34 +18575,34 @@
       "name": "IWebhook",
       "symbolId": "src/interface/webhook:IWebhook"
     },
-    "@cdklabs/cdk-ssm-documents.Input": {
-      "abstract": true,
+    "@cdklabs/cdk-ssm-documents.InlineScriptCode": {
       "assembly": "@cdklabs/cdk-ssm-documents",
+      "base": "@cdklabs/cdk-ssm-documents.ScriptCode",
       "docs": {
         "stability": "stable"
       },
-      "fqn": "@cdklabs/cdk-ssm-documents.Input",
+      "fqn": "@cdklabs/cdk-ssm-documents.InlineScriptCode",
       "initializer": {
         "docs": {
           "stability": "stable"
         },
         "locationInModule": {
-          "filename": "src/domain/input.ts",
-          "line": 125
+          "filename": "src/parent-steps/automation/execute-script-step.ts",
+          "line": 59
         },
         "parameters": [
           {
-            "name": "props",
+            "name": "inlineCode",
             "type": {
-              "fqn": "@cdklabs/cdk-ssm-documents.InputProps"
+              "primitive": "string"
             }
           }
         ]
       },
       "kind": "class",
       "locationInModule": {
-        "filename": "src/domain/input.ts",
-        "line": 69
+        "filename": "src/parent-steps/automation/execute-script-step.ts",
+        "line": 48
       },
       "methods": [
         {
@@ -18593,49 +18610,141 @@
             "stability": "stable"
           },
           "locationInModule": {
-            "filename": "src/domain/input.ts",
-            "line": 95
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 64
           },
-          "name": "ofSpecifiedType",
-          "parameters": [
-            {
-              "name": "type",
-              "type": {
-                "fqn": "@cdklabs/cdk-ssm-documents.DataTypeEnum"
-              }
-            },
-            {
-              "name": "inputName",
-              "type": {
-                "primitive": "string"
-              }
-            },
-            {
-              "name": "props",
-              "type": {
-                "fqn": "@cdklabs/cdk-ssm-documents.InputProps"
-              }
-            }
-          ],
+          "name": "codeAsString",
+          "overrides": "@cdklabs/cdk-ssm-documents.ScriptCode",
           "returns": {
             "type": {
-              "fqn": "@cdklabs/cdk-ssm-documents.Input"
+              "primitive": "string"
             }
-          },
-          "static": true
+          }
         },
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "Otherwise, create a file with the specified suffix.",
+            "stability": "stable",
+            "summary": "If there is a file for this code, return it."
           },
           "locationInModule": {
-            "filename": "src/domain/input.ts",
-            "line": 79
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 68
           },
-          "name": "ofTypeBoolean",
+          "name": "createOrGetFile",
+          "overrides": "@cdklabs/cdk-ssm-documents.ScriptCode",
           "parameters": [
             {
-              "name": "name",
+              "name": "suffix",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          }
+        }
+      ],
+      "name": "InlineScriptCode",
+      "properties": [
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 58
+          },
+          "name": "inlineCode",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/parent-steps/automation/execute-script-step:InlineScriptCode"
+    },
+    "@cdklabs/cdk-ssm-documents.Input": {
+      "abstract": true,
+      "assembly": "@cdklabs/cdk-ssm-documents",
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@cdklabs/cdk-ssm-documents.Input",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/domain/input.ts",
+          "line": 125
+        },
+        "parameters": [
+          {
+            "name": "props",
+            "type": {
+              "fqn": "@cdklabs/cdk-ssm-documents.InputProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/domain/input.ts",
+        "line": 69
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "locationInModule": {
+            "filename": "src/domain/input.ts",
+            "line": 95
+          },
+          "name": "ofSpecifiedType",
+          "parameters": [
+            {
+              "name": "type",
+              "type": {
+                "fqn": "@cdklabs/cdk-ssm-documents.DataTypeEnum"
+              }
+            },
+            {
+              "name": "inputName",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "props",
+              "type": {
+                "fqn": "@cdklabs/cdk-ssm-documents.InputProps"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cdklabs/cdk-ssm-documents.Input"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "locationInModule": {
+            "filename": "src/domain/input.ts",
+            "line": 79
+          },
+          "name": "ofTypeBoolean",
+          "parameters": [
+            {
+              "name": "name",
               "type": {
                 "primitive": "string"
               }
@@ -23340,6 +23449,42 @@
       ],
       "symbolId": "src/parent-steps/command/ps-module-step:PsModuleStepProps"
     },
+    "@cdklabs/cdk-ssm-documents.PythonVersion": {
+      "assembly": "@cdklabs/cdk-ssm-documents",
+      "docs": {
+        "remarks": "Simulation will use local python version.",
+        "stability": "stable",
+        "summary": "Python runtime to use when writing SSM Document."
+      },
+      "fqn": "@cdklabs/cdk-ssm-documents.PythonVersion",
+      "kind": "enum",
+      "locationInModule": {
+        "filename": "src/parent-steps/automation/execute-script-step.ts",
+        "line": 192
+      },
+      "members": [
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "name": "VERSION_3_6"
+        },
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "name": "VERSION_3_7"
+        },
+        {
+          "docs": {
+            "stability": "stable"
+          },
+          "name": "VERSION_3_8"
+        }
+      ],
+      "name": "PythonVersion",
+      "symbolId": "src/parent-steps/automation/execute-script-step:PythonVersion"
+    },
     "@cdklabs/cdk-ssm-documents.RebootInstanceAndWait": {
       "assembly": "@cdklabs/cdk-ssm-documents",
       "base": "@cdklabs/cdk-ssm-documents.CompositeAutomationStep",
@@ -27492,23 +27637,320 @@
       ],
       "symbolId": "src/interface/downloadable-content:SSMDocumentContent"
     },
+    "@cdklabs/cdk-ssm-documents.ScriptCode": {
+      "abstract": true,
+      "assembly": "@cdklabs/cdk-ssm-documents",
+      "docs": {
+        "remarks": "See \"script\" parameter here:\nhttps://docs.aws.amazon.com/systems-manager/latest/userguide/automation-action-executeScript.html\nAttachments are not yet supported.",
+        "stability": "stable",
+        "summary": "The code to run for the execution."
+      },
+      "fqn": "@cdklabs/cdk-ssm-documents.ScriptCode",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/parent-steps/automation/execute-script-step.ts",
+        "line": 18
+      },
+      "methods": [
+        {
+          "docs": {
+            "remarks": "File is parsed to produce yaml/json.\nSimulation will execute this file using the language specified.\n(Attachments not yet supported)",
+            "stability": "stable",
+            "summary": "Full path to the code to execute."
+          },
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 31
+          },
+          "name": "fromFile",
+          "parameters": [
+            {
+              "name": "fullPath",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cdklabs/cdk-ssm-documents.FileScriptCode"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "remarks": "String will be used to produce function in yaml/json.\nSimulation will execute the function in this string using the language specified.",
+            "stability": "stable",
+            "summary": "Inline code to be executed."
+          },
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 23
+          },
+          "name": "inline",
+          "parameters": [
+            {
+              "name": "code",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cdklabs/cdk-ssm-documents.InlineScriptCode"
+            }
+          },
+          "static": true
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "returns": "code as a string",
+            "stability": "stable"
+          },
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 38
+          },
+          "name": "codeAsString",
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Otherwise, create a file with the specified suffix.",
+            "stability": "stable",
+            "summary": "If there is a file for this code, return it."
+          },
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 45
+          },
+          "name": "createOrGetFile",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "of the file to create (such as \".py\")."
+              },
+              "name": "suffix",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          }
+        }
+      ],
+      "name": "ScriptCode",
+      "symbolId": "src/parent-steps/automation/execute-script-step:ScriptCode"
+    },
     "@cdklabs/cdk-ssm-documents.ScriptLanguage": {
+      "abstract": true,
       "assembly": "@cdklabs/cdk-ssm-documents",
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Specifies the script language as described in the \"Runtime\" argument here: https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-action-executeScript.html."
       },
       "fqn": "@cdklabs/cdk-ssm-documents.ScriptLanguage",
-      "kind": "enum",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        }
+      },
+      "kind": "class",
       "locationInModule": {
         "filename": "src/parent-steps/automation/execute-script-step.ts",
-        "line": 10
+        "line": 92
       },
-      "members": [
+      "methods": [
         {
           "docs": {
-            "stability": "stable"
+            "remarks": "Prefer one of the other static constructors if possible.",
+            "stability": "stable",
+            "summary": "Creates a ScriptLanguage based on the provided runtime."
+          },
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 109
+          },
+          "name": "fromRuntime",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "is the runtime name (such as \"python3.6\")."
+              },
+              "name": "runtime",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "docs": {
+                "summary": "to be provided for python executions."
+              },
+              "name": "handlerName",
+              "optional": true,
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cdklabs/cdk-ssm-documents.ScriptLanguage"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Create a new ScriptLanguage for python execution."
+          },
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 99
+          },
+          "name": "python",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "is the pythonVersion to use when writing the document (for simulation will not matter)."
+              },
+              "name": "version",
+              "type": {
+                "fqn": "@cdklabs/cdk-ssm-documents.PythonVersion"
+              }
+            },
+            {
+              "docs": {
+                "summary": "is the function name in code as entry point for script handler."
+              },
+              "name": "handlerName",
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cdklabs/cdk-ssm-documents.ScriptLanguage"
+            }
           },
-          "name": "PYTHON"
+          "static": true
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The suffix to apply to file names of this type of execution."
+          },
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 142
+          },
+          "name": "fileSuffix",
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "The associated runtime of this ScriptLanguage."
+          },
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 137
+          },
+          "name": "runtime",
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Provide the inputs after replaced with the actual values (not variables).",
+            "stability": "stable",
+            "summary": "Simulate an execution of this ScriptLanguage."
+          },
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 148
+          },
+          "name": "simulate",
+          "parameters": [
+            {
+              "name": "code",
+              "type": {
+                "fqn": "@cdklabs/cdk-ssm-documents.ScriptCode"
+              }
+            },
+            {
+              "name": "inputs",
+              "type": {
+                "collection": {
+                  "elementtype": {
+                    "primitive": "string"
+                  },
+                  "kind": "map"
+                }
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "primitive": "string"
+                },
+                "kind": "map"
+              }
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Builds the ssm inputs."
+          },
+          "locationInModule": {
+            "filename": "src/parent-steps/automation/execute-script-step.ts",
+            "line": 132
+          },
+          "name": "ssmInputs",
+          "returns": {
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "primitive": "string"
+                },
+                "kind": "map"
+              }
+            }
+          }
         }
       ],
       "name": "ScriptLanguage",
@@ -31296,7 +31738,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/patterns/automation/string-step.ts",
-        "line": 26
+        "line": 27
       },
       "methods": [
         {
@@ -31308,7 +31750,7 @@
           },
           "locationInModule": {
             "filename": "src/patterns/automation/string-step.ts",
-            "line": 44
+            "line": 45
           },
           "name": "fromJson",
           "parameters": [
@@ -31341,7 +31783,7 @@
           },
           "locationInModule": {
             "filename": "src/patterns/automation/string-step.ts",
-            "line": 54
+            "line": 55
           },
           "name": "fromObject",
           "parameters": [
@@ -31379,7 +31821,7 @@
           },
           "locationInModule": {
             "filename": "src/patterns/automation/string-step.ts",
-            "line": 34
+            "line": 35
           },
           "name": "fromYaml",
           "parameters": [
@@ -31409,7 +31851,7 @@
           },
           "locationInModule": {
             "filename": "src/patterns/automation/string-step.ts",
-            "line": 155
+            "line": 157
           },
           "name": "addToDocument",
           "overrides": "@cdklabs/cdk-ssm-documents.CompositeAutomationStep",
@@ -31600,7 +32042,7 @@
         },
         "locationInModule": {
           "filename": "src/patterns/document/timed-document.ts",
-          "line": 7
+          "line": 15
         },
         "parameters": [
           {
@@ -31626,7 +32068,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/patterns/document/timed-document.ts",
-        "line": 5
+        "line": 13
       },
       "methods": [
         {
@@ -31635,7 +32077,7 @@
           },
           "locationInModule": {
             "filename": "src/patterns/document/timed-document.ts",
-            "line": 11
+            "line": 19
           },
           "name": "collectedSteps",
           "overrides": "@cdklabs/cdk-ssm-documents.AutomationDocument",
@@ -32688,6 +33130,6 @@
       "symbolId": "src/interface/webhook:WebhookImpl"
     }
   },
-  "version": "0.0.21",
-  "fingerprint": "MHsuAT8tEHjLi6zJGs2rvlPNjjeQ1KZi9ojvYT7/Sn4="
+  "version": "0.0.22",
+  "fingerprint": "gKmW8YofUYLY0f/svFky0/BPOoz6ZwRTI68vqhuKYK0="
 }