メインコンテンツへスキップ
見出し画像

マルチアカウントCI/CD、ソースコードをどう渡す? AWSの4つの構成パターン

    AWSで開発・ステージング・本番のアカウントを分けるとき、CI/CDを共通アカウントへ集約する構成があります。

    その際、最初に考えたいのが「ソースコードをどこで管理し、共通のリリース基盤へどう渡すか」です。

    CodeCommitで管理する方法もあれば、既存のGitHubやGitLabへ直接つなぐ方法もあります。外部のGitリポジトリからCodeCommitへ同期したり、ソースをZIPにしてS3へ納品したりする構成も考えられます。

    今回は、CodePipelineを共通アカウントに置く前提をそろえ、この入口の違いを4パターンで比較します。メリット・デメリットに加え、実装時に必要になる設定作業と確認事項まで整理します。

    ※2026年11月11日時点で確認したAWS公式資料を基にしています。図は本記事の説明用の構成例で、実環境へデプロイして検証したものではありません。

    1.比較する範囲と共通の前提

    本記事では、共通AWSアカウントにCodePipelineとCodeBuildを配置し、別アカウントのステージング・本番環境へデプロイする構成を想定します。

    比較するのは、ソースコードを共通CodePipelineへ取り込む部分です。クロスアカウントの配備方式は共通とし、IAMやKMSの設定詳細、ECS・Lambdaなど配備先ごとの実装は扱いません。図ではアカウント境界と処理の流れを示します。

    また、4パターンともAWS側でソースをビルドする前提です。開発側で作ったビルド済み成果物を受け渡す方式は、今回のS3納品方式とは分けて考えます。

    最初に、どの方式でも次を決めておきます。

    • 何をリリース対象にするか。例えば、mainへのマージ後のコミットを対象にする。

    • いつ起動するか。変更を自動検知するのか、承認後に外部CIから起動するのかを決める。

    • 何を配備したか、どの識別子で追跡するか。Gitのcommit SHAを基本にする。

    • 短時間に複数の変更が入ったとき、実行を順番に進めるか、古い実行を置き換えるかを決める。

    • ステージングで確認した成果物を、同じ版のまま本番へ昇格させる。

    「最新のコードを取得する」だけでは、実行中に別の変更が入ったときの対象が曖昧になります。どの版を受け取り、どの実行で使うかまで意識しておきます。

    2.パターン①:CodeCommitでソースコードを管理する

    開発者が共通アカウントのCodeCommitへコードをpushし、CodePipelineがそのリポジトリから取得する構成です。

    画像

    メリットとデメリット

    リポジトリとリリース基盤をAWS側へ集約できます。外部Gitとの接続や、リポジトリ間の同期処理を別途用意する必要がありません。

    一方、既にGitHubやGitLabで開発している場合は、ソースの移行だけでなく、レビューや課題管理、周辺ツールとの連携を含めて開発フローを見直す必要があります。

    ソース管理もAWS側へまとめたい場合の候補です。なお、CodeCommitは新規顧客の受付再開がAWS公式ブログで案内されています。以前の「新規利用できない」という情報だけで候補から外さないようにします。[1]

    必要な設定作業

    1. 共通アカウントにCodeCommitリポジトリを作成する。

    2. 開発者のGit接続・認証を設定し、初期コードとリリース対象ブランチをpushする。

    3. CodePipelineのSourceにCodeCommitを選び、リポジトリ名とブランチ名を設定する。

    4. Sourceの出力アーティファクトを、CodeBuildの入力へ接続する。

    5. 対象ブランチの変更を検知するEventBridgeルールを設定する。

    6. 対象ブランチへpushし、実行されたパイプラインのソースリビジョンが、そのcommit SHAと一致するか確認する。

    Sourceの主な設定値は、RepositoryName、BranchName、PollForSourceChangesです。イベント起動を使う場合、PollForSourceChangesをfalseにして、ポーリングとの二重起動を避けます。[2]

    留意事項

    通常はソースをZIPで後段へ渡せます。ただし、ビルド処理がGit履歴やタグに依存する場合は、ZIPだけで必要な情報がそろうかを確認します。

    Git履歴が必要ならFull cloneを検討します。CODEBUILD_CLONE_REF形式は後段のCodeBuild向けで、接続に必要な追加設定もあります。単に「ZIPをcloneへ変更すればよい」とは扱わず、ビルドの要件に合わせて選びます。[2]

    3.パターン②:GitHub/GitLabと直接連携する

    開発側ではGitHubやGitLabを使い続け、共通アカウントのCodeConnections経由でCodePipelineへソースを渡す構成です。

    画像

    GitHubなどの組織とAWSアカウントは、別の管理境界です。この方式では、共通AWSアカウントの中にGitHubのサーバーやGitリポジトリのミラーを持つ必要はありません。

    CodeConnectionsは、GitHub、GitHub Enterprise Server、GitLab.com、GitLab Self-Managedなどへの接続に対応しています。利用するプロバイダーとリージョンの対応は、採用時に確認します。[3]

    メリットとデメリット

    既存の開発環境とレビューの流れを維持しやすく、リポジトリのコピーを同期する仕組みも不要です。既にGitHubやGitLabを使っている場合、比較の出発点にしやすい構成です。

    一方、ソース取得は外部Gitと接続の状態に依存します。組織の設定変更、リポジトリへのアクセス解除、外部サービスの障害などがAWS側の新しいリリースへ影響します。

    必要な設定作業

    1. 外部Gitのリポジトリと、リリース対象ブランチを確定する。

    2. 共通アカウントにCodeConnectionsの接続を作成する。

    3. 外部Git側で接続を承認し、対象リポジトリへのアクセスを許可する。

    4. CodePipelineのSourceへ、接続・リポジトリ・ブランチを設定する。

    5. 起動条件と出力形式を設定し、Sourceの出力をCodeBuildへ接続する。

    6. 対象ブランチへ変更を反映し、起動とcommit SHAを確認する。

    Sourceの設定では、ConnectionArnに接続のARN、FullRepositoryIdに組織名/リポジトリ名、BranchNameに対象ブランチを指定します。出力をZIPにする場合は、OutputArtifactFormatにCODE_ZIPを指定します。[3]

    留意事項

    接続リソースの作成と、外部Git側での承認は別の作業として確認します。リポジトリ名の大文字・小文字にも注意します。

    また、PRの検証と、マージ後のリリースは目的が異なります。起動条件を広げる前に、何を検証用、何をリリース用として動かすのかを決めます。高度なトリガーフィルターを使う場合は、パイプラインタイプを含めて対応条件を確認します。

    GitLab Self-Managedでは、GitLabのホスト設定やネットワーク到達性も確認します。GitLab.comと同じ作業だけで接続できるとは限りません。[4]

    4.パターン③:外部GitをCodeCommitへミラーする

    GitHubやGitLabでソースを管理し、その変更をCodeCommitへ一方向に同期してからCodePipelineへ渡す構成です。

    画像

    図では外部CIなどで同期処理を動かす例を示しています。外部Git側の標準ミラー機能を使う方法もありますが、認証方式や機能の利用条件が異なるため、実装方式として分けて確認します。

    メリットとデメリット

    既存の開発環境を維持しながら、AWS側にもGit形式のリリース用コピーを保持できます。同期が完了したコードは、AWS側のCodeCommitから取得できます。

    その代わり、同期処理の構築と運用が増えます。開発側ではマージ済みでも、同期が失敗すればCodeCommitには古いコードが残ります。「外部Gitにある版」と「AWS側から配備できる版」を区別する必要があります。

    AWS側にGitのコピーを持つ明確な要件がある場合に選ぶ構成です。単にCodePipelineから外部Gitを使いたいだけなら、パターン②で足りるかを先に確認します。

    必要な設定作業

    1. パターン①を基に、ミラー先のCodeCommitとCodePipelineを用意する。

    2. 同期範囲を決める。まずはmainなど、必要なブランチに限定する。

    3. 同期処理の実行場所を決め、外部Gitの取得とCodeCommitへのpushに必要な認証を設定する。

    4. マージ後や承認後など、同期の起動タイミングを設定する。

    5. 対象のGit参照をCodeCommitへpushする処理を実装する。

    6. CodeCommitへの反映を検知して、CodePipelineを起動する。

    7. 同期失敗の通知と、外部Git・CodeCommit間のcommit SHA照合を設定する。

    留意事項

    最初は一方向同期にし、CodeCommit側で独自にコードを変更しない運用にすると整理しやすくなります。

    ブランチやタグの削除、force pushをどう扱うかも決めます。git push --mirrorは削除も反映し得るため、必要な対象だけをpushする方式から検討します。

    外部CIで浅いcloneを使う場合は、同期に必要な履歴が不足しないかを確認します。submoduleやGit LFSも、通常のGitオブジェクトだけの同期で必要な内容がそろうかを別途確認します。

    起動は「CodeCommit更新のイベント」か「同期処理からの明示起動」のどちらかへ整理します。両方を有効にして二重に起動したり、同期完了前にパイプラインを起動したりしないようにします。

    5.パターン④:外部GitからS3へソースZIPを納品する

    外部Gitで管理しているコードをCIでZIP化し、共通アカウントのS3へ送付する構成です。CodePipelineは、そのZIPをソースとして取得します。

    画像

    S3はGitリポジトリではなく、リリース対象のファイル一式を受け渡す場所です。開発側が特定コミットのスナップショットを納品し、AWS側がビルド・テスト・配備を担う、と整理できます。

    メリットとデメリット

    開発側とAWS側の境界を、納品物として明確にできます。AWS側から開発リポジトリへ直接アクセスせずに、受領したコードを使ってリリースできます。

    一方、ZIPの作成、アップロード、起動の仕組みが必要です。通常はGit履歴を引き継がないため、元コミットと納品物を対応付けないと、後から何を配備したか追いにくくなります。

    必要な設定作業

    1. 共通アカウントにソース受領用S3バケットを作り、バージョニングを有効にする。

    2. CodePipelineのSourceに、S3バケット名とオブジェクトキーを設定する。

    3. 外部CIでリリース対象のコミットを確定し、ZIPを作る。

    4. 外部CIからS3への送付に必要な認証を設定する。

    5. ZIPをアップロードし、返されたVersion IDを取得する。

    6. そのVersion IDを指定してCodePipelineを起動する。

    7. commit SHA・S3 Version ID・パイプライン実行IDを記録する。

    S3ソースではバージョニングが必要です。Sourceの主な設定値はS3BucketとS3ObjectKeyです。[5]

    実装の最初の案としては、アップロードしたCIが、そのVersion IDを指定して明示的に起動する方式が分かりやすいと考えます。StartPipelineExecutionでは、ソースリビジョンとしてS3_OBJECT_VERSION_IDを指定できます。[6]

    留意事項

    latest.zipのような同じキーを使う場合でも、実行に使うVersion IDを固定します。アップロード後に単に「最新」を取得させると、次の変更が入った場合に意図しない版を使う可能性があります。

    ソース受領用S3と、CodePipeline内部で成果物を受け渡すS3は役割を分けて考えます。図では比較しやすいように、別のバケットとして表現しています。

    ZIPの中身も確認します。不要な親フォルダーが入るとbuildspec.ymlなどを見つけられないことがあります。秘密情報や不要なローカルファイルを含めず、submoduleやGit LFSの実体、ビルドに必要なファイルがそろっていることを確認します。

    外部CIから明示起動する場合は、同じアップロードを自動検知して二重起動しないようにします。イベント起動を採用する場合は、そのイベントに対応するVersion IDを実行へ渡す設計にします。AWS公式にはEventBridgeとCloudTrailを使う設定手順があります。[7]

    6.どの方式でも「意図した版が配備されるか」を確認する

    ソースを取得できるだけで、設定が完成したとはいえません。4パターンで共通の確認項目を持っておくと比較しやすくなります。

    1. 通常の変更:対象ブランチの変更で、意図した実行が1回起動する。

    2. 対象外の変更:別ブランチなど、リリース対象外の変更では起動しない。

    3. 版の一致:元コミットと、パイプラインで使ったコードが一致する。

    4. 連続変更:短時間に2回更新しても、意図した実行方式に従い、対象版が混ざらない。

    5. 失敗時の停止:同期や送付が失敗したら、古い版や不完全な納品物を新しいリリースとして進めない。

    6. 過去版の再実行:保存済みのソース版を明示して、再実行できる。

    ソースの版を固定するだけで、ビルドの再現性まで保証されるわけではありません。依存パッケージ、ビルドイメージ、外部から取得するファイルなども管理対象になります。

    本番へ出す版を確実にそろえるには、同じコードを環境ごとにビルドし直すよりも、一度作ってステージングで確認した成果物を本番へ昇格させる設計を基本にします。環境固有の設定は、成果物との差分として管理します。

    7.選ぶ基準は、開発側とAWS側をどこで分けるか

    ソース管理をAWSへまとめたいなら、パターン①のCodeCommitが候補です。

    既存のGitHubやGitLabを使い続け、余分な同期処理を増やしたくないなら、パターン②の直接連携を比較の基準にできます。

    AWS側にもGit形式のコピーを残す要件があるなら、パターン③のミラーを検討します。その際は、コピーを持つ利点と同期運用の負担をセットで評価します。

    開発側から承認済みソースを納品し、AWS側は受領物からリリースする責任分担にしたいなら、パターン④のS3方式が候補です。

    今回の比較では、CodePipelineの配置を固定したことで、違いがソースの管理場所と受け渡し方法にあると整理できました。次に配備先サービスを決めれば、各アカウントで必要な設定や、承認・切り戻しの設計を具体化できます。

    参考資料

    [1] The Future of AWS CodeCommit(AWS公式ブログ)
    https://aws.amazon.com/blogs/devops/aws-codecommit-returns-to-general-availability/

    [2] CodeCommitソースアクション(AWS公式)
    https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-CodeCommit.html

    [3] CodeConnectionsを使うソースアクション(AWS公式)
    https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-CodestarConnectionSource.html

    [4] GitLab Self-Managedへの接続(AWS公式)
    https://docs.aws.amazon.com/codepipeline/latest/userguide/connections-gitlab-managed.html

    [5] S3ソースアクション(AWS公式)
    https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-S3.html

    [6] ソースリビジョンの上書き指定(AWS公式API)
    https://docs.aws.amazon.com/codepipeline/latest/APIReference/API_SourceRevisionOverride.html

    [7] S3ソースのイベント起動(AWS公式)
    https://docs.aws.amazon.com/codepipeline/latest/userguide/create-cloudtrail-S3-source-console.html

    [8] クロスアカウントのパイプライン構成(AWS公式・配備部分を具体化する際の参照先)
    https://docs.aws.amazon.com/codepipeline/latest/userguide/pipelines-create-cross-account.html

    図はAWS Architecture Iconsの公式配布素材を使用して筆者作成。GitHub/GitLab、同期処理、CodeConnectionsは汎用ボックスで表現しています。
    https://aws.amazon.com/architecture/icons/

     
     

    blse

     
     
    40代のSE。成果が出せずもやもやする毎日。30代後半の時に、ここでやらなきゃ終わってしまうと決断。行動を変化させた結果、少しずつ、見える景色が変わり始めた。自己紹介記事はこちらから。https://note.com/blse/n/n71d800fff35c

    あなたへのおすすめ