PublishBuildArtifacts@1 - Menerbitkan tugas artefak build v1

Gunakan tugas ini dalam alur build untuk menerbitkan artefak build ke Azure Pipelines, TFS, atau berbagi file.

Jika Anda menggunakan Azure DevOps Services, sebaiknya gunakan Unduh Artefak Alur dan Terbitkan Artefak Alur untuk performa yang lebih cepat.

Sintaksis

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

Masukan

jalur PathtoPublish - untuk menerbitkan
string. Dibutuhkan. Nilai default: $(Build.ArtifactStagingDirectory).

Menentukan folder atau jalur file yang akan diterbitkan. Ini bisa menjadi jalur yang sepenuhnya memenuhi syarat atau jalur yang relatif terhadap akar repositori. Kartubebas tidak didukung. Variabel didukung. Contoh: $(Build.ArtifactStagingDirectory). Untuk informasi selengkapnya, lihat Artefak dalam alur - gambaran umum.

nama Artefak ArtifactName -
string. Dibutuhkan. Nilai default: drop.

Menentukan nama artefak yang akan dibuat di lokasi penerbitan. Karakter khusus berikut tidak diizinkan: +, %, {, }

lokasi penerbitan Artefak publishLocation -
Alias input: ArtifactType. string. Dibutuhkan. Nilai yang diizinkan: Container (Azure Pipelines), FilePath (Berbagi file). Nilai default: Container.

Menentukan apakah akan menyimpan artefak di Azure Pipelines (Kontainer), atau menyalinnya ke berbagi file (FilePath) yang harus dapat diakses dari agen build. Alias input: ArtifactType adalah nama alternatif untuk publishLocation dan dapat digunakan secara bergantian. Untuk informasi selengkapnya, lihat Artefak di Azure Pipelines.

Ukuran Artefak Maks MaxArtifactSize -
string. Nilai default: 0.

Batas maksimum ukuran artefak yang akan diterbitkan dalam byte. Masukkan 0 jika Anda tidak ingin menetapkan batas apa pun.

jalur berbagi file TargetPath -
string. Diperlukan saat ArtifactType = FilePath.

Menentukan jalur ke berbagi file tempat Anda ingin menyalin file. Jalur harus merupakan jalur yang sepenuhnya memenuhi syarat atau jalur yang valid relatif terhadap direktori akar repositori Anda. Menerbitkan artefak dari agen Linux atau macOS ke berbagi file tidak didukung. Contoh: \\my\share\$(Build.DefinitionName)\$(Build.BuildNumber).

salinan paralel Parallel -
boolean. Fakultatif. Gunakan saat ArtifactType = FilePath. Nilai default: false.

Menentukan apakah akan menyalin file secara paralel menggunakan beberapa utas untuk throughput potensial yang lebih besar. Jika pengaturan ini tidak diaktifkan, satu utas akan digunakan.

jumlah paralel ParallelCount -
string. Fakultatif. Gunakan saat ArtifactType = FilePath && Parallel = true. Nilai default: 8.

Menentukan tingkat paralelisme (jumlah utas) yang digunakan untuk melakukan salinan. Nilai harus minimal 1 dan tidak lebih besar dari 128. Pilih nilai berdasarkan kemampuan CPU agen build.

StoreAsTar - Tar artefak sebelum mengunggah
boolean. Nilai default: false.

Menambahkan semua file dari jalur penerbitan ke arsip tar sebelum mengunggah. Ini memungkinkan Anda mempertahankan izin file UNIX. Gunakan opsi extractTars DownloadBuildArtifacts untuk mengekstrak item yang diunduh secara otomatis. Pengaturan ini diabaikan pada agen Windows.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat opsi Kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Komentar

Nota

Anda tidak dapat menggunakan Bin, App_Data dan nama folder lain yang dicadangkan oleh IIS sebagai nama Artefak karena konten ini tidak dilayani sebagai respons terhadap permintaan Web. Silakan lihat ASP.NET Struktur Folder Proyek Web untuk detail selengkapnya.

Contoh

steps:
- task: CopyFiles@2
  inputs:
    contents: '_buildOutput/**'
    targetFolder: $(Build.ArtifactStagingDirectory)
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: $(Build.ArtifactStagingDirectory)
    artifactName: MyBuildOutputs

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak
Kemampuan	Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
pembatasan Perintah	Apapun
variabel yang Dapat Diatur	Apapun
Versi agen	1.91.0 atau lebih tinggi
Kategori tugas	Utilitas

Lihat juga

• Referensi pola pencocokan file
• Bagaimana cara menggunakan tugas ini untuk menerbitkan artefak
• Pelajari cara menggunakan log verbose untuk pemecahan masalah .