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"、"githubenterprise"、"github"または として指定します。

• github_enterpTAK_url : GitHub エンタープライズのお客様のみ、 GitHub URL を指定します。

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

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

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

• global_customizations_repo_name : デフォルトでは、この値は AWS CodeCommit ユーザーaft-global-customizationsに対して に設定されます。 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 ドキュメントを参照してください。