此示例演示如何使用提交 ID 以外的格式(也称为提交 SHA)指定源的版本。您可以通过以下方式指定源的版本:
-
对于 Amazon S3 源提供商,请使用表示构建输入 ZIP 文件的对象的版本 ID。
-
对于 CodeCommit、Bitbucket、GitHub 和 GitHub Enterprise Server,请使用下列项之一:
-
拉取请求作为拉取请求参考(例如,
refs/pull/1/head
)。 -
分支作为分支名称。
-
提交 ID。
-
标签。
-
参考和提交 ID。参考可以是下列项之一:
-
标签(例如,
refs/tags/mytagv1.0^{full-commit-SHA}
)。 -
分支(例如,
refs/heads/mydevbranch^{full-commit-SHA}
)。 -
拉取请求(例如,
refs/pull/1/head^{full-commit-SHA}
)。
-
-
-
对于 GitLab 和 GitLab 自行管理,执行以下操作之一:
-
分支作为分支名称。
-
提交 ID。
-
标签。
-
注意
仅在存储库为 GitHub 或 GitHub Enterprise Server 时可指定拉取请求源的版本。
如果使用参考和提交 ID 指定版本,则构建的 DOWNLOAD_SOURCE
阶段比仅提供版本时更快。这是因为,在添加参考时,CodeBuild 不需要下载整个存储库来查找提交。
-
可以仅使用提交 ID 指定源版本,例如
12345678901234567890123467890123456789
。如果您执行此操作,则 CodeBuild 必须下载整个存储库来查找版本。 -
您可以按此格式使用参考和提交 ID 指定源版本:
(例如refs
/heads
/branchname
^{full-commit-SHA
}refs/heads/main^{12345678901234567890123467890123456789}
)。如果您执行此操作,则 CodeBuild 仅下载指定的分支来查找版本。
注意
要加快构建的 DOWNLOAD_SOURCE
阶段,您也可以将 Git 克隆深度设置为较小数字。CodeBuild 下载较少版本的存储库。