Amazon S3 および S3 互換ストレージ

TeamCity には、Amazon S3 Artifact Storage プラグインがバンドルされており、これにより、ビルドアーティファクトを Amazon S3 バケットや MinIO(英語)、バックブレイズ B2(英語) などの S3 互換バケットに保存できます。S3 互換ストレージは、AWS 環境と AWS 以外の環境の両方でホストできます。

新しい AWS S3 ストレージを作成してセットアップする

「管理 | <あなたのプロジェクト>」ページに移動し、「アーティファクトストレージ」タブに切り替えます。
- 新しいストレージをすべての TeamCity プロジェクトで使用できるようにする場合は、<ルートプロジェクト> の設定を開きます。
- 新しいストレージをこのプロジェクトとそのサブプロジェクトでのみ使用できるようにする場合は、特定のプロジェクトを 1 つ編集します。
組み込みの TeamCity アーティファクトストレージはデフォルトで表示され、アクティブとしてマークされます。新しいストレージを追加ボタンをクリックして新しいストレージを作成します。
カスタムストレージ名を指定し、必要に応じて内部で使用される ID を指定します。
タイプフィールドを「AWS S3」に設定します。
TeamCity が Amazon リソースにアクセスするために使用する既存の AWS 接続を選択します。適切な AWS 接続が存在しない場合は、「+」アイコンをクリックして追加します。
親プロジェクトに属し、サブプロジェクトで利用可能設定が無効になっている AWS 接続は使用できません。
ただし、親プロジェクトに非共有接続を使用して構成された S3 ストレージがある場合、このストレージは子プロジェクトで引き続き使用できます。
選択した AWS 接続が S3 バケットにアクセスするために使用する認証情報 (またはそれが想定する IAM ロール) を持つユーザーには、次の権限が必要です。
- ListAllMyBuckets
- GetBucketLocation
- GetObject
- ListBucket
- PutObject
- DeleteObject
- GetAccelerateConfiguration ( 転送加速が有効な場合)
以前の TeamCity バージョンでは、アーティファクトストレージダイアログで接続設定 (アクセスキー認証情報、ユーザー IAM ロール、TeamCity がデフォルトの AWS の場所 ( デフォルトのプロバイダーチェーン設定) で認証情報を検索するかどうか) を明示的に指定できました。
バージョン 2023.11 以降、これらの設定は AWS 接続専用です。TeamCity の古いバージョンから移行しており、既存の AWS S3 ストレージでこれらの設定のいずれかを使用している場合は、AWS 接続に変換リンクをクリックします。このアクションにより、AWS 関連の設定が新しい AWS 接続に転送され、この新しい接続がストレージのソース接続として選択されます。
TeamCity は、選択された AWS 接続を使用して、利用可能な S3 バケットのリストを取得します。バケットドロップダウンメニューを開いて、リストから特定の項目を選択します。

(オプション) すべての TeamCity プロジェクトに同じ S3 バケットを使用し、接頭辞ベースの権限を構成する場合は、パス接頭辞(英語)を指定します。
Amazon S3 バケットは、ファイルのアップロードとダウンロードを高速化する 2 つのオプションをサポートしています。
- AWS クラウドフロント(英語) — TeamCity が近くの低レイテンシ CloudFront サーバーを使用してアリファクトを転送できるようにするコンテンツ配信ネットワーク (CDN)。
- 転送加速(英語) — 世界中から一元化された S3 バケットへの転送速度を最適化するように設計されたバケットレベルの機能。これにより、クライアントと S3 バケット間の長距離にわたるファイルの高速、簡単、安全な転送が可能になります。
バケットが Transfer Acceleration または CloudFront を使用するように構成されている場合は、転送速度の向上セクションで対応するオプションを選択します。それ以外の場合、TeamCity が通常モードでファイルを転送する場合は、なしタイプを選択します。
AWS クラウドフロントオプションを選択するには、追加のフィールドを設定する必要があります。詳細については、このセクションを参照してください: CloudFront を介したアーティファクトの転送。
Transfer Acceleration を使用すると、次の制限が適用されます。
- S3 バケットで Transfer Acceleration を有効にする必要があります。
- バケット名前にドット (.) を含めることはできません(英語)。
- AWS 接続がバケットにアクセスするために使用するユーザー認証情報または IAM ロールには、GetAccelerateConfiguration 権限が含まれている必要があります。

ストレージへの大きなファイルのアップロード(英語)を最適化するには、マルチパートアップロード(英語)を有効にします。これを行うには、しきい値とパーツサイズをカスタマイズする設定にチェックを入れて、マルチパートアップロードのしきい値を設定します。許可される最小値は 5MB です。サポートされている接尾辞: KB、MB、GB、TB このフィールドを空のままにすると、8 MB を超えるすべてのファイルに対してマルチパートアップロードが自動的に開始されます (8MB がデフォルト値です)。
さらに、アップロードされた各ファイルパーツの最大許容サイズを構成できます。最小値は 5MB です。空のままにすると、TeamCity はデフォルト値として 8MB を使用します。
マルチパートのアップロードが不完全にならないように、バケットライフサイクルポリシー(英語)を構成することをお勧めします。

アップロード後にファイルの整合性を確認するにチェックを入れると、TeamCity が追加のアップロードされたファイルのチェックアップ(英語)を実行できるようになります。整合性検証が失敗した場合、TeamCity は対応するメッセージをビルドログに書き込みます。
保存をクリックして新しいストレージを保存し、使用可能なストレージのリストに戻ります。

プロジェクトで使用可能なストレージのリストを表示しているときに、アクティブにするをクリックして、このプロジェクトのすべての新しいビルドに対して対応するストレージの使用を開始します。「N 個の使用状況」リンクでは、アーティファクトをアップロードするためにこのストレージを使用したビルドを表示できます。

新しい S3 互換ストレージの作成とセットアップ

「管理 | <あなたのプロジェクト>」ページに移動し、「アーティファクトストレージ」タブに切り替えます。
- 新しいストレージをすべての TeamCity プロジェクトで使用できるようにする場合は、<ルートプロジェクト> の設定を開きます。
- 新しいストレージをこのプロジェクトとそのサブプロジェクトでのみ使用できるようにする場合は、特定のプロジェクトを 1 つ編集します。
組み込みの TeamCity アーティファクトストレージはデフォルトで表示され、アクティブとしてマークされます。新しいストレージを追加ボタンをクリックして新しいストレージを作成します。
カスタムストレージ名を指定し、必要に応じて内部で使用される ID を指定します。
タイプフィールドを「カスタム S3」に設定します。
アクセスキー ID 値と秘密アクセスキー値を指定します。アクセスキーの発行方法については、S3 互換ストレージベンダーのドキュメントを参照してください。
TeamCity がバケットへのアクセスに使用するストレージエンドポイントを指定します。
(オプション) すべての TeamCity プロジェクトに同じ S3 バケットを使用し、接頭辞ベースの権限を構成する場合は、パス接頭辞(英語)を指定します。
ストレージへの大きなファイルのアップロード(英語)を最適化するには、マルチパートアップロード(英語)を有効にします。これを行うには、しきい値とパーツサイズをカスタマイズする設定にチェックを入れて、マルチパートアップロードのしきい値を設定します。許可される最小値は 5MB です。サポートされている接尾辞: KB、MB、GB、TB このフィールドを空のままにすると、8 MB を超えるすべてのファイルに対してマルチパートアップロードが自動的に開始されます (8MB がデフォルト値です)。
さらに、アップロードされた各ファイルパーツの最大許容サイズを構成できます。最小値は 5MB です。空のままにすると、TeamCity はデフォルト値として 8MB を使用します。
アップロード後にファイルの整合性を確認するにチェックを入れると、TeamCity が追加のアップロードされたファイルのチェックアップ(英語)を実行できるようになります。整合性検証が失敗した場合、TeamCity は対応するメッセージをビルドログに書き込みます。
保存をクリックして新しいストレージを保存し、使用可能なストレージのリストに戻ります。

S3 ストレージクラス

Amazon S3 ストレージクラス(英語)を使用すると、必要なパフォーマンス、データの可用性と復元力に基づいてストレージを微調整できます。

必要なストレージクラスを有効にするには、次の 2 つの方法があります。

TeamCity 側。S3 バケットにアーティファクトをアップロードする場合、TeamCity は PUT リクエストに x-amz-storage-class ヘッダーを追加します。ヘッダーの値は、TeamCity の対応するストレージ設定 (例: x-amz-storage-class: INTELLIGENT_TIERING) によって異なります。このモードでは、AWS 側で追加の設定は必要ありません。
このアプローチは現在サポートされていませんが、今後のリリースサイクルでこの機能を実装したいと考えています。この機能をサポートし、フィードバックを共有するには、この YouTrack チケットに賛成票を投じ、コメントしてください: TW-79992(英語)。
AWS 側。このモードでは、TeamCity は定期的にアーティファクトをアップロードし、アーティファクトがアップロードされた後、事前構成されたライフサイクルルールによって必要なストレージクラスが適用されます。このルールを設定するには、次の手順を実行します。
1. 必要な S3 ストレージを開き、管理タブに切り替えます。
2. ライフサイクルルールを作成するをクリックします。
3. ライフサイクルルールアクションセクションのストレージクラス間でオブジェクトの現在のバージョンを移動するを確認します。
4. 必要なストレージクラスと、アップロード日と移行日の間の遅延を選択します。オブジェクト作成後の日数を「0」に設定すると、TeamCity がアーティファクトをアップロードするとすぐに移行されます。
  TeamCity はアーカイブストレージクラスをサポートしていません。アーカイブストレージクラスのファイルはすぐには利用できず、取得する前に追加の解凍 / ウォームアップアクションが必要になるためです。
5. 保存されたアーティファクトの追加ルールを有効にします。例: オブジェクトの現在のバージョンを期限切れにするをチェックすると、以前にアップロードされたアーティファクトに期限切れのラベルを付けることができ、オブジェクトの非現在のバージョンを完全に削除するをチェックすると、ストレージを定期的にクリーンアップできます。
6. ルールのスコープを指定して、ストレージ全体に適用するか、必要なフィルターに一致するアーティファクトのみに適用するかを選択します。
7. ページの下部にあるルールを確認します。次のようになります。
8. ライフサイクルルールを保存するには、ルールを作成をクリックします。

詳細については、次の AWS ヘルプ記事を参照してください: Amazon S3 ストレージクラスの使用(英語)。

CloudFront を介したアーティファクトの転送

Amazon CloudFront(英語) は、低遅延と高速転送を提供するコンテンツ配信ネットワークです。S3 ストレージのサポートを有効にすると、TeamCity は最も近い CloudFront サーバーを介してアーティファクトを転送できるようになります。S3 バケットが TeamCity インフラストラクチャとは異なるリージョンにある場合、これによりアーティファクトのアップロード / ダウンロードが大幅に高速化され、費用が削減される可能性があります。

前提条件

TeamCity は CloudFront 統合をセットアップすることも、すべての設定を手動でセットアップすることもできます。

CloudFront 統合には、以下を設定する必要があります。

OAI(英語) ユーザー
2 つの CloudFront ディストリビューション(英語)、1 つはアーティファクトのアップロードとダウンロード用。
信頼できるキーグループ (英語)
PEM 形式の SSH-2RSA キーペア(英語)（公開鍵 + 秘密鍵）

CloudFront 設定

ストレージタイプを AWS クラウドフロントに切り替えると、4 つの新しい設定が表示されます。

手動で作成されたディストリビューションを選択するには、ダウンロードディストリビューションおよびアップロード配信ドロップダウンメニューを使用します。
公開鍵フィールドと秘密鍵をアップロード ... ボタンを使用すると、対応するキーを指定できます。

あるいは、アイコンをクリックして、TeamCity に 4 つの設定すべてを自動的に構成させることもできます。

Cloudfront 設定が適切に機能するには、TeamCity に次の権限が必要です。

クラウドフロント: ListDistributions
cloudfront:ListKeyGroups
cloudfront:ListPublicKeys

CloudFront の自動セットアップ

TeamCity は設定を自動的に構成できます。これには以下が含まれます。

キーペアを生成し、公開鍵を CloudFront にアップロードします。
CloudFront で新しいキーグループを作成します。
次の方法で 2 つの新しいディストリビューションを作成します。
- すべてのエッジ位置を使用価格クラス。
- 現在のバケットにアクセスできる新しいオリジンアクセス ID(英語)。
- 定義するデフォルトの動作
  - アーティファクトをアップロードするために許可された HTTP メソッド: GET、HEAD、OPTIONS、PUT、POST、PATCH、DELETE、ダウンロード用: GET、HEAD、OPTIONS ;
  - ビューアーアクセス権を持つ新しいキーグループ(英語)。
  - すべてのクエリ文字列を渡すことができるカスタムキャッシュポリシー(英語)。
S3 バケットに新しいポリシーを追加して、新しいディストリビューションがそれにアクセスできるようにします。ポリシーの例を参照してください。

自動セットアップでは、Teamcity に追加のアクセス許可を与える必要があります。

クラウドフロント: CreateDistribution
クラウドフロント: CreateKeyGroup
cloudfront:CreatePublicKey
cloudfront:CreateOriginRequestPolicy
cloudfront:CreateCloudFrontOriginAccessIdentity
クラウドフロント: CreateCachePolicy
cloudfront:DeleteKeyGroup
cloudfront:DeletePublicKey
cloudfront:ListCloudFrontOriginAccessIdentities
cloudfront:ListCachePolicies
cloudfront:ListOriginRequestPolicies
クラウドフロント: GetDistribution
クラウドフロント: GetPublicKey
s3:GetBucketPolicy
s3:PutBucketPolicy

必要なすべてのアクセス許可を提供するポリシーの例:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "1",
            "Effect": "Allow",
            "Action": [
                "cloudfront:CreatePublicKey",
                "cloudfront:CreateOriginRequestPolicy",
                "cloudfront:ListCloudFrontOriginAccessIdentities",
                "cloudfront:DeleteKeyGroup",
                "cloudfront:GetPublicKey",
                "cloudfront:ListCachePolicies",
                "cloudfront:CreateDistribution",
                "cloudfront:ListOriginRequestPolicies",
                "cloudfront:DeletePublicKey",
                "cloudfront:CreateCloudFrontOriginAccessIdentity",
                "cloudfront:CreateKeyGroup",
                "cloudfront:CreateCachePolicy",
                "cloudfront:GetDistribution",
                "cloudfront:ListPublicKeys",
                "s3:ListAllMyBuckets",
                "cloudfront:ListKeyGroups",
                "cloudfront:ListDistributions"
            ],
            "Resource": "*"
        },
        {
            "Sid": "2",
            "Effect": "Allow",
            "Action": [
                "s3:PutBucketPolicy",
                "s3:GetBucketPolicy"
            ],
            "Resource": "arn:aws:s3:::<YOUR_BUCKET_NAME>"
        }
    ]
}

CloudFront の手動セットアップ

セキュリティ上の理由から、アーティファクトのアップロードとダウンロード用に 2 つの別々のディストリビューションを構成することをお勧めします。ディストリビューションごとに:

SSH-2RSA キー形式(英語)でキーペアを生成します。
ペアから CloudFront に公開鍵をアップロードします。
CloudFront で新しいキーグループを追加する(英語)を実行し、作成した公開鍵をこのグループに追加します。
キャッシュキー設定 | クエリ文字列をすべてに設定して新しいキャッシュポリシーを作成します。
プライベートバケットを使用する場合は、新しい OAI(英語) ユーザーを作成します。
ディストリビューションを作成する(英語)とそれにキーグループを添付します。
- TeamCity で指定されているものと同じ S3 バケットを選択してください。
- アーティファクトをアップロードするための許可された HTTP メソッド GET、HEAD、OPTIONS、PUT、POST、PATCH、DELETE; GET、HEAD、OPTIONS をダウンロードするため
- ビューアーのアクセスを制限する : はい
- 信頼できる認証タイプ : 信頼できるキーグループ
- キーとオリジンのリクエストをキャッシュする : キャッシュポリシーとオリジンリクエストポリシー
- プライベートバケットの場合は、OAI の使用オプションを有効にし、次の設定で OAI を構成します。
  - バケットポリシー : いいえ、バケットポリシーを更新します
- パブリックバケットの場合、パブリックアクセスをブロックするオプションを無効にします。
新しいポリシーを追加する(英語)を S3 バケットに追加します。ポリシーの例を参照してください。

設定すると、ディストリビューションはダウンロードディストリビューションおよびアップロード配信ドロップダウンメニューに自動的に表示されます。

ターゲットの CloudFront ディストリビューションを選択します。
公開鍵で、このディストリビューションに関連付けられている公開鍵を選択します。
秘密鍵をアップロード ... ボタンをクリックして、ペアから秘密鍵をアップロードします。
ストレージ設定を保存します。

S3 ポリシーの例

OAI を使用してプライベートバケットにアクセスするには:

{
"Sid": "1",
"Effect": "Allow",
"Principal": {
      "AWS": "arn:aws:iam::cloudfront:user/CloudFront Origin Access Identity <OAI ID"
  },
  "Action": [
      "s3:GetObject",
      "s3:PutObject",
      "s3:DeleteObject"
  ],
  "Resource": "arn:aws:s3:::<S3 bucket name/*"
}

パブリックバケットにアクセスする場合:

{
"Sid": "PublicRead",
"Effect": "Allow",
"Principal": "*",
  "Action": [
        "s3:GetObject",
        "s3:GetObjectVersion"
    ],
  "Resource": "arn:aws:s3::<BUCKET_NAME>/*"
}

Kotlin DSL

次のサンプルは、S3 バケットをプロジェクトアーティファクトのカスタムストレージとして追加し、このストレージをプライマリ (デフォルト) として設定する方法を示しています。

import jetbrains.buildServer.configs.kotlin.*
import jetbrains.buildServer.configs.kotlin.projectFeatures.activeStorage
import jetbrains.buildServer.configs.kotlin.projectFeatures.s3Storage

project {
    // ...
    features {
        activeStorage {
            id = "PROJECT_EXT_37"
            activeStorageID = "PROJECT_EXT_4"
        }
        s3Storage {
            id = "PROJECT_EXT_4"
            awsEnvironment = default {
                awsRegionName = "eu-west-1"
            }
            connectionId = "AwsPrimary"
            storageName = "S3 Transfer Acceleration"
            bucketName = "dk-s3ta"
            enableTransferAcceleration = true
            forceVirtualHostAddressing = true
            verifyIntegrityAfterUpload = true
        }
    }
    // ...
}

アーティファクトを別のストレージに移行する

TeamCity サーバーには、ビルドアーティファクトを 1 つのストレージから別のストレージに転送するコマンドラインツールが付属しています。このツールは、プロジェクト設定 |Artifacts Storage ページからダウンロードできます。

現在、このツールは次の移行ルートをサポートしています。

ローカルディレクトリから Amazon S3 バケットへ、またはその逆
ある Amazon S3 バケットから別のバケット
へ

他のクラウドストレージオプションのサポートにも取り組んでいます。

詳細: アーティファクト移行ツール。

2026 年 5 月 06 日

TeamCity オンプレミス 2026.1 ヘルプ