ビルド パイプラインでこのタスクを使用して、ビルド成果物を Azure Pipelines、TFS、またはファイル共有に発行します。
Azure DevOps Services を使用している場合は、パフォーマンスを向上させるために、パイプライン 成果物 のダウンロードとパイプライン成果物の発行 の を使用することをお勧めします。
ビルド パイプラインでこのタスクを使用して、ビルド成果物を Azure Pipelines、TFS、またはファイル共有に発行します。
構文
# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
inputs:
PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish ___location. Default: Container.
#MaxArtifactSize: '0' # string. Max Artifact Size. Default: 0.
#TargetPath: # string. Required when ArtifactType = FilePath. File share path.
#Parallel: false # boolean. Optional. Use when ArtifactType = FilePath. Parallel copy. Default: false.
#ParallelCount: '8' # string. Optional. Use when ArtifactType = FilePath && Parallel = true. Parallel count. Default: 8.
# Advanced
#StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.
# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
inputs:
PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish ___location. Default: Container.
#TargetPath: # string. Required when ArtifactType = FilePath. File share path.
#Parallel: false # boolean. Optional. Use when ArtifactType = FilePath. Parallel copy. Default: false.
#ParallelCount: '8' # string. Optional. Use when ArtifactType = FilePath && Parallel = true. Parallel count. Default: 8.
# Advanced
#FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options.
#StoreAsTar: false # boolean. Tar the artifact before uploading. Default: false.
# Publish build artifacts v1
# Publish build artifacts to Azure Pipelines or a Windows file share.
- task: PublishBuildArtifacts@1
inputs:
PathtoPublish: '$(Build.ArtifactStagingDirectory)' # string. Required. Path to publish. Default: $(Build.ArtifactStagingDirectory).
ArtifactName: 'drop' # string. Required. Artifact name. Default: drop.
publishLocation: 'Container' # 'Container' | 'FilePath'. Alias: ArtifactType. Required. Artifact publish ___location. Default: Container.
#TargetPath: # string. Required when ArtifactType = FilePath. File share path.
#Parallel: false # boolean. Optional. Use when ArtifactType = FilePath. Parallel copy. Default: false.
#ParallelCount: '8' # string. Optional. Use when ArtifactType = FilePath && Parallel = true. Parallel count. Default: 8.
# Advanced
#FileCopyOptions: # string. Optional. Use when ArtifactType = FilePath. File copy options.
入力
PathtoPublish
-
発行するパス
string。 必須。 既定値: $(Build.ArtifactStagingDirectory).
発行するフォルダーまたはファイル パスを指定します。 これは、完全修飾パスまたはリポジトリのルートに対する相対パスです。 ワイルドカードはサポートされていません。
変数 がサポートされています。 例: $(Build.ArtifactStagingDirectory)。 詳細については、「パイプラインの成果物の - 概要」を参照してください。
アーティファクト名を ArtifactName - する
string。 必須。 既定値: drop.
発行場所に作成する成果物の名前を指定します。 次の特殊文字は使用できません:+、%、{、}
publishLocation
-
成果物の公開場所
入力エイリアス: ArtifactType。
string。 必須。 使用できる値: Container (Azure Pipelines)、FilePath (ファイル共有)。 既定値: Container.
成果物を Azure Pipelines (コンテナー) に格納するか、ビルド エージェントからアクセスできる必要があるファイル共有 (FilePath) にコピーするかを指定します。 入力エイリアス: ArtifactType は、publishLocation の別名であり、同じ意味で使用できます。 詳細については、「Artifacts in Azure Pipelines」を参照してください。
成果物の最大サイズを MaxArtifactSize - する
string。 既定値: 0.
発行される成果物のサイズの上限 (バイト単位)。 制限を設定しない場合は、0 を入力します。
TargetPath
-
ファイル共有パスの
string。
ArtifactType = FilePathする場合に必要です。
ファイルをコピーするファイル共有へのパスを指定します。 パスは、完全修飾パス、またはリポジトリのルート ディレクトリを基準とした有効なパスである必要があります。 Linux または macOS エージェントからファイル共有への成果物の発行はサポートされていません。 例: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber)。
Parallel
-
並列コピー
boolean。 随意。
ArtifactType = FilePathするときに使用します。 既定値: false.
スループットを向上させるために、複数のスレッドを使用してファイルを並列コピーするかどうかを指定します。 この設定が有効になっていない場合は、1 つのスレッドが使用されます。
ParallelCount
-
並列カウント
string。 随意。
ArtifactType = FilePath && Parallel = trueするときに使用します。 既定値: 8.
コピーの実行に使用される並列処理の次数 (スレッド数) を指定します。 値は少なくとも 1 で、128 より大きくすることはできません。 ビルド エージェントの CPU 機能に基づいて値を選択します。
をアップロードする前に成果物を tar に StoreAsTar - する
boolean。 既定値: false.
アップロードする前に、発行パスのすべてのファイルを tar アーカイブに追加します。 これにより、UNIX ファイルのアクセス許可を保持できます。
extractTars タスクの オプションを使用して、ダウンロードしたアイテムを自動的に抽出します。 Windows エージェントでは、この設定は無視されます。
FileCopyOptions
-
ファイル のコピー オプション
string。 随意。
ArtifactType = FilePathするときに使用します。
Robocopy コマンドに追加のオプションを渡します。 たとえば、再帰的なミニマッチ パターン **/*。
タスク制御オプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。
注釈
注
このコンテンツは Web 要求に応答して提供されないため、IIS によって予約された Bin、App_Data、およびその他のフォルダー名をアーティファクト名として使用することはできません。 詳細については、「ASP.NET Web プロジェクト フォルダー構造の」を参照してください。
例示
steps:
- task: CopyFiles@2
inputs:
contents: '_buildOutput/**'
targetFolder: $(Build.ArtifactStagingDirectory)
- task: PublishBuildArtifacts@1
inputs:
pathToPublish: $(Build.ArtifactStagingDirectory)
artifactName: MyBuildOutputs
必要条件
| 要件 | 説明 |
|---|---|
| パイプラインの種類 | YAML、クラシック ビルド |
| 実行日 | エージェント、DeploymentGroup |
| の需要 | なし |
| 機能の | このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。 |
| コマンドの制限 | どれでも |
| 設定可能な変数 | どれでも |
| エージェントのバージョン | 1.91.0 以上 |
| タスク カテゴリ | 効用 |
こちらもご覧ください
- ファイル一致パターンのリファレンス
- このタスクを使用してアーティファクトを発行する方法
- 詳細ログ を使用して、のトラブルシューティングする方法について説明します。