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 = publish
kullanı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 = publish
kullanı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 = custom
gereklidir.
Ö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 = custom
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
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 = custom
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
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 = custom
gereklidir.
Seçilen akışı oluşturulan .npmrc
öğesine ekler. Proje kapsamlı akışlar için veya ProjectID/FeedID
kullanı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 = custom
gereklidir.
Seçilen akışı oluşturulan .npmrc
öğesine ekler. Proje kapsamlı akışlar için veya ProjectID/FeedID
kullanı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 = custom
kullanın.
Projenin .npmrc
iç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 = custom
kullanın.
Projenin .npmrc
iç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 = custom
kullanın.
Projenin .npmrc
iç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 = publish
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.
publishFeed
- Hedef kayıt defteri
string
. olduğunda publishRegistry = useFeed && command = publish
gereklidir.
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 = publish
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.
publishPackageMetadata
- İşlem hattı meta verilerini yayımlama
boolean
. İsteğe bağlı. olduğunda command = publish && publishRegistry = useFeed && command = install || command = publish
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.
publishEndpoint
- Dış Kayıt Defteri
string
. olduğunda publishRegistry = useExternalRegistry && command = publish
gereklidir.
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 |