Npm@1 - npm v1 görevi

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

Uyarı

Azure Artifacts akışlarıyla kimlik doğrulaması yapmak için npm Kimlik Doğrulaması görevini kullanın. Görev Npm@1 artık etkin geliştirme aşamasında değil, yalnızca kritik hatalar gideriliyor.

Sözdizimi

# 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. 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 (command = install || command = ci || command = custom) && customRegistry = useFeed. Use packages from this Azure Artifacts/TFS registry. 
    #customEndpoint: # string. Optional. Use when (command = install || command = ci || command = custom) && customRegistry = useNpmrc. 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.

Girişler

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

Yürütme için npm geçirilen 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.

Paketler varsayılan olarak yerel olarak yüklenir. Paketleri genel olarak yüklemek için komut olarak install -g belirtin. Daha fazla bilgi için bkz. Paketleri genel olarak indirme ve yükleme ve paketleriyerel olarak indirme ve yükleme.


package.jsoniçeren workingDir - Çalışma klasörü
string.

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


Ayrıntılı günlükverbose -
boolean. Opsiyonel. command = install || command = ci || command = publisholduğunda kullanın.

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


customCommand - Komutu ve bağımsız değişkenleri
string. command = customgerekir.

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


kullanmak için Kayıt Defterlerini customRegistry -
string. Opsiyonel. command = install || command = ci || command = customolduğunda kullanı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 dosyası 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 defteri gelen paketleri kullanın
string. (command = install || command = ci || command = custom) && customRegistry = useFeedgerekir.

Seçilen akışı oluşturulan .npmrcekler. Proje kapsamlı akışlar için ProjectName/FeedName veya ProjectID/FeedIDkullanın. Kuruluş kapsamındaki akışlar için değer akış adı olmalıdır.


Bu kuruluş/koleksiyondışındaki kayıt defterleri için customEndpoint - Kimlik Bilgileri
string. Opsiyonel. (command = install || command = ci || command = custom) && customRegistry = useNpmrcolduğunda kullanın.

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


kayıt defteri konumupublishRegistry -
string. Opsiyonel. command = publisholduğunda kullanı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.


hedef kayıt defteripublishFeed -
string. publishRegistry = useFeed && command = publishgerekir.

Hesapta barındırılan bir kayıt defterini 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. Opsiyonel. command = publish && publishRegistry = useFeedolduğunda kullanı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.


Dış Kayıt DefteripublishEndpoint -
string. publishRegistry = useExternalRegistry && command = publishgerekir.

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


Görev denetimi seçenekleri

Tüm görevlerin, 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

Uyarı

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

Listelenen npm komutları hakkında nereden daha fazla bilgi edinebilirim?

Örnekler

Gereksinimler

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Agent, DeploymentGroup
Talepleri Şirket içinde barındırılan aracıların, bu görevi kullanan işleri çalıştırmak için aşağıdaki talepleri talep eden özellikleri olmalıdır: npm
Özellikleri Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Herhangi bir
Ayarlanabilir değişkenleri Herhangi bir
Aracı sürümü 2.115.0 veya üzeri
Görev kategorisi Paket