Npm@1 - npm v1 görevi

Npm paketlerini yükleyip yayımlamak veya bir npm komut çalıştırmak için bu görevi kullanın. Azure Artifacts gibi kayıt defterlerini ve kimliği doğrulanmış kayıt defterlerini destekler npmjs.com .

Not

npm Authenticate görevi, Azure Artifacts ile kimlik doğrulaması yapmak için önerilen yoldur. Bu görev artık yeni özellikler almaz ve yalnızca kritik hatalar giderilir.

Syntax

# npm v1
# Install and publish npm packages, or run an npm command. Supports npmjs.com and authenticated registries like Azure Artifacts.
- task: Npm@1
  inputs:
    command: 'install' # 'ci' | 'install' | 'publish' | 'custom'. Required. Command. Default: install.
    #workingDir: # string. Working folder that contains package.json. 
    #customCommand: # string. Required when command = custom. Command and arguments. 
  # Advanced
    #verbose: # boolean. Optional. Use when command = install || command = ci || command = publish. Verbose logging. 
    #publishPackageMetadata: true # boolean. Optional. Use when command = publish && publishRegistry = useFeed && command = install || command = ci || command = publish. Publish pipeline metadata. Default: true.
  # Custom registries and authentication
    #customRegistry: 'useNpmrc' # 'useNpmrc' | 'useFeed'. Optional. Use when command = install || command = ci || command = custom. Registries to use. Default: useNpmrc.
    #customFeed: # string. Required when customRegistry = useFeed && command = install || command = ci || command = custom. Use packages from this Azure Artifacts/TFS registry. 
    #customEndpoint: # string. Optional. Use when customRegistry = useNpmrc && command = install || command = ci || command = custom. Credentials for registries outside this organization/collection. 
  # Destination registry and authentication
    #publishRegistry: 'useExternalRegistry' # 'useExternalRegistry' | 'useFeed'. Optional. Use when command = publish. Registry location. Default: useExternalRegistry.
    #publishFeed: # string. Required when publishRegistry = useFeed && command = publish. Target registry. 
    #publishEndpoint: # string. Required when publishRegistry = useExternalRegistry && command = publish. External Registry.
# npm v1
# Install and publish npm packages, or run an npm command. Supports npmjs.com and authenticated registries like Azure Artifacts.
- task: Npm@1
  inputs:
    command: 'install' # 'install' | 'publish' | 'custom'. Required. Command. Default: install.
    #workingDir: # string. Working folder that contains package.json. 
    #customCommand: # string. Required when command = custom. Command and arguments. 
  # Advanced
    #verbose: # boolean. Optional. Use when command = install || command = publish. Verbose logging. 
    #publishPackageMetadata: true # boolean. Optional. Use when command = publish && publishRegistry = useFeed && command = install || command = publish. Publish pipeline metadata. Default: true.
  # Custom registries and authentication
    #customRegistry: 'useNpmrc' # 'useNpmrc' | 'useFeed'. Optional. Use when command = install || command = custom. Registries to use. Default: useNpmrc.
    #customFeed: # string. Required when customRegistry = useFeed && command = install || command = custom. Use packages from this Azure Artifacts/TFS registry. 
    #customEndpoint: # string. Optional. Use when customRegistry = useNpmrc && command = install || command = custom. Credentials for registries outside this organization/collection. 
  # Destination registry and authentication
    #publishRegistry: 'useExternalRegistry' # 'useExternalRegistry' | 'useFeed'. Optional. Use when command = publish. Registry location. Default: useExternalRegistry.
    #publishFeed: # string. Required when publishRegistry = useFeed && command = publish. Target registry. 
    #publishEndpoint: # string. Required when publishRegistry = useExternalRegistry && command = publish. External Registry.
# npm v1
# Install and publish npm packages, or run an npm command. Supports npmjs.com and authenticated registries like Package Management.
- task: Npm@1
  inputs:
    command: 'install' # 'install' | 'publish' | 'custom'. Required. Command. Default: install.
    #workingDir: # string. Working folder with package.json. 
    #customCommand: # string. Required when command = custom. Command and arguments. 
  # Advanced
    #verbose: # boolean. Optional. Use when command = install || command = publish. Verbose logging. 
  # Custom registries and authentication
    #customRegistry: 'useNpmrc' # 'useNpmrc' | 'useFeed'. Optional. Use when command = install || command = custom. Registries to use. Default: useNpmrc.
    #customFeed: # string. Required when customRegistry = useFeed && command = install || command = custom. Use packages from this Azure Artifacts/TFS registry. 
    #customEndpoint: # string. Optional. Use when customRegistry = useNpmrc && command = install || command = custom. Credentials for registries outside this account/collection. 
  # Destination registry and authentication
    #publishRegistry: 'useExternalRegistry' # 'useExternalRegistry' | 'useFeed'. Optional. Use when command = publish. Registry location. Default: useExternalRegistry.
    #publishFeed: # string. Required when publishRegistry = useFeed && command = publish. Target registry. 
    #publishEndpoint: # string. Required when publishRegistry = useExternalRegistry && command = publish. External Registry.

Girişler

command - Komut
string. Gereklidir. İzin verilen değerler: ci, install, publish, custom. Varsayılan değer: install.

Yürütme için öğesine geçirilen npm komutu ve bağımsız değişkenleri belirtir.

Bağımsız değişkenleriniz çift tırnak ()" içeriyorsa, bunları eğik çizgiyle ()\ kaçış ve kaçış dizesini çift tırnak ()" ile çevreleyin.


command - Komut
string. Gereklidir. İzin verilen değerler: install, publish, custom. Varsayılan değer: install.

Yürütme için öğesine geçirilen npm komutu ve bağımsız değişkenleri belirtir.

Bağımsız değişkenleriniz çift tırnak ()" içeriyorsa, bunları eğik çizgiyle ()\ kaçış ve kaçış dizesini çift tırnak ()" ile çevreleyin.


workingDir - package.json içeren çalışma klasörü
string.

Hedefi package.json ve .npmrc dosyaları içeren klasörün yolunu belirtir. Dosyayı değil klasörü seçin. Örnek: /packages/mypackage.


workingDir - package.json ile çalışma klasörü
string.

Hedefi package.json ve .npmrc dosyaları içeren klasörün yolunu belirtir. Dosyayı değil klasörü seçin. Örnek: /packages/mypackage.


verbose - Ayrıntılı günlük kaydı
boolean. İsteğe bağlı. olduğunda command = install || command = ci || command = publishkullanın.

Görev çalıştırıldığında konsola daha fazla bilgi yazdırır.


verbose - Ayrıntılı günlük kaydı
boolean. İsteğe bağlı. olduğunda command = install || command = publishkullanın.

Görev çalıştırıldığında konsola daha fazla bilgi yazdırır.


customCommand - Komut ve bağımsız değişkenler
string. olduğunda command = customgereklidir.

Özel bir komut çalıştırır. Örnek: dist-tag ls mypackage.


customRegistry - Kullanılacak kayıt defterleri
string. İsteğe bağlı. olduğunda command = install || command = ci || command = customkullanın. İzin verilen değerler: useNpmrc (.npmrc'mdeki kayıt defterleri), useFeed (Buradan seçtiğim Kayıt Defteri). Varsayılan değer: useNpmrc.

Kullanılacak kayıt defterlerini belirtir. Kaynak kod deponuza bir .npmrc dosya işleyin ve yolunu değer olarak ayarlayın veya değer olarak Azure Artifacts'ten bir kayıt defteri belirtin.


customRegistry - Kullanılacak kayıt defterleri
string. İsteğe bağlı. olduğunda command = install || command = customkullanın. İzin verilen değerler: useNpmrc (.npmrc'mdeki kayıt defterleri), useFeed (Buradan seçtiğim Kayıt Defteri). Varsayılan değer: useNpmrc.

Kullanılacak kayıt defterlerini belirtir. Kaynak kod deponuza bir .npmrc dosya işleyin ve yolunu değer olarak ayarlayın veya değer olarak Azure Artifacts'ten bir kayıt defteri belirtin.


customFeed - Bu Azure Artifacts/TFS kayıt defterinden paketleri kullanın
string. olduğunda customRegistry = useFeed && command = install || command = ci || command = customgereklidir.

Seçilen akışı oluşturulan .npmrcöğesine ekler. Proje kapsamlı akışlar için veya ProjectID/FeedIDkullanınProjectName/FeedName. Kuruluş kapsamındaki akışlar için değer, akış adı olmalıdır.


customFeed - Bu Azure Artifacts/TFS kayıt defterinden paketleri kullanın
string. olduğunda customRegistry = useFeed && command = install || command = customgereklidir.

Seçilen akışı oluşturulan .npmrcöğesine ekler. Proje kapsamlı akışlar için veya ProjectID/FeedIDkullanınProjectName/FeedName. Kuruluş kapsamındaki akışlar için değer, akış adı olmalıdır.


customEndpoint - Bu kuruluş/koleksiyon dışındaki kayıt defterleri için kimlik bilgileri
string. İsteğe bağlı. olduğunda customRegistry = useNpmrc && command = install || command = ci || command = customkullanın.

Projenin .npmrciçinde bulunan dış kayıt defterleri için kullanılacak kimlik bilgileri. Bu hesaptaki/koleksiyondaki kayıt defterleri için bunu boş bırakın; görev, derlemenin kimlik bilgilerini otomatik olarak kullanır.


customEndpoint - Bu kuruluş/koleksiyon dışındaki kayıt defterleri için kimlik bilgileri
string. İsteğe bağlı. olduğunda customRegistry = useNpmrc && command = install || command = customkullanın.

Projenin .npmrciçinde bulunan dış kayıt defterleri için kullanılacak kimlik bilgileri. Bu hesaptaki/koleksiyondaki kayıt defterleri için bunu boş bırakın; görev, derlemenin kimlik bilgilerini otomatik olarak kullanır.


customEndpoint - Bu hesap/koleksiyon dışındaki kayıt defterleri için kimlik bilgileri
string. İsteğe bağlı. olduğunda customRegistry = useNpmrc && command = install || command = customkullanın.

Projenin .npmrciçinde bulunan dış kayıt defterleri için kullanılacak kimlik bilgileri. Bu hesaptaki/koleksiyondaki kayıt defterleri için bunu boş bırakın; görev, derlemenin kimlik bilgilerini otomatik olarak kullanır.


publishRegistry - Kayıt defteri konumu
string. İsteğe bağlı. olduğunda command = publishkullanın. İzin verilen değerler: useExternalRegistry (Dış npm kayıt defteri (diğer hesaplar/koleksiyonlar dahil)), useFeed (Buradan seçtiğim Kayıt Defteri). Varsayılan değer: useExternalRegistry.

Komutun hedefleeceği kayıt defterini belirtir.


publishFeed - Hedef kayıt defteri
string. olduğunda publishRegistry = useFeed && command = publishgereklidir.

Hesapta barındırılan bir kayıt defteri belirtir. Burada bir kayıt defteri seçmek için Paket Yönetimi'nin yüklü ve lisanslı olması gerekir.


publishPackageMetadata - İşlem hattı meta verilerini yayımlama
boolean. İsteğe bağlı. olduğunda command = publish && publishRegistry = useFeed && command = install || command = ci || command = publishkullanın. Varsayılan değer: true.

Derleme/yayın işlem hattının meta verilerini (çalıştırma # ve kaynak kodu bilgileri) paketle ilişkilendirir.


publishPackageMetadata - İşlem hattı meta verilerini yayımlama
boolean. İsteğe bağlı. olduğunda command = publish && publishRegistry = useFeed && command = install || command = publishkullanın. Varsayılan değer: true.

Derleme/yayın işlem hattının meta verilerini (çalıştırma # ve kaynak kodu bilgileri) paketle ilişkilendirir.


publishEndpoint - Dış Kayıt Defteri
string. olduğunda publishRegistry = useExternalRegistry && command = publishgereklidir.

Dış kayıt defterinde yayımlamak için kullanılacak kimlik bilgilerini belirtir.


Görev denetim seçenekleri

Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

Not

Paketlerinizi Azure Pipelines kullanarak bir akışta yayımlamak için Proje Koleksiyonu Derleme Hizmeti ve projenizin Derleme Hizmeti kimliği Katkıda Bulunan olarak ayarlanmalıdır. Daha fazla ayrıntı için bkz. Yeni kullanıcı/grup ekleme .

Npm komutlarını ve bağımsız değişkenlerini nereden öğrenebilirim?

Örnekler

Gereksinimler

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalıştırılır Agent, DeploymentGroup
Talep Şirket içinde barındırılan aracılar, bu görevi kullanan işleri çalıştırmak için aşağıdaki taleplerle eşleşen özelliklere sahip olmalıdır: npm
Özellikler Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Herhangi biri
Ayarlanabilir değişkenler Herhangi biri
Aracı sürümü 2.115.0 veya üzeri
Görev kategorisi Paket
Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalıştırılır Agent, DeploymentGroup
Talep Şirket içinde barındırılan aracılar, bu görevi kullanan işleri çalıştırmak için aşağıdaki taleplerle eşleşen özelliklere sahip olmalıdır: npm
Özellikler Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Herhangi biri
Ayarlanabilir değişkenler Herhangi biri
Aracı sürümü 1.91.0 veya üzeri
Görev kategorisi Paket