Azure Artifacts NPM paketleriyle çalışmaya başlama

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

Paketleri yayımlama

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

npm publish

Önemli

publishConfigYayımlama zamanında kayıt defteri yapılandırma param 'ı geçersiz kılmak için özelliğini kullanmak desteklenmez.

Paketleri geri yükleme

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

npm install --save <package>

Sonraki adımlar

NPM paketlerini yayımlama (YAML/klasik)npmjs.com from NPM kapsamlarındanpaketleri kullanmaNPM denetimi kullan

Azure Artifacts ile, npm paketlerini npmjs.com gibi akışlardan ve genel kayıt defterlerinden yayımlayabilir ve indirebilirsiniz. bu hızlı başlangıç, kendi akışınızı oluşturma, projenizi ayarlama ve Azure Artifacts akışınıza ve npm paketlerini yayımlama ve indirme konusunda size kılavuzluk eder.

Azure Artifacts uzantısına lisans

TFS 'de Azure Artifacts kullanmak için, Visual Studio Team Foundation Server 2017 ' ye yükseltmeniz gerekir. Azure Artifacts uzantısı kaldırılmışsa, bunu Visual Studio marketi'nden yükleyebilirsiniz.

Team Foundation Server lisansları atama

Her kuruluş beş ücretsiz lisans alır. beşten fazla lisansa ihtiyacınız varsa Visual Studio marketi' ne gidin ve ücretsiz al' ı seçin.

Emin değilseniz, 30 günlük ücretsiz denemeyi Başlat' ı seçebilirsiniz. daha sonra kuruluşunuzdaki her kullanıcıya 30 gün boyunca Azure Artifacts erişim verilir. 30 günlük deneme süresinden sonra kuruluşunuz, beş Kullanıcı adlı kullanıcıya geri döner ve lisansları ayrı kullanıcılara atamanız gerekir. bu noktada ek lisanslara ihtiyacınız varsa, bunları Visual Studio market 'ten satın alabilirsiniz. Visual Studio Enterprise lisansınız varsa, zaten Azure Artifacts erişiminizin olması ve lisans atanması gerekmez. yalnızca "Visual Studio Enterprise" erişim düzeyini atadığınızdan emin olun.

Not

30 günlük ücretsiz denemeyi Başlat ' ı seçtiyseniz ve hala deneme süresinde çalışıyorsanız, her kullanıcıya erişim verilir. Deneme süresi sona erene kadar lisansların atanması gerekmez.

Team Foundation Server tüm koleksiyonlardan, ayarlar menüsünün üzerine gelin ve kullanıcılar' ı seçin. Paket Yönetimiöğesini seçin.
Ata' yı seçin, lisans atamak istediğiniz kullanıcıları girin ve Tamam' ı seçin.
- Visual Studio Enterprise aboneliklerine sahip kullanıcılar ücretsiz Azure Artifacts alır. Visual Studio Enterprise abonelerinizin uygun erişim düzeyine sahip olduğundan emin olun. Daha fazla bilgi için bkz. erişim düzeylerini değiştirme.
- ınternet bağlantısı kesilen bir Team Foundation Server örneğini kullanan kullanıcılar (ve bu nedenle Visual Studio market 'ten lisans satın almamanız), bir kurumsal anlaşma aracılığıyla satın alınan lisansları yine de atayabilir.

Akış oluşturma

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

Projenizin içinden Azure Artifacts' a gidin.
Akış oluştur' u seçin.
Akışınıza bir ad verin ve görünürlüğünü, yukarı akış kaynaklarınıve kapsam ayarlarını seçin.
İşiniz bittiğinde Oluştur ' u seçin.

Azure Artifacts TFS 2017 müşterileri için varsayılan olarak yüklenir. Azure Artifacts kullanmak için TFS 2017 ' e yükseltmeniz gerekir. Akışınızı ilk kez kullanıyorsanız, bir lisans atamanız istenebilir

Derleme sürümü ' ne gidin ve paketler' i seçin.
+ Yeni akış' ı seçin.
Akışa bir ad, Açıklamaverin ve kimler okuyabilen, dış paketleri dahiletmek istiyorsanız kimlerin katkıda bulunabileceğini ve bunları okuyabilirler.
İşiniz bittiğinde Oluştur ' u seçin.

Bu ayarları daha sonra, akışınızın ayarlarını düzenleyerek değiştirebilirsiniz.

Akışı Düzenle düğmesinin ekran görüntüsü.

Akışı Düzenle düğmesinin TFS ekran görüntüsü.

. Npmrc dosyalarınızı ayarlama

Not

vsts-npm-authTFS ve Azure DevOps Server desteklenmez.

İki. npmrc dosyası olmasını öneririz. Birincisi, Package. JSON dosyanız ile aynı dizine yerleştirilmelidir. İkinci bir, $Home dizinine (Linux/MacOS) veya $env yerleştirilmelidir. kimlik bilgilerinizi depolamak için ana (Windows). NPM istemcisi daha sonra bu dosyayı arayabilir ve kimlik bilgilerinizi kimlik doğrulama için getirebilir. Bu, kimlik bilgilerinizi güvende tutarken yapılandırma dosyanızı paylaşmanızı sağlar.

Artifacts' yi seçin ve ardından akışa Bağlan' ı seçin.
NPM'yi seçin. Azure Artifacts ilk kez kullanıyorsanız, araçları al ' ı seçin ve ardından Node.js indirmek ve kimlik bilgisi sağlayıcısını ayarlamak için adımları izleyin.
projenizi ayarlamak için Project kurulumunda bulunan yönergeleri izleyin.

Geliştirme makinenizde kimlik doğrulamasını ayarlama

Önemli

NPM registry ,. npmrc dosyanızda tek bir destekler. Kapsamlar ve yukarı akış kaynaklarıylabirden çok kayıt defterleri mümkündür.

Windows
Linux/MacOS

Windows üzerinde geliştiriyorsanız vsts-npm-auth Azure Artifacts kimlik doğrulaması yapmak için kullanmanızı öneririz. npm install -g vsts-npm-authPaketi genel olarak yüklemek için çalıştırın ve ardından Package. json ' a bir çalıştırma betiği ekleyin.

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

vsts-npm-auth Linux/MacOS 'ta desteklenmez. Azure Artifacts kimlik doğrulaması yapmak için bir kişisel erişim belirteci oluşturmalı ve bunu. npmrc dosyasına ekleyeceğiz.

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.
```
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 ardından ENTERtuşuna basın.
3. Base64 kodlamalı değeri kopyalayın.
[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]. Npmrc dosyanızdaki yer tutucuyu Base64 kişisel erişim belirtecinizle değiştirin.

paketler' i seçin ve ardından akışa Bağlan' yi seçin.
NPM'yi seçin.
NPM kimlik bilgileri oluştur' u seçin. Kimlik bilgilerini kopyalayın ve. npmrc dosyanıza ekleyin.