Azure Artifacts'te npm paketlerini kullanmaya başlama

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

Azure Artifacts'i kullanarak akışlardan ve npmjs.com gibi genel kayıt defterlerinden npm paketleri yayımlayabilir ve indirebilirsiniz. Bu hızlı başlangıçta, akışınızı oluşturma, projenizi yapılandırma ve Azure Artifacts akışınıza npm paketlerini yayımlama ve indirme işlemi boyunca size yol gösterilir.

Akış oluşturma

Akış, kullanıcıların paketlerini depolamasına ve bunlara kimlerin erişebileceğini denetlemesine olanak tanıyan bir kuruluş yapısıdır. Azure Artifacts, NuGet, npm, Maven, Python, Cargo ve Universal paketleri gibi çeşitli paket türlerinin tek bir akışta depolanmasını destekler.

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

2. Yapıtlar'ı seçin ve ardından Yeni bir akış oluşturmak için Akış Oluştur'u seçin.

3. Akışınız için açıklayıcı bir Ad girin ve Görünürlüğünü tanımlayın (akıştaki paketleri kimlerin görüntüleyebileceğini belirtir). Akışınızın Kapsamını belirtin ve genel kaynaklardan paketler eklemek istiyorsanız Yukarı akış kaynakları onay kutusunu işaretleyin.

4. İşiniz bittiğinde Oluştur'u seçin.

   

Not

Varsayılan olarak, yeni oluşturulan akışlar projelerinin Derleme Hizmeti Akış ve Yukarı Akış Okuyucusu (Ortak Çalışan) olarak ayarlanmıştır.

.npmrc dosyalarınızı ayarlama

Not

vsts-npm-auth Azure DevOps Server'da desteklenmez.

İki .npmrc dosyası kullanmanızı öneririz. İlki, package.json dosyanızla aynı dizinde bulunmalıdır. İkincisi $home dizinine (Linux/macOS) veya $env yerleştirilmelidir. HOME (Windows) ile kimlik bilgilerinizi güvenli bir şekilde depolayın. Npm istemcisi daha sonra bu dosyayı arayabilir ve kimlik doğrulaması için kimlik bilgilerinizi getirebilir. Bu, kimlik bilgilerinizi güvenli tutarken yapılandırma dosyanızı paylaşmanızı sağlar.

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

2. Yapıtlar'ı ve ardından beslenen Bağlan seçin.

3. Sol gezinti bölmesinden npm'yi seçin. Azure Artifacts'i npm ile ilk kez kullanıyorsanız Araçları al'ı seçin ve Node.js indirip makinenizi ayarlama adımlarını izleyin.

4. .npmrc dosyanıza, package.json dosyanızla aynı dizinde bulunan aşağıdaki kod parçacığını ekleyin. Yer tutucuları uygun değerlerle değiştirin.

   • Kuruluş kapsamlı akış:

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

   • Proje kapsamlı akış:

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

Kurulum kimlik bilgileri

Önemli

npm, .npmrc dosyanızda tek registry bir dosyayı destekler. Kapsamlar ve yukarı akış kaynaklarıyla birden çok kayıt defteri mümkündür.

Windows

Windows'da geliştiriyorsanız Azure Artifacts ile kimlik doğrulaması yapmak için vsts-npm-auth kullanmanızı öneririz. Araçları alma bölümünden vsts-npm-auth dosyasının yüklü olduğundan emin olun ve ardından vsts-npm-auth komutunu çalıştırarak kullanıcı düzeyinde npmrc dosyanıza eklenen bir Azure Artifacts belirtecini alın:

vsts-npm-auth -config .npmrc

Diğer

Windows dışı bir platformda geliştirmeler yapıp Azure Artifacts ile kimlik doğrulaması yapmanız gerekiyorsa, kişisel bir erişim belirteci oluşturmanız, 64 Tabanında kodlamanız ve ardından bunu kullanıcı düzeyi npmrc dosyanıza eklemeniz gerekir.

1. Paketleme okuma ve yazma kapsamlarıyla kişisel erişim belirtecioluşturun.

2. Yeni oluşturulan kişisel erişim belirtecinizi aşağıdaki gibi kodlayın:

   1. PAT'nizi kodlamak için komut istemi penceresinde aşağıdaki komutu çalıştırı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(); })"
      

   2. Kişisel erişim belirtecinizi yapıştırın ve enter tuşuna basın.

   3. Base 64 ile kodlanmış kişisel erişim belirtecini kopyalayın.

3. Aşağıdaki kod parçacığını kullanıcı düzeyi .npmrc dosyanıza kopyalayın ve yer tutucuyu [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] Temel 64 kişisel erişim belirtecinizle değiştirin:

   • 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
     

---

Paketleri yayımlama

npm paketinizi yayımlamak için proje dizininizde aşağıdaki komutu çalıştırın:

npm publish

Önemli

publishConfig Yayımlama zamanında kayıt defteri yapılandırma parametresini geçersiz kılmak için özelliğinin kullanılması desteklenmez.

Paketleri geri yükleme

Npm paketini geri yüklemek için proje dizininizde aşağıdaki komutu çalıştırın:

npm install --save <package>

Tüm npm paketlerinizi geri yüklemek için proje dizininizden aşağıdaki komutu çalıştırın:

npm install

İlgili makaleler

• Npm paketlerini yayımlama (YAML/Klasik)
• npmjs.com paketlerini kullanma
• npm kapsamlarını kullanma