TeamCity オンプレミス 2026.1 ヘルプ

ビルドアーティファクトにアクセスするためのパターン

このセクションは、以前の TeamCity バージョンとの下位互換性と特定の機能のために保存されています。

以下の情報も確認してください。

  • ビルド内のアーティファクトにアクセスする必要がある場合は、TeamCity の組み込みアーティファクト依存関係機能の使用を検討してください。

  • Ivy 依存関係マネージャーを使用して TeamCity からアーティファクトをダウンロードすることもできます。

  • 外部の TeamCity ビルドからのアーティファクトのダウンロードには、REST API の使用を検討してください。

  • スクリプトからの HTTP アクセスをカバーする基本ルールについては、HTTP によるサーバーへのアクセスも参照してください。

アーティファクトの取得

最新ビルドのアーティファクトをダウンロードする (最後に終了、成功、ピン留め)、次のパスを使用してください。

/repository/download/BUILD_TYPE_EXT_ID/.lastFinished/ARTIFACT_PATH /repository/download/BUILD_TYPE_EXT_ID/.lastSuccessful/ARTIFACT_PATH /repository/download/BUILD_TYPE_EXT_ID/.lastPinned/ARTIFACT_PATH

ビルド ID でアーティファクトをダウンロードするには、使用:

/repository/download/BUILD_TYPE_EXT_ID/BUILD_ID:id/ARTIFACT_PATH

ビルド番号でアーティファクトをダウンロードするには、使用:

/repository/download/BUILD_TYPE_EXT_ID/BUILD_NUMBER/ARTIFACT_PATH

最新のビルドから特定のタグを付けてアーティファクトをダウンロードするには、使用:

/repository/download/BUILD_TYPE_EXT_ID/BUILD_TAG.tcbuildtag/ARTIFACT_PATH

.zip アーカイブ内のすべてのアーティファクトをダウンロードするには、使用:

/repository/downloadAll/BUILD_TYPE_EXT_ID/BUILD_SPECIFICATION

where

  • BUILD_TYPE_EXT_IDビルド構成 ID です。

  • BUILD_SPECIFICATION は、.lastFinished.lastSuccessful、または .lastPinned、特定の buildNumberBUILD_ID:id 形式のビルド ID にすることができます。

  • ARTIFACT_PATH は、TeamCity サーバー上のアーティファクトへのパスです。このパスには、アーティファクトが取得されるビルドのビルド番号を持つ TeamCity に置き換えられる {build.number} パターン (%7Bbuild.number%7D) を含めることができます。デフォルトでは、すべてのアーティファクトを含むアーカイブには、非表示のアーティファクトは含まれません。含めるには、対応する URL の末尾に ?showAll=true を追加します。
    特定のブランチ内の最後に完了したビルド、最後に成功したビルド、最後にピン留めされたビルド、最後にタグ付けされたビルドからアーティファクトをダウンロードするには、対応する URL の末尾に ?branch=<branch_name> パラメーターを追加します。ブランチパラメーターが指定されていない場合、アーティファクトはデフォルトのブランチ内のビルドからダウンロードされます。

アーカイブからのアーティファクトの取得

TeamCity では、以下の URL パターンを使用して、ビルドアーティファクトディレクトリからアーカイブからファイルを取得できます。

/repository/download/BUILD_TYPE_EXT_ID/BUILD_SPECIFICATION/<archive>!/PATH_WITHIN_ARCHIVE
  • BUILD_TYPE_EXT_ID ビルド構成 ID です。

  • BUILD_SPECIFICATION は、.lastFinished.lastPinned.lastSuccessful、特定の buildNumberBUILD_ID:id 形式のビルド ID にすることができます。

  • PATH_WITHIN_ARCHIVE は、TeamCity サーバー上の zip/7-zip/jar/tar.gz アーカイブ内のファイルへのパスです。次のアーカイブタイプがサポートされています(大文字と小文字は区別されません)。

  • .zip

  • .7z

  • .jar

  • .war

  • .ear

  • .nupkg

  • .sit

  • .apk

  • .tar.gz

  • .tgz

  • .tar.gzip

  • .tar

ビルドスクリプトからアーティファクトを取得する

多くの場合、wget などのツールや HTML ログインページをサポートしていない別のダウンローダーを使用して、ビルド構成のアーティファクトをダウンロードする必要があります。TeamCity は、アーティファクトのリポジトリにアクセスするときに認証を求めます。

ビルドスクリプトからトークンベースの認証を使用して正しく認証するには、HTTP ヘッダー Authorization: Bearer <token-value> で個人アクセストークンを渡す必要があります。

ビルドスクリプトから基本認証を使用して正しく認証するには、URL を変更する必要があります(URL に /httpAuth/ 接頭辞を追加します)。

/httpAuth/repository/download/BUILD_TYPE_EXT_ID/.lastFinished/ARTIFACT_PATH

/httpAuth/ 接頭辞が付いたこれらの URL によってアーティファクトにアクセスするには、基本認証が必要です。

基本認証設定で既存の TeamCity ユーザー名とパスワードを使用できますが、ダウンロードアーティファクトリクエストの資格情報として teamcity.auth.userId/teamcity.auth.password システムプロパティを使用することを検討してください。このようにして、TeamCity は、あるビルドが別のビルドで使用されたアーティファクトを記録し、ビルドの依存関係タブ。

ゲストユーザーログインでアーティファクトをダウンロードできるようにするには、次の方法のいずれかを使用できます。

  • /httpAuth/ 接頭辞を付けずに guest=1 パラメーターを追加した古い URL を使用します。例:

    /repository/download/BUILD_TYPE_EXT_ID/.lastFinished/ARTIFACT_PATH?guest=1
  • guest=1 パラメーターを使用する代わりに、URL に /guestAuth 接頭辞を追加します。例:

    /guestAuth/repository/download/BUILD_TYPE_EXT_ID/.lastFinished/ARTIFACT_PATH

この場合、認証を求められることはありません。アーティファクトのリストは /repository/download/BUILD_TYPE_EXT_ID/.lastFinished/teamcity-ivy.xml にあります。

TeamCity ビルド番号を含むアーティファクトへのリンク

アーティファクトファイル名の現在のビルド番号へのショートカットとして {build.number} (URL の %7Bbuild.number%7D)を使用できます。例:

http://teamcity.yourdomain.com/repository/download/MyConfExtId/.lastFinished/TeamCity-%7Bbuild.number%7D.exe
2025 年 4 月 07 日

関連ページ:

完成したビルドを管理する

この記事では、TeamCity RESTAPI を介して完成したビルドを管理する一般的なユースケースについて説明します。ビルドタグの操作。ビルドの固定と固定解除。アーティファクトとビルドパラメーターの取得。ビルドのラベル付け。ビルドタグの管理:特定のビルドのタグを取得するには、次を使用します。/app/rest/builds/<buildLocator>/tags ここで、は BuildLocator エンティティです。エンドポイントはタグエンティティで応答します。新しいタグを追加するに...

アーティファクトの依存関係

このページでは、あるビルドから別のビルドにファイルを渡すことができる TeamCity アーティファクトの依存関係の構成について詳しく説明します。例: 一般的なデプロイビルド構成は、他の (本番) 構成によって生成されたファイルを公開します。アーティファクトは以下から渡すことができます: 同じビルドチェーン内のターゲット構成の前に実行される構成。ターゲット構成と同じビルドチェーンの一部ではない個別の構成。同じ構成の以前のビルド。Web UI を使用したアーティファクトの依存関係の設定:ビルド構成...

ビルド結果ページ

TeamCity では、ビルドに関するすべての情報 (キューに入っているか、実行中か、完了しているかに関係なく) がビルド結果ページに蓄積されます。ビルド結果を表示するには、任意の構成を選択してビルド履歴を表示し、必要なビルド番号をクリックします。このページには、いくつかの静的タブ(概要、変更、ビルドログ、アーティファクトなど)と、特定の構成機能に応じて表示されるコンテキストタブが含まれています。例: 依存関係タブは、親構成がビルドチェーンに属するビルドに対してのみ表示されます。内部ビルド ID:...

ユーザープロファイルの構成

ユーザープロファイル設定にアクセスするには、ヘッダーのアバターをクリックし、ドロップダウンメニューからプロファイルを選択します。パスワードを変更する:組み込み認証が設定されている場合、TeamCity サーバーはユーザー認証用のパスワードを保持します。プロファイル | 一般 | 組み込み認証でパスワードを変更できます。既存のパスワードと新しいパスワードを入力し、変更を保存をクリックします。パスワードは、組み込みの認証でのみ変更できます。これらのフィールドが表示されない場合は、TeamCity...