AWS 認証情報

AWS クレデンシャルビルド機能により、エージェントのビルド内から AWS 接続クレデンシャルにアクセスできるようになります。この機能を使用するには、プロジェクトで少なくとも 1 つの AWS 接続を構成する必要があります。

この機能は、AWS CLI を使用してファイルを S3 バケットにアップロードするビルドに認証情報を提供する必要がある場合、AWS ECS タスクまたは AWS SDK に基づくカスタムコードを実行する必要がある場合に役立ちます。このような場合は、一時的な認証情報を使用することをお勧めします。

ビルドを開始すると、ビルドの AWS 認証情報が別のファイルに保存されます。これは自動的に作成され、ファイルパスは TeamCity によって設定された AWS_SHARED_CREDENTIALS_FILE 環境変数に格納されます。ファイルは現在のビルド中にのみ利用可能で、ビルドが終了すると自動的に削除されます。

設定

オプション	説明
AWS 接続	ドロップダウンメニューリストから AWS 接続を選択します。ビルドで利用可能設定が有効になっている接続のみを選択できます。ターゲット接続が、ビルド構成を設定したプロジェクトではなく、その親プロジェクトによって所有されている場合は、サブプロジェクトで利用可能チェックボックスもオンになっていることを確認してください。
AWS プロファイル名	エージェントマシン上の `AWS_SHARED_CREDENTIALS_FILE` ファイルに保存されている資格情報のどれをビルドステップで使用するかを指定できます。ビルドで `default` プロファイルを使用する場合は、この設定を無視しても構いません。ただし、同じビルド構成に複数の AWS 認証情報ビルド機能を追加する場合は、このプロパティが必須になります。そうでない場合、ビルドは失敗し、ビルドログに「AWS 接続をビルドに挿入できませんでした: AWS プロファイル名が重複しています: default」というエラーが表示されます。
セッション時間	この設定は一時的な資格情報による接続にのみ影響し、ビルドの開始後にこれらの資格情報が有効な期間を定義します。 TeamCity は、このフィールドにデフォルトの 60 分を自動的に入力します。所要時間をご確認ください。一時認証情報の有効期間を延長したい場合は、デフォルト値を変更できます。長いビルドに役立ちます。このビルド機能を使用すると、ビルドごとに新しい一時認証情報が生成されます。

オプション

説明

AWS 接続

ドロップダウンメニューリストから AWS 接続を選択します。

ビルドで利用可能設定が有効になっている接続のみを選択できます。ターゲット接続が、ビルド構成を設定したプロジェクトではなく、その親プロジェクトによって所有されている場合は、サブプロジェクトで利用可能チェックボックスもオンになっていることを確認してください。

AWS プロファイル名

エージェントマシン上の AWS_SHARED_CREDENTIALS_FILE ファイルに保存されている資格情報のどれをビルドステップで使用するかを指定できます。

セッション時間

この設定は一時的な資格情報による接続にのみ影響し、ビルドの開始後にこれらの資格情報が有効な期間を定義します。

TeamCity は、このフィールドにデフォルトの 60 分を自動的に入力します。

所要時間をご確認ください。一時認証情報の有効期間を延長したい場合は、デフォルト値を変更できます。長いビルドに役立ちます。

このビルド機能を使用すると、ビルドごとに新しい一時認証情報が生成されます。

Kotlin DSL

import jetbrains.buildServer.configs.kotlin.*
import jetbrains.buildServer.configs.kotlin.buildFeatures.provideAwsCredentials


object MyBuildConfig : BuildType({
    name = "Build"

    features {
        provideAwsCredentials {
            awsConnectionId = "AwsPrimary"
        }
    }
})

2025 年 9 月 08 日

関連ページ：

ビルド機能を追加する

ビルド機能は、追加の機能を有効にするために任意のビルド構成に追加できる機能です。例: ステータス発行者のコミットビルド機能は、コードファイルを保存する VCS に TeamCity ビルド結果を公開し、調査自動割り当ては最新の変更によってビルドが壊れたユーザーを識別し、これらの問題を解決するタスクを自動的に割り当てます。構成されたビルド機能は、削除することなくいつでも一時的に無効にできます。TeamCity ビルドの特徴：TeamCity には、構成に追加できる次のビルド機能が付属しています。A...

接続を構成

TeamCity 接続は、外部サービスへのアクセスに必要な資格情報を保存します。このサードパーティサービスの種類に基づいて、2 つの主要な接続カテゴリがあります。VCS 接続これらの接続は、GitHub、GitLab、Bitbucket クラウドなどの VCS プロバイダーへのアクセスに必要な情報を保存します。これらの接続は、プロジェクト、ビルド構成、パイプラインを最も速く作成する方法を提供します。認証は自動的に処理されるため、リポジトリを選択するだけでビルドステップの設定を開始できます。接続が...

自動マージ

自動マージビルド機能は、構成されたフィルターに一致するブランチ内のビルドを追跡し、ビルドが構成された条件を満たす場合 (たとえば、ビルドが成功した場合)、指定された宛先ブランチにマージします。VCS サポート：この機能は、Git、Mercurial、Perforce VCS ルートを利用するビルド構成でサポートされています。VCS ルートには、TeamCity が少なくとも 2 つのブランチと連携できるようにするブランチ仕様が必要です。自動マージ設定：ビルド機能を追加する方法については、ビル...