AWS CodeArtifact

AWS CodeArtifact は、アプリケーション開発で利用するソフトウェアパッケージを保存・共有するためのフルマネージドなアーティファクトリポジトリサービスです。npm、Maven、PyPI、NuGet など主要なパッケージ形式に対応し、開発チームが社内で作成したライブラリの配布先としても、パブリックレジストリのパッケージを取得する経路としても利用できます。

解決する課題

アプリケーション開発では、外部のオープンソースパッケージや社内で共有する内製ライブラリへの依存が積み重なります。これらを自前のアーティファクトリポジトリで管理しようとすると、サーバーの可用性確保、ストレージ容量の管理、認証・認可、各パッケージ形式のプロトコル対応など、継続的な運用負担が発生します。

また、ビルドのたびにパブリックレジストリへ直接アクセスする構成では、上流の障害やレート制限、あるいはパッケージが削除されたケースによってビルドが不安定になりがちです。CodeArtifact はマネージドなリポジトリを提供することでこれらの基盤運用から開発者を解放し、上流リポジトリ機能によってパブリックパッケージをキャッシュして依存解決を安定させます。さらに IAM と統合された認証により、認証情報の配布や権限管理を AWS の仕組みに集約できます。

主要概念と用語

• ドメイン: 複数のリポジトリをまとめる最上位の単位。アカウントや組織のポリシー適用、ストレージの重複排除の境界となる。
• リポジトリ: パッケージを保存・取得する単位。形式の異なるパッケージを同一リポジトリに混在させて格納できる。
• 上流リポジトリ: あるリポジトリが依存解決時に参照する別のリポジトリ。複数を連結でき、ローカルに無いパッケージを上流からたどって取得する。
• 外部接続: パブリックレジストリ（npm の公開レジストリや PyPI など）への接続設定。これを介して取得したパッケージはリポジトリにキャッシュされる。
• パッケージ: ライブラリの配布単位。形式ごとに名前空間やバージョンの規則が異なる。
• 認可トークン: クライアントがリポジトリへアクセスするために取得する一時的な認証トークン。有効期間がある。
• ドメインポリシー / リポジトリポリシー: ドメインやリポジトリ単位でアクセスを許可するリソースベースのポリシー。クロスアカウント共有にも使う。

仕様・制限・クォータ

CodeArtifact は npm、Maven、Python、NuGet、Swift、Ruby、Rust、汎用パッケージを扱えます。標準クライアントをリポジトリのエンドポイントへ向け、短期の認可トークンで公開・取得します。パッケージは保管時に暗号化され、転送時も TLS で保護されます。

既定は 1 アカウント・リージョンあたりドメイン 10、1 ドメインあたりリポジトリ 1,000、1 資産 5 GB、1 リポジトリの直接上流 10 です。依存解決で探索する上流は最大 25、1 リポジトリの外部接続は 1 つで、引き上げできない項目もあります。CI の同時取得では、アカウント単位と単一トークン単位の要求上限を分けて監視します。

内部の仕組み

横にスクロール

リポジトリは依存解決時に、自身に存在しないパッケージを上流リポジトリへ順にたどって探します。上流の先頭に外部接続を設定したリポジトリを置くと、パブリックレジストリのパッケージが見つかった時点でその実体がリポジトリにキャッシュされ、以降は上流へアクセスせずに取得できます。これにより上流の障害やパッケージ削除の影響を受けにくくなります。

パッケージの実体は AWS が管理するストレージに保持され、保管時の暗号化が適用されます。暗号化キーは AWS マネージドの方式と、カスタマー管理のキーを用いる方式から選べます。ストレージはドメイン単位で集約されるため、同一ドメイン内の複数リポジトリが同じパッケージを参照しても実体は重複して保持されず、ストレージ効率が高まります。一度取得・公開したパッケージのバージョンは原則として内容が固定され、同一バージョンの上書きは許されないため、ビルドの再現性が保たれます。

設計パターン / ベストプラクティス

ドメインは組織やアカウント群の単位で設計し、用途や環境（開発・本番など）ごとにリポジトリを分けると管理しやすくなります。外部接続を持つ「取得用」のリポジトリを上流に置き、内製パッケージを公開する「配布用」のリポジトリをその下流に置く構成にすると、開発者は単一のエンドポイントを向けるだけで、内製パッケージとパブリックパッケージの双方を解決できます。

パブリックレジストリへ直接アクセスさせず、必ず CodeArtifact を経由させることで、上流のレート制限や可用性の影響を緩和し、取得したパッケージをキャッシュとして固定できます。クロスアカウントで内製パッケージを共有する場合は、リポジトリポリシーやドメインポリシーで必要最小限の権限を付与します。

運用・監視

CodeArtifact は API 呼び出しを証跡として記録できるため、誰がいつパッケージを公開・取得・削除したかを監査できます。パッケージのバージョンが追加・変更された際のイベントを契機に、後続の通知や自動処理を起動する運用も構成できます。

メトリクスを通じてリポジトリの利用状況やストレージ使用量を把握し、不要になった古いパッケージバージョンを整理することで肥大化を抑えます。CI/CD と連携する場合は、ビルド時に認可トークンを取得して依存を解決し、生成した内製パッケージを公開するまでの一連の流れをパイプラインに組み込み、依存の取得を再現性のあるものにします。

コスト

CodeArtifact の料金は主に、保存しているパッケージのストレージ容量、リクエスト数、そしてリージョン外へのデータ転送量に基づきます。同一ドメイン内ではストレージが重複排除されるため、複数リポジトリで同じパッケージを共有してもストレージコストは抑えられます。

コストを抑えるには、不要になったパッケージバージョンを定期的に削除し、外部接続によるキャッシュを活用して重複した取得を避けることが有効です。具体的な単価は変動するため、最新の料金ページで確認してください。

セキュリティ

アクセス制御は IAM ポリシーとリソースベースのポリシーの組み合わせで行います。IAM でプリンシパルごとの権限を定義し、ドメインポリシーやリポジトリポリシーでドメイン・リポジトリ単位の許可やクロスアカウント共有を構成します。最小権限の原則に従い、パッケージの公開と取得の権限を役割ごとに分離するのが望ましい設計です。

保管時の暗号化はカスタマー管理キーを指定でき、鍵の管理やローテーション、アクセスログを統制下に置けます。外部接続を経由したキャッシュにより、信頼できる経路でパブリックパッケージを取り込み、削除や差し替えの影響を抑えられます。VPC からの閉域アクセスが必要な場合は、インターフェース型のプライベート接続を用いることで、インターネットを経由せずにリポジトリへアクセスできます。

Well-Architected の観点

セキュリティの柱では、IAM とリソースポリシーによる最小権限、保管時暗号化、外部接続を経由した信頼できる取り込み、閉域アクセスが中心になります。依存パッケージの取得経路を CodeArtifact に集約することで、ソフトウェアサプライチェーンの統制を高められます。

運用上の優秀性の柱では、上流リポジトリによるキャッシュで依存解決を安定させること、API 証跡による監査性、イベント駆動の自動処理、CI/CD への統合が貢献します。マネージドサービスとしてリポジトリ基盤の運用を AWS に委ねられる点も、運用効率の向上につながります。

試験で問われるポイント

関連サービス・比較

CodeArtifact と比較されやすいのは、コンテナイメージを扱う Amazon ECR です。どちらもソフトウェアの成果物を保存・配布するマネージドなリポジトリですが、CodeArtifact はライブラリ単位のパッケージを、ECR はコンテナイメージを対象とする点が大きく異なります。

ハンズオン / CLI例

# ドメインとリポジトリを作成
aws codeartifact create-domain --domain my-domain
aws codeartifact create-repository \
  --domain my-domain \
  --repository my-repo

# 外部接続を追加してパブリック npm レジストリをキャッシュ
aws codeartifact associate-external-connection \
  --domain my-domain \
  --repository my-repo \
  --external-connection public:npmjs

# npm クライアントをリポジトリ向けに設定（認可トークン取得を含む）
aws codeartifact login \
  --tool npm \
  --domain my-domain \
  --repository my-repo

# 認可トークンを個別に取得して環境変数へ
aws codeartifact get-authorization-token \
  --domain my-domain \
  --query authorizationToken \
  --output text