CDK部署ElasticBeanstalk应用时无法提取.ebextensions配置文件

问题分析 #

核心矛盾点：

• 用CDK的aws-s3-assets/Asset打包app文件夹时，EB提示无法提取配置文件，.ebextensions不执行，但本地7zip打包同结构文件夹却正常；
• 打包app/*时.ebextensions能执行，但因composer.json不在压缩包根目录，EB提示缺少该文件。

本质原因是CDK默认的Asset打包逻辑与EB的要求不匹配，且当前目录结构下composer.json和.ebextensions不在同一层级，无法通过简单打包单个目录满足EB的双重要求（.ebextensions需在根目录、composer.json也需在根目录）。

解决方案 #

通过自定义CDK Asset的打包命令，将app目录下的所有内容（含.ebextensions）和others_files中的composer.json合并打包到压缩包根目录，同时确保压缩格式符合EB的要求。

具体CDK代码调整 #

修改Asset的配置，添加bundling参数自定义打包流程：

import { Asset, BundlingOutput } from 'aws-cdk-lib/aws-s3-assets';
import { DockerImage } from 'aws-cdk-lib';

// 在你的Stack类中定义Asset
const phpAppAsset = new Asset(this, 'PhpAppAsset', {
  path: `${__dirname}/../../`, // 指向项目根目录
  bundling: {
    image: DockerImage.fromRegistry('alpine:latest'), // 用alpine镜像提供zip命令
    command: [
      'sh', '-c',
      // 进入app目录打包所有内容到输出zip，再添加composer.json
      'cd app && zip -r /asset-output/app.zip ./* && cd ../others_files && zip -g /asset-output/app.zip composer.json'
    ],
    outputType: BundlingOutput.NOT_ARCHIVED, // 直接输出打包好的zip文件
  },
});

// 后续将phpAppAsset的S3信息传入CfnApplicationVersion
new CfnApplicationVersion(this, 'AppVersion', {
  applicationName: 'your-eb-app-name',
  sourceBundle: {
    s3Bucket: phpAppAsset.s3BucketName,
    s3Key: phpAppAsset.s3ObjectKey,
  },
});

额外优化（可选） #

如果EB对文件权限敏感，可在打包前添加权限调整命令，确保文件权限符合EB的运行要求：

command: [
  'sh', '-c',
  'cd app && chmod -R 755 . && zip -r /asset-output/app.zip ./* && cd ../others_files && chmod 644 composer.json && zip -g /asset-output/app.zip composer.json'
],

验证逻辑 #

1. 本地执行上述打包命令，解压生成的zip文件，确认根目录同时存在.ebextensions文件夹和composer.json文件；
2. 部署CDK栈后，EB不会再弹出配置文件提取警告，.ebextensions会正常执行，同时Composer依赖也能正确安装。

内容的提问来源于stack exchange，提问作者DimitriosK