UniversalPackages@0 - Tugas paket universal v0

Gunakan tugas ini untuk mengunduh, atau mengemas dan menerbitkan Paket Universal.

Sintaks

# Universal packages v0
# Download or publish Universal Packages.
- task: UniversalPackages@0
  inputs:
    command: 'download' # 'download' | 'publish'. Required. Command. Default: download.
    downloadDirectory: '$(System.DefaultWorkingDirectory)' # string. Required when command = download. Destination directory. Default: $(System.DefaultWorkingDirectory).
    #publishDirectory: '$(Build.ArtifactStagingDirectory)' # string. Required when command = publish. Path to file(s) to publish. Default: $(Build.ArtifactStagingDirectory).
  # Feed & package details
    feedsToUse: 'internal' # 'internal' | 'external'. Alias: internalOrExternalDownload. Required when command = download. Feed location. Default: internal.
    #externalFeedCredentials: # string. Alias: externalEndpoint. Optional. Use when internalOrExternalDownload = external && command = download. organization/collection connection. 
    #vstsFeed: # string. Alias: feedListDownload. Required when internalOrExternalDownload = internal && command = download. Feed. 
    #vstsFeedPackage: # string. Alias: packageListDownload. Required when internalOrExternalDownload = internal && command = download. Package name. 
    #vstsPackageVersion: # string. Alias: versionListDownload. Required when internalOrExternalDownload = internal && command = download. Version. 
    #feedDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Feed (or Project/Feed if the feed was created in a project). 
    #packageDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Package name. 
    #versionDownloadExternal: # string. Required when internalOrExternalDownload = external && command = download. Version. 
  # Feed & package details
    #feedsToUsePublish: 'internal' # 'internal' | 'external'. Alias: internalOrExternalPublish. Required when command = publish. Feed location. Default: internal.
    #publishFeedCredentials: # string. Alias: externalEndpoints. Required when internalOrExternalPublish = external && command = publish. organization/collection connection. 
    #vstsFeedPublish: # string. Alias: feedListPublish. Required when internalOrExternalPublish = internal && command = publish. Destination Feed. 
    #vstsFeedPackagePublish: # string. Alias: packageListPublish. Required when internalOrExternalPublish = internal && command = publish. Package name. 
    #feedPublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Feed (or Project/Feed if the feed was created in a project). 
    #packagePublishExternal: # string. Required when internalOrExternalPublish = external && command = publish. Package name. 
    #versionOption: 'patch' # 'major' | 'minor' | 'patch' | 'custom'. Alias: versionPublishSelector. Required when command = publish. Version. Default: patch.
    #versionPublish: # string. Required when versionPublishSelector = custom && command = publish. Custom version. 
    #packagePublishDescription: # string. Optional. Use when command = publish. Description. 
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = publish && internalOrExternalPublish = internal. Publish pipeline metadata. Default: true.
    #verbosity: 'None' # 'None' | 'Trace' | 'Debug' | 'Information' | 'Warning' | 'Error' | 'Critical'. Verbosity. Default: None.
  # Output
    #publishedPackageVar: # string. Optional. Use when command = publish. Package Output Variable.

Input

command - Perintah
string. Wajib diisi. Nilai yang diizinkan: download, publish. Nilai default: download.

Menentukan perintah NuGet untuk dijalankan.

downloadDirectory - Direktori tujuan
string. Diperlukan saat command = download. Nilai default: $(System.DefaultWorkingDirectory).

Menentukan jalur folder tempat tugas mengunduh konten paket.

feedsToUse - Lokasi umpan
Alias input: internalOrExternalDownload. string. Diperlukan saat command = download. Nilai yang diizinkan: internal (Organisasi/koleksi ini), external (Organisasi/koleksi lain). Nilai default: internal.

Menentukan umpan dari koleksi ini atau koleksi lain di Azure Artifacts.

externalFeedCredentials - koneksi organisasi/pengumpulan
Alias input: externalEndpoint. string. Pilihan. Gunakan saat internalOrExternalDownload = external && command = download.

Menentukan kredensial yang akan digunakan untuk registri eksternal yang terletak di yang dipilih NuGet.config. Untuk umpan dalam organisasi atau koleksi ini, biarkan kosong ini; kredensial build digunakan secara otomatis.

vstsFeed - Feed
Alias input: feedListDownload. string. Diperlukan saat internalOrExternalDownload = internal && command = download.

Menyertakan umpan yang dipilih. Anda harus menginstal dan melisensikan Artefak Azure untuk memilih umpan di sini. Menentukan FeedName untuk umpan yang dilingkup organisasi dan projectName/FeedName atau ProjectID/FeedID untuk umpan yang dilingkup proyek.

vstsFeedPackage - Nama paket
Alias input: packageListDownload. string. Diperlukan saat internalOrExternalDownload = internal && command = download.

Menentukan nama paket untuk diunduh oleh tugas.

vstsPackageVersion - Versi
Alias input: versionListDownload. string. Diperlukan saat internalOrExternalDownload = internal && command = download.

Menentukan versi paket atau menggunakan variabel yang berisi versi untuk diunduh. Entri ini juga bisa menjadi ekspresi kartubebas, seperti *, untuk mendapatkan versi tertinggi. Contoh: 1.* mendapatkan versi tertinggi dengan versi utama 1, dan 1.2.* mendapatkan rilis patch tertinggi dengan versi utama 1 dan minor versi 2.

feedDownloadExternal - Umpan (atau Proyek/Umpan jika umpan dibuat dalam proyek)
string. Diperlukan saat internalOrExternalDownload = external && command = download.

Menentukan umpan di organisasi/koleksi lain.

Untuk umpan yang dilingkup proyek, nilainya harus Project/Feed, di mana Project adalah nama atau ID proyek, dan Feed merupakan nama/ID umpan. Untuk umpan yang dilingkup organisasi, nilainya harus hanya nama umpan.

packageDownloadExternal - Nama paket
string. Diperlukan saat internalOrExternalDownload = external && command = download.

Menentukan nama paket yang akan diunduh.

versionDownloadExternal - Versi
string. Diperlukan saat internalOrExternalDownload = external && command = download.

Menentukan versi paket atau menggunakan variabel yang berisi versi untuk diunduh. Entri ini juga bisa menjadi ekspresi kartubebas, seperti *, untuk mendapatkan versi tertinggi. Contoh: 1.* mendapatkan versi tertinggi dengan versi utama 1, dan 1.2.* mendapatkan rilis patch tertinggi dengan versi utama 1 dan minor versi 2. Pola wildcard tidak didukung dengan paket pra-rilis.

publishDirectory - Jalur ke file yang akan diterbitkan
string. Diperlukan saat command = publish. Nilai default: $(Build.ArtifactStagingDirectory).

Menentukan jalur ke daftar file yang akan diterbitkan.

feedsToUsePublish - Lokasi umpan
Alias input: internalOrExternalPublish. string. Diperlukan saat command = publish. Nilai yang diizinkan: internal (Organisasi/koleksi ini), external (Organisasi/koleksi lain). Nilai default: internal.

Menentukan umpan dari koleksi ini atau koleksi lain di Azure Artifacts.

publishFeedCredentials - koneksi organisasi/pengumpulan
Alias input: externalEndpoints. string. Diperlukan saat internalOrExternalPublish = external && command = publish.

Menentukan kredensial yang akan digunakan untuk umpan eksternal.

vstsFeedPublish - Umpan Tujuan
Alias input: feedListPublish. string. Diperlukan saat internalOrExternalPublish = internal && command = publish.

Menentukan proyek dan nama umpan/GUID untuk diterbitkan.

publishPackageMetadata - Menerbitkan metadata alur
boolean. Pilihan. Gunakan saat command = publish && internalOrExternalPublish = internal. Nilai default: true.

Mengaitkan metadata alur build/rilis ini (seperti jalankan # dan informasi kode sumber) dengan paket .

vstsFeedPackagePublish - Nama paket
Alias input: packageListPublish. string. Diperlukan saat internalOrExternalPublish = internal && command = publish.

Menentukan ID paket untuk menerbitkan atau membuat ID paket baru jika Anda belum pernah menerbitkan versi paket ini sebelumnya. Nama paket harus huruf kecil dan hanya dapat menggunakan huruf, angka, dan tanda hubung (-).

feedPublishExternal - Umpan (atau Proyek/Umpan jika umpan dibuat dalam proyek)
string. Diperlukan saat internalOrExternalPublish = external && command = publish.

Menentukan nama umpan eksternal yang akan diterbitkan.

Jika umpan dibuat dalam proyek, nilainya harus Project/Feed, di mana Project adalah nama atau ID proyek, dan Feed merupakan nama umpan. Jika umpan tidak dibuat dalam proyek, nilainya seharusnya hanya nama umpan.

packagePublishExternal - Nama paket
string. Diperlukan saat internalOrExternalPublish = external && command = publish.

Menentukan nama paket ketika menerbitkan ke umpan eksternal.

versionOption - Versi
Alias input: versionPublishSelector. string. Diperlukan saat command = publish. Nilai yang diizinkan: major (Utama berikutnya), minor (Minor berikutnya), patch (Patch berikutnya), custom. Nilai default: patch.

Menentukan strategi kenaikan versi. Nilai custom untuk memasukkan versi paket Anda secara manual. Untuk paket baru, versi pertama akan menjadi 1.0.0 jika Anda menentukan major, 0.1.0 jika Anda menentukan minor, atau 0.0.1 jika Anda menentukan patch. Lihat spesifikasi Penerapan Versi Semantik untuk informasi selengkapnya.

versionPublish - Versi kustom
string. Diperlukan saat versionPublishSelector = custom && command = publish.

Menentukan skema versi kustom untuk paket.

packagePublishDescription - Deskripsi
string. Pilihan. Gunakan saat command = publish.

Menentukan deskripsi isi paket dan/atau perubahan yang dibuat dalam versi paket ini.

verbosity - Verbositas
string. Nilai yang diizinkan: None, , DebugTrace, Information, Warning, Error, Critical. Nilai default: None.

Menentukan jumlah detail yang ditampilkan dalam output.

publishedPackageVar - Variabel Output Paket
string. Pilihan. Gunakan saat command = publish.

Menentukan nama untuk variabel yang akan berisi nama dan versi paket yang diterbitkan.

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.

Keterangan

Gunakan tugas ini untuk mengunduh, atau mengemas dan menerbitkan Paket Universal.

Alur Saya perlu mengakses umpan dalam proyek yang berbeda

Jika alur berjalan dalam proyek yang berbeda dari proyek yang menghosting umpan, Anda harus menyiapkan proyek lain untuk memberikan akses baca/tulis ke layanan build. Lihat Izin paket di Azure Pipelines untuk detail selengkapnya.

Contoh

Cara paling sederhana untuk memulai tugas Paket Universal adalah dengan menggunakan editor tugas Alur untuk menghasilkan YAML. Anda kemudian dapat menyalin kode yang dihasilkan ke dalam file proyek azure-pipelines.yml Anda. Dalam contoh ini, sampel menunjukkan cara menghasilkan YAML dengan cepat menggunakan alur yang membangun aplikasi web progresif (PWA) GatsbyJS.

Paket Universal adalah cara yang berguna untuk merangkum dan membuat versi aplikasi web. Mengemas aplikasi web ke dalam Paket Universal memungkinkan pemutaran kembali cepat ke versi tertentu dari situs Anda dan menghilangkan kebutuhan untuk membangun situs dalam alur penyebaran.

Contoh alur ini menunjukkan cara mengambil alat dari umpan dalam proyek Anda. Tugas Paket Universal digunakan untuk mengunduh alat, menjalankan build, dan sekali lagi menggunakan tugas Paket Universal untuk menerbitkan seluruh GatsbyJS PWA yang dikompilasi ke umpan sebagai Paket Universal versi.

Mengunduh paket dengan tugas Paket Universal

Tugas kedua dalam proyek sampel menggunakan tugas Paket Universal untuk mengambil alat, imagemagick, dari umpan yang berada dalam proyek yang berbeda di organisasi yang sama. Alat ini, imagemagick, diperlukan oleh langkah build berikutnya untuk mengubah ukuran gambar.

1. Tambahkan tugas Paket Universal dengan mengklik ikon plus, mengetik "universal" di kotak pencarian, dan mengklik tombol Tambahkan untuk menambahkan tugas ke alur Anda.

   

2. Klik tugas Paket Universal yang baru ditambahkan dan Perintah ke Download.

3. Pilih Direktori tujuan yang akan digunakan untuk pengunduhan alat.

4. Pilih Umpan sumber yang berisi alat, atur Nama paket, dan pilih Versi alat imagemagick dari Umpan sumber.

   

5. Setelah menyelesaikan bidang, klik Lihat YAML untuk melihat YAML yang dihasilkan.

   

6. Pembuat tugas Paket Universal menghasilkan YAML yang disederhanakan yang berisi nilai non-default. Salin YAML yang dihasilkan ke dalam file Anda azure-pipelines.yml di akar repositori git proyek Anda.

   # Download Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal download'
     inputs:
       downloadDirectory: Application
       vstsFeed: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000001'
       vstsFeedPackage: imagemagick
       vstsPackageVersion: 1.0.0
   

Menerbitkan paket dengan tugas Paket Universal

Langkah terakhir dalam alur sampel ini menggunakan tugas Paket Universal untuk mengunggah Gatsby PWA siap produksi yang diproduksi oleh Run gatsby build langkah ke umpan sebagai Paket Universal versi. Setelah berada di umpan, Anda memiliki salinan permanen situs lengkap Anda yang dapat disebarkan ke penyedia hosting dan dimulai dengan gatsby serve.

1. Tambahkan tugas Paket Universal lain ke akhir alur dengan mengklik ikon plus, mengetik "universal" di kotak pencarian, dan mengklik tombol Tambahkan untuk menambahkan tugas ke alur Anda. Tugas ini mengumpulkan semua aset siap produksi yang dihasilkan oleh Run gatsby build langkah, menghasilkan Paket Universal versi, dan menerbitkan paket ke umpan.

   

2. Atur Perintah ke Publish.

3. Atur Jalur ke file untuk diterbitkan ke direktori yang berisi proyek package.jsonGatsbyJS Anda.

4. Pilih umpan tujuan, nama paket, dan atur strategi penerapan versi Anda.

   

5. Setelah menyelesaikan bidang yang diperlukan, klik Lihat YAML.

6. Salin YAML yang dihasilkan ke dalam file Anda azure-pipelines.yml seperti sebelumnya. YAML untuk proyek sampel ini ditampilkan di bawah ini.

   # Publish Universal Package
   steps:
   - task: UniversalPackages@0
     displayName: 'Universal publish'
     inputs:
       command: publish
       publishDirectory: Application
       vstsFeedPublish: '00000000-0000-0000-0000-000000000000/00000000-0000-0000-0000-000000000002' # You can also use '<projectName>/<feedName>' instead of the GUIDs
       vstsFeedPackagePublish: mygatsbysite
       packagePublishDescription: 'A test package'
   

Contoh ini menunjukkan cara menggunakan penyusun tugas Alur untuk menghasilkan YAML dengan cepat untuk tugas Paket Universal, yang kemudian dapat ditempatkan ke dalam file Anda azure-pipelines.yml . Pembuat tugas Paket Universal mendukung semua konfigurasi lanjutan yang dapat dibuat dengan argumen tugas Paket Universal .

Catatan

Menerbitkan paket langsung ke tampilan tidak didukung di Azure Artifacts. Anda harus menerbitkan paket ke umpan Anda terlebih dahulu, lalu mempromosikannya ke tampilan.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	2.144.0 atau lebih tinggi
Kategori tugas	Paket