Menerbitkan paket npm dengan Azure Pipelines (YAML/Klasik)

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

Dengan Azure Pipelines, Anda dapat menerbitkan paket npm anda ke umpan Azure Artifacts dan registri publik seperti npmjs.com. Artikel ini akan memandu Anda menerbitkan paket npm menggunakan alur YAML dan Klasik.

Prasyarat

• Organisasi Azure DevOps. Buat akun gratis.

• Proyek Azure DevOps. Buat proyek baru jika Anda belum memilikinya.

• Umpan Artefak Azure. Buat akun gratis.

Menerbitkan ke umpan Artefak Azure

Catatan

Untuk menerbitkan paket Anda ke umpan menggunakan Azure Pipelines, pastikan bahwa Project Collection Build Service dan identitas Build Service proyek Anda dikonfigurasi sebagai Penerbit Umpan (Kontributor). Lihat Menambahkan pengguna/grup baru untuk detail selengkapnya.

YAML

- task: Npm@1
  inputs:
    command: publish
    publishRegistry: useFeed
    publishFeed: <FEED_NAME>        ## For project-scoped feeds, use: <PROJECT_NAME>/<FEED_NAME> 

• publishRegistry: pilih useFeed untuk menggunakan umpan dalam organisasi Anda. Opsi: useExternalRegistry, useFeed
• publishFeed: umpan yang ingin Anda terbitkan. Diperlukan saat publishRegistry = useFeed.

Tip

Saat menambahkan tugas npm ke alur YAML Anda menggunakan editor YAML, ID proyek dan umpan untuk Anda publishFeed akan dibuat secara otomatis.

Klasik

1. Navigasi ke portal Azure DevOps, lalu pilih proyek Anda.

2. Pilih Alur, lalu pilih definisi alur Anda.

3. Pilih Edit, lalu pilih + tanda untuk menambahkan tugas baru. Cari tugas npm , lalu pilih Tambahkan untuk menambahkannya ke alur Anda.

   

4. Beri nama tugas Anda lalu pilih Terbitkan dari menu dropdown perintah. Tentukan jalur package.json, lokasi Registri, dan registri Target Anda.

   • Folder kerja yang berisi package.json: jalur ke folder yang berisi file package.json target dan .npmrc. Biarkan ini kosong jika file-file tersebut berada di akar repositori Anda.
   • Lokasi registri: pilih Registri yang saya pilih di sini untuk menerbitkan ke umpan.
   • Registri target: pilih umpan Anda dari menu dropdown.

   

Menerbitkan ke registri publik

Sebelum menerbitkan paket Anda ke registri npm publik seperti npmjs.com, Anda harus terlebih dahulu membuat koneksi layanan untuk mengautentikasi dengan layanan eksternal yang diinginkan.

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

2. Pilih Pengaturan proyek>Koneksi layanan, lalu pilih Buat koneksi layanan.

   

3. Pilih npm lalu pilih Berikutnya. Isi bidang yang diperlukan, lalu pilih Simpan setelah selesai.

YAML

- task: Npm@1
  inputs:
    command: publish
    publishRegistry: useExternalRegistry
    publishEndpoint: '<NAME_OF_YOUR_SERVICE_CONNECTION>'

• publishRegistry: pilih useExternalRegistry untuk diterbitkan ke registri publik. Opsi: useExternalRegistry | useFeed.
• publishEndpoint: ganti tempat penampung dengan nama koneksi layanan yang Anda buat sebelumnya. diperlukan saat publishRegistry == useExternalRegistry.

Klasik

1. Navigasi ke portal Azure DevOps, lalu pilih proyek Anda.

2. Pilih Alur, lalu pilih definisi alur Anda.

3. Pilih Edit, lalu pilih + tanda untuk menambahkan tugas baru. Cari tugas npm , lalu pilih Tambahkan untuk menambahkannya ke alur Anda.

   

4. Beri nama tugas Anda lalu pilih Terbitkan dari menu dropdown perintah. Tentukan jalur package.json, lokasi Registri, dan registri Eksternal Anda.

   • Folder kerja yang berisi package.json: jalur ke folder yang berisi file package.json target dan .npmrc. Biarkan ini kosong jika file-file tersebut berada di akar repositori Anda.
   • Lokasi registri: pilih Registri npm eksternal untuk diterbitkan ke registri publik seperti npmjs.com.
   • Registri eksternal: pilih koneksi layanan yang Anda buat sebelumnya.

   

Artikel terkait

• Terbitkan dan pulihkan paket npm dari baris perintah.
• Gunakan paket dari npmjs.com.
• Menerbitkan dan mengunduh artefak alur.