适用于 CodeBuild 的生成规范参考

构建规范文件名称和存储位置

如果您在源代码中包含生成规范，则默认情况下，构建规范文件必须命名为 buildspec.yml 且放置在源目录的根目录中。

可以覆盖默认构建规范文件名和位置。例如，您可以：

• 对同一存储库中的不同构建使用不同的构建规范文件，如 buildspec_debug.yml 和 buildspec_release.yml。

• 将构建规范文件存储在源目录的根目录之外的位置，如 config/buildspec.yml。

您可以只为构建项目指定一个生成规范，而不管构建规范文件的名称如何。

要覆盖默认构建规范文件名、默认位置或这两者，执行下列操作之一：

• 运行 AWS CLI create-project 或 update-project 命令，将 buildspec 值设置为备用构建规范文件的路径（相对于内置环境变量 CODEBUILD_SRC_DIR 的值）。您还可以在 AWS 开发工具包中执行与 create project 操作等效的操作。有关更多信息，请参阅 创建构建项目 或 更改生成项目的设置。

• 运行 AWS CLI start-build 命令，将 buildspecOverride 值设置为备用构建规范文件的路径（相对于内置环境变量 CODEBUILD_SRC_DIR 的值）。您还可以在 AWS 开发工具包中执行与 start build 操作等效的操作。有关更多信息，请参阅运行生成项目。

• 在 AWS CloudFormation 模板中，将类型为 AWS::CodeBuild::Project 的资源中 Source 的 BuildSpec 属性设置为备用规范文件的路径（相对于内置环境变量 CODEBUILD_SRC_DIR 的值）。有关更多信息，请参阅 AWS CloudFormation User Guide 中的 AWS CodeBuild 项目源中的 BuildSpec 属性。