npm projenizi Azure Artifacts'e bağlama

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Azure Artifacts, geliştiricilerin hem npmjs.com hem de özel akışlar gibi genel kayıt defterleri de dahil olmak üzere çeşitli kaynaklardan paketlerini yönetmesine olanak tanır. Azure Artifacts ile kimlik doğrulaması yapmak için npm yapılandırma dosyanızı yapılandırmanız gerekir. Bu dosya npm tarafından kullanılan akış URL'lerini ve kimlik bilgilerini içerir; proxy'leri ayarlama, varsayılan paket konumlarını tanımlama veya özel paket akışlarını yapılandırma gibi npm istemci davranışınızı özelleştirme seçenekleri sunar. .npmrc dosyası genellikle kullanıcının giriş dizininde bulunur, ancak varsayılan ayarları geçersiz kılmak için proje düzeyinde de oluşturulabilir.

Önkoşullar

• Bir Azure DevOps kuruluşu. Ücretsiz bir tane oluşturun.

• Azure DevOps projesi. Henüz bir projeniz yoksa yeni bir proje oluşturun.

• Azure Artifacts akışı. Ücretsiz bir tane oluşturun.

• Node.js ve npm'yi indirip yükleyin.

Akışa Bağlan

Azure Artifacts iki ayrı yapılandırma dosyası kullanılmasını önerir. Birincisi Azure Artifacts ile kimlik doğrulamaya ayrılmışken, ikincisi kimlik bilgilerinizi depolamak için yerel olarak tutulmalıdır. Bu yaklaşım, kimlik bilgilerinizi güvenli tutarken yapılandırma dosyanızı paylaşmanızı sağlar.

İkinci dosyayı ayarlamak için geliştirme makinenizdeki giriş dizininize yerleştirmeniz ve tüm kayıt defteri kimlik bilgilerinizi eklemeniz yeterlidir. Bu, npm istemcisinin kimlik doğrulaması için kimlik bilgilerinize kolayca erişmesini sağlar.

Aşağıdaki adımlar, ilk yapılandırma dosyasını ayarlama konusunda size yol gösterir:

Windows

1. Azure DevOps kuruluşunuzda oturum açın ve projenize gidin.

2. Yapıtlar'ı ve ardından Akışa Bağlan'ı seçin.

   

3. Sol kenar çubuğundan npm'yi seçin. Azure Artifacts'i npm ile ilk kez kullanıyorsanız önkoşulları yüklediğinizden emin olun.

4. Akışınıza bağlanmak için Proje kurulumu bölümündeki yönergeleri izleyin.

   

Diğer

1. Projenizin dizinine, package.json dosyanızla aynı dizine bir .npmrc dosyası ekleyin ve içine aşağıdaki kod parçacığını yapıştırın.

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

Kurulum kimlik bilgileri

1. Aşağıdaki kod parçacığını kopyalayın ve kullanıcı düzeyi npmrc dosyanıza yapıştırın:

   • Kuruluş kapsamlı akış:

     ; 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
     

   • Proje kapsamlı akış:

     ; 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. Paketleme okuma ve yazma kapsamlarıyla kişisel erişim belirteci oluşturun.

3. Komut istemi penceresinde aşağıdaki komutu çalıştırın ve istendiğinde kişisel erişim belirtecinizi yapıştırın. İşiniz bittiğinde, oluşturulan Base 64 kodlanmış değerini kopyalayın.

   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. Linux/Mac kullanıyorsanız, alternatif olarak aşağıdaki komutu kullanarak kişisel erişim belirtecinizi Temel 64'e dönüştürebilirsiniz. Sonuçta elde edilen Base64 kodlanmış değerini kopyalayın.

   echo -n "YOUR_PERSONAL_ACCESS-TOKEN" | base64
   

5. Kullanıcı .npmrc dosyanızdaki [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] yer tutucularını önceki adımdan alınan kodlanmış kişisel erişim belirteci ile değiştirin.

İpucu

.npmrc dosyalarında birden çok kayıt defterinin kullanılması kapsamlar ve yukarı akış kaynaklarıyla desteklenir.

İşlem hattı kimlik doğrulaması

İşlem hattınızla kimlik doğrulaması yapmak için Azure Artifacts, npm kimlik doğrulama görevinin kullanılmasını önerir.

Gulp veya Grunt gibi görev çalıştırıcıları kullanırken, işlem hattınızın başında npm kimlik doğrulama görevinizi ayarlamaya öncelik vermek gerekir. Bu adım, kimlik bilgilerinizin projenizin .npmrc dosyasına eklenip işlem hattı çalıştırması boyunca saklanmasını garanti eder ve yapılandırma dosyasındaki kimlik bilgilerine erişmek için sonraki adımları etkinleştirir.

Klasik

1. Projenize gidin, İşlem hatları'na ve ardından işlem hattı tanımınızı seçin.

2. İşlem hattınızı değiştirmek için Düzenle'yi seçin.

3. İşlem hattınıza yeni bir görev eklemek için seçin + .

   

4. npm Kimlik Doğrulaması görevini arayın ve Ekle'yi seçin.

   

5. .npmrc dosyanızı seçin ve işiniz bittiğinde Kaydet ve kuyruk seçeneğini belirleyin.

   

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

Not

akışınıza işlem hattınızdan erişmek için, Akış ayarları>İzinleri'nde derleme hizmeti rolünün Akış ve Yukarı Akış Okuyucusu (Katkıda Bulunan) olarak ayarlandığından emin olun.

Not

Kuruluşunuz bir güvenlik duvarı veya ara sunucu kullanıyorsa, uygun etki alanı URL'lerine izin verin. Ayrıntılar için bkz . İzin verilen IP adresleri ve etki alanı URL'leri .

Sorun giderme

vsts-npm-auth tanınmıyor

Bu hata, npm modules klasörünün yolunuz için eklenmediğini gösterir. Node.js kurulumunu yeniden çalıştırın ve seçeneği belirlediğinizden Add to PATH emin olun. Alternatif olarak, Komut İstemi'nde veya $env:APPDATA\npm PowerShell'de PATH değişkenini %APPDATA%\npm değiştirerek npm modules klasörünü yolunuza ekleyebilirsiniz.

Kimlik doğrulanamadı

• Hata: kod E401 npm ERR! Kimlik doğrulaması yapılamıyor: -> Yeniden kimlik doğrulaması yapmak için komutu -F bayrağıyla çalıştırınvsts-npm-auth:

  vsts-npm-auth -config .npmrc -F
  

vsts-npm-auth'i sıfırla

vsts-npm-auth kimlik bilgilerinizi sıfırlamak için şu adımları izleyin:

1. vsts-npm-auth'u kaldırın:

   npm uninstall -g vsts-npm-auth
   

2. npm önbelleğinizi temizleyin:

   npm cache clean --force
   

3. .npmrc dosyanızı silin.

4. vsts-npm-auth'i yeniden yükleyin:

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

Yayımlanamıyor

403 hatasıyla karşılaşırsanız, bu bir ad çakışması olduğunu gösterebilir. Azure Artifacts'te paketler sabittir; başka bir deyişle akışınızda bir paket yayımladığınızda sürüm numarası kalıcı olarak ayrılmıştır. Silseniz bile, aynı sürüm numarasına sahip yeni bir paket yayımlayamazsınız. Bu sorunu gidermek için package.json dosyanızdaki paket sürümünü güncelleştirin ve yeniden deneyin.

İlgili makaleler

• Npm paketlerini yayımlama ve geri yükleme (CLI)
• Npm paketlerini yayımlama (YAML/Klasik)
• npmjs.com paketlerini kullanma