Koneksi proyek npm Anda ke umpan Azure Artifacts

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

Azure Artifacts memungkinkan pengembang untuk menerbitkan dan menginstal berbagai jenis paket dari umpan dan registri publik seperti npmjs.com. Untuk mengautentikasi dengan Azure Artifacts, Anda perlu 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. Dengan memodifikasi file .npmrc, pengguna dapat mempersonalisasi pengalaman npm mereka untuk memenuhi persyaratan spesifik mereka.

Prasyarat

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

• Umpan Artefak Azure. Buat umpan baru jika Anda belum memilikinya .

• Unduh dan instal Node.js dan npm.

Penyusunan proyek

Untuk praktik terbaik, disarankan untuk menggunakan dua file konfigurasi terpisah. Yang pertama digunakan untuk mengautentikasi dengan Azure Artifacts, sementara yang kedua disimpan secara lokal dan menyimpan kredensial Anda.

Untuk menyiapkan file kedua, cukup letakkan di direktori rumah Anda di komputer pengembangan Anda dan sertakan semua kredensial registri Anda. Dengan cara ini, klien npm dapat dengan mudah mengakses kredensial Anda untuk autentikasi, memungkinkan Anda berbagi file konfigurasi sambil menjaga kredensial Anda tetap aman.

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 Koneksi untuk disalurkan.

   

3. Pilih npm dari panel navigasi kiri.

4. Jika ini pertama kalinya menggunakan Azure Artifacts dengan npm, pilih Dapatkan alat dan ikuti instruksi untuk menginstal prasyarat.

5. Ikuti instruksi dalam 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 salin 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 ke dalam 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. Kodekan token akses pribadi anda yang baru dibuat sebagai berikut:

   1. Jalankan perintah berikut di jendela prompt perintah, lalu tempelkan token akses pribadi Anda saat diminta:

      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(); })"
      

      Anda juga dapat menggunakan perintah berikut untuk mengonversi token akses pribadi Anda ke Base 64.

      • Linux/Mac:

        echo -n "YOUR_PERSONAL_ACCESS-TOKEN" | base64
        

   2. Salin nilai base 64 yang dikodekan.

4. Ganti kedua nilai [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] dalam file .npmrc pengguna Anda dengan token akses pribadi Anda dari Langkah 3.

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, penting untuk menyertakan tugas autentikasi npm Anda di awal alur Anda. Tindakan ini memastikan 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

Agar alur Anda mengakses umpan Anda, pastikan bahwa peran layanan build diatur ke Feed And Upstream Reader (Contributor) di 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

Jika Anda mengalami kesalahan berikut selama eksekusi proyek:

• Cmd: 'vsts-npm-auth' is not recognized as an internal or external command, operable program or batch file.

• PowerShell: vsts-npm-auth : The term 'vsts-npm-auth' is not recognized as the name of a cmdlet, function, script file, or operable program.

Maka kemungkinan folder modul npm belum ditambahkan ke jalur Anda. Untuk mengatasinya, 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

Jika Anda mengalami kesalahan E401: code E401 npm ERR! Unable to authenticate. Jalankan vsts-npm-auth perintah dengan bendera -F untuk mengotoris 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
   

Artikel terkait

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