feat(core): add volumes-from option to docker run command for bundling

packages/@aws-cdk/aws-lambda-python/README.md

@@ -145,6 +145,18 @@ new python.PythonFunction(this, 'function', {
 });
 ```
 
+In situations where files are needed for bundling that are from a different container, you can specify the container ID from which additional volumes should be mounted.
+
+ ```ts
+const entry = '/path/to/function';
+
+new python.PythonFunction(this, 'function', {
+  entry,
+  runtime: Runtime.PYTHON_3_8,
+  bundling: { volumesFrom: ['777f7dc92da7'] },
+});
+```
+
 ## Custom Bundling with Code Artifact
 
 To use a Code Artifact PyPI repo, the `PIP_INDEX_URL` for bundling the function can be customized (requires AWS CLI in the build environment):

packages/@aws-cdk/aws-lambda-python/lib/bundling.ts

@@ -59,6 +59,7 @@ export class Bundling implements CdkBundlingOptions {
   public readonly image: DockerImage;
   public readonly command: string[];
   public readonly environment?: { [key: string]: string };
+  public readonly volumesFrom?: string[];
 
   constructor(props: BundlingProps) {
     const {
@@ -68,6 +69,7 @@ export class Bundling implements CdkBundlingOptions {
       outputPathSuffix = '',
       image,
       poetryIncludeHashes,
+      customCommands,
     } = props;
 
     const outputPath = path.posix.join(AssetStaging.BUNDLING_OUTPUT_DIR, outputPathSuffix);
@@ -77,6 +79,7 @@ export class Bundling implements CdkBundlingOptions {
       inputDir: AssetStaging.BUNDLING_INPUT_DIR,
       outputDir: outputPath,
       poetryIncludeHashes,
+      customCommands: customCommands,
     });
 
     this.image = image ?? DockerImage.fromBuild(path.join(__dirname, '../lib'), {
@@ -88,6 +91,7 @@ export class Bundling implements CdkBundlingOptions {
     });
     this.command = ['bash', '-c', chain(bundlingCommands)];
     this.environment = props.environment;
+    this.volumesFrom = props.volumesFrom;
   }
 
   private createBundlingCommand(options: BundlingCommandOptions): string[] {
@@ -99,6 +103,9 @@ export class Bundling implements CdkBundlingOptions {
     if (packaging.dependenciesFile) {
       bundlingCommands.push(`python -m pip install -r ${DependenciesFile.PIP} -t ${options.outputDir}`);
     }
+    if (options.customCommands) {
+      bundlingCommands.push(...options.customCommands);
+    }
     return bundlingCommands;
   }
 }
@@ -108,6 +115,7 @@ interface BundlingCommandOptions {
   readonly inputDir: string;
   readonly outputDir: string;
   readonly poetryIncludeHashes?: boolean;
+  readonly customCommands?: string[]
 }
 
 /**

packages/@aws-cdk/aws-lambda-python/lib/types.ts

@@ -86,4 +86,17 @@ export interface BundlingOptions {
    * @default - Based on `assetHashType`
    */
   readonly assetHash?: string;
+
+  /**
+   * Where to mount the specified volumes from
+   * @see https://docs.docker.com/engine/reference/commandline/run/#mount-volumes-from-container---volumes-from
+   * @default - no containers are specified to mount volumes from
+   */
+  readonly volumesFrom?: string[];
+
+  /**
+   * Additional commands executed in the bundling container after running dependency installation
+   * @default - no additional custom commands are executed
+   */
+  readonly customCommands?: string[]
 }

packages/@aws-cdk/aws-lambda-python/test/bundling.test.ts

@@ -278,6 +278,21 @@ test('Bundling with custom environment vars`', () => {
   }));
 });
 
+test('Bundling with custom volumes', () => {
+  const entry = path.join(__dirname, 'lambda-handler');
+  Bundling.bundle({
+    entry: entry,
+    runtime: Runtime.PYTHON_3_7,
+    volumesFrom: ['777f7dc92da7'],
+  });
+
+  expect(Code.fromAsset).toHaveBeenCalledWith(entry, expect.objectContaining({
+    bundling: expect.objectContaining({
+      volumesFrom: ['777f7dc92da7'],
+    }),
+  }));
+});
+
 test('Do not build docker image when skipping bundling', () => {
   const entry = path.join(__dirname, 'lambda-handler');
   Bundling.bundle({