Menerbitkan dan mengunduh Paket Universal di Azure Artifacts

  • Artikel

Azure DevOps

Paket Universal memungkinkan pengembang untuk menyimpan berbagai jenis paket di luar yang tradisional seperti paket NuGet, npm, Python, dll. Menggunakan Azure CLI, Anda dapat menerbitkan dan mengunduh Paket Universal langsung dari baris perintah. Meskipun ukuran paket yang diterbitkan dapat bervariasi, mencapai hingga 4 TB, mereka harus selalu mempertahankan persyaratan penting termasuk nama dan nomor versi. Artikel ini akan memancang Anda melalui langkah-langkah untuk menerbitkan dan mengunduh Paket Universal dari umpan Azure Artifacts Anda.

Prasyarat

Membuat umpan

Jika Anda sudah memiliki umpan, Anda dapat melanjutkan ke bagian berikutnya. Jika tidak, ikuti langkah-langkah di bawah ini untuk membuat umpan Azure Artifacts baru:

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

  2. Pilih Artefak, lalu pilih Buat Umpan.

  3. Berikan Nama deskriptif untuk umpan Anda dan atur Visibilitasnya(siapa yang dapat melihat paket di umpan Anda). Tentukan Cakupan umpan Anda, lalu pilih kotak centang Sumber upstream jika Anda ingin menyertakan paket dari registri publik.

  4. Pilih Buat setelah selesai.

    Cuplikan layar memperlihatkan cara membuat umpan baru.

Catatan

Umpan yang baru dibuat menunjuk peran Build Service proyek sebagai Umpan dan Pembaca Upstream (Kolaborator) secara default.

Menginstal ekstensi Azure DevOps

Menggunakan CLI membantu menyederhanakan tugas Anda. Sebelum melanjutkan, pastikan Anda telah menginstal Azure CLI (versi 2.10.1 atau yang lebih tinggi). Selain itu, kita harus menginstal ekstensi Azure DevOps untuk mengelola layanan Azure DevOps dari baris perintah.

  1. Jalankan perintah berikut untuk menginstal ekstensi Azure DevOps:

    az extension add --name azure-devops

  2. Jika Anda sudah menginstal ekstensi Azure DevOps dan ingin memperbaruinya ke yang terbaru, jalankan perintah berikut:

    az extension update --name azure-devops

Hubungkan ke umpan

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

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

  3. Pilih Koneksi untuk umpan, lalu pilih Paket Universal dari panel navigasi kiri.

  4. Ikuti instruksi di bagian Penyiapan proyek untuk menyambungkan ke umpan Anda.

  1. Jalankan perintah berikut untuk masuk ke Azure CLI:

    az login

  2. Jalankan perintah berikut untuk mengatur proyek dan organisasi Anda sebagai konfigurasi default CLI:

    az devops configure --defaults project=<YOUR_PROJECT_NAME> organization=https://dev.azure.com/<YOUR_ORGANIZATION_NAME>

Menerbitkan Paket Universal

Untuk menerbitkan Paket Universal ke umpan Anda, Anda perlu memberikan nama paket dan nomor versi.

Nama paket harus dalam huruf kecil, dimulai dan diakhapi dengan huruf atau angka, dan hanya berisi huruf, angka, dan tanda hubung nonkonsekutif, garis bawah, dan titik. Versi paket juga harus dalam huruf kecil dan tidak boleh menyertakan metadata build (+ akhiran). Lihat penerapan versi semantik untuk detail selengkapnya.

  1. Jalankan perintah berikut untuk menerbitkan Paket Universal Anda ke umpan Anda:

    • 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>

    • 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>

Catatan

Jika organisasi Anda menggunakan firewall atau server proksi, pastikan Anda mengizinkan URL dan alamat IP Domain Artefak Azure.

Menampilkan paket yang diterbitkan

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

  2. Pilih Artefak, lalu pilih umpan Anda dari menu dropdown. Setelah proses penerbitan berhasil diselesaikan, paket Anda akan tersedia di umpan Anda.

    Cuplikan layar memperlihatkan Paket Universal yang baru diterbitkan.

Unduh Paket Universal

Jalankan perintah berikut untuk mengunduh Paket Universal tertentu dari umpan Anda menggunakan Azure CLI:

  • Umpan cakupan organisasi:

    az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>

  • Umpan cakupan proyek:

    az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>

Mengunduh file tertentu

Jika Anda hanya ingin mengunduh file tertentu, gunakan --file-filter parameter untuk mengambil subset file. Lihat Referensi pola pencocokan file untuk detail selengkapnya.

  • Umpan cakupan organisasi:

    az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>

  • Umpan cakupan proyek:

    az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>

Contoh: Misalnya, menggunakan --file-filter logs/.log akan cocok dengan file apa pun dengan nama file yang berisi "log" dan diakhapi dengan ekstensi ".log" (misalnya, build_logs.log).

Unduh versi terbaru

Anda dapat menggunakan wildcard * untuk mengunduh versi terbaru Paket Universal Anda.

Contoh:

  • --version '*': unduh versi terbaru.

  • --version '1.*': unduh versi terbaru dengan 1 utama.

  • --version '1.2.*': unduh rilis patch terbaru dengan 1 utama dan minor 2.

Catatan

Pola kartubebas tidak didukung dengan versi pra-rilis (paket dengan tanda hubung di nomor versinya).