Bagikan melalui


Mulai menggunakan paket npm di Azure Artifacts

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Dengan menggunakan Azure Artifacts, Anda dapat menerbitkan dan mengunduh paket npm Anda dari umpan dan registri publik seperti npmjs.com. Mulai cepat ini akan memandu Anda membuat umpan, mengonfigurasi proyek, dan mengelola paket npm dengan umpan Azure Artifacts Anda.

Prasyarat

Membuat umpan

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

  2. Pilih Artefak, lalu pilih Buat Umpan untuk membuat umpan baru.

  3. Masukkan Nama deskriptif untuk umpan Anda dan tentukan Visibilitasnya(menunjukkan siapa yang dapat melihat paket dalam umpan). Tentukan Cakupan umpan Anda, dan jika Anda ingin menyertakan paket dari sumber publik, tandai kotak centang Sumber upstream.

  4. Pilih Buat setelah selesai.

    Cuplikan layar memperlihatkan cara membuat umpan baru di Azure DevOps Services.

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

  2. Pilih Artefak, lalu pilih Buat Umpan untuk membuat umpan baru.

  3. Masukkan Nama deskriptif untuk umpan Anda dan tentukan Visibilitasnya(menunjukkan siapa yang dapat melihat paket dalam umpan). Tentukan Cakupan umpan Anda, dan jika Anda ingin menyertakan paket dari sumber publik, tandai kotak centang Sumber upstream.

  1. Pilih Buat setelah selesai.

    Cuplikan layar memperlihatkan cara membuat umpan baru di Azure DevOps 2022.

  1. Pilih Buat setelah selesai.

    Cuplikan layar memperlihatkan cara membuat umpan baru di Azure DevOps 2020.

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

  2. Pilih Artefak, lalu pilih Umpan baru.

  3. Masukkan Nama deskriptif untuk umpan Anda dan tentukan Visibilitasnya(menunjukkan siapa yang dapat melihat paket dalam umpan). Jika Anda ingin menyertakan paket dari sumber publik, pilih opsi Gunakan paket dari sumber publik melalui umpan ini.

  4. Pilih Buat setelah selesai.

    Cuplikan layar memperlihatkan cara membuat umpan baru di Azure DevOps 2019.

Catatan

Secara default, umpan yang baru dibuat memiliki Layanan Build proyek mereka yang diatur ke Umpan dan Pembaca Upstream (Kolaborator).

Koneksi ke umpan

Catatan

vsts-npm-auth tidak didukung di Azure DevOps Server.

Azure Artifacts merekomendasikan penggunaan dua file .npmrc. Yang pertama harus ditempatkan di direktori $home (Linux/macOS) atau $env. HOME (Windows) untuk menyimpan kredensial Anda dengan aman. Ini memungkinkan klien npm menemukan file dan mengambil kredensial Anda untuk autentikasi, memungkinkan Anda berbagi file konfigurasi tanpa mengekspos kredensial Anda. Di bagian ini, kami akan menyiapkan file .npmrc kedua, yang harus ditempatkan di direktori yang sama dengan file package.json Anda.

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

  2. Pilih Artefak, lalu pilih Koneksi untuk disalurkan.

  3. Pilih npm dari area navigasi kiri. Jika ini pertama kalinya Anda menggunakan Azure Artifacts dengan npm, pastikan Anda telah menginstal prasyarat.

  4. Ikuti instruksi di bagian Penyiapan proyek untuk menyiapkan file konfigurasi Anda dan menyambungkan ke umpan Anda.

    Cuplikan layar yang memperlihatkan cara menyiapkan proyek npm dan menyambungkan ke umpan Azure Artifacts di Azure DevOps Services.

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

  2. Pilih Artefak, lalu pilih Koneksi ke Umpan.

  3. Pilih npm dari kiri, lalu ikuti instruksi di bagian Penyiapan proyek untuk menyambungkan ke umpan Anda.

    Cuplikan layar yang memperlihatkan cara menyiapkan proyek npm dan menyambungkan ke umpan Azure Artifacts di Azure DevOps Server 2022.

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

  2. Pilih Artefak, lalu pilih Koneksi untuk disalurkan.

  3. Pilih npm dari kiri, lalu ikuti instruksi dalam Penyiapan Proyek untuk menyiapkan file konfigurasi Anda dan menyambungkan ke umpan Anda.

    Cuplikan layar yang memperlihatkan cara menyiapkan proyek npm dan menyambungkan ke umpan Azure Artifacts di Azure DevOps Server 2020.

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

  2. Pilih Artefak, lalu pilih Koneksi untuk disalurkan.

  3. Jendela baru akan muncul. Dari panel navigasi kiri, pilih npm dan ikuti instruksi untuk menyiapkan file proyek dan user.npmrc Anda.

    Cuplikan layar yang memperlihatkan cara menyiapkan proyek npm dan menyambungkan ke umpan Azure Artifacts di Azure DevOps Server 2019.

Penting

npm mendukung satu registry dalam file .npmrc Anda. Beberapa registri dimungkinkan dengan cakupan dan sumber hulu.

Menerbitkan paket

Jalankan perintah berikut di direktori proyek Anda untuk menerbitkan paket npm Anda:

npm publish

Penting

publishConfig Menggunakan properti untuk mengambil alih param konfigurasi registri pada waktu publikasi tidak didukung.

Memulihkan paket

Jalankan perintah berikut di direktori proyek Anda untuk memulihkan paket npm Anda:

npm install

Untuk memulihkan paket npm tertentu, jalankan perintah berikut dari direktori proyek Anda:

npm install --save <PACKAGE_NAME>