Menerbitkan Paket Universal dari sumber Artefak Azure

Layanan Azure DevOps

Paket Universal memungkinkan Anda menyimpan banyak jenis file dan konten paket di luar format seperti Paket NuGet, npm, dan Python. Anda dapat menerbitkannya langsung dari baris perintah dengan menggunakan Azure CLI. Paket Universal dapat mencapai 4 TiB dan harus menyertakan nama dan versi. Artikel ini memperlihatkan cara menerbitkan Paket Universal ke umpan Azure Artifacts Anda.

Prasyarat

Produk	Persyaratan
Azure DevOps	- Organisasi Azure DevOps . - Azure DevOps proyek. - Instal Azure CLI. - Instal ekstensi Azure DevOps versi 0.14.0 atau yang lebih tinggi.

Menginstal ekstensi Azure DevOps

Ekstensi Azure DevOps untuk Azure CLI memungkinkan Anda mengelola layanan Azure DevOps dari baris perintah. Sebelum menginstalnya, pastikan Anda telah menginstal Azure CLI versi 2.10.1 atau yang lebih tinggi.

1. Untuk menginstal ekstensi Azure DevOps, jalankan:

   az extension add --name azure-devops
   

2. Untuk memperbarui penginstalan yang ada ke versi terbaru, jalankan:

   az extension update --name azure-devops
   

Membuat umpan

Sebelum dapat menerbitkan Paket Universal, Anda memerlukan umpan untuk menerbitkannya. Umpan adalah kontainer yang menyimpan dan mengatur paket Anda, dan Anda dapat mengontrol siapa yang dapat mengaksesnya. Gunakan langkah-langkah berikut untuk membuat umpan untuk proyek atau organisasi Anda.

1. Masuk ke organisasi Azure DevOps Anda dan navigasikan ke proyek Anda.

2. Pilih Artefak, lalu pilih Buat Umpan.

3. Masukkan Nama untuk umpan Anda.

4. Pilih opsi Visibilitas untuk mengontrol siapa yang dapat melihat paket Anda.

5. Pilih Sertakan paket dari sumber publik umum jika Anda ingin umpan Anda juga menarik paket dari sumber publik seperti nuget.org atau npmjs.com.

6. Untuk Cakupan, pilih apakah umpan hanya berlaku untuk proyek Anda atau ke seluruh organisasi.

7. Pilih Buat setelah selesai.

   

Menerbitkan Paket Universal

Setelah membuat feed, Anda siap untuk menerbitkan Paket Universal ke feed tersebut. Setiap paket yang Anda terbitkan memerlukan nama dan nomor versi, dan keduanya harus mengikuti aturan penamaan tertentu:

• Nama paket harus menggunakan huruf kecil, diawali dan diakhiri dengan huruf atau angka, dan hanya boleh menyertakan huruf, angka, serta tanda hubung yang tidak berurutan (-), garis bawah (_), atau titik (.).
• Versi paket juga harus menggunakan huruf kecil dan tidak boleh berisi metadata build, yang ditandai dengan akhiran +. Untuk informasi selengkapnya, lihat penerapan versi semantik.

1. Jalankan salah satu perintah berikut untuk menerbitkan Paket Universal Anda, bergantung pada apakah umpan Anda dilingkupkan ke proyek atau ke organisasi Anda:

   • umpan cakupan proyek

     az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
     

   • umpan cakupan organisasi:

     az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
     

Nota

Jika paket Anda berisi sejumlah besar file (100K atau lebih), penerbitan mungkin gagal. Dalam hal ini, bundel file ke dalam arsip ZIP atau TAR untuk mengurangi jumlah file.

Menampilkan paket yang diterbitkan

Setelah menerbitkan paket, Anda dapat mengonfirmasi bahwa paket tersebut tersedia di umpan Anda.

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

2. Pilih Artefak, lalu pilih umpan Anda dari menu tarik-turun. Jika penerbitan berhasil diselesaikan, paket Anda harus tersedia di umpan Anda.

   

Konten terkait

• Unduh Paket Universal

• Menerbitkan dan Mengunduh Paket Universal dengan Azure Pipelines (YAML/Klasik)

• Sumber Paket Universal hulu