aws-cdk-lib 2.117.0__py3-none-any.whl → 2.119.0__py3-none-any.whl

aws_cdk/aws_stepfunctions_tasks/__init__.py

@@ -648,7 +648,7 @@ tasks.EmrCreateCluster(self, "SpotSpecification",
                 spot_specification=tasks.EmrCreateCluster.SpotProvisioningSpecificationProperty(
                     allocation_strategy=tasks.EmrCreateCluster.SpotAllocationStrategy.CAPACITY_OPTIMIZED,
                     timeout_action=tasks.EmrCreateCluster.SpotTimeoutAction.TERMINATE_CLUSTER,
-                    timeout_duration_minutes=60
+                    timeout=Duration.minutes(5)
                 )
             )
         )]
@@ -15697,8 +15697,8 @@ class EmrCreateCluster(
             :param instance_type_configs: The instance type configurations that define the EC2 instances in the instance fleet. Default: No instanceTpeConfigs
             :param launch_specifications: The launch specification for the instance fleet. Default: No launchSpecifications
             :param name: The friendly name of the instance fleet. Default: No name
-            :param target_on_demand_capacity: The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand instances to provision. Default: No targetOnDemandCapacity
-            :param target_spot_capacity: The target capacity of Spot units for the instance fleet, which determines how many Spot instances to provision. Default: No targetSpotCapacity
+            :param target_on_demand_capacity: The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand instances to provision. If not specified or set to 0, only Spot Instances are provisioned for the instance fleet using ``targetSpotCapacity``. At least one of ``targetSpotCapacity`` and ``targetOnDemandCapacity`` should be greater than 0. For a master instance fleet, only one of ``targetSpotCapacity`` and ``targetOnDemandCapacity`` can be specified, and its value must be 1. Default: No targetOnDemandCapacity
+            :param target_spot_capacity: The target capacity of Spot units for the instance fleet, which determines how many Spot instances to provision. If not specified or set to 0, only On-Demand Instances are provisioned for the instance fleet using ``targetOnDemandCapacity``. At least one of ``targetSpotCapacity`` and ``targetOnDemandCapacity`` should be greater than 0. For a master instance fleet, only one of ``targetSpotCapacity`` and ``targetOnDemandCapacity`` can be specified, and its value must be 1. Default: No targetSpotCapacity
 
             :see: https://docs.aws.amazon.com/emr/latest/APIReference/API_InstanceFleetConfig.html
             :exampleMetadata: fixture=_generated
@@ -15753,11 +15753,12 @@ class EmrCreateCluster(
                         ),
                         spot_specification=stepfunctions_tasks.EmrCreateCluster.SpotProvisioningSpecificationProperty(
                             timeout_action=stepfunctions_tasks.EmrCreateCluster.SpotTimeoutAction.SWITCH_TO_ON_DEMAND,
-                            timeout_duration_minutes=123,
                 
                             # the properties below are optional
                             allocation_strategy=stepfunctions_tasks.EmrCreateCluster.SpotAllocationStrategy.CAPACITY_OPTIMIZED,
-                            block_duration_minutes=123
+                            block_duration_minutes=123,
+                            timeout=cdk.Duration.minutes(30),
+                            timeout_duration_minutes=123
                         )
                     ),
                     name="name",
@@ -15834,6 +15835,12 @@ class EmrCreateCluster(
         def target_on_demand_capacity(self) -> typing.Optional[jsii.Number]:
             '''The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand instances to provision.
 
+            If not specified or set to 0, only Spot Instances are provisioned for the instance fleet using ``targetSpotCapacity``.
+
+            At least one of ``targetSpotCapacity`` and ``targetOnDemandCapacity`` should be greater than 0.
+            For a master instance fleet, only one of ``targetSpotCapacity`` and ``targetOnDemandCapacity`` can be specified, and its value
+            must be 1.
+
             :default: No targetOnDemandCapacity
             '''
             result = self._values.get("target_on_demand_capacity")
@@ -15843,6 +15850,12 @@ class EmrCreateCluster(
         def target_spot_capacity(self) -> typing.Optional[jsii.Number]:
             '''The target capacity of Spot units for the instance fleet, which determines how many Spot instances to provision.
 
+            If not specified or set to 0, only On-Demand Instances are provisioned for the instance fleet using ``targetOnDemandCapacity``.
+
+            At least one of ``targetSpotCapacity`` and ``targetOnDemandCapacity`` should be greater than 0.
+            For a master instance fleet, only one of ``targetSpotCapacity`` and ``targetOnDemandCapacity`` can be specified, and its value
+            must be 1.
+
             :default: No targetSpotCapacity
             '''
             result = self._values.get("target_spot_capacity")
@@ -15910,7 +15923,7 @@ class EmrCreateCluster(
                                 spot_specification=tasks.EmrCreateCluster.SpotProvisioningSpecificationProperty(
                                     allocation_strategy=tasks.EmrCreateCluster.SpotAllocationStrategy.CAPACITY_OPTIMIZED,
                                     timeout_action=tasks.EmrCreateCluster.SpotTimeoutAction.TERMINATE_CLUSTER,
-                                    timeout_duration_minutes=60
+                                    timeout=Duration.minutes(5)
                                 )
                             )
                         )]
@@ -16269,7 +16282,7 @@ class EmrCreateCluster(
                             spot_specification=tasks.EmrCreateCluster.SpotProvisioningSpecificationProperty(
                                 allocation_strategy=tasks.EmrCreateCluster.SpotAllocationStrategy.CAPACITY_OPTIMIZED,
                                 timeout_action=tasks.EmrCreateCluster.SpotTimeoutAction.TERMINATE_CLUSTER,
-                                timeout_duration_minutes=60
+                                timeout=Duration.minutes(5)
                             )
                         )
                     )]
@@ -16312,8 +16325,8 @@ class EmrCreateCluster(
             '''An instance type configuration for each instance type in an instance fleet, which determines the EC2 instances Amazon EMR attempts to provision to fulfill On-Demand and Spot target capacities.
 
             :param instance_type: An EC2 instance type.
-            :param bid_price: The bid price for each EC2 Spot instance type as defined by InstanceType. Expressed in USD. Default: - None
-            :param bid_price_as_percentage_of_on_demand_price: The bid price, as a percentage of On-Demand price. Default: - None
+            :param bid_price: The bid price for each EC2 Spot instance type as defined by InstanceType. Expressed in USD. Cannot specify both ``bidPrice`` and ``bidPriceAsPercentageOfOnDemandPrice``. Default: - None
+            :param bid_price_as_percentage_of_on_demand_price: The bid price, as a percentage of On-Demand price. Cannot specify both ``bidPrice`` and ``bidPriceAsPercentageOfOnDemandPrice``. Default: - None
             :param configurations: A configuration classification that applies when provisioning cluster instances, which can include configurations for applications and software that run on the cluster. Default: - None
             :param ebs_configuration: The configuration of Amazon Elastic Block Storage (EBS) attached to each instance as defined by InstanceType. Default: - None
             :param weighted_capacity: The number of units that a provisioned instance of this type provides toward fulfilling the target capacities defined in the InstanceFleetConfig. Default: - None
@@ -16395,9 +16408,9 @@ class EmrCreateCluster(
 
         @builtins.property
         def bid_price(self) -> typing.Optional[builtins.str]:
-            '''The bid price for each EC2 Spot instance type as defined by InstanceType.
+            '''The bid price for each EC2 Spot instance type as defined by InstanceType. Expressed in USD.
 
-            Expressed in USD.
+            Cannot specify both ``bidPrice`` and ``bidPriceAsPercentageOfOnDemandPrice``.
 
             :default: - None
             '''
@@ -16410,6 +16423,8 @@ class EmrCreateCluster(
         ) -> typing.Optional[jsii.Number]:
             '''The bid price, as a percentage of On-Demand price.
 
+            Cannot specify both ``bidPrice`` and ``bidPriceAsPercentageOfOnDemandPrice``.
+
             :default: - None
             '''
             result = self._values.get("bid_price_as_percentage_of_on_demand_price")
@@ -17015,7 +17030,7 @@ class EmrCreateCluster(
                             spot_specification=tasks.EmrCreateCluster.SpotProvisioningSpecificationProperty(
                                 allocation_strategy=tasks.EmrCreateCluster.SpotAllocationStrategy.CAPACITY_OPTIMIZED,
                                 timeout_action=tasks.EmrCreateCluster.SpotTimeoutAction.TERMINATE_CLUSTER,
-                                timeout_duration_minutes=60
+                                timeout=Duration.minutes(5)
                             )
                         )
                     )]
@@ -17071,7 +17086,7 @@ class EmrCreateCluster(
                                 spot_specification=tasks.EmrCreateCluster.SpotProvisioningSpecificationProperty(
                                     allocation_strategy=tasks.EmrCreateCluster.SpotAllocationStrategy.CAPACITY_OPTIMIZED,
                                     timeout_action=tasks.EmrCreateCluster.SpotTimeoutAction.TERMINATE_CLUSTER,
-                                    timeout_duration_minutes=60
+                                    timeout=Duration.minutes(5)
                                 )
                             )
                         )]
@@ -17782,7 +17797,7 @@ class EmrCreateCluster(
                             spot_specification=tasks.EmrCreateCluster.SpotProvisioningSpecificationProperty(
                                 allocation_strategy=tasks.EmrCreateCluster.SpotAllocationStrategy.CAPACITY_OPTIMIZED,
                                 timeout_action=tasks.EmrCreateCluster.SpotTimeoutAction.TERMINATE_CLUSTER,
-                                timeout_duration_minutes=60
+                                timeout=Duration.minutes(5)
                             )
                         )
                     )]
@@ -17794,15 +17809,25 @@ class EmrCreateCluster(
 
         CAPACITY_OPTIMIZED = "CAPACITY_OPTIMIZED"
         '''Capacity-optimized, which launches instances from Spot Instance pools with optimal capacity for the number of instances that are launching.'''
+        PRICE_CAPACITY_OPTIMIZED = "PRICE_CAPACITY_OPTIMIZED"
+        '''Price-capacity-optimized, which launches instances from Spot Instance pools with the highest capacity availability for the number of instances that are launching.
+
+        Recommended.
+        '''
+        LOWEST_PRICE = "LOWEST_PRICE"
+        '''Lowest-price, which launches instances from the lowest priced pool that has available capacity.'''
+        DIVERSIFIED = "DIVERSIFIED"
+        '''Diversified, which launches instances across all Spot capacity pools.'''
 
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_stepfunctions_tasks.EmrCreateCluster.SpotProvisioningSpecificationProperty",
         jsii_struct_bases=[],
         name_mapping={
             "timeout_action": "timeoutAction",
-            "timeout_duration_minutes": "timeoutDurationMinutes",
             "allocation_strategy": "allocationStrategy",
             "block_duration_minutes": "blockDurationMinutes",
+            "timeout": "timeout",
+            "timeout_duration_minutes": "timeoutDurationMinutes",
         },
     )
     class SpotProvisioningSpecificationProperty:
@@ -17810,16 +17835,18 @@ class EmrCreateCluster(
             self,
             *,
             timeout_action: "EmrCreateCluster.SpotTimeoutAction",
-            timeout_duration_minutes: jsii.Number,
             allocation_strategy: typing.Optional["EmrCreateCluster.SpotAllocationStrategy"] = None,
             block_duration_minutes: typing.Optional[jsii.Number] = None,
+            timeout: typing.Optional[_Duration_4839e8c3] = None,
+            timeout_duration_minutes: typing.Optional[jsii.Number] = None,
         ) -> None:
             '''The launch specification for Spot instances in the instance fleet, which determines the defined duration and provisioning timeout behavior.
 
             :param timeout_action: The action to take when TargetSpotCapacity has not been fulfilled when the TimeoutDurationMinutes has expired.
-            :param timeout_duration_minutes: The spot provisioning timeout period in minutes.
             :param allocation_strategy: Specifies the strategy to use in launching Spot Instance fleets. Default: - No allocation strategy, i.e. spot instance type will be chosen based on current price only
             :param block_duration_minutes: (deprecated) The defined duration for Spot instances (also known as Spot blocks) in minutes. Default: - No blockDurationMinutes
+            :param timeout: The spot provisioning timeout period in minutes. The value must be between 5 and 1440 minutes. You must specify one of ``timeout`` and ``timeoutDurationMinutes``. Default: - The value in ``timeoutDurationMinutes`` is used
+            :param timeout_duration_minutes: (deprecated) The spot provisioning timeout period in minutes. The value must be between 5 and 1440 minutes. You must specify one of ``timeout`` and ``timeoutDurationMinutes``. Default: - The value in ``timeout`` is used
 
             :see: https://docs.aws.amazon.com/emr/latest/APIReference/API_SpotProvisioningSpecification.html
             :exampleMetadata: infused
@@ -17849,7 +17876,7 @@ class EmrCreateCluster(
                                 spot_specification=tasks.EmrCreateCluster.SpotProvisioningSpecificationProperty(
                                     allocation_strategy=tasks.EmrCreateCluster.SpotAllocationStrategy.CAPACITY_OPTIMIZED,
                                     timeout_action=tasks.EmrCreateCluster.SpotTimeoutAction.TERMINATE_CLUSTER,
-                                    timeout_duration_minutes=60
+                                    timeout=Duration.minutes(5)
                                 )
                             )
                         )]
@@ -17861,17 +17888,21 @@ class EmrCreateCluster(
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__dafa3d17787fdab36cd1f4f58ea87a372f8918f012ead69328993cd9b112eef0)
                 check_type(argname="argument timeout_action", value=timeout_action, expected_type=type_hints["timeout_action"])
-                check_type(argname="argument timeout_duration_minutes", value=timeout_duration_minutes, expected_type=type_hints["timeout_duration_minutes"])
                 check_type(argname="argument allocation_strategy", value=allocation_strategy, expected_type=type_hints["allocation_strategy"])
                 check_type(argname="argument block_duration_minutes", value=block_duration_minutes, expected_type=type_hints["block_duration_minutes"])
+                check_type(argname="argument timeout", value=timeout, expected_type=type_hints["timeout"])
+                check_type(argname="argument timeout_duration_minutes", value=timeout_duration_minutes, expected_type=type_hints["timeout_duration_minutes"])
             self._values: typing.Dict[builtins.str, typing.Any] = {
                 "timeout_action": timeout_action,
-                "timeout_duration_minutes": timeout_duration_minutes,
             }
             if allocation_strategy is not None:
                 self._values["allocation_strategy"] = allocation_strategy
             if block_duration_minutes is not None:
                 self._values["block_duration_minutes"] = block_duration_minutes
+            if timeout is not None:
+                self._values["timeout"] = timeout
+            if timeout_duration_minutes is not None:
+                self._values["timeout_duration_minutes"] = timeout_duration_minutes
 
         @builtins.property
         def timeout_action(self) -> "EmrCreateCluster.SpotTimeoutAction":
@@ -17880,13 +17911,6 @@ class EmrCreateCluster(
             assert result is not None, "Required property 'timeout_action' is missing"
             return typing.cast("EmrCreateCluster.SpotTimeoutAction", result)
 
-        @builtins.property
-        def timeout_duration_minutes(self) -> jsii.Number:
-            '''The spot provisioning timeout period in minutes.'''
-            result = self._values.get("timeout_duration_minutes")
-            assert result is not None, "Required property 'timeout_duration_minutes' is missing"
-            return typing.cast(jsii.Number, result)
-
         @builtins.property
         def allocation_strategy(
             self,
@@ -17914,6 +17938,36 @@ class EmrCreateCluster(
             result = self._values.get("block_duration_minutes")
             return typing.cast(typing.Optional[jsii.Number], result)
 
+        @builtins.property
+        def timeout(self) -> typing.Optional[_Duration_4839e8c3]:
+            '''The spot provisioning timeout period in minutes.
+
+            The value must be between 5 and 1440 minutes.
+
+            You must specify one of ``timeout`` and ``timeoutDurationMinutes``.
+
+            :default: - The value in ``timeoutDurationMinutes`` is used
+            '''
+            result = self._values.get("timeout")
+            return typing.cast(typing.Optional[_Duration_4839e8c3], result)
+
+        @builtins.property
+        def timeout_duration_minutes(self) -> typing.Optional[jsii.Number]:
+            '''(deprecated) The spot provisioning timeout period in minutes.
+
+            The value must be between 5 and 1440 minutes.
+
+            You must specify one of ``timeout`` and ``timeoutDurationMinutes``.
+
+            :default: - The value in ``timeout`` is used
+
+            :deprecated: - Use ``timeout``.
+
+            :stability: deprecated
+            '''
+            result = self._values.get("timeout_duration_minutes")
+            return typing.cast(typing.Optional[jsii.Number], result)
+
         def __eq__(self, rhs: typing.Any) -> builtins.bool:
             return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -17958,7 +18012,7 @@ class EmrCreateCluster(
                             spot_specification=tasks.EmrCreateCluster.SpotProvisioningSpecificationProperty(
                                 allocation_strategy=tasks.EmrCreateCluster.SpotAllocationStrategy.CAPACITY_OPTIMIZED,
                                 timeout_action=tasks.EmrCreateCluster.SpotTimeoutAction.TERMINATE_CLUSTER,
-                                timeout_duration_minutes=60
+                                timeout=Duration.minutes(5)
                             )
                         )
                     )]
@@ -32784,9 +32838,10 @@ def _typecheckingstub__cdaa7a075b4efdc50702fd6877f9b79e13b0eb9f1d360c4243fbf89fd
 def _typecheckingstub__dafa3d17787fdab36cd1f4f58ea87a372f8918f012ead69328993cd9b112eef0(
     *,
     timeout_action: EmrCreateCluster.SpotTimeoutAction,
-    timeout_duration_minutes: jsii.Number,
     allocation_strategy: typing.Optional[EmrCreateCluster.SpotAllocationStrategy] = None,
     block_duration_minutes: typing.Optional[jsii.Number] = None,
+    timeout: typing.Optional[_Duration_4839e8c3] = None,
+    timeout_duration_minutes: typing.Optional[jsii.Number] = None,
 ) -> None:
     """Type checking stubs"""
     pass

aws_cdk/pipelines/__init__.py

@@ -26,7 +26,8 @@ down to using the `aws-codepipeline` construct library directly.
 > allows more control of CodeBuild project generation; supports deployment
 > engines other than CodePipeline.
 >
-> The README for the original API, as well as a migration guide, can be found in [our GitHub repository](https://github.com/aws/aws-cdk/blob/main/packages/@aws-cdk/pipelines/ORIGINAL_API.md).
+> The README for the original API, as well as a migration guide, can be found in
+> [our GitHub repository](https://github.com/aws/aws-cdk/blob/main/packages/@aws-cdk/pipelines/ORIGINAL_API.md).
 
 ## At a glance
 
@@ -1176,6 +1177,53 @@ and orphan the old bucket. You should manually delete the orphaned bucket
 after you are sure you have redeployed all CDK applications and there are no
 more references to the old asset bucket.
 
+## Considerations around Running at Scale
+
+If you are planning to run pipelines for more than a hundred repos
+deploying across multiple regions, then you will want to consider reusing
+both artifacts buckets and cross-region replication buckets.
+
+In a situation like this, you will want to have a separate CDK app / dedicated repo which creates
+and managed the buckets which will be shared by the pipelines of all your other apps.
+Note that this app must NOT be using the shared buckets because of chicken & egg issues.
+
+The following code assumes you have created and are managing your buckets in the aforementioned
+separate cdk repo and are just importing them for use in one of your (many) pipelines.
+
+```python
+# shared_xRegion_us_west1_bucket_arn: str
+# shared_xRegion_us_west1_key_arn: str
+
+# shared_xRegion_us_west2_bucket_arn: str
+# shared_xRegion_us_west2_key_arn: str
+
+
+us_west1_bucket = s3.Bucket.from_bucket_attributes(scope, "UsEast1Bucket",
+    bucket_arn=shared_xRegion_us_west1_bucket_arn,
+    encryption_key=kms.Key.from_key_arn(scope, "UsEast1BucketKeyArn", shared_xRegion_us_west1_bucket_arn)
+)
+
+us_west2_bucket = s3.Bucket.from_bucket_attributes(scope, "UsWest2Bucket",
+    bucket_arn=shared_xRegion_us_west2_bucket_arn,
+    encryption_key=kms.Key.from_key_arn(scope, "UsWest2BucketKeyArn", shared_xRegion_us_west2_key_arn)
+)
+
+cross_region_replication_buckets = {
+    "us-west-1": us_west1_bucket,
+    "us-west-2": us_west2_bucket
+}
+
+pipeline = pipelines.CodePipeline(self, "Pipeline",
+    synth=pipelines.ShellStep("Synth",
+        input=pipelines.CodePipelineSource.connection("my-org/my-app", "main",
+            connection_arn="arn:aws:codestar-connections:us-east-1:222222222222:connection/7d2469ff-514a-4e4f-9003-5ca4a43cdc41"
+        ),
+        commands=["npm ci", "npm run build", "npx cdk synth"]
+    ),  # Use shared buckets.
+    cross_region_replication_buckets=cross_region_replication_buckets
+)
+```
+
 ## Context Lookups
 
 You might be using CDK constructs that need to look up [runtime
@@ -2351,6 +2399,7 @@ class CodePipelineActionFactoryResult:
         "code_build_defaults": "codeBuildDefaults",
         "code_pipeline": "codePipeline",
         "cross_account_keys": "crossAccountKeys",
+        "cross_region_replication_buckets": "crossRegionReplicationBuckets",
         "docker_credentials": "dockerCredentials",
         "docker_enabled_for_self_mutation": "dockerEnabledForSelfMutation",
         "docker_enabled_for_synth": "dockerEnabledForSynth",
@@ -2376,6 +2425,7 @@ class CodePipelineProps:
         code_build_defaults: typing.Optional[typing.Union[CodeBuildOptions, typing.Dict[builtins.str, typing.Any]]] = None,
         code_pipeline: typing.Optional[_Pipeline_ea38de84] = None,
         cross_account_keys: typing.Optional[builtins.bool] = None,
+        cross_region_replication_buckets: typing.Optional[typing.Mapping[builtins.str, _IBucket_42e086fd]] = None,
         docker_credentials: typing.Optional[typing.Sequence["DockerCredential"]] = None,
         docker_enabled_for_self_mutation: typing.Optional[builtins.bool] = None,
         docker_enabled_for_synth: typing.Optional[builtins.bool] = None,
@@ -2398,6 +2448,7 @@ class CodePipelineProps:
         :param code_build_defaults: Customize the CodeBuild projects created for this pipeline. Default: - All projects run non-privileged build, SMALL instance, LinuxBuildImage.STANDARD_7_0
         :param code_pipeline: An existing Pipeline to be reused and built upon. [disable-awslint:ref-via-interface] Default: - a new underlying pipeline is created.
         :param cross_account_keys: Create KMS keys for the artifact buckets, allowing cross-account deployments. The artifact buckets have to be encrypted to support deploying CDK apps to another account, so if you want to do that or want to have your artifact buckets encrypted, be sure to set this value to ``true``. Be aware there is a cost associated with maintaining the KMS keys. Default: false
+        :param cross_region_replication_buckets: A map of region to S3 bucket name used for cross-region CodePipeline. For every Action that you specify targeting a different region than the Pipeline itself, if you don't provide an explicit Bucket for that region using this property, the construct will automatically create a Stack containing an S3 Bucket in that region. Passed directly through to the {@link cp.Pipeline}. Default: - no cross region replication buckets.
         :param docker_credentials: A list of credentials used to authenticate to Docker registries. Specify any credentials necessary within the pipeline to build, synth, update, or publish assets. Default: []
         :param docker_enabled_for_self_mutation: Enable Docker for the self-mutate step. Set this to true if the pipeline itself uses Docker container assets (for example, if you use ``LinuxBuildImage.fromAsset()`` as the build image of a CodeBuild step in the pipeline). You do not need to set it if you build Docker image assets in the application Stages and Stacks that are *deployed* by this pipeline. Configures privileged mode for the self-mutation CodeBuild action. If you are about to turn this on in an already-deployed Pipeline, set the value to ``true`` first, commit and allow the pipeline to self-update, and only then use the Docker asset in the pipeline. Default: false
         :param docker_enabled_for_synth: Enable Docker for the 'synth' step. Set this to true if you are using file assets that require "bundling" anywhere in your application (meaning an asset compilation step will be run with the tools provided by a Docker image), both for the Pipeline stack as well as the application stacks. A common way to use bundling assets in your application is by using the ``aws-cdk-lib/aws-lambda-nodejs`` library. Configures privileged mode for the synth CodeBuild action. If you are about to turn this on in an already-deployed Pipeline, set the value to ``true`` first, commit and allow the pipeline to self-update, and only then use the bundled asset. Default: false
@@ -2415,18 +2466,24 @@ class CodePipelineProps:
 
         Example::
 
-            # code_pipeline: codepipeline.Pipeline
-            
-            
-            source_artifact = codepipeline.Artifact("MySourceArtifact")
-            
-            pipeline = pipelines.CodePipeline(self, "Pipeline",
-                code_pipeline=code_pipeline,
+            # Modern API
+            modern_pipeline = pipelines.CodePipeline(self, "Pipeline",
+                self_mutation=False,
                 synth=pipelines.ShellStep("Synth",
-                    input=pipelines.CodePipelineFileSet.from_artifact(source_artifact),
-                    commands=["npm ci", "npm run build", "npx cdk synth"]
+                    input=pipelines.CodePipelineSource.connection("my-org/my-app", "main",
+                        connection_arn="arn:aws:codestar-connections:us-east-1:222222222222:connection/7d2469ff-514a-4e4f-9003-5ca4a43cdc41"
+                    ),
+                    commands=["npm ci", "npm run build", "npx cdk synth"
+                    ]
                 )
             )
+            
+            # Original API
+            cloud_assembly_artifact = codepipeline.Artifact()
+            original_pipeline = pipelines.CdkPipeline(self, "Pipeline",
+                self_mutating=False,
+                cloud_assembly_artifact=cloud_assembly_artifact
+            )
         '''
         if isinstance(asset_publishing_code_build_defaults, dict):
             asset_publishing_code_build_defaults = CodeBuildOptions(**asset_publishing_code_build_defaults)
@@ -2445,6 +2502,7 @@ class CodePipelineProps:
             check_type(argname="argument code_build_defaults", value=code_build_defaults, expected_type=type_hints["code_build_defaults"])
             check_type(argname="argument code_pipeline", value=code_pipeline, expected_type=type_hints["code_pipeline"])
             check_type(argname="argument cross_account_keys", value=cross_account_keys, expected_type=type_hints["cross_account_keys"])
+            check_type(argname="argument cross_region_replication_buckets", value=cross_region_replication_buckets, expected_type=type_hints["cross_region_replication_buckets"])
             check_type(argname="argument docker_credentials", value=docker_credentials, expected_type=type_hints["docker_credentials"])
             check_type(argname="argument docker_enabled_for_self_mutation", value=docker_enabled_for_self_mutation, expected_type=type_hints["docker_enabled_for_self_mutation"])
             check_type(argname="argument docker_enabled_for_synth", value=docker_enabled_for_synth, expected_type=type_hints["docker_enabled_for_synth"])
@@ -2472,6 +2530,8 @@ class CodePipelineProps:
             self._values["code_pipeline"] = code_pipeline
         if cross_account_keys is not None:
             self._values["cross_account_keys"] = cross_account_keys
+        if cross_region_replication_buckets is not None:
+            self._values["cross_region_replication_buckets"] = cross_region_replication_buckets
         if docker_credentials is not None:
             self._values["docker_credentials"] = docker_credentials
         if docker_enabled_for_self_mutation is not None:
@@ -2589,6 +2649,22 @@ class CodePipelineProps:
         result = self._values.get("cross_account_keys")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def cross_region_replication_buckets(
+        self,
+    ) -> typing.Optional[typing.Mapping[builtins.str, _IBucket_42e086fd]]:
+        '''A map of region to S3 bucket name used for cross-region CodePipeline.
+
+        For every Action that you specify targeting a different region than the Pipeline itself,
+        if you don't provide an explicit Bucket for that region using this property,
+        the construct will automatically create a Stack containing an S3 Bucket in that region.
+        Passed directly through to the {@link cp.Pipeline}.
+
+        :default: - no cross region replication buckets.
+        '''
+        result = self._values.get("cross_region_replication_buckets")
+        return typing.cast(typing.Optional[typing.Mapping[builtins.str, _IBucket_42e086fd]], result)
+
     @builtins.property
     def docker_credentials(self) -> typing.Optional[typing.List["DockerCredential"]]:
         '''A list of credentials used to authenticate to Docker registries.
@@ -4403,18 +4479,24 @@ class ShellStepProps:
 
         Example::
 
-            # code_pipeline: codepipeline.Pipeline
-            
-            
-            source_artifact = codepipeline.Artifact("MySourceArtifact")
-            
-            pipeline = pipelines.CodePipeline(self, "Pipeline",
-                code_pipeline=code_pipeline,
+            # Modern API
+            modern_pipeline = pipelines.CodePipeline(self, "Pipeline",
+                self_mutation=False,
                 synth=pipelines.ShellStep("Synth",
-                    input=pipelines.CodePipelineFileSet.from_artifact(source_artifact),
-                    commands=["npm ci", "npm run build", "npx cdk synth"]
+                    input=pipelines.CodePipelineSource.connection("my-org/my-app", "main",
+                        connection_arn="arn:aws:codestar-connections:us-east-1:222222222222:connection/7d2469ff-514a-4e4f-9003-5ca4a43cdc41"
+                    ),
+                    commands=["npm ci", "npm run build", "npx cdk synth"
+                    ]
                 )
             )
+            
+            # Original API
+            cloud_assembly_artifact = codepipeline.Artifact()
+            original_pipeline = pipelines.CdkPipeline(self, "Pipeline",
+                self_mutating=False,
+                cloud_assembly_artifact=cloud_assembly_artifact
+            )
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__672600085b4c1f54d7e497f605a0be2945f1a2759aaf8632197707da6d73a55c)
@@ -6448,18 +6530,24 @@ class CodePipeline(
 
     Example::
 
-        # code_pipeline: codepipeline.Pipeline
-        
-        
-        source_artifact = codepipeline.Artifact("MySourceArtifact")
-        
-        pipeline = pipelines.CodePipeline(self, "Pipeline",
-            code_pipeline=code_pipeline,
+        # Modern API
+        modern_pipeline = pipelines.CodePipeline(self, "Pipeline",
+            self_mutation=False,
             synth=pipelines.ShellStep("Synth",
-                input=pipelines.CodePipelineFileSet.from_artifact(source_artifact),
-                commands=["npm ci", "npm run build", "npx cdk synth"]
+                input=pipelines.CodePipelineSource.connection("my-org/my-app", "main",
+                    connection_arn="arn:aws:codestar-connections:us-east-1:222222222222:connection/7d2469ff-514a-4e4f-9003-5ca4a43cdc41"
+                ),
+                commands=["npm ci", "npm run build", "npx cdk synth"
+                ]
             )
         )
+        
+        # Original API
+        cloud_assembly_artifact = codepipeline.Artifact()
+        original_pipeline = pipelines.CdkPipeline(self, "Pipeline",
+            self_mutating=False,
+            cloud_assembly_artifact=cloud_assembly_artifact
+        )
     '''
 
     def __init__(
@@ -6474,6 +6562,7 @@ class CodePipeline(
         code_build_defaults: typing.Optional[typing.Union[CodeBuildOptions, typing.Dict[builtins.str, typing.Any]]] = None,
         code_pipeline: typing.Optional[_Pipeline_ea38de84] = None,
         cross_account_keys: typing.Optional[builtins.bool] = None,
+        cross_region_replication_buckets: typing.Optional[typing.Mapping[builtins.str, _IBucket_42e086fd]] = None,
         docker_credentials: typing.Optional[typing.Sequence[DockerCredential]] = None,
         docker_enabled_for_self_mutation: typing.Optional[builtins.bool] = None,
         docker_enabled_for_synth: typing.Optional[builtins.bool] = None,
@@ -6497,6 +6586,7 @@ class CodePipeline(
         :param code_build_defaults: Customize the CodeBuild projects created for this pipeline. Default: - All projects run non-privileged build, SMALL instance, LinuxBuildImage.STANDARD_7_0
         :param code_pipeline: An existing Pipeline to be reused and built upon. [disable-awslint:ref-via-interface] Default: - a new underlying pipeline is created.
         :param cross_account_keys: Create KMS keys for the artifact buckets, allowing cross-account deployments. The artifact buckets have to be encrypted to support deploying CDK apps to another account, so if you want to do that or want to have your artifact buckets encrypted, be sure to set this value to ``true``. Be aware there is a cost associated with maintaining the KMS keys. Default: false
+        :param cross_region_replication_buckets: A map of region to S3 bucket name used for cross-region CodePipeline. For every Action that you specify targeting a different region than the Pipeline itself, if you don't provide an explicit Bucket for that region using this property, the construct will automatically create a Stack containing an S3 Bucket in that region. Passed directly through to the {@link cp.Pipeline}. Default: - no cross region replication buckets.
         :param docker_credentials: A list of credentials used to authenticate to Docker registries. Specify any credentials necessary within the pipeline to build, synth, update, or publish assets. Default: []
         :param docker_enabled_for_self_mutation: Enable Docker for the self-mutate step. Set this to true if the pipeline itself uses Docker container assets (for example, if you use ``LinuxBuildImage.fromAsset()`` as the build image of a CodeBuild step in the pipeline). You do not need to set it if you build Docker image assets in the application Stages and Stacks that are *deployed* by this pipeline. Configures privileged mode for the self-mutation CodeBuild action. If you are about to turn this on in an already-deployed Pipeline, set the value to ``true`` first, commit and allow the pipeline to self-update, and only then use the Docker asset in the pipeline. Default: false
         :param docker_enabled_for_synth: Enable Docker for the 'synth' step. Set this to true if you are using file assets that require "bundling" anywhere in your application (meaning an asset compilation step will be run with the tools provided by a Docker image), both for the Pipeline stack as well as the application stacks. A common way to use bundling assets in your application is by using the ``aws-cdk-lib/aws-lambda-nodejs`` library. Configures privileged mode for the synth CodeBuild action. If you are about to turn this on in an already-deployed Pipeline, set the value to ``true`` first, commit and allow the pipeline to self-update, and only then use the bundled asset. Default: false
@@ -6522,6 +6612,7 @@ class CodePipeline(
             code_build_defaults=code_build_defaults,
             code_pipeline=code_pipeline,
             cross_account_keys=cross_account_keys,
+            cross_region_replication_buckets=cross_region_replication_buckets,
             docker_credentials=docker_credentials,
             docker_enabled_for_self_mutation=docker_enabled_for_self_mutation,
             docker_enabled_for_synth=docker_enabled_for_synth,
@@ -7236,18 +7327,24 @@ class ShellStep(
 
     Example::
 
-        # code_pipeline: codepipeline.Pipeline
-        
-        
-        source_artifact = codepipeline.Artifact("MySourceArtifact")
-        
-        pipeline = pipelines.CodePipeline(self, "Pipeline",
-            code_pipeline=code_pipeline,
+        # Modern API
+        modern_pipeline = pipelines.CodePipeline(self, "Pipeline",
+            self_mutation=False,
             synth=pipelines.ShellStep("Synth",
-                input=pipelines.CodePipelineFileSet.from_artifact(source_artifact),
-                commands=["npm ci", "npm run build", "npx cdk synth"]
+                input=pipelines.CodePipelineSource.connection("my-org/my-app", "main",
+                    connection_arn="arn:aws:codestar-connections:us-east-1:222222222222:connection/7d2469ff-514a-4e4f-9003-5ca4a43cdc41"
+                ),
+                commands=["npm ci", "npm run build", "npx cdk synth"
+                ]
             )
         )
+        
+        # Original API
+        cloud_assembly_artifact = codepipeline.Artifact()
+        original_pipeline = pipelines.CdkPipeline(self, "Pipeline",
+            self_mutating=False,
+            cloud_assembly_artifact=cloud_assembly_artifact
+        )
     '''
 
     def __init__(
@@ -7837,6 +7934,7 @@ def _typecheckingstub__c46bc21ca63efb27c935c31017ebbc8c85b3b93ae1798e54892dd3eae
     code_build_defaults: typing.Optional[typing.Union[CodeBuildOptions, typing.Dict[builtins.str, typing.Any]]] = None,
     code_pipeline: typing.Optional[_Pipeline_ea38de84] = None,
     cross_account_keys: typing.Optional[builtins.bool] = None,
+    cross_region_replication_buckets: typing.Optional[typing.Mapping[builtins.str, _IBucket_42e086fd]] = None,
     docker_credentials: typing.Optional[typing.Sequence[DockerCredential]] = None,
     docker_enabled_for_self_mutation: typing.Optional[builtins.bool] = None,
     docker_enabled_for_synth: typing.Optional[builtins.bool] = None,
@@ -8298,6 +8396,7 @@ def _typecheckingstub__7b4b4a0bcbd5fab3e4b78aa07ff9504469ae96c16799604ca3345bcb9
     code_build_defaults: typing.Optional[typing.Union[CodeBuildOptions, typing.Dict[builtins.str, typing.Any]]] = None,
     code_pipeline: typing.Optional[_Pipeline_ea38de84] = None,
     cross_account_keys: typing.Optional[builtins.bool] = None,
+    cross_region_replication_buckets: typing.Optional[typing.Mapping[builtins.str, _IBucket_42e086fd]] = None,
     docker_credentials: typing.Optional[typing.Sequence[DockerCredential]] = None,
     docker_enabled_for_self_mutation: typing.Optional[builtins.bool] = None,
     docker_enabled_for_synth: typing.Optional[builtins.bool] = None,

{aws_cdk_lib-2.117.0.dist-info → aws_cdk_lib-2.119.0.dist-info}/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+   Copyright 2018-2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.