Menyambungkan proyek npm Anda ke Azure Artifacts

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

Azure Artifacts memungkinkan pengembang mengelola paket mereka dari berbagai sumber, termasuk registri publik seperti npmjs.com dan umpan privat. Untuk mengautentikasi dengan Azure Artifacts, Anda harus mengonfigurasi file konfigurasi npm Anda. File ini berisi URL umpan dan kredensial yang digunakan oleh npm, menawarkan opsi untuk menyesuaikan perilaku klien npm Anda, seperti menyiapkan proksi, menentukan lokasi paket default, atau mengonfigurasi umpan paket privat. File .npmrc biasanya terletak di direktori beranda pengguna tetapi juga dapat dibuat di tingkat proyek untuk mengambil alih pengaturan default.

Prasyarat

• Organisasi Azure DevOps. Buat akun gratis.

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

• Umpan Artefak Azure. Buat akun gratis.

• Unduh dan instal Node.js dan npm.

Hubungkan ke Umpan

Azure Artifacts merekomendasikan penggunaan dua file konfigurasi terpisah. Yang pertama didedikasikan untuk mengautentikasi dengan Azure Artifacts, sementara yang kedua harus disimpan secara lokal untuk menyimpan kredensial Anda. Pendekatan ini memungkinkan Anda berbagi file konfigurasi sambil menjaga kredensial Anda tetap aman.

Untuk menyiapkan file kedua, cukup letakkan di direktori rumah Anda di komputer pengembangan Anda dan sertakan semua kredensial registri Anda. Ini memungkinkan klien npm untuk dengan mudah mengakses kredensial Anda untuk autentikasi.

Langkah-langkah berikut akan memandu Anda menyiapkan file konfigurasi pertama:

Windows

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

2. Pilih Artefak, lalu pilih Sambungkan ke Umpan.

   

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

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

   

Lainnya

1. Tambahkan file .npmrc di direktori proyek Anda, di direktori yang sama dengan file package.json Anda, dan tempelkan cuplikan berikut ke dalamnya.

   registry=https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/ 
   
   always-auth=true
   

Menyiapkan kredensial

1. Salin cuplikan berikut dan tempelkan ke file npmrc tingkat pengguna Anda:

   • Umpan cakupan organisasi:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:username=[ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

   • Umpan cakupan proyek:

     ; begin auth token
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/registry/:email=npm requires email to be set but doesn't use the value
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:username=[ENTER_ANY_VALUE_BUT_NOT_AN_EMPTY_STRING]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
     //pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/npm/:email=npm requires email to be set but doesn't use the value
     ; end auth token
     

2. Hasilkan token akses pribadi dengan cakupan baca dan tulis kemasan.

3. Jalankan perintah berikut di jendela prompt perintah, lalu tempelkan token akses pribadi Anda saat diminta. Setelah selesai, salin nilai yang dikodekan Base 64 yang dihasilkan.

   node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"
   

4. Jika Anda menggunakan Linux/Mac, Anda dapat menggunakan perintah berikut untuk mengonversi token akses pribadi Anda ke Base 64. Salin nilai yang dikodekan Base64 yang dihasilkan.

   echo -n "YOUR_PERSONAL_ACCESS-TOKEN" | base64
   

5. Ganti tempat penampung [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] dalam file .npmrc pengguna Anda dengan token akses pribadi yang dikodekan yang diperoleh dari langkah sebelumnya.

Tip

Menggunakan beberapa registri dalam file .npmrc didukung dengan cakupan dan sumber hulu.

Autentikasi alur

Untuk mengautentikasi dengan alur Anda, Azure Artifacts merekomendasikan penggunaan tugas autentikasi npm.

Saat menggunakan pelari tugas seperti gulp atau Grunt, anda harus memprioritaskan pengaturan tugas autentikasi npm Anda di awal alur Anda. Langkah ini menjamin bahwa kredensial Anda disuntikkan ke dalam file .npmrc proyek Anda dan dipertahankan di seluruh eksekusi alur, memungkinkan langkah-langkah berikutnya untuk mengakses kredensial dalam file konfigurasi.

Klasik

1. Navigasi ke proyek Anda, pilih Alur, lalu pilih definisi alur Anda.

2. Pilih Edit untuk mengubah alur Anda.

3. Pilih + untuk menambahkan tugas baru ke alur Anda.

   

4. Cari tugas Autentikasi npm, lalu pilih Tambahkan.

   

5. Pilih file .npmrc Anda, lalu pilih Simpan &antrean setelah selesai.

   

YAML

- task: npmAuthenticate@0
  inputs:
    workingFile: .npmrc                ## Path to the npmrc file
    customEndpoint: #Optional          ## Comma-separated list of npm service connection names for registries from external organizations. For registries in your org, leave this blank

Catatan

Untuk mengakses umpan dari alur Anda, pastikan bahwa peran layanan build diatur ke Umpan Dan Pembaca Upstream (Kontributor) di Izin pengaturan>Umpan Anda.

Catatan

Jika organisasi Anda menggunakan firewall atau server proksi, pastikan Anda mengizinkan URL domain yang sesuai. Lihat Alamat IP dan URL domain yang diizinkan untuk detailnya.

Pecahkan masalah

vsts-npm-auth tidak dikenali

Kesalahan ini menunjukkan bahwa folder modul npm belum ditambahkan ke jalur Anda. Jalankan ulang penyiapan Node.js dan pastikan untuk memilih Add to PATH opsi . Atau, Anda dapat menambahkan folder modul npm ke jalur Anda dengan memodifikasi variabel PATH ke %APPDATA%\npm di Command Prompt atau $env:APPDATA\npm di PowerShell.

Tidak dapat mengautentikasi

• Kesalahan: kode E401 npm ERR! Tidak dapat mengautentikasi: -> Jalankan vsts-npm-auth perintah dengan bendera -F untuk mengautentikasi ulang:

  vsts-npm-auth -config .npmrc -F
  

Reset vsts-npm-auth

Ikuti langkah-langkah ini untuk mengatur ulang info masuk vsts-npm-auth Anda:

1. Hapus instalan vsts-npm-auth:

   npm uninstall -g vsts-npm-auth
   

2. Hapus cache npm Anda:

   npm cache clean --force
   

3. Hapus file .npmrc Anda.

4. Instal ulang vsts-npm-auth:

   npm install -g vsts-npm-auth --registry https://registry.npmjs.com --always-auth false
   

Tidak dapat menerbitkan

Jika Anda mengalami kesalahan 403, itu mungkin menunjukkan konflik nama. Di Azure Artifacts, paket tidak dapat diubah, yang berarti bahwa setelah Anda menerbitkan paket ke umpan Anda, nomor versinya dicadangkan secara permanen. Bahkan jika Anda menghapusnya, Anda tidak dapat menerbitkan paket baru dengan nomor versi yang sama. Untuk mengatasi masalah ini, perbarui versi paket dalam file package.json Anda, lalu coba lagi.

Artikel terkait

• Menerbitkan dan memulihkan paket npm (CLI)
• Menerbitkan paket npm (YAML/Klasik)
• Menggunakan paket dari npmjs.com