Projenizi ayarlayın ve Azure Artifacts bağlanın

Makale
11/29/2021
Okumak için 4 dakika

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017

Azure Artifacts sayesinde, akışlarınıza npm, NuGet, Python, maven ve evrensel paketler gibi farklı türlerde paketler yayımlayabilirsiniz. Ayrıca, npmjs.com gibi akışlardan ve genel kayıt defterlerinden paketleri de yükleyebilirsiniz.

Azure Artifacts kimlik doğrulaması yapmak için ilk olarak yapılandırma dosyanızı ayarlamanız gerekir. NPM, akış URL 'Lerini ve kimlik bilgilerini depolamak için . npmrc yapılandırma dosyalarını kullanır.

Proje ayarları

iki .npmrc_ dosyası kullanmanızı öneririz, birincisi Azure Artifacts kimlik doğrulaması yapmak için kullanacağız ve ikinci birinin kimlik bilgilerini depolamak için yerel olarak tutulması gerekir. Bu, projenizin . npmrc , kimlik bilgilerinizi güvenli tutarken paylaşmanızı sağlar.

Artifacts' yi seçin ve ardından akışa Bağlan' ı seçin.

paketler' i seçin ve ardından akışa Bağlan' yi seçin.

Paket türleri listesinden NPM ' yi seçin.
npm ile Azure Artifacts ilk kez kullanıyorsanız, araçları al düğmesini seçin ve önkoşulları yüklemek için yönergeleri izleyin.

projenizi ayarlamak için Project kurulum bölümündeki yönergeleri izleyin.

projenizi ayarlamak için Project kurulum bölümündeki yönergeleri izleyin.

Projenizi ayarlamak için yönergeleri izleyin.

Geliştirme makinenizde, Linux/Mac veya $env için $Home ikinci . npmrc dosyasını yerleştirin . Windows IÇIN giriş. Bu . npmrc dosyası, tüm kayıt defterlerinin kimlik bilgilerini içermelidir.

Kimlik bilgileri kurulumu

İpucu

. Npmrc dosyalarında birden çok kayıt defterleri, yukarı akış kaynakları ve kapsamlarıile desteklenir.

Windows
Linux/Mac

Windows üzerinde geliştiriyorsanız, vsts-npm-auth kimlik bilgilerini getirmek ve vsts-npm-authverilerinize eklemek için kullanmanızı öneririz. Bunu ayarlamanın en kolay yolu, vsts-npm-auth genel olarak yüklemek ve ardından vsts-npm-auth' a bir çalıştırma betiği eklemektir.

VSTS 'yi Install-NPM-auth Global:
```
npm install -g vsts-npm-auth
```

Betiği Package. JSON dosyasına Ekle:

"scripts": {
    "refreshVSToken" : "vsts-npm-auth -config .npmrc"
}

vsts-npm-auth Linux/Mac 'te desteklenmez. Kimlik bilgilerinizi ayarlamak için aşağıdaki adımları izleyin:

Aşağıdaki kod parçacığını. npmrc dosyanıza kopyalayın.

Kuruluş kapsamındaki 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

Project 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

Paket okuma ve yazma kapsamları ile bir kişisel erişim belirteci oluşturun.
Yeni oluşturulan kişisel erişim belirtecinizi aşağıdaki şekilde kodlayın:
1. Yükseltilmiş bir komut istemi penceresinde aşağıdaki komutu çalıştırın ve sorulduğunda kişisel erişim belirtecinizi yapış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(); })"
```
  Kişisel erişim belirtecinizi Base64 'e dönüştürmek için aşağıdaki komutu da kullanabilirsiniz:
  - Linuxmac:
```
echo -n "YOUR_PERSONAL_ACCESS-TOKEN" | base64
```
2. Base64 kodlamalı değeri kopyalayın.
. Npmrc dosyanızı açın ve [BASE64_ENCODED_PERSONAL_ACCESS_TOKEN] yer tutucusunu, önceki adımda oluşturduğunuz kodlanmış kişisel erişim belirtecinizle değiştirin.

Not

vsts-npm-authTFS ve Azure DevOps Server desteklenmez.

İşlem hattınızda kimlik doğrulamasını ayarlama

İşlem hattınızda kimlik doğrulaması ayarlamak için iki seçenek vardır:

Bir görev Çalıştırıcısı olmadan.
Bir görev Çalıştırıcısı (ör. Gulp) ile.

Görev Çalıştırıcısı olmadan

görev çalıştırıcısı olmadan işlem hattınızdan Azure Artifacts kimlik doğrulaması yapmak için aşağıdaki adımları izleyin:

Azure Pipelines' yi seçin ve ardından işlem hattı tanımınızı seçin.
İşlem hattınızı değiştirmek için Düzenle ' yi seçin.
İşlem + hattınızı bir görev eklemek için seçin.
NPM görevini arayın ve sonra işlem hattınızı eklemek için Ekle ' yi seçin.
Package. JSON dosyanızı içeren klasörü seçin.
Özel kayıt defterleri ve kimlik doğrulama bölümünü genişletin ve ardından buradan Select ıseçin. Açılır menüden akışınızı seçin.

Not

Bu seçeneği belirlediğinizde, görev burada seçtiğiniz akış için geçici bir . npmrc oluşturacak ve projenin . npmrcöğesini geçersiz kılacaktır.
İşiniz bittiğinde sırayı kaydet ' i seçin.

Build ve Release' i seçin ve ardından yapılar' ı seçin.
İşlem hattınızı seçin ve ardından Düzenle' yi seçin.
İşlem + hattınızı bir görev eklemek için seçin.
NPM görevini arayın ve sonra işlem hattınızı eklemek için Ekle ' yi seçin.
Package. JSON dosyanızı içeren klasörü seçin.
Özel kayıt defterleri ve kimlik doğrulama bölümünü genişletin ve ardından buradan Select ıseçin. Açılır menüden akışınızı seçin.

Not

Bu seçeneği belirlediğinizde, görev burada seçtiğiniz akış için geçici bir . npmrc oluşturacak ve projenin . npmrcöğesini geçersiz kılacaktır.
İşiniz bittiğinde sırayı kaydet ' i seçin.

İpucu

İşlem hattınızın akışınıza erişmesine izin vermek için, derleme hizmetini akışınızın ayarlarındaki bir katkıda bulunan olarak ayarladığınızdan emin olun. Azure Artifacts- > akışınızı seçin- > Ayarlar > izinleri- > derleme hizmeti rolünü >olarak ayarlayın.

İpucu ekran görüntüsü

Bir görev Çalıştırıcısı ile

Bir görev Çalıştırıcısı kullanırken, işlem hattının başlangıcında NPM kimlik doğrulaması görevi eklemeniz gerekir. Bu, kimlik bilgilerinizi projenizin . npmrc içine ekler ve işlem hattı çalıştırmasının ömrü boyunca kalıcı hale getirin. Bu, sonraki adımların . npmrciçindeki kimlik bilgilerini kullanmasına olanak sağlar.

Azure Pipelines' yi seçin ve ardından işlem hattı tanımınızı seçin.
İşlem hattınızı değiştirmek için Düzenle ' yi seçin.
İşlem + hattınızı bir görev eklemek için seçin.
NPM kimlik doğrulaması görevi için arama yapın ve sonra işlem hattınızı eklemek için Ekle ' yi seçin.
. Npmrc dosyanızı seçin.
İşiniz bittiğinde sırayı kaydet ' i seçin.

Build ve Release' i seçin ve ardından yapılar' ı seçin.
İşlem hattınızı ve ardından Düzenle'yi seçin.
İşlem + hattınıza görev eklemek için öğesini seçin.
npm Kimlik Doğrulaması görevini aranın ve ekle'yi seçerek işlem hattınıza ekleyin.
.npmrc dosyanızı seçin.
Bitirerek kuyruğu kaydet'i seçin.

Sorun giderme

Komut tanınmıyor:

Aşağıdaki hatayla karşılaştıysanız:
- 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.
Bu halde npm modules klasörü büyük olasılıkla yolunuz içinde değildir. Bu sorunu düzeltmek için kurulumda Node.js yeniden çalıştırın ve seçeneklerin Add to PATH seçildiğinden emin olun.

Alternatif olarak PATH değişkenini %APPDATA%\npm (Komut İstemi) veya $env:APPDATA\npm (PowerShell) düzenlayarak yolunuzla birlikte ebilirsiniz.
Kimlik doğrulaması yapamaz:

Bir E401 hatasıyla karşılaştıysanız: code E401 npm ERR! Unable to authenticate . Yeniden vsts-npm-auth kimlik doğrulaması yapmak vsts-npm-auth bayrağıyla çalıştırın.
```
vsts-npm-auth -config .npmrc -F
```