Menerbitkan paket npm dengan Azure Pipelines (YAML/Klasik)

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

Dengan Azure Pipelines, Anda dapat menerbitkan paket npm Anda ke umpan Azure Artifacts dalam organisasi Anda dan di organisasi lain. Artikel ini akan memandu Anda menerbitkan paket npm Anda ke umpan internal dan eksternal menggunakan alur YAML dan Klasik.

Prasyarat

• Buat organisasi Azure DevOps dan proyek jika Anda belum melakukannya.

• Buat umpan baru jika Anda belum memilikinya .

• Jika Anda menggunakan agen yang dihost sendiri, pastikan agen tersebut memiliki Node.js dan npm.

Menerbitkan paket ke umpan di organisasi yang sama

Catatan

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

YAML

steps:
- task: NodeTool@0
  inputs:
    checkLatest: true

- task: npmAuthenticate@0
  displayName: 'Authenticate to Azure Artifacts feed'
  inputs:
    workingFile: .npmrc

- script: |
   npm publish
  displayName: Publish

Klasik

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

2. Pilih Alur, lalu pilih definisi alur Anda.

3. Pilih Edit, lalu pilih + tanda untuk menambahkan tugas baru. Tambahkan alat penginstal Node.js, npm Authenticate dan tugas Command line ke definisi pipeline Anda. Anda dapat membiarkan tugas penginstal alat Node.js dengan pengaturan default dan mengonfigurasi tugas Autentikasi npm dan Command line sebagai berikut:

   1. npm Autentikasi tugas: Pilih jalur ke file .npmrc .

   2. Tugas baris perintah:

      • Nama tampilan: Terbitkan.
      • Skrip:

        npm publish
        

Menerbitkan paket ke feed di organisasi lain

Untuk menerbitkan paket Anda ke umpan di organisasi Azure DevOps lain, Anda harus terlebih dahulu membuat token akses pribadi di organisasi target.

Arahkan ke organisasi yang menghosting umpan target Anda dan Buat token akses pribadi dengan Kemasan>ruang lingkup Baca & tulis. Salin token akses pribadi Anda karena Anda akan membutuhkannya di bagian berikut.

Membuat koneksi layanan

1. Masuk ke organisasi Azure DevOps tempat alur Anda akan berjalan, lalu navigasikan ke proyek Anda.

2. Navigasikan ke pengaturan Proyek

3. Pilih Koneksi layanan baru, pilih npm, lalu pilih Berikutnya.

4. Pilih Nama Pengguna dan Kata Sandi sebagai metode Autentikasi, lalu masukkan URL Registri Anda. Masukkan Nama Pengguna Anda (tempat penampung, karena Azure Pipelines akan menggunakan file konfigurasi Anda .npmrc dan token akses pribadi yang Anda buat sebelumnya untuk mengautentikasi). Untuk Kata Sandi, tempelkan token akses pribadi Anda. Berikan nama untuk koneksi layanan Anda, dan centang kotak Berikan izin akses ke semua alur .

5. Pilih Simpan saat Anda selesai.

Menerbitkan paket

YAML

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

2. Pilih Alur, lalu pilih definisi alur Anda.

3. Pilih Edit, lalu tambahkan cuplikan berikut ke alur YAML Anda.

   - task: NodeTool@0
     inputs:
       checkLatest: true
   
   - task: npmAuthenticate@0
     displayName: 'Authenticate to Azure Artifacts feed'
     inputs:
       workingFile: .npmrc
       customEndpoint: <SERVICE_CONNECTION_NAME>
   
   - script: |
      npm publish  
     displayName: Publish  
   

Klasik

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

2. Pilih Alur, lalu pilih definisi alur Anda.

3. Pilih Edit, lalu pilih + tanda untuk menambahkan tugas baru. Tambahkan alat penginstal Node.js, npm Authenticate dan tugas Command line ke definisi pipeline Anda. Anda dapat membiarkan tugas penginstal alat Node.js dengan pengaturan default dan mengonfigurasi tugas Autentikasi npm dan Command line sebagai berikut:

   1. npm Autentikasi tugas:

      1. Pilih jalur ke file .npmrc Anda.
      2. Pilih koneksi layanan yang Anda buat sebelumnya dari menu dropdown Kredensial untuk registri di luar organisasi/koleksi ini.

   2. Tugas baris perintah:

      • Nama tampilan: Terbitkan.
      • Skrip:

        npm publish
        

Konten terkait

• Menerbitkan dan mengunduh artefak pipelin
• Gunakan file .artifactignore
• Menyebarkan Artefak Pull Request.