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 - Artifact publish location
入力エイリアス: 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 エージェントでは、この設定は無視されます。

タスク制御オプション

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

出力変数

なし。

注釈

注

このコンテンツは 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 以上
タスク カテゴリ	効用

こちらもご覧ください

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