AFT 使用 AWS CodeCommit 作为源代码版本控制系统(VCS),并且允许满足您业务需求或现有架构的其他 CodeConnections。
如果您是首次部署 AFT,并且没有现有 CodeCommit 存储库,则必须指定一个外部 VCS 提供商,这是 AFT 部署先决条件的一部分。有关更多信息,请参阅 Alternatives for version control of source code in AFT。
AFT 支持以下源代码控制替代方案:
-
GitHub
-
GitHub Enterprise Server
-
BitBucket
-
GitLab
-
GitLab 自行管理
注意
如果您指定 AWS CodeCommit 为 VCS,则无需执行任何其他步骤。AFT 会使用默认名称在您的环境中创建必要的 git
存储库。但是,您可以根据需要覆盖 CodeCommit 的默认存储库名称,以符合贵组织标准。
使用 AFT 设置替代源代码版本控制系统(自定义 VCS)
要为 AFT 部署设置替代源代码版本控制系统,请按照以下步骤操作。
步骤 1:在支持的第三方版本控制系统(VCS)中创建 git
存储库。
如果您未使用 AWS CodeCommit,则必须在 AFT 支持的第三方 VCS 提供商环境中为以下项目创建 git
存储库。
-
AFT 账户申请。提供示例代码
。有关 AFT 账户请求的更多信息,请参阅 使用 AFT 预置新账户。 -
AFT 账户预置自定义。提供示例代码
。有关 AFT 账户预置自定义的更多信息,请参阅 创建 AFT 账户预置自定义状态机。
步骤 2:指定 AFT 部署所需的 VCS 配置参数
作为 AFT 部署的一部分,需要使用以下输入参数来配置 VCS 提供商。
-
vcs_provider:如果您未使用 AWS CodeCommit,请根据使用案例将 VCS 提供商指定为
"bitbucket"
、"github"
、"githubenterprise"
或"gitlab"
。 -
github_enterprise_url:仅适用于 GitHub Enterprise 客户,请指定 GitHub URL。
-
account_request_repo_name:对于 AWS CodeCommit 用户,此值设置为
aft-account-request
。在 AFT 支持的第三方 VCS 提供商环境中,使用您的实际存储库名称更新此输入值。对于 BitBucket、GitHub、GitHub Enterprise、GitLab 和 GitLab 自行管理,存储库名称必须采用以下格式:[Org]/[Repo]
。 -
account_customizations_repo_name:对于 AWS CodeCommit 用户,此值设置为
aft-account-customizations
。在 AFT 支持的第三方 VCS 提供商环境中,使用您的存储库名称更新此输入值。对于 BitBucket、GitHub、GitHub Enterprise、GitLab 和 GitLab 自行管理,存储库名称必须采用以下格式:[Org]/[Repo]
。 -
account_provisioning_customizations_repo_name:对于 AWS CodeCommit 用户,此值设置为
aft-account-provisioning-customizations
。在 AFT 支持的第三方 VCS 提供商环境中,使用您的存储库名称更新此输入值。对于 BitBucket、GitHub、GitHub Enterprise、GitLab 和 GitLab 自行管理,存储库名称必须采用以下格式:[Org]/[Repo]
。 -
global_customizations_repo_name:对于 AWS CodeCommit 用户,此值设置为
aft-global-customizations
。在 AFT 支持的第三方 VCS 提供商环境中,使用您的存储库名称更新此输入值。对于 BitBucket、GitHub、GitHub Enterprise、GitLab 和 GitLab 自行管理,存储库名称必须采用以下格式:[Org]/[Repo]
。 -
account_request_repo_branch:默认情况下,该分支为
main
,但该值可以被覆盖。
默认情况下,AFT 来自每个 git
存储库的 main
分支。您可以使用其他输入参数覆盖该分支名称值。有关输入参数的更多信息,请参阅 AFT Terraform module
对于现有 AWS CodeCommit 客户
如果您使用新名称为 AFT 创建 CodeCommit 存储库,则可以通过更新这些输入参数的值来更新存储库名称。
步骤 3:为第三方 VCS 提供商完成 AWS CodeStar 连接
部署运行时,AFT 要么创建所需的 AWS CodeCommit 存储库,要么为您选择的第三方 VCS 提供商创建 AWS CodeStar 连接。如果是后者,则必须手动登录 AFT 管理账户的控制台才能完成待处理的 AWS CodeStar 连接。有关完成 AWS CodeStar 连接的进一步说明,请参阅 AWS CodeStar documentation。