适用于 CodeBuild 的生成规范参考

variables：在指定了 env 并且您希望定义纯文本格式的自定义环境变量时必需。包含 key/value 标量的映射，其中每个映射表示一个纯文本形式的自定义环境变量。key 是自定义环境变量的名称，value 是该变量的值。

parameter-store：在指定了 env 并且您要检索存储在 Amazon EC2 Systems Manager Parameter Store 中的自定义环境变量时必需。包含 key/value 标量的映射，其中每个映射表示存储在 Amazon EC2 Systems Manager Parameter Store 中的一个自定义环境变量。key 是您之后在构建命令中用于表示此自定义环境变量的名称，而 value 是存储在 Amazon EC2 Systems Manager Parameter Store 中的自定义环境变量的名称。要存储敏感值，请参阅 Amazon EC2 Systems Manager 用户指南 中的 Systems Manager Parameter Store 和 Systems Manager Parameter Store 控制台演练。

git-credential-helper：可选的映射。用于指示 CodeBuild 是否使用其 Git 凭证辅助程序来提供 Git 凭证。如果使用该辅助程序，则为 yes。否则为 no 或未指定。有关更多信息，请参阅 Git 网站上的 gitcredentials。

upload-artifacts：可选的映射。如果您希望显式代理服务器中的构建来上传构件，请设置为 yes。默认为 no。

logs：可选的映射。要使显式代理服务器中的构建创建 CloudWatch 日志，请设置为 yes。默认为 no。

run-as：可选的序列。在构建阶段中使用，以指定运行命令的 Linux 用户。如果还在构建规范文件的顶部为所有命令全局指定了 run-as，则阶段级别用户优先。例如，如果 run-as 全局指定用户 1，并且对于 install 阶段，只有一条 run-as 语句指定用户 2，则构建规范文件中的所有命令将以用户 1 的身份运行，但 install 阶段中的命令除外，这些命令以用户 2 的身份运行。

install：可选的序列。表示 CodeBuild 在安装过程中将运行的命令（如果有）。建议使用仅适用于在构建环境中安装软件包的 install 阶段。例如，您可以使用此阶段来安装代码测试框架 (如 Mocha 或 RSpec)。

pre_build：可选的序列。表示 CodeBuild 在构建之前将运行的命令（如果有）。例如，可以使用此阶段登录 Amazon ECR，也可以安装 npm 依赖项。

build：可选的序列。表示 CodeBuild 在生成过程中将运行的命令（如果有）。例如，您可以使用此阶段运行 Mocha、RSpec 或 sbt。

post_build：可选的序列。表示 CodeBuild 在生成后将运行的命令（如果有）。例如，您可以使用 Maven 将构建项目打包成 JAR 或 WAR 文件，还可以将 Docker 镜像推入到 Amazon ECR 中。然后，您可以通过 Amazon SNS 发送构建通知。

files：必需的序列。表示包含构建环境中的输出项目的位置。包含一系列标量，其中每个标量表示一个相对于原始构建位置或基本目录 (如果已设置) 的单独位置，CodeBuild 可在此处查找构建输出项目。位置可包含以下内容：

您在指定构建输出项目位置时，CodeBuild 可在构建环境中查找原始构建位置。您无需将包含路径的构建项目输出位置放在原始构建位置的前面，或指定 ./ 或类似。如果您需要了解此位置的路径，则可以在构建过程中运行命令 echo $CODEBUILD_SRC_DIR。各个构建环境的位置可能略有不同。

name：可选名称。为构建构件指定名称。将在以下任一条件为 true 时使用此名称。

可以在构建规范文件中指定于构建时计算得出的名称。构建规范文件中指定的名称使用 Shell 命令语言。例如，您可以将日期和时间附加到您的项目名称后面，以便它始终是唯一的。构件名称唯一防止覆盖构件。有关更多信息，请参阅 Shell 命令语言。

这是追加有构件创建日期的构件名称的示例。

version: 0.2         
phases:
  build:
    commands:
      - rspec HelloWorld_spec.rb
artifacts:
  files:
    - '**/*'
  name: myname-$(date +%Y-%m-%d) 

这是使用 CodeBuild 环境变量的构件名称的示例。有关更多信息，请参阅构建环境中的环境变量。

version: 0.2         
phases:
  build:
    commands:
      - rspec HelloWorld_spec.rb
artifacts:
  files:
    - '**/*'
  name: myname-$AWS_REGION 

这是使用 CodeBuild 环境变量且追加了构件创建日期的构件名称的示例。

version: 0.2         
phases:
  build:
    commands:
      - rspec HelloWorld_spec.rb
artifacts:
  files:
    - '**/*'
  name: $AWS_REGION-$(date +%Y-%m-%d) 

discard-paths：可选的映射。表示是否放弃构建输出项目中的文件的路径。如果丢弃路径，则为 yes；否则为 no 或未指定（默认）。例如，如果构建输出项目中的文件路径为 com/mycompany/app/HelloWorld.java，则指定 yes 可能会将此路径缩短为 HelloWorld.java。

base-directory：可选的映射。表示相对于原始构建位置的一个或多个顶级目录，CodeBuild 使用这些目录确定在构建输出项目中包含哪些文件和子目录。有效值包括：

构建输出项目中不包含映射顶级目录，只包含其文件和子目录。

您可以使用 files 和 discard-paths 进一步限制包含哪些文件和子目录。例如，对于以下目录结构：

|-- my-build1
|     `-- my-file1.txt
`-- my-build2
      |-- my-file2.txt
      `-- my-subdirectory
            `-- my-file3.txt

对于以下 artifacts 序列：

artifacts:
  files: 
    - '*/my-file3.txt'
  base-directory: my-build2

以下子目录和文件应包含在构建输出项目中：

my-subdirectory
  `-- my-file3.txt

对于以下 artifacts 序列：

artifacts:
  files: 
    - '**/*'
  base-directory: 'my-build*'
  discard-paths: yes

以下文件应包含在构建输出项目中：

|-- my-file1.txt
|-- my-file2.txt
`-- my-file3.txt

secondary-artifacts：可选的序列。将一个或多个构件定义表示为构件标识符与构件定义之间的映射。此块中的每个构件标识符都必须与项目的 secondaryArtifacts 属性中定义的构件匹配。每个单独的定义与上面的 artifacts: 块具有相同的语法。例如，如果项目具有以下结构：

  {
    "name": "sample-project",
    "secondaryArtifacts": [
      {
        "type": "S3",
        "location": "output-bucket1",
        "artifactIdentifier": "artifact1",
        "name": "secondary-artifact-name-1"
      },
      {
        "type": "S3",
        "location": "output-bucket2",
        "artifactIdentifier": "artifact2",
        "name": "secondary-artifact-name-2"
      }
    ]
  }

则 Buildpec 如下所示：

version: 0.2

phases:
build:
  commands:
    - echo Building...
artifacts:
  secondary-artifacts:
    artifact1:
      files:
        - directory/file
      name: secondary-artifact-name-1        
    artifact2:
      files:
        - directory/file2
      name: secondary-artifact-name-2

paths：必需的序列。表示缓存的位置。包含一系列标量，其中每个标量表示一个相对于原始构建位置或基本目录 (如果已设置) 的单独位置，CodeBuild 可在此处查找构建输出项目。位置可包含以下内容：