PublishBuildArtifacts@1 - ビルド成果物 v1 タスクを発行する
ビルド パイプラインでこのタスクを使用して、ビルド成果物を 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.
# 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.
# Publish Build Artifacts v1
# Publish build artifacts to Azure Pipelines/TFS or a 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.
入力
PathtoPublish
- 発行するパス
string
. 必須です。 既定値: $(Build.ArtifactStagingDirectory)
。
発行するフォルダーまたはファイル パスを指定します。 これには、完全修飾パス、またはリポジトリのルートに対する相対パスを指定できます。 ワイルドカードはサポートされていません。 変数がサポートされています。 例: $(Build.ArtifactStagingDirectory)
. 詳細については、「 パイプラインの成果物 - 概要」を参照してください。
ArtifactName
- 成果物名
string
. 必須です。 既定値: drop
。
発行場所に作成する成果物の名前を指定します。 次の特殊文字は使用できません: +
、、 %
、 {
、 }
publishLocation
- 成果物の発行場所
入力エイリアス: ArtifactType
。 string
. 必須です。 使用できる値: Container
(Azure Pipelines)、 FilePath
(ファイル共有)。 既定値: Container
。
成果物を Azure Pipelines (コンテナー) に格納するか、ビルド エージェントからアクセスできる必要があるファイル共有 (FilePath) にコピーするかを指定します。 詳細については、zure Pipelines の成果物に関するページを参照してください。
publishLocation
- 成果物の発行場所
入力エイリアス: ArtifactType
。 string
. 必須です。 使用できる値: Container
(Azure Pipelines/TFS)、 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 エージェントでは、この設定は無視されます。
FileCopyOptions
- ファイルコピーオプション
string
. 省略可能。 の場合は ArtifactType = FilePath
を使用します。
Robocopy コマンドに追加のオプションを渡します。 たとえば、再帰的な minimatch パターン **/*
です。
タスク制御オプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。
出力変数
[なし] :
解説
注意
このコンテンツは 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 以上 |
タスクのカテゴリ | ユーティリティ |
こちらもご覧ください
- ファイル一致パターンのリファレンス
- このタスクを使用して成果物を発行操作方法
- トラブルシューティングに詳細ログを使用する方法について説明します。