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

アーティファクトルール

ここでは、ダウンロードするソースビルドのアーティファクトと、依存ビルドが開始される前にダウンロードされるエージェント上の場所を指定します。

改行で区切られた一連の規則。各規則は、次の構文を持つ必要があります。

各ルールは、「ソース」ビルドからダウンロードされるファイルを指定します。SourcePath は、「ソース」ビルドのアーティファクトのディレクトリに対する相対パスである必要があります。パスは特定のファイルやディレクトリを識別することも、ワイルドカードを使用して複数のファイルと一致させることもできます。Ant のようなワイルドカードがサポートされています。
ダウンロードされたアーティファクトは、最初の * または ? で始まる「ソース」ディレクトリ構造を保持します。
DestinationPath は、ダウンロードされたアーティファクトが配置されるエージェント上の宛先ディレクトリを指定します。パスが相対パスである場合 (これが推奨されます)、ビルドチェックアウトディレクトリに対して解決されます。必要に応じて、アーティファクトをダウンロードする前に宛先ディレクトリをクリーンアップできます。宛先パスが空の場合、アーティファクトはチェックアウトルートに直接ダウンロードされます。

基本的な例:

• a/b/**=>lib を使用して、ソースビルドの a/b ディレクトリから lib ディレクトリにすべてのファイルをダウンロードします。ソースビルドアーティファクトに a/b/c/file.txt ファイルがある場合は、lib/c/file.txt ファイルにダウンロードされます。

• 同時に、アーティファクト依存関係 **/*.txt=>lib はディレクトリ構造を保存します。ソースビルドアーティファクトからの a/b/c/file.txt ファイルは lib/a/b/c/file.txt にダウンロードされます。

ArchivePath は、ダウンロードした圧縮アーティファクトを抽出するために使用されます。zip、7zip、jar、tar、tar.gz がサポートされています。
ArchivePath は SourcePath の一般的なルールに従います: ant のようなワイルドカードが許可されており、アーカイブ内で一致したファイルは、最初のワイルドカード一致に対応するディレクトリに配置されます（宛先パスを基準に）
たとえば: release.zip!*.dll コマンドは、release.zip アーティファクトのルートにあるすべての .dll ファイルを抽出します。

アーカイブ処理例

• release-*.zip!*.dll=>dlls は、release-*.zip パターンに一致するすべてのアーカイブから *.dll を dlls ディレクトリに抽出します。

• a.zip!**=>destination はパス情報を保存しているアーカイブ全体を解凍します。

• a.zip!a/b/c/**/*.dll=>dlls は、a/b/c プレフィックスなしで、a/b/c およびそのサブディレクトリからすべての .dll ファイルを dlls ディレクトリに抽出します。

+: および -: を使用して、ダウンロードまたは解凍から特定のファイルを含めたり除外したりできます。+: プレフィックスは省略できるため、ルールはデフォルトで包括的であり、少なくとも 1 つの包括的ルールが必要です。ルールの順序は重要ではありません。アーティファクトごとに、最も具体的なルール（最初のワイルドカードシンボルの前にプレフィックスが最も長いルール）が適用されます。ファイルを除外する場合、DestinationPath は無視されます。ファイルはまったくダウンロードされません。ファイルは、アーカイブの解凍から除外することもできます。アーカイブコンテンツに適用されるルールのセットは、アーカイブ自体と一致するルールのセットによって決定されます。

独占パターンの例:

• **/*.txt=>texts
-:bad/exclude.txt は、bad ディレクトリの exclude.txt を除く、すべてのディレクトリからすべての *.txt ファイルをダウンロードします。

• +:release-*.zip!**/*.dll=>dlls -:release-0.0.1.zip!Bad.dll すべての *.dll ファイルを release-*.zip ファイルから *.dll のディレクトリにダウンロードして解凍します。release-0.0.1.zip の Bad.dll ファイルはスキップされます

• **/*.*=>target
-:excl/**/*.*
+:excl/must_have.txt=>target すべてのアーティファクトを target ディレクトリにダウンロードします。excl ディレクトリからは何もダウンロードされませんが、must_have.txt というファイルがダウンロードされます

.teamcity ディレクトリに配置されたアーティファクトは、非表示とみなされます。これらのアーティファクトは、デフォルトではワイルドカードによって無視されます。
何らかの目的で .teamcity ディレクトリのファイルを含める場合は、必ず .teamcity で始まるアーティファクトパスを明示的に追加してください。

非表示のアーティファクトにアクセスする例

• .teamcity/properties/*.properties

• .teamcity/*.*

デフォルトでは、アーティファクトの依存関係をエージェントの作業ディレクトリにダウンロードすることは許可されていますが、エージェントのホームディレクトリは禁止されています。デフォルトをオーバーライドするには、 buildAgent.properties でコンマ区切りのパス ( teamcity.artifactDependenciesResolution.bannedList および teamcity.artifactDependenciesResolution.allowedList) を指定して、アーティファクトをダウンロードするカスタムルールを設定します。禁止リストにパスを追加すると、許可リストに存在しない限り、このディレクトリへのアーティファクトのダウンロードが禁止されます。

アーティファクトの依存関係のためのスペースの自動割り当て

TeamCity は、アーティファクトのサイズに基づいて、アーティファクトの依存関係を解決するためにディスク領域を自動的に解放します。手動で構成する必要はありません。