TeamCity On-Premises 2026.2 Help

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

このセクションは、以前の 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

  • ビルドタイプ外部 ID は ビルド構成 ID です。

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

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

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

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

/repository/download/BUILD_TYPE_EXT_ID/BUILD_SPECIFICATION/<archive>!/PATH_WITHIN_ARCHIVE

  • ビルドタイプ外部 ID は ビルド構成 ID です。

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

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

  • .zip

  • .7z

  • .jar

  • .war

  • .ear

  • .nupkg

  • .snupkg

  • .sit

  • .apk

  • .tar.gz

  • .tgz

  • .tar.gzip

  • .tar.zst

  • .tzst

  • .tar

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

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

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

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

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

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

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

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

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

    /repository/download/BUILD_TYPE_EXT_ID/.lastFinished/ARTIFACT_PATH?guest=1

  • guest=1 パラメーターを使用する代わりに、URL に /ゲスト認証 接頭辞を追加します。 例:

    /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
2026 年 9 月 11 日
エンティティ ID要件条件