aws-cdk-lib 2.178.2__py3-none-any.whl → 2.180.0__py3-none-any.whl

aws_cdk/aws_codepipeline_actions/__init__.py

@@ -1400,7 +1400,8 @@ manual_approval_action = codepipeline_actions.ManualApprovalAction(
     notification_topic=sns.Topic(self, "Topic"),  # optional
     notify_emails=["some_email@example.com"
     ],  # optional
-    additional_information="additional info"
+    additional_information="additional info",  # optional
+    timeout=Duration.minutes(10)
 )
 approve_stage.add_action(manual_approval_action)
 ```
@@ -1578,6 +1579,103 @@ pipeline.add_stage(
 
 See [the AWS documentation](https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-StepFunctions.html)
 for information on Action structure reference.
+
+## Compute
+
+### Commands
+
+The Commands action allows you to run shell commands in a virtual compute instance. When you run the action, commands
+specified in the action configuration are run in a separate container. All artifacts that are specified as input
+artifacts to a CodeBuild action are available inside of the container running the commands. This action allows you
+to specify commands without first creating a CodeBuild project.
+
+```python
+# Source action
+bucket = s3.Bucket(self, "SourceBucket",
+    versioned=True
+)
+source_artifact = codepipeline.Artifact("SourceArtifact")
+source_action = codepipeline_actions.S3SourceAction(
+    action_name="Source",
+    output=source_artifact,
+    bucket=bucket,
+    bucket_key="my.zip"
+)
+
+# Commands action
+output_artifact = codepipeline.Artifact("OutputArtifact")
+commands_action = codepipeline_actions.CommandsAction(
+    action_name="Commands",
+    commands=["echo \"some commands\""
+    ],
+    input=source_artifact,
+    output=output_artifact
+)
+
+pipeline = codepipeline.Pipeline(self, "Pipeline",
+    stages=[codepipeline.StageProps(
+        stage_name="Source",
+        actions=[source_action]
+    ), codepipeline.StageProps(
+        stage_name="Commands",
+        actions=[commands_action]
+    )
+    ]
+)
+```
+
+If you want to filter the files to be included in the output artifact, you can specify their paths as the second
+argument to `Artifact`.
+
+```python
+# source_artifact: codepipeline.Artifact
+
+
+# filter files to be included in the output artifact
+output_artifact = codepipeline.Artifact("OutputArtifact", ["my-dir/**/*"])
+commands_action = codepipeline_actions.CommandsAction(
+    action_name="Commands",
+    commands=["mkdir -p my-dir", "echo \"HelloWorld\" > my-dir/file.txt"
+    ],
+    input=source_artifact,
+    output=output_artifact
+)
+```
+
+You can also specify the `outputVariables` property in the `CommandsAction` to emit environment variables that can be used
+in subsequent actions. The variables are those defined in your shell commands or exported as defaults by the CodeBuild service.
+For a reference of CodeBuild environment variables, see
+[Environment variables in build environments](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html)
+in the CodeBuild User Guide.
+
+To use the output variables in a subsequent action, you can use the `variable` method on the action:
+
+```python
+# source_artifact: codepipeline.Artifact
+# output_artifact: codepipeline.Artifact
+
+
+commands_action = codepipeline_actions.CommandsAction(
+    action_name="Commands",
+    commands=["export MY_OUTPUT=my-key"
+    ],
+    input=source_artifact,
+    output=output_artifact,
+    output_variables=["MY_OUTPUT", "CODEBUILD_BUILD_ID"]
+)
+
+# Deploy action
+deploy_action = codepipeline_actions.S3DeployAction(
+    action_name="DeployAction",
+    extract=True,
+    input=output_artifact,
+    bucket=s3.Bucket(self, "DeployBucket"),
+    object_key=commands_action.variable("MY_OUTPUT")
+)
+```
+
+See [the AWS documentation](https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-Commands.html)
+for more details about using Commands action in CodePipeline.
 '''
 from pkgutil import extend_path
 __path__ = extend_path(__path__, __name__)
@@ -1678,13 +1776,16 @@ class Action(
         category: _ActionCategory_0e233e69,
         provider: builtins.str,
         account: typing.Optional[builtins.str] = None,
+        commands: typing.Optional[typing.Sequence[builtins.str]] = None,
         inputs: typing.Optional[typing.Sequence[_Artifact_0cb05964]] = None,
         outputs: typing.Optional[typing.Sequence[_Artifact_0cb05964]] = None,
+        output_variables: typing.Optional[typing.Sequence[builtins.str]] = None,
         owner: typing.Optional[builtins.str] = None,
         region: typing.Optional[builtins.str] = None,
         resource: typing.Optional[_IResource_c80c4260] = None,
         role: typing.Optional[_IRole_235f5d8e] = None,
         run_order: typing.Optional[jsii.Number] = None,
+        timeout: typing.Optional[_Duration_4839e8c3] = None,
         variables_namespace: typing.Optional[builtins.str] = None,
         version: typing.Optional[builtins.str] = None,
     ) -> None:
@@ -1694,13 +1795,16 @@ class Action(
         :param category: The category of the action. The category defines which action type the owner (the entity that performs the action) performs.
         :param provider: The service provider that the action calls.
         :param account: The account the Action is supposed to live in. For Actions backed by resources, this is inferred from the Stack ``resource`` is part of. However, some Actions, like the CloudFormation ones, are not backed by any resource, and they still might want to be cross-account. In general, a concrete Action class should specify either ``resource``, or ``account`` - but not both.
+        :param commands: Shell commands for the Commands action to run. Default: - no commands
         :param inputs: 
         :param outputs: 
+        :param output_variables: The names of the variables in your environment that you want to export. Default: - no output variables
         :param owner: 
         :param region: The AWS region the given Action resides in. Note that a cross-region Pipeline requires replication buckets to function correctly. You can provide their names with the ``PipelineProps#crossRegionReplicationBuckets`` property. If you don't, the CodePipeline Construct will create new Stacks in your CDK app containing those buckets, that you will need to ``cdk deploy`` before deploying the main, Pipeline-containing Stack. Default: the Action resides in the same region as the Pipeline
         :param resource: The optional resource that is backing this Action. This is used for automatically handling Actions backed by resources from a different account and/or region.
         :param role: 
         :param run_order: The order in which AWS CodePipeline runs this action. For more information, see the AWS CodePipeline User Guide. https://docs.aws.amazon.com/codepipeline/latest/userguide/reference-pipeline-structure.html#action-requirements
+        :param timeout: A timeout duration that can be applied against the ActionType’s default timeout value specified in Quotas for AWS CodePipeline. This attribute is available only to the ``ManualApprovalAction``. It is configurable up to 86400 minutes (60 days) with a minimum value of 5 minutes. Default: - default timeout value defined by each ActionType
         :param variables_namespace: The name of the namespace to use for variables emitted by this action. Default: - a name will be generated, based on the stage and action names
         :param version: 
         '''
@@ -1710,13 +1814,16 @@ class Action(
             category=category,
             provider=provider,
             account=account,
+            commands=commands,
             inputs=inputs,
             outputs=outputs,
+            output_variables=output_variables,
             owner=owner,
             region=region,
             resource=resource,
             role=role,
             run_order=run_order,
+            timeout=timeout,
             variables_namespace=variables_namespace,
             version=version,
         )
@@ -6720,6 +6827,332 @@ class CodeStarSourceVariables:
         )
 
 
+class CommandsAction(
+    Action,
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_codepipeline_actions.CommandsAction",
+):
+    '''CodePipeline compute action that uses AWS Commands.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        # source_artifact: codepipeline.Artifact
+        # output_artifact: codepipeline.Artifact
+        
+        
+        commands_action = codepipeline_actions.CommandsAction(
+            action_name="Commands",
+            commands=["export MY_OUTPUT=my-key"
+            ],
+            input=source_artifact,
+            output=output_artifact,
+            output_variables=["MY_OUTPUT", "CODEBUILD_BUILD_ID"]
+        )
+        
+        # Deploy action
+        deploy_action = codepipeline_actions.S3DeployAction(
+            action_name="DeployAction",
+            extract=True,
+            input=output_artifact,
+            bucket=s3.Bucket(self, "DeployBucket"),
+            object_key=commands_action.variable("MY_OUTPUT")
+        )
+    '''
+
+    def __init__(
+        self,
+        *,
+        commands: typing.Sequence[builtins.str],
+        input: _Artifact_0cb05964,
+        extra_inputs: typing.Optional[typing.Sequence[_Artifact_0cb05964]] = None,
+        output: typing.Optional[_Artifact_0cb05964] = None,
+        output_variables: typing.Optional[typing.Sequence[builtins.str]] = None,
+        role: typing.Optional[_IRole_235f5d8e] = None,
+        action_name: builtins.str,
+        run_order: typing.Optional[jsii.Number] = None,
+        variables_namespace: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''
+        :param commands: Shell commands for the Commands action to run. All formats are supported except multi-line formats. The length of the commands array must be between 1 and 50.
+        :param input: The source to use as input for this action.
+        :param extra_inputs: The list of additional input artifacts for this action. Default: - no extra inputs
+        :param output: The output artifact for this action. You can filter files that you want to export as the output artifact for the action. Default: - no output artifact
+        :param output_variables: The names of the variables in your environment that you want to export. These variables can be referenced in other actions by using the ``variable`` method of this class. Default: - No output variables are exported
+        :param role: The Role in which context's this Action will be executing in. The Pipeline's Role will assume this Role (the required permissions for that will be granted automatically) right before executing this Action. This Action will be passed into your ``IAction.bind`` method in the ``ActionBindOptions.role`` property. Default: a new Role will be generated
+        :param action_name: The physical, human-readable name of the Action. Note that Action names must be unique within a single Stage.
+        :param run_order: The runOrder property for this Action. RunOrder determines the relative order in which multiple Actions in the same Stage execute. Default: 1
+        :param variables_namespace: The name of the namespace to use for variables emitted by this action. Default: - a name will be generated, based on the stage and action names, if any of the action's variables were referenced - otherwise, no namespace will be set
+        '''
+        props = CommandsActionProps(
+            commands=commands,
+            input=input,
+            extra_inputs=extra_inputs,
+            output=output,
+            output_variables=output_variables,
+            role=role,
+            action_name=action_name,
+            run_order=run_order,
+            variables_namespace=variables_namespace,
+        )
+
+        jsii.create(self.__class__, self, [props])
+
+    @jsii.member(jsii_name="bound")
+    def _bound(
+        self,
+        scope: _constructs_77d1e7e8.Construct,
+        stage: _IStage_415fc571,
+        *,
+        bucket: _IBucket_42e086fd,
+        role: _IRole_235f5d8e,
+    ) -> _ActionConfig_846fc217:
+        '''This is a renamed version of the ``IAction.bind`` method.
+
+        :param scope: -
+        :param stage: -
+        :param bucket: 
+        :param role: 
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__bbe79ee7c34315f68e6df88d72bfe72e659a27a9fec26929b6ecfa2c9489e62d)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument stage", value=stage, expected_type=type_hints["stage"])
+        options = _ActionBindOptions_3a612254(bucket=bucket, role=role)
+
+        return typing.cast(_ActionConfig_846fc217, jsii.invoke(self, "bound", [scope, stage, options]))
+
+    @jsii.member(jsii_name="variable")
+    def variable(self, variable_name: builtins.str) -> builtins.str:
+        '''Reference a CodePipeline variable exported in the Commands action.
+
+        :param variable_name: the name of the variable exported by ``outputVariables``.
+
+        :see: https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__f4edb851cf8ea72119d980b99b9e14e11af9c8f5ebca0f3de5a9d841fd93b27f)
+            check_type(argname="argument variable_name", value=variable_name, expected_type=type_hints["variable_name"])
+        return typing.cast(builtins.str, jsii.invoke(self, "variable", [variable_name]))
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_codepipeline_actions.CommandsActionProps",
+    jsii_struct_bases=[_CommonAwsActionProps_8b809bb6],
+    name_mapping={
+        "action_name": "actionName",
+        "run_order": "runOrder",
+        "variables_namespace": "variablesNamespace",
+        "role": "role",
+        "commands": "commands",
+        "input": "input",
+        "extra_inputs": "extraInputs",
+        "output": "output",
+        "output_variables": "outputVariables",
+    },
+)
+class CommandsActionProps(_CommonAwsActionProps_8b809bb6):
+    def __init__(
+        self,
+        *,
+        action_name: builtins.str,
+        run_order: typing.Optional[jsii.Number] = None,
+        variables_namespace: typing.Optional[builtins.str] = None,
+        role: typing.Optional[_IRole_235f5d8e] = None,
+        commands: typing.Sequence[builtins.str],
+        input: _Artifact_0cb05964,
+        extra_inputs: typing.Optional[typing.Sequence[_Artifact_0cb05964]] = None,
+        output: typing.Optional[_Artifact_0cb05964] = None,
+        output_variables: typing.Optional[typing.Sequence[builtins.str]] = None,
+    ) -> None:
+        '''Construction properties of the ``CommandsAction``.
+
+        :param action_name: The physical, human-readable name of the Action. Note that Action names must be unique within a single Stage.
+        :param run_order: The runOrder property for this Action. RunOrder determines the relative order in which multiple Actions in the same Stage execute. Default: 1
+        :param variables_namespace: The name of the namespace to use for variables emitted by this action. Default: - a name will be generated, based on the stage and action names, if any of the action's variables were referenced - otherwise, no namespace will be set
+        :param role: The Role in which context's this Action will be executing in. The Pipeline's Role will assume this Role (the required permissions for that will be granted automatically) right before executing this Action. This Action will be passed into your ``IAction.bind`` method in the ``ActionBindOptions.role`` property. Default: a new Role will be generated
+        :param commands: Shell commands for the Commands action to run. All formats are supported except multi-line formats. The length of the commands array must be between 1 and 50.
+        :param input: The source to use as input for this action.
+        :param extra_inputs: The list of additional input artifacts for this action. Default: - no extra inputs
+        :param output: The output artifact for this action. You can filter files that you want to export as the output artifact for the action. Default: - no output artifact
+        :param output_variables: The names of the variables in your environment that you want to export. These variables can be referenced in other actions by using the ``variable`` method of this class. Default: - No output variables are exported
+
+        :exampleMetadata: infused
+
+        Example::
+
+            # source_artifact: codepipeline.Artifact
+            # output_artifact: codepipeline.Artifact
+            
+            
+            commands_action = codepipeline_actions.CommandsAction(
+                action_name="Commands",
+                commands=["export MY_OUTPUT=my-key"
+                ],
+                input=source_artifact,
+                output=output_artifact,
+                output_variables=["MY_OUTPUT", "CODEBUILD_BUILD_ID"]
+            )
+            
+            # Deploy action
+            deploy_action = codepipeline_actions.S3DeployAction(
+                action_name="DeployAction",
+                extract=True,
+                input=output_artifact,
+                bucket=s3.Bucket(self, "DeployBucket"),
+                object_key=commands_action.variable("MY_OUTPUT")
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__21385ddbb3031b453940ecb11b8a645ed20dfca73333fe16ee187494d8459395)
+            check_type(argname="argument action_name", value=action_name, expected_type=type_hints["action_name"])
+            check_type(argname="argument run_order", value=run_order, expected_type=type_hints["run_order"])
+            check_type(argname="argument variables_namespace", value=variables_namespace, expected_type=type_hints["variables_namespace"])
+            check_type(argname="argument role", value=role, expected_type=type_hints["role"])
+            check_type(argname="argument commands", value=commands, expected_type=type_hints["commands"])
+            check_type(argname="argument input", value=input, expected_type=type_hints["input"])
+            check_type(argname="argument extra_inputs", value=extra_inputs, expected_type=type_hints["extra_inputs"])
+            check_type(argname="argument output", value=output, expected_type=type_hints["output"])
+            check_type(argname="argument output_variables", value=output_variables, expected_type=type_hints["output_variables"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "action_name": action_name,
+            "commands": commands,
+            "input": input,
+        }
+        if run_order is not None:
+            self._values["run_order"] = run_order
+        if variables_namespace is not None:
+            self._values["variables_namespace"] = variables_namespace
+        if role is not None:
+            self._values["role"] = role
+        if extra_inputs is not None:
+            self._values["extra_inputs"] = extra_inputs
+        if output is not None:
+            self._values["output"] = output
+        if output_variables is not None:
+            self._values["output_variables"] = output_variables
+
+    @builtins.property
+    def action_name(self) -> builtins.str:
+        '''The physical, human-readable name of the Action.
+
+        Note that Action names must be unique within a single Stage.
+        '''
+        result = self._values.get("action_name")
+        assert result is not None, "Required property 'action_name' is missing"
+        return typing.cast(builtins.str, result)
+
+    @builtins.property
+    def run_order(self) -> typing.Optional[jsii.Number]:
+        '''The runOrder property for this Action.
+
+        RunOrder determines the relative order in which multiple Actions in the same Stage execute.
+
+        :default: 1
+
+        :see: https://docs.aws.amazon.com/codepipeline/latest/userguide/reference-pipeline-structure.html
+        '''
+        result = self._values.get("run_order")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
+    @builtins.property
+    def variables_namespace(self) -> typing.Optional[builtins.str]:
+        '''The name of the namespace to use for variables emitted by this action.
+
+        :default:
+
+        - a name will be generated, based on the stage and action names,
+        if any of the action's variables were referenced - otherwise,
+        no namespace will be set
+        '''
+        result = self._values.get("variables_namespace")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def role(self) -> typing.Optional[_IRole_235f5d8e]:
+        '''The Role in which context's this Action will be executing in.
+
+        The Pipeline's Role will assume this Role
+        (the required permissions for that will be granted automatically)
+        right before executing this Action.
+        This Action will be passed into your ``IAction.bind``
+        method in the ``ActionBindOptions.role`` property.
+
+        :default: a new Role will be generated
+        '''
+        result = self._values.get("role")
+        return typing.cast(typing.Optional[_IRole_235f5d8e], result)
+
+    @builtins.property
+    def commands(self) -> typing.List[builtins.str]:
+        '''Shell commands for the Commands action to run.
+
+        All formats are supported except multi-line formats.
+
+        The length of the commands array must be between 1 and 50.
+        '''
+        result = self._values.get("commands")
+        assert result is not None, "Required property 'commands' is missing"
+        return typing.cast(typing.List[builtins.str], result)
+
+    @builtins.property
+    def input(self) -> _Artifact_0cb05964:
+        '''The source to use as input for this action.'''
+        result = self._values.get("input")
+        assert result is not None, "Required property 'input' is missing"
+        return typing.cast(_Artifact_0cb05964, result)
+
+    @builtins.property
+    def extra_inputs(self) -> typing.Optional[typing.List[_Artifact_0cb05964]]:
+        '''The list of additional input artifacts for this action.
+
+        :default: - no extra inputs
+        '''
+        result = self._values.get("extra_inputs")
+        return typing.cast(typing.Optional[typing.List[_Artifact_0cb05964]], result)
+
+    @builtins.property
+    def output(self) -> typing.Optional[_Artifact_0cb05964]:
+        '''The output artifact for this action.
+
+        You can filter files that you want to export as the output artifact for the action.
+
+        :default: - no output artifact
+
+        Example::
+
+            codepipeline.Artifact("CommandsArtifact", ["my-dir/**"])
+        '''
+        result = self._values.get("output")
+        return typing.cast(typing.Optional[_Artifact_0cb05964], result)
+
+    @builtins.property
+    def output_variables(self) -> typing.Optional[typing.List[builtins.str]]:
+        '''The names of the variables in your environment that you want to export.
+
+        These variables can be referenced in other actions by using the ``variable`` method
+        of this class.
+
+        :default: - No output variables are exported
+
+        :see: https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html
+        '''
+        result = self._values.get("output_variables")
+        return typing.cast(typing.Optional[typing.List[builtins.str]], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "CommandsActionProps(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_codepipeline_actions.CommonCloudFormationStackSetOptions",
     jsii_struct_bases=[],
@@ -9157,6 +9590,7 @@ class ManualApprovalAction(
         external_entity_link: typing.Optional[builtins.str] = None,
         notification_topic: typing.Optional[_ITopic_9eca4852] = None,
         notify_emails: typing.Optional[typing.Sequence[builtins.str]] = None,
+        timeout: typing.Optional[_Duration_4839e8c3] = None,
         role: typing.Optional[_IRole_235f5d8e] = None,
         action_name: builtins.str,
         run_order: typing.Optional[jsii.Number] = None,
@@ -9167,6 +9601,7 @@ class ManualApprovalAction(
         :param external_entity_link: URL you want to provide to the reviewer as part of the approval request. Default: - the approval request will not have an external link
         :param notification_topic: Optional SNS topic to send notifications to when an approval is pending.
         :param notify_emails: A list of email addresses to subscribe to notifications when this Action is pending approval. If this has been provided, but not ``notificationTopic``, a new Topic will be created.
+        :param timeout: A timeout duration. It is configurable up to 86400 minutes (60 days) with a minimum value of 5 minutes. Default: - 10080 minutes (7 days)
         :param role: The Role in which context's this Action will be executing in. The Pipeline's Role will assume this Role (the required permissions for that will be granted automatically) right before executing this Action. This Action will be passed into your ``IAction.bind`` method in the ``ActionBindOptions.role`` property. Default: a new Role will be generated
         :param action_name: The physical, human-readable name of the Action. Note that Action names must be unique within a single Stage.
         :param run_order: The runOrder property for this Action. RunOrder determines the relative order in which multiple Actions in the same Stage execute. Default: 1
@@ -9177,6 +9612,7 @@ class ManualApprovalAction(
             external_entity_link=external_entity_link,
             notification_topic=notification_topic,
             notify_emails=notify_emails,
+            timeout=timeout,
             role=role,
             action_name=action_name,
             run_order=run_order,
@@ -9241,6 +9677,7 @@ class ManualApprovalAction(
         "external_entity_link": "externalEntityLink",
         "notification_topic": "notificationTopic",
         "notify_emails": "notifyEmails",
+        "timeout": "timeout",
     },
 )
 class ManualApprovalActionProps(_CommonAwsActionProps_8b809bb6):
@@ -9255,6 +9692,7 @@ class ManualApprovalActionProps(_CommonAwsActionProps_8b809bb6):
         external_entity_link: typing.Optional[builtins.str] = None,
         notification_topic: typing.Optional[_ITopic_9eca4852] = None,
         notify_emails: typing.Optional[typing.Sequence[builtins.str]] = None,
+        timeout: typing.Optional[_Duration_4839e8c3] = None,
     ) -> None:
         '''Construction properties of the ``ManualApprovalAction``.
 
@@ -9266,6 +9704,7 @@ class ManualApprovalActionProps(_CommonAwsActionProps_8b809bb6):
         :param external_entity_link: URL you want to provide to the reviewer as part of the approval request. Default: - the approval request will not have an external link
         :param notification_topic: Optional SNS topic to send notifications to when an approval is pending.
         :param notify_emails: A list of email addresses to subscribe to notifications when this Action is pending approval. If this has been provided, but not ``notificationTopic``, a new Topic will be created.
+        :param timeout: A timeout duration. It is configurable up to 86400 minutes (60 days) with a minimum value of 5 minutes. Default: - 10080 minutes (7 days)
 
         :exampleMetadata: infused
 
@@ -9291,6 +9730,7 @@ class ManualApprovalActionProps(_CommonAwsActionProps_8b809bb6):
             check_type(argname="argument external_entity_link", value=external_entity_link, expected_type=type_hints["external_entity_link"])
             check_type(argname="argument notification_topic", value=notification_topic, expected_type=type_hints["notification_topic"])
             check_type(argname="argument notify_emails", value=notify_emails, expected_type=type_hints["notify_emails"])
+            check_type(argname="argument timeout", value=timeout, expected_type=type_hints["timeout"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "action_name": action_name,
         }
@@ -9308,6 +9748,8 @@ class ManualApprovalActionProps(_CommonAwsActionProps_8b809bb6):
             self._values["notification_topic"] = notification_topic
         if notify_emails is not None:
             self._values["notify_emails"] = notify_emails
+        if timeout is not None:
+            self._values["timeout"] = timeout
 
     @builtins.property
     def action_name(self) -> builtins.str:
@@ -9391,6 +9833,19 @@ class ManualApprovalActionProps(_CommonAwsActionProps_8b809bb6):
         result = self._values.get("notify_emails")
         return typing.cast(typing.Optional[typing.List[builtins.str]], result)
 
+    @builtins.property
+    def timeout(self) -> typing.Optional[_Duration_4839e8c3]:
+        '''A timeout duration.
+
+        It is configurable up to 86400 minutes (60 days) with a minimum value of 5 minutes.
+
+        :default: - 10080 minutes (7 days)
+
+        :see: https://docs.aws.amazon.com/codepipeline/latest/userguide/limits.html
+        '''
+        result = self._values.get("timeout")
+        return typing.cast(typing.Optional[_Duration_4839e8c3], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -9473,28 +9928,26 @@ class S3DeployAction(
 
     Example::
 
-        # source_action: codepipeline_actions.S3SourceAction
-        # source_output: codepipeline.Artifact
-        # deploy_bucket: s3.Bucket
+        # source_artifact: codepipeline.Artifact
+        # output_artifact: codepipeline.Artifact
         
         
-        codepipeline.Pipeline(self, "Pipeline",
-            stages=[codepipeline.StageProps(
-                stage_name="Source",
-                actions=[source_action]
-            ), codepipeline.StageProps(
-                stage_name="Deploy",
-                actions=[
-                    codepipeline_actions.S3DeployAction(
-                        action_name="DeployAction",
-                        # can reference the variables
-                        object_key=f"{sourceAction.variables.versionId}.txt",
-                        input=source_output,
-                        bucket=deploy_bucket
-                    )
-                ]
-            )
-            ]
+        commands_action = codepipeline_actions.CommandsAction(
+            action_name="Commands",
+            commands=["export MY_OUTPUT=my-key"
+            ],
+            input=source_artifact,
+            output=output_artifact,
+            output_variables=["MY_OUTPUT", "CODEBUILD_BUILD_ID"]
+        )
+        
+        # Deploy action
+        deploy_action = codepipeline_actions.S3DeployAction(
+            action_name="DeployAction",
+            extract=True,
+            input=output_artifact,
+            bucket=s3.Bucket(self, "DeployBucket"),
+            object_key=commands_action.variable("MY_OUTPUT")
         )
     '''
 
@@ -9618,28 +10071,26 @@ class S3DeployActionProps(_CommonAwsActionProps_8b809bb6):
 
         Example::
 
-            # source_action: codepipeline_actions.S3SourceAction
-            # source_output: codepipeline.Artifact
-            # deploy_bucket: s3.Bucket
+            # source_artifact: codepipeline.Artifact
+            # output_artifact: codepipeline.Artifact
             
             
-            codepipeline.Pipeline(self, "Pipeline",
-                stages=[codepipeline.StageProps(
-                    stage_name="Source",
-                    actions=[source_action]
-                ), codepipeline.StageProps(
-                    stage_name="Deploy",
-                    actions=[
-                        codepipeline_actions.S3DeployAction(
-                            action_name="DeployAction",
-                            # can reference the variables
-                            object_key=f"{sourceAction.variables.versionId}.txt",
-                            input=source_output,
-                            bucket=deploy_bucket
-                        )
-                    ]
-                )
-                ]
+            commands_action = codepipeline_actions.CommandsAction(
+                action_name="Commands",
+                commands=["export MY_OUTPUT=my-key"
+                ],
+                input=source_artifact,
+                output=output_artifact,
+                output_variables=["MY_OUTPUT", "CODEBUILD_BUILD_ID"]
+            )
+            
+            # Deploy action
+            deploy_action = codepipeline_actions.S3DeployAction(
+                action_name="DeployAction",
+                extract=True,
+                input=output_artifact,
+                bucket=s3.Bucket(self, "DeployBucket"),
+                object_key=commands_action.variable("MY_OUTPUT")
             )
         '''
         if __debug__:
@@ -9820,25 +10271,28 @@ class S3SourceAction(
 
     Example::
 
-        import aws_cdk.aws_cloudtrail as cloudtrail
-        
         # source_bucket: s3.Bucket
         
-        source_output = codepipeline.Artifact()
+        # later:
+        # project: codebuild.PipelineProject
         key = "some/key.zip"
-        trail = cloudtrail.Trail(self, "CloudTrail")
-        trail.add_s3_event_selector([cloudtrail.S3EventSelector(
-            bucket=source_bucket,
-            object_prefix=key
-        )],
-            read_write_type=cloudtrail.ReadWriteType.WRITE_ONLY
-        )
+        source_output = codepipeline.Artifact()
         source_action = codepipeline_actions.S3SourceAction(
             action_name="S3Source",
             bucket_key=key,
             bucket=source_bucket,
             output=source_output,
-            trigger=codepipeline_actions.S3Trigger.EVENTS
+            variables_namespace="MyNamespace"
+        )
+        codepipeline_actions.CodeBuildAction(
+            action_name="CodeBuild",
+            project=project,
+            input=source_output,
+            environment_variables={
+                "VERSION_ID": codebuild.BuildEnvironmentVariable(
+                    value=source_action.variables.version_id
+                )
+            }
         )
     '''
 
@@ -9950,25 +10404,28 @@ class S3SourceActionProps(_CommonAwsActionProps_8b809bb6):
 
         Example::
 
-            import aws_cdk.aws_cloudtrail as cloudtrail
-            
             # source_bucket: s3.Bucket
             
-            source_output = codepipeline.Artifact()
+            # later:
+            # project: codebuild.PipelineProject
             key = "some/key.zip"
-            trail = cloudtrail.Trail(self, "CloudTrail")
-            trail.add_s3_event_selector([cloudtrail.S3EventSelector(
-                bucket=source_bucket,
-                object_prefix=key
-            )],
-                read_write_type=cloudtrail.ReadWriteType.WRITE_ONLY
-            )
+            source_output = codepipeline.Artifact()
             source_action = codepipeline_actions.S3SourceAction(
                 action_name="S3Source",
                 bucket_key=key,
                 bucket=source_bucket,
                 output=source_output,
-                trigger=codepipeline_actions.S3Trigger.EVENTS
+                variables_namespace="MyNamespace"
+            )
+            codepipeline_actions.CodeBuildAction(
+                action_name="CodeBuild",
+                project=project,
+                input=source_output,
+                environment_variables={
+                    "VERSION_ID": codebuild.BuildEnvironmentVariable(
+                        value=source_action.variables.version_id
+                    )
+                }
             )
         '''
         if __debug__:
@@ -12145,6 +12602,8 @@ __all__ = [
     "CodeStarConnectionsSourceAction",
     "CodeStarConnectionsSourceActionProps",
     "CodeStarSourceVariables",
+    "CommandsAction",
+    "CommandsActionProps",
     "CommonCloudFormationStackSetOptions",
     "EcrSourceAction",
     "EcrSourceActionProps",
@@ -12582,6 +13041,37 @@ def _typecheckingstub__cafaad91c3e2208fbf7ad428836c6a672d42b11ef090e05536df65ea9
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__bbe79ee7c34315f68e6df88d72bfe72e659a27a9fec26929b6ecfa2c9489e62d(
+    scope: _constructs_77d1e7e8.Construct,
+    stage: _IStage_415fc571,
+    *,
+    bucket: _IBucket_42e086fd,
+    role: _IRole_235f5d8e,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__f4edb851cf8ea72119d980b99b9e14e11af9c8f5ebca0f3de5a9d841fd93b27f(
+    variable_name: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__21385ddbb3031b453940ecb11b8a645ed20dfca73333fe16ee187494d8459395(
+    *,
+    action_name: builtins.str,
+    run_order: typing.Optional[jsii.Number] = None,
+    variables_namespace: typing.Optional[builtins.str] = None,
+    role: typing.Optional[_IRole_235f5d8e] = None,
+    commands: typing.Sequence[builtins.str],
+    input: _Artifact_0cb05964,
+    extra_inputs: typing.Optional[typing.Sequence[_Artifact_0cb05964]] = None,
+    output: typing.Optional[_Artifact_0cb05964] = None,
+    output_variables: typing.Optional[typing.Sequence[builtins.str]] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__2410584584bdbc5570942e28fb48b74fa12d17853f6fde7bdcddfd923102e537(
     *,
     failure_tolerance_percentage: typing.Optional[jsii.Number] = None,
@@ -12811,6 +13301,7 @@ def _typecheckingstub__c0df3ee447df61616e40150270a600545e86dd4118230e7dc4127cf7e
     external_entity_link: typing.Optional[builtins.str] = None,
     notification_topic: typing.Optional[_ITopic_9eca4852] = None,
     notify_emails: typing.Optional[typing.Sequence[builtins.str]] = None,
+    timeout: typing.Optional[_Duration_4839e8c3] = None,
 ) -> None:
     """Type checking stubs"""
     pass