PublishBuildArtifacts@1 - ビルド成果物 v1 タスクを発行する

ビルド パイプラインでこのタスクを使用して、ビルド成果物を Azure Pipelines、TFS、またはファイル共有に発行します。

Azure DevOps Servicesを使用している場合は、パフォーマンスを向上させるために、パイプライン成果物のダウンロードとパイプライン成果物の発行を使用することをお勧めします。

構文

# 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.

入力

PathtoPublish - 発行するパス
string. 必須です。 既定値: $(Build.ArtifactStagingDirectory)。

発行するフォルダーまたはファイル パスを指定します。 これには、完全修飾パス、またはリポジトリのルートに対する相対パスを指定できます。 ワイルドカードはサポートされていません。 変数がサポートされています。 例: $(Build.ArtifactStagingDirectory). 詳細については、「 パイプラインの成果物 - 概要」を参照してください。

ArtifactName - 成果物名
string. 必須です。 既定値: drop。

発行場所に作成する成果物の名前を指定します。 次の特殊文字は使用できません: +、、 %、 {、 }

publishLocation - 成果物の発行場所
入力エイリアス: ArtifactType。 string. 必須です。 使用できる値: Container (Azure Pipelines)、 FilePath (ファイル共有)。 既定値: Container。

成果物を Azure Pipelines (コンテナー) に格納するか、ビルド エージェントからアクセスできる必要があるファイル共有 (FilePath) にコピーするかを指定します。 詳細については、zure 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 機能に基づいて値を選択します。

StoreAsTar - アップロードする前に成果物をタールする
boolean. 既定値: false。

アップロードする前に、発行パスから tar アーカイブにすべてのファイルを追加します。 これにより、UNIX ファイルのアクセス許可を保持できます。 DownloadBuildArtifacts タスクのオプションを使用してextractTars、ダウンロードしたアイテムを自動的に抽出します。 Windows エージェントでは、この設定は無視されます。

タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

注意

このコンテンツは 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
確認要求	なし
Capabilities	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	Any
設定可能な変数	Any
エージェントのバージョン	1.91.0 以上
タスクのカテゴリ	ユーティリティ

こちらもご覧ください

• ファイル一致パターンのリファレンス
• このタスクを使用して成果物を発行操作方法
• トラブルシューティングに詳細ログを使用する方法について説明します。