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

AFT はソースコードバージョン管理システム (VCS) AWS CodeCommit に を使用し、ビジネス要件または既存のアーキテクチャを満たす他の CodeConnections を許可します。

AFT を初めてデプロイする場合に、既存の CodeCommit リポジトリがないときは、AFT デプロイの前提条件の一部として外部 VCS プロバイダーを指定する必要があります。詳細については、「Alternatives for version control of source code in AFT」を参照してください。

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

• GitHub

• GitHub Enterprise Server

• Bitbucket

• GitLab

• GitLab セルフマネージド

注記

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

• 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 モジュールの README ファイルを参照してください。

既存の AWS CodeCommit お客様向け

AFT の新しい名前で CodeCommit リポジトリを作成する場合は、これらの入力パラメータの値を更新することでリポジトリ名を更新できます。

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

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