aws-cdk-lib 2.153.0__py3-none-any.whl → 2.154.0__py3-none-any.whl

aws_cdk/pipelines/__init__.py

@@ -46,7 +46,7 @@ details.
 CDK Pipelines supports multiple *deployment engines* (see
 [Using a different deployment engine](#using-a-different-deployment-engine)),
 and comes with a deployment engine that deploys CDK apps using AWS CodePipeline.
-To use the CodePipeline engine, define a `CodePipeline` construct.  The following
+To use the CodePipeline engine, define a `CodePipeline` construct. The following
 example creates a CodePipeline that deploys an application from GitHub:
 
 ```python
@@ -81,20 +81,20 @@ class MyPipelineStack(Stack):
                 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"
-                ]
+                commands=["npm ci", "npm run build", "npx cdk synth"]
             )
         )
 
         # 'MyApplication' is defined below. Call `addStage` as many times as
         # necessary with any account and region (may be different from the
         # pipeline's).
-        pipeline.add_stage(MyApplication(self, "Prod",
-            env=cdk.Environment(
-                account="123456789012",
-                region="eu-west-1"
-            )
-        ))
+        pipeline.add_stage(
+            MyApplication(self, "Prod",
+                env=cdk.Environment(
+                    account="123456789012",
+                    region="eu-west-1"
+                )
+            ))
 
 #
 # Your application
@@ -167,24 +167,15 @@ To make the development more convenient, the self-mutation feature can be turned
 off temporarily, by passing `selfMutation: false` property, example:
 
 ```python
-# Modern API
-modern_pipeline = pipelines.CodePipeline(self, "Pipeline",
+pipeline = pipelines.CodePipeline(self, "Pipeline",
     self_mutation=False,
     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"
-        ]
+        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
-)
 ```
 
 ## Defining the pipeline
@@ -214,8 +205,7 @@ typical NPM-based project, the synth will look like this:
 pipeline = pipelines.CodePipeline(self, "Pipeline",
     synth=pipelines.ShellStep("Synth",
         input=source,
-        commands=["npm ci", "npm run build", "npx cdk synth"
-        ]
+        commands=["npm ci", "npm run build", "npx cdk synth"]
     )
 )
 ```
@@ -232,8 +222,7 @@ CDK project lives in a subdirectory, be sure to adjust the
 pipeline = pipelines.CodePipeline(self, "Pipeline",
     synth=pipelines.ShellStep("Synth",
         input=source,
-        commands=["cd mysubdir", "npm ci", "npm run build", "npx cdk synth"
-        ],
+        commands=["cd mysubdir", "npm ci", "npm run build", "npx cdk synth"],
         primary_output_directory="mysubdir/cdk.out"
     )
 )
@@ -261,8 +250,7 @@ For Yarn, the install commands are different:
 pipeline = pipelines.CodePipeline(self, "Pipeline",
     synth=pipelines.ShellStep("Synth",
         input=source,
-        commands=["yarn install --frozen-lockfile", "yarn build", "npx cdk synth"
-        ]
+        commands=["yarn install --frozen-lockfile", "yarn build", "npx cdk synth"]
     )
 )
 ```
@@ -295,8 +283,7 @@ as you run `cdk synth`:
 pipeline = pipelines.CodePipeline(self, "Pipeline",
     synth=pipelines.ShellStep("Synth",
         input=source,
-        commands=["npm install -g aws-cdk", "cdk synth"
-        ]
+        commands=["npm install -g aws-cdk", "cdk synth"]
     )
 )
 ```
@@ -438,12 +425,13 @@ so, call `pipeline.addStage()` on the Stage object:
 
 # Do this as many times as necessary with any account and region
 # Account and region may different from the pipeline's.
-pipeline.add_stage(MyApplicationStage(self, "Prod",
-    env=cdk.Environment(
-        account="123456789012",
-        region="eu-west-1"
-    )
-))
+pipeline.add_stage(
+    MyApplicationStage(self, "Prod",
+        env=cdk.Environment(
+            account="123456789012",
+            region="eu-west-1"
+        )
+    ))
 ```
 
 CDK Pipelines will automatically discover all `Stacks` in the given `Stage`
@@ -471,12 +459,14 @@ application to `eu-west-1` and `eu-central-1` in parallel:
 # pipeline: pipelines.CodePipeline
 
 europe_wave = pipeline.add_wave("Europe")
-europe_wave.add_stage(MyApplicationStage(self, "Ireland",
-    env=cdk.Environment(region="eu-west-1")
-))
-europe_wave.add_stage(MyApplicationStage(self, "Germany",
-    env=cdk.Environment(region="eu-central-1")
-))
+europe_wave.add_stage(
+    MyApplicationStage(self, "Ireland",
+        env=cdk.Environment(region="eu-west-1")
+    ))
+europe_wave.add_stage(
+    MyApplicationStage(self, "Germany",
+        env=cdk.Environment(region="eu-central-1")
+    ))
 ```
 
 #### Deploying to other accounts / encrypting the Artifact Bucket
@@ -504,8 +494,7 @@ pipeline = pipelines.CodePipeline(self, "Pipeline",
         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"
-        ]
+        commands=["npm ci", "npm run build", "npx cdk synth"]
     )
 )
 ```
@@ -561,9 +550,7 @@ pipeline.add_stage(preprod,
     ]
 )
 pipeline.add_stage(prod,
-    pre=[
-        pipelines.ManualApprovalStep("PromoteToProd")
-    ]
+    pre=[pipelines.ManualApprovalStep("PromoteToProd")]
 )
 ```
 
@@ -588,7 +575,8 @@ pipeline.add_stage(prod,
     ), pipelines.StackSteps(
         stack=prod.stack2,
         post=[pipelines.ManualApprovalStep("Post-Deploy Check")]
-    )]
+    )
+    ]
 )
 ```
 
@@ -628,7 +616,9 @@ class MyOutputStage(Stage):
 
     def __init__(self, scope, id, *, env=None, outdir=None, stageName=None, permissionsBoundary=None, policyValidationBeta1=None):
         super().__init__(scope, id, env=env, outdir=outdir, stageName=stageName, permissionsBoundary=permissionsBoundary, policyValidationBeta1=policyValidationBeta1)
-        self.load_balancer_address = CfnOutput(self, "Output", value="value")
+        self.load_balancer_address = CfnOutput(self, "Output",
+            value="value"
+        )
 
 lb_app = MyOutputStage(self, "MyApp")
 pipeline.add_stage(lb_app,
@@ -708,12 +698,14 @@ pipelines.CodeBuildStep("Synth",
         privileged=True
     ),
     timeout=Duration.minutes(90),
-    file_system_locations=[codebuild.FileSystemLocation.efs(
-        identifier="myidentifier2",
-        location="myclodation.mydnsroot.com:/loc",
-        mount_point="/media",
-        mount_options="opts"
-    )],
+    file_system_locations=[
+        codebuild.FileSystemLocation.efs(
+            identifier="myidentifier2",
+            location="myclodation.mydnsroot.com:/loc",
+            mount_point="/media",
+            mount_options="opts"
+        )
+    ],
 
     # Control Elastic Network Interface creation
     vpc=vpc,
@@ -747,8 +739,7 @@ pipelines.CodePipeline(self, "Pipeline",
         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"
-        ]
+        commands=["npm ci", "npm run build", "npx cdk synth"]
     ),
 
     # Defaults for all CodeBuild projects
@@ -812,22 +803,22 @@ class MyJenkinsStep(pipelines.Step):
         })
 
     def produce_action(self, stage, *, scope, actionName, runOrder, variablesNamespace=None, artifacts, fallbackArtifact=None, pipeline, codeBuildDefaults=None, beforeSelfMutation=None, stackOutputsMap):
-
         # This is where you control what type of Action gets added to the
         # CodePipeline
-        stage.add_action(cpactions.JenkinsAction(
-            # Copy 'actionName' and 'runOrder' from the options
-            action_name=action_name,
-            run_order=run_order,
+        stage.add_action(
+            cpactions.JenkinsAction(
+                # Copy 'actionName' and 'runOrder' from the options
+                action_name=action_name,
+                run_order=run_order,
 
-            # Jenkins-specific configuration
-            type=cpactions.JenkinsActionType.TEST,
-            jenkins_provider=self.provider,
-            project_name="MyJenkinsProject",
+                # Jenkins-specific configuration
+                type=cpactions.JenkinsActionType.TEST,
+                jenkins_provider=self.provider,
+                project_name="MyJenkinsProject",
 
-            # Translate the FileSet into a codepipeline.Artifact
-            inputs=[artifacts.to_code_pipeline(self.input)]
-        ))
+                # Translate the FileSet into a codepipeline.Artifact
+                inputs=[artifacts.to_code_pipeline(self.input)]
+            ))
 
         return pipelines.CodePipelineActionFactoryResult(run_orders_consumed=1)
 ```
@@ -840,17 +831,20 @@ class MyLambdaStep(pipelines.Step):
 
     def __init__(self, fn, stack_output):
         super().__init__("MyLambdaStep")
-        self.stack_output_reference = pipelines.StackOutputReference.from_cfn_output(stack_output)
+        self.stack_output_reference =
+        pipelines.StackOutputReference.from_cfn_output(stack_output)
 
     def produce_action(self, stage, *, scope, actionName, runOrder, variablesNamespace=None, artifacts, fallbackArtifact=None, pipeline, codeBuildDefaults=None, beforeSelfMutation=None, stackOutputsMap):
-
-        stage.add_action(cpactions.LambdaInvokeAction(
-            action_name=action_name,
-            run_order=run_order,
-            # Map the reference to the variable name the CDK has generated for you.
-            user_parameters={"stack_output": stack_outputs_map.to_code_pipeline(self.stack_output_reference)},
-            lambda_=self.fn
-        ))
+        stage.add_action(
+            cpactions.LambdaInvokeAction(
+                action_name=action_name,
+                run_order=run_order,
+                # Map the reference to the variable name the CDK has generated for you.
+                user_parameters={
+                    "stack_output": stack_outputs_map.to_code_pipeline(self.stack_output_reference)
+                },
+                lambda_=self.fn
+            ))
 
         return pipelines.CodePipelineActionFactoryResult(run_orders_consumed=1)public get consumedStackOutputs(): pipelines.StackOutputReference[] {
         return [this.stackOutputReference];
@@ -1031,7 +1025,9 @@ the **Synth**, **Self-Update**, and **Asset Publishing** actions within the
 ```python
 docker_hub_secret = secretsmanager.Secret.from_secret_complete_arn(self, "DHSecret", "arn:aws:...")
 # Only the image asset publishing actions will be granted read access to the secret.
-creds = pipelines.DockerCredential.docker_hub(docker_hub_secret, usages=[pipelines.DockerCredentialUsage.ASSET_PUBLISHING])
+creds = pipelines.DockerCredential.docker_hub(docker_hub_secret,
+    usages=[pipelines.DockerCredentialUsage.ASSET_PUBLISHING]
+)
 ```
 
 ## CDK Environment Bootstrapping
@@ -1133,7 +1129,7 @@ These command lines explained:
 > Be aware that anyone who has access to the trusted Accounts **effectively has all
 > permissions conferred by the configured CloudFormation execution policies**,
 > allowing them to do things like read arbitrary S3 buckets and create arbitrary
-> infrastructure in the bootstrapped account.  Restrict the list of `--trust`ed Accounts,
+> infrastructure in the bootstrapped account. Restrict the list of `--trust`ed Accounts,
 > or restrict the policies configured by `--cloudformation-execution-policies`.
 
 <br>
@@ -1244,7 +1240,7 @@ contains the results of the context lookups. This will make sure your
 synthesized infrastructure is consistent and repeatable. If you do not commit
 `cdk.context.json`, the results of the lookups may suddenly be different in
 unexpected ways, and even produce results that cannot be deployed or will cause
-data loss.  To give an account permissions to perform lookups against an
+data loss. To give an account permissions to perform lookups against an
 environment, without being able to deploy to it and make changes, run
 `cdk bootstrap --trust-for-lookup=<account>`.
 
@@ -1341,9 +1337,7 @@ You can insert the security check by using a `ConfirmPermissionsBroadening` step
 
 stage = MyApplicationStage(self, "MyApplication")
 pipeline.add_stage(stage,
-    pre=[
-        pipelines.ConfirmPermissionsBroadening("Check", stage=stage)
-    ]
+    pre=[pipelines.ConfirmPermissionsBroadening("Check", stage=stage)]
 )
 ```
 
@@ -1427,7 +1421,7 @@ but the directory wasn't there. There are two common causes for this:
 
 ### <Stack> is in ROLLBACK_COMPLETE state and can not be updated
 
-If  you see the following error during execution of your pipeline:
+If you see the following error during execution of your pipeline:
 
 ```plaintext
 Stack ... is in ROLLBACK_COMPLETE state and can not be updated. (Service:
@@ -1476,21 +1470,6 @@ that bundles asset using tools run via Docker, like `aws-lambda-nodejs`, `aws-la
 
 Make sure you set the `privileged` environment variable to `true` in the synth definition:
 
-```python
-source_artifact = codepipeline.Artifact()
-cloud_assembly_artifact = codepipeline.Artifact()
-pipeline = pipelines.CdkPipeline(self, "MyPipeline",
-    cloud_assembly_artifact=cloud_assembly_artifact,
-    synth_action=pipelines.SimpleSynthAction.standard_npm_synth(
-        source_artifact=source_artifact,
-        cloud_assembly_artifact=cloud_assembly_artifact,
-        environment=codebuild.BuildEnvironment(
-            privileged=True
-        )
-    )
-)
-```
-
 After turning on `privilegedMode: true`, you will need to do a one-time manual cdk deploy of your
 pipeline to get it going again (as with a broken 'synth' the pipeline will not be able to self
 update to the right state).
@@ -1543,27 +1522,6 @@ An "S3 Access Denied" error can have two causes:
 * Asset hashes have changed, but self-mutation has been disabled in the pipeline.
 * You have deleted and recreated the bootstrap stack, or changed its qualifier.
 
-#### Self-mutation step has been removed
-
-Some constructs, such as EKS clusters, generate nested stacks. When CloudFormation tries
-to deploy those stacks, it may fail with this error:
-
-```console
-S3 error: Access Denied For more information check http://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html
-```
-
-This happens because the pipeline is not self-mutating and, as a consequence, the `FileAssetX`
-build projects get out-of-sync with the generated templates. To fix this, make sure the
-`selfMutating` property is set to `true`:
-
-```python
-cloud_assembly_artifact = codepipeline.Artifact()
-pipeline = pipelines.CdkPipeline(self, "MyPipeline",
-    self_mutating=True,
-    cloud_assembly_artifact=cloud_assembly_artifact
-)
-```
-
 #### Bootstrap roles have been renamed or recreated
 
 While attempting to deploy an application stage, the "Prepare" or "Deploy" stage may fail with a cryptic error like:
@@ -1617,13 +1575,13 @@ encryption key policy for the artifacts bucket may have a statement that looks l
 
 ```json
 {
-  "Effect" : "Allow",
-  "Principal" : {
+  "Effect": "Allow",
+  "Principal": {
     // "AWS" : "AROAYBRETNYCYV6ZF2R93"  // Indicates this issue; replace this value
-    "AWS": "arn:aws:iam::0123456789012:role/cdk-hnb659fds-deploy-role-0123456789012-eu-west-1", // Correct value
+    "AWS": "arn:aws:iam::0123456789012:role/cdk-hnb659fds-deploy-role-0123456789012-eu-west-1" // Correct value
   },
-  "Action" : [ "kms:Decrypt", "kms:DescribeKey" ],
-  "Resource" : "*"
+  "Action": ["kms:Decrypt", "kms:DescribeKey"],
+  "Resource": "*"
 }
 ```
 
@@ -1857,9 +1815,7 @@ class AddStageOpts:
                 ]
             )
             pipeline.add_stage(prod,
-                pre=[
-                    pipelines.ManualApprovalStep("PromoteToProd")
-                ]
+                pre=[pipelines.ManualApprovalStep("PromoteToProd")]
             )
         '''
         if __debug__:
@@ -2470,24 +2426,18 @@ class CodePipelineProps:
 
         Example::
 
-            # Modern API
-            modern_pipeline = pipelines.CodePipeline(self, "Pipeline",
-                self_mutation=False,
+            # code_pipeline: codepipeline.Pipeline
+            
+            
+            source_artifact = codepipeline.Artifact("MySourceArtifact")
+            
+            pipeline = pipelines.CodePipeline(self, "Pipeline",
+                code_pipeline=code_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"
-                    ]
+                    input=pipelines.CodePipelineFileSet.from_artifact(source_artifact),
+                    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)
@@ -3171,7 +3121,9 @@ class DockerCredentialUsage(enum.Enum):
 
         docker_hub_secret = secretsmanager.Secret.from_secret_complete_arn(self, "DHSecret", "arn:aws:...")
         # Only the image asset publishing actions will be granted read access to the secret.
-        creds = pipelines.DockerCredential.docker_hub(docker_hub_secret, usages=[pipelines.DockerCredentialUsage.ASSET_PUBLISHING])
+        creds = pipelines.DockerCredential.docker_hub(docker_hub_secret,
+            usages=[pipelines.DockerCredentialUsage.ASSET_PUBLISHING]
+        )
     '''
 
     SYNTH = "SYNTH"
@@ -3354,7 +3306,9 @@ class ExternalDockerCredentialOptions:
 
             docker_hub_secret = secretsmanager.Secret.from_secret_complete_arn(self, "DHSecret", "arn:aws:...")
             # Only the image asset publishing actions will be granted read access to the secret.
-            creds = pipelines.DockerCredential.docker_hub(docker_hub_secret, usages=[pipelines.DockerCredentialUsage.ASSET_PUBLISHING])
+            creds = pipelines.DockerCredential.docker_hub(docker_hub_secret,
+                usages=[pipelines.DockerCredentialUsage.ASSET_PUBLISHING]
+            )
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__c359b9b78870cd0768aec95eba517b31efce3c0139487e9574671e537d4d9c8a)
@@ -3810,9 +3764,7 @@ class PermissionsBroadeningCheckProps:
             
             stage = MyApplicationStage(self, "MyApplication")
             pipeline.add_stage(stage,
-                pre=[
-                    pipelines.ConfirmPermissionsBroadening("Check", stage=stage)
-                ]
+                pre=[pipelines.ConfirmPermissionsBroadening("Check", stage=stage)]
             )
         '''
         if __debug__:
@@ -4485,24 +4437,18 @@ class ShellStepProps:
 
         Example::
 
-            # Modern API
-            modern_pipeline = pipelines.CodePipeline(self, "Pipeline",
-                self_mutation=False,
+            # code_pipeline: codepipeline.Pipeline
+            
+            
+            source_artifact = codepipeline.Artifact("MySourceArtifact")
+            
+            pipeline = pipelines.CodePipeline(self, "Pipeline",
+                code_pipeline=code_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"
-                    ]
+                    input=pipelines.CodePipelineFileSet.from_artifact(source_artifact),
+                    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)
@@ -5194,17 +5140,20 @@ class StackOutputReference(
         
             def __init__(self, fn, stack_output):
                 super().__init__("MyLambdaStep")
-                self.stack_output_reference = pipelines.StackOutputReference.from_cfn_output(stack_output)
+                self.stack_output_reference =
+                pipelines.StackOutputReference.from_cfn_output(stack_output)
         
             def produce_action(self, stage, *, scope, actionName, runOrder, variablesNamespace=None, artifacts, fallbackArtifact=None, pipeline, codeBuildDefaults=None, beforeSelfMutation=None, stackOutputsMap):
-        
-                stage.add_action(cpactions.LambdaInvokeAction(
-                    action_name=action_name,
-                    run_order=run_order,
-                    # Map the reference to the variable name the CDK has generated for you.
-                    user_parameters={"stack_output": stack_outputs_map.to_code_pipeline(self.stack_output_reference)},
-                    lambda_=self.fn
-                ))
+                stage.add_action(
+                    cpactions.LambdaInvokeAction(
+                        action_name=action_name,
+                        run_order=run_order,
+                        # Map the reference to the variable name the CDK has generated for you.
+                        user_parameters={
+                            "stack_output": stack_outputs_map.to_code_pipeline(self.stack_output_reference)
+                        },
+                        lambda_=self.fn
+                    ))
         
                 return pipelines.CodePipelineActionFactoryResult(run_orders_consumed=1)public get consumedStackOutputs(): pipelines.StackOutputReference[] {
                 return [this.stackOutputReference];
@@ -5666,22 +5615,22 @@ class Step(metaclass=jsii.JSIIAbstractClass, jsii_type="aws-cdk-lib.pipelines.St
                 })
         
             def produce_action(self, stage, *, scope, actionName, runOrder, variablesNamespace=None, artifacts, fallbackArtifact=None, pipeline, codeBuildDefaults=None, beforeSelfMutation=None, stackOutputsMap):
-        
                 # This is where you control what type of Action gets added to the
                 # CodePipeline
-                stage.add_action(cpactions.JenkinsAction(
-                    # Copy 'actionName' and 'runOrder' from the options
-                    action_name=action_name,
-                    run_order=run_order,
+                stage.add_action(
+                    cpactions.JenkinsAction(
+                        # Copy 'actionName' and 'runOrder' from the options
+                        action_name=action_name,
+                        run_order=run_order,
         
-                    # Jenkins-specific configuration
-                    type=cpactions.JenkinsActionType.TEST,
-                    jenkins_provider=self.provider,
-                    project_name="MyJenkinsProject",
+                        # Jenkins-specific configuration
+                        type=cpactions.JenkinsActionType.TEST,
+                        jenkins_provider=self.provider,
+                        project_name="MyJenkinsProject",
         
-                    # Translate the FileSet into a codepipeline.Artifact
-                    inputs=[artifacts.to_code_pipeline(self.input)]
-                ))
+                        # Translate the FileSet into a codepipeline.Artifact
+                        inputs=[artifacts.to_code_pipeline(self.input)]
+                    ))
         
                 return pipelines.CodePipelineActionFactoryResult(run_orders_consumed=1)
     '''
@@ -5828,12 +5777,14 @@ class Wave(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.pipelines.Wave"):
         # pipeline: pipelines.CodePipeline
         
         europe_wave = pipeline.add_wave("Europe")
-        europe_wave.add_stage(MyApplicationStage(self, "Ireland",
-            env=cdk.Environment(region="eu-west-1")
-        ))
-        europe_wave.add_stage(MyApplicationStage(self, "Germany",
-            env=cdk.Environment(region="eu-central-1")
-        ))
+        europe_wave.add_stage(
+            MyApplicationStage(self, "Ireland",
+                env=cdk.Environment(region="eu-west-1")
+            ))
+        europe_wave.add_stage(
+            MyApplicationStage(self, "Germany",
+                env=cdk.Environment(region="eu-central-1")
+            ))
     '''
 
     def __init__(
@@ -6536,24 +6487,18 @@ class CodePipeline(
 
     Example::
 
-        # Modern API
-        modern_pipeline = pipelines.CodePipeline(self, "Pipeline",
-            self_mutation=False,
+        # code_pipeline: codepipeline.Pipeline
+        
+        
+        source_artifact = codepipeline.Artifact("MySourceArtifact")
+        
+        pipeline = pipelines.CodePipeline(self, "Pipeline",
+            code_pipeline=code_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"
-                ]
+                input=pipelines.CodePipelineFileSet.from_artifact(source_artifact),
+                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__(
@@ -7081,9 +7026,7 @@ class ConfirmPermissionsBroadening(
         
         stage = MyApplicationStage(self, "MyApplication")
         pipeline.add_stage(stage,
-            pre=[
-                pipelines.ConfirmPermissionsBroadening("Check", stage=stage)
-            ]
+            pre=[pipelines.ConfirmPermissionsBroadening("Check", stage=stage)]
         )
     '''
 
@@ -7181,22 +7124,22 @@ class FileSet(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.pipelines.FileSet"
                 })
         
             def produce_action(self, stage, *, scope, actionName, runOrder, variablesNamespace=None, artifacts, fallbackArtifact=None, pipeline, codeBuildDefaults=None, beforeSelfMutation=None, stackOutputsMap):
-        
                 # This is where you control what type of Action gets added to the
                 # CodePipeline
-                stage.add_action(cpactions.JenkinsAction(
-                    # Copy 'actionName' and 'runOrder' from the options
-                    action_name=action_name,
-                    run_order=run_order,
+                stage.add_action(
+                    cpactions.JenkinsAction(
+                        # Copy 'actionName' and 'runOrder' from the options
+                        action_name=action_name,
+                        run_order=run_order,
         
-                    # Jenkins-specific configuration
-                    type=cpactions.JenkinsActionType.TEST,
-                    jenkins_provider=self.provider,
-                    project_name="MyJenkinsProject",
+                        # Jenkins-specific configuration
+                        type=cpactions.JenkinsActionType.TEST,
+                        jenkins_provider=self.provider,
+                        project_name="MyJenkinsProject",
         
-                    # Translate the FileSet into a codepipeline.Artifact
-                    inputs=[artifacts.to_code_pipeline(self.input)]
-                ))
+                        # Translate the FileSet into a codepipeline.Artifact
+                        inputs=[artifacts.to_code_pipeline(self.input)]
+                    ))
         
                 return pipelines.CodePipelineActionFactoryResult(run_orders_consumed=1)
     '''
@@ -7286,9 +7229,7 @@ class ManualApprovalStep(
             ]
         )
         pipeline.add_stage(prod,
-            pre=[
-                pipelines.ManualApprovalStep("PromoteToProd")
-            ]
+            pre=[pipelines.ManualApprovalStep("PromoteToProd")]
         )
     '''
 
@@ -7333,24 +7274,18 @@ class ShellStep(
 
     Example::
 
-        # Modern API
-        modern_pipeline = pipelines.CodePipeline(self, "Pipeline",
-            self_mutation=False,
+        # code_pipeline: codepipeline.Pipeline
+        
+        
+        source_artifact = codepipeline.Artifact("MySourceArtifact")
+        
+        pipeline = pipelines.CodePipeline(self, "Pipeline",
+            code_pipeline=code_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"
-                ]
+                input=pipelines.CodePipelineFileSet.from_artifact(source_artifact),
+                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__(