AFT での代替のソースコードバージョン管理

AFT はソースコードバージョン管理システム (VCS) AWS CodeCommit をネイティブに使用しますが、CodeConnectionsビジネス要件や既存のアーキテクチャを満たす他のシステムも使用できます。AFT デプロイの前提条件の一部として、サードパーティー VCS を指定できます。

AFT では、次のソースコード管理の代替方法がサポートされています。

• GitHub

• GitHub エンタープライズサーバー

• BitBucket

VCS AWS CodeCommit として選択した場合、追加の手順は必要ありません。AFT はデフォルトで、環境内に必要な git リポジトリ (デフォルト名を使用) を作成します。ただし、組織の標準に合わせて CodeCommit、必要に応じてデフォルトのリポジトリ名をオーバーライドできます。

AFT で代替のソースコードバージョン管理システム (カスタム VCS) を設定する

AFT デプロイ用の代替のソースコードバージョン管理システムを設定するには、次のステップに従います。

ステップ 1: サポートされているサードパーティーのバージョン管理システム (VCS、Version Control System) で git リポジトリを作成する

を使用していない場合は AWS CodeCommit、AFT がサポートするサードパーティ VCS git プロバイダー環境で以下の項目用のリポジトリを作成する必要があります。

• AFT アカウントリクエスト。サンプルコードがあります。AFT アカウントリクエストの詳細については、「AFT による新しいアカウントのプロビジョニング」を参照してください。

• AFT アカウントプロビジョニングのカスタマイズ。サンプルコードがあります。AFT アカウントプロビジョニングのカスタマイズの詳細については、「AFT アカウントプロビジョニングのカスタマイズのステートマシンを作成する」を参照してください。

• AFT グローバルカスタマイズ。サンプルコードがあります。AFT グローバルカスタマイズの詳細については、「アカウントのカスタマイズ」を参照してください。

• AFT アカウントのカスタマイズ。サンプルコードがあります。AFT アカウントのカスタマイズの詳細については、「アカウントのカスタマイズ」を参照してください。

ステップ 2: AFT デプロイに必要な VCS 設定パラメータを指定する

AFT デプロイの一部として VCS プロバイダーを設定するには、次の入力パラメータが必要です。

• vcs_provider: 使用していない場合は AWS CodeCommit、ユースケースに応じて VCS プロバイダーを"bitbucket"、"github"、またはとして指定します。"githubenterprise"

• github_enterprise_url: エンタープライズのお客様のみ、URL を指定してください。 GitHub GitHub

• account_request_repo_name: デフォルトでは、この値はユーザーに対してに設定されています。aft-account-request AWS CodeCommit AFT がサポートするサードパーティ VCS プロバイダー環境内、 CodeCommit または AFT がサポートするサードパーティ VCS プロバイダー環境で新しい名前でリポジトリを作成した場合は、この入力値を実際のリポジトリ名で更新してください。 BitBucket、Github および GitHub Enterprise の場合、リポジトリ名は次の形式である必要があります。[Org]/[Repo]

• account_customizations_repo_name: デフォルトでは、この値はユーザー用にに設定されています。aft-account-customizations AWS CodeCommit AFT がサポートするサードパーティ VCS プロバイダー環境内、 CodeCommit または AFT がサポートするサードパーティ VCS プロバイダー環境で新しい名前でリポジトリを作成した場合は、この入力値をリポジトリ名で更新してください。 BitBucket、Github および GitHub Enterprise では、リポジトリ名を次の形式にする必要があります。[Org]/[Repo]

• account_provisioning_customizations_repo_name: デフォルトでは、この値はユーザー用にに設定されています。aft-account-provisioning-customizations AWS CodeCommit AFT がサポートするサードパーティ VCS プロバイダー環境内、 AWS CodeCommit または AFT がサポートするサードパーティ VCS プロバイダー環境で新しい名前でリポジトリを作成した場合は、この入力値をリポジトリ名で更新してください。 BitBucket、Github、および GitHub Enterprise では、リポジトリ名を次の形式にする必要があります。[Org]/[Repo]

• global_customizations_repo_name: デフォルトでは、この値はユーザー用にに設定されています。aft-global-customizations AWS CodeCommit AFT がサポートするサードパーティ VCS プロバイダー環境内、 CodeCommit または AFT がサポートするサードパーティ VCS プロバイダー環境で新しい名前でリポジトリを作成した場合は、この入力値をリポジトリ名で更新してください。 BitBucket、Github および GitHub Enterprise では、リポジトリ名を次の形式にする必要があります。[Org]/[Repo]

• account_request_repo_branch: ブランチはデフォルトで main ですが、この値はオーバーライドできます。

デフォルトでは、AFT のソースは各 git リポジトリの main ブランチです。ブランチ名の値は、追加の入力パラメータでオーバーライドできます。入力パラメータの詳細については、AFT Terraform モジュールの README ファイルを参照してください。

ステップ 3: サードパーティ VCS AWS CodeStar プロバイダーとの接続を完了する

デプロイメントが実行されると、AFT AWS CodeCommit は必要なリポジトリを作成するか、選択したサードパーティ VCS AWS CodeStar プロバイダーの接続を作成します。後者の場合は、AFT 管理アカウントのコンソールに手動でサインインして、 AWS CodeStar 保留中の接続を完了する必要があります。AWS CodeStar 接続を完了する詳細な手順については、 AWS CodeStar ドキュメントを参照してください。