Mempromosikan paket dan mengelola tampilan umpan

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Tampilan umpan memungkinkan pengembang mengontrol visibilitas paket dengan berbagi beberapa paket sambil menjaga orang lain tetap privat. Setiap tampilan memfilter umpan untuk menampilkan subset paket berdasarkan kriteria tertentu yang ditentukan untuk tampilan tersebut.

Secara default, Artefak Azure menyertakan tiga tampilan: @Local, @Prerelease, dan @Release. Tampilan @Local adalah default dan berisi semua paket yang diterbitkan, bersama dengan paket yang disimpan dari sumber hulu. Semua tampilan mendukung NuGet, npm, Maven, Python, Cargo, dan Universal Packages.

Anda dapat mengubah tampilan default di Pengaturan Umpan>Tampilan. Namun, mengubah tampilan default tidak mengizinkan penerbitan langsung ke tampilan tersebut. Paket hanya dapat diterbitkan ke umpan dasar, di mana paket tersedia dalam tampilan @Local.

Prasyarat

Produk Persyaratan
Azure DevOps - Organisasi Azure DevOps dan proyek.
- Umpan Azure Artifak.

Mempromosikan paket ke tampilan

Catatan

Anda harus menjadi Penerbit Umpan (Kontributor) atau Pemilik Umpan untuk mempromosikan paket ke dalam tampilan.

Ikuti langkah-langkah berikut untuk mempromosikan paket ke tampilan tertentu di umpan Anda:

  1. Masuk ke organisasi Azure DevOps Anda, lalu navigasikan ke proyek Anda.

  2. Pilih Artefak, lalu pilih feed Anda dari menu dropdown.

  3. Pilih paket yang ingin Anda promosikan, lalu pilih Promosikan.

  4. Pilih tampilan dari menu dropdown, lalu pilih Promosikan sekali lagi.

    Cuplikan layar yang menampilkan cara mempromosikan paket ke tampilan di Azure Artifacts.

Penting

Azure Artifacts tidak mendukung penurunan paket. Setelah paket dipromosikan, paket tidak dapat dikembalikan ke tampilan sebelumnya.

Mempromosikan paket menggunakan REST API

Untuk mempromosikan paket menggunakan REST API, kirim permintaan PATCH dengan isi permintaan yang diformat sebagai dokumen JSON Patch . Ini menambahkan tampilan target (misalnya, Prarilis) ke dalam array tampilan paket.

  1. Masuk ke Azure DevOps, lalu navigasikan ke proyek Anda.

  2. Buat Token Akses Pribadi dengan Packaging>Membaca, menulis, & mengelola cakupan.

  3. Salin URL titik akhir, ganti di salah satu contoh di bawah ini (PowerShell atau curl), dan jalankan perintah untuk mempromosikan paket Anda ke tampilan yang diinginkan.

  • Umpan lingkup organisasi:

    https://pkgs.dev.azure.com/{organization}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1

  • Umpan lingkup proyek

    https://pkgs.dev.azure.com/{organization}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.2-preview.1

Lihat JsonPatchOperation dan NuGet - Perbarui Versi Paket untuk informasi lebih lanjut.

  • umpan cakupan koleksi:

    https://{instance}/{collection}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1

  • Umpan lingkup proyek

    https://{instance}/{collection}/{project}/_apis/packaging/feeds/{feedId}/nuget/packages/{packageName}/versions/{packageVersion}?api-version=7.1

Lihat JsonPatchOperation dan NuGet - Perbarui Versi Paket untuk informasi lebih lanjut.

Contoh

Ganti tempat penampung dengan token akses pribadi, URL titik akhir, dan nama tampilan, lalu jalankan perintah untuk mempromosikan paket Anda ke tampilan yang diinginkan:

$env:PAT = "YOUR_PERSONAL_ACCESS_TOKEN"
$uri = "YOUR_URL"
$headers = @{
    "Content-Type" = "application/json"
    Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$env:PAT"))
}
$body = @{
    views = @{
        op    = "add"
        path  = "/views/-"
        value = "YOUR_VIEW_NAME"
    }
} | ConvertTo-Json

Invoke-RestMethod -Uri $uri -Method Patch -Headers $headers -Body $body

Catatan

Semua tampilan umpan dalam proyek publik dapat diakses secara publik dan dapat dilihat oleh siapa saja di internet.

Mengelola tampilan

Secara default, Artefak Azure menyertakan tiga tampilan: @Local, @Prerelease, dan @Release. Anda juga dapat membuat tampilan tambahan dan mengelola tampilan yang sudah ada dengan mengganti nama atau menghapusnya dari pengaturan umpan Anda

  1. Masuk ke organisasi Azure DevOps Anda, lalu navigasikan ke proyek Anda.

  2. Pilih Artefak, lalu pilih feed Anda dari menu dropdown.

  3. Pilih ikon roda gigi untuk membuka pengaturan umpan Anda.

    Cuplikan layar memperlihatkan cara mengakses pengaturan umpan di Azure Artifacts.

  4. Pilih Tampilan, pilih tampilan, lalu pilih Edit untuk mengubahnya. Untuk membuat tampilan baru, pilih Tambahkan tampilan.

    Cuplikan layar memperlihatkan cara menambahkan, mengedit, atau menghapus tampilan umpan.

  5. Pilih Simpan saat Anda selesai.

Penting

Untuk umpan publik, jika Anda mengubah izin akses tampilan menjadi Orang tertentu, tampilan tersebut tidak lagi tersedia sebagai sumber hulu.

Konten terkait

  • Last updated on