Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Använd den här uppgiften för att installera och publicera npm-paket eller för att köra ett npm kommando. Stöder npmjs.com och autentiserade register som Azure Artifacts.
Anmärkning
Om du vill autentisera med Azure Artifacts-feeds använder du npm Authenticate-uppgiften . Uppgiften Npm@1 är inte längre under aktiv utveckling, endast kritiska buggar åtgärdas.
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. 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.
Ingångar
command
-
kommando
string. Obligatoriskt. Tillåtna värden: ci, install, publish, custom. Standardvärde: install.
Anger kommandot och argumenten som skickas till npm för körning.
Om argumenten innehåller dubbla citattecken ("), kan du undvika dem med ett snedstreck (\) och omge den undantagna strängen med dubbla citattecken (").
Som standard installeras paket lokalt. Om du vill installera paket globalt anger du install -g som kommando. Mer information finns i Ladda ned och installera paket globalt och Hämta och installera paket lokalt.
workingDir
-
Arbetsmapp som innehåller package.json
string.
Anger sökvägen till mappen som innehåller målfilerna package.json och .npmrc. Välj mappen, inte filen. Exempel: /packages/mypackage.
verbose
-
utförlig loggning
boolean. Valfritt. Använd när command = install || command = ci || command = publish.
Skriver ut mer information till konsolen när aktiviteten körs.
customCommand
-
kommando och argument
string. Krävs när command = custom.
Kör ett anpassat kommando. Exempel: dist-tag ls mypackage.
customRegistry
-
att använda
string. Valfritt. Använd när command = install || command = ci || command = custom. Tillåtna värden: useNpmrc (register i min .npmrc), useFeed (register väljer jag här). Standardvärde: useNpmrc.
Anger vilka register som ska användas. Checka in en .npmrc fil till källkodslagringsplatsen och ange dess sökväg som värde, eller ange ett register från Azure Artifacts som värde.
customFeed
-
Använda paket från det här Azure Artifacts/TFS-registret
string. Krävs när (command = install || command = ci || command = custom) && customRegistry = useFeed.
Innehåller den valda feeden i den genererade .npmrc. För feeds med projektomfattning använder du ProjectName/FeedName eller ProjectID/FeedID. För feeds med organisationsomfattning ska värdet vara feednamnet.
customEndpoint
-
autentiseringsuppgifter för register utanför organisationen/samlingen
string. Valfritt. Använd när (command = install || command = ci || command = custom) && customRegistry = useNpmrc.
Autentiseringsuppgifter som ska användas för externa register som finns i projektets .npmrc. Lämna detta tomt för register i det här kontot/samlingen. aktiviteten använder autentiseringsuppgifterna för bygget automatiskt.
publishRegistry
-
Registerplats
string. Valfritt. Använd när command = publish. Tillåtna värden: useExternalRegistry (externt npm-register (inklusive andra konton/samlingar)), useFeed (register väljer jag här). Standardvärde: useExternalRegistry.
Anger det register som kommandot ska rikta in sig på.
publishFeed
-
Målregister
string. Krävs när publishRegistry = useFeed && command = publish.
Anger ett register som finns i kontot. Du måste ha Pakethantering installerat och licensierat för att kunna välja ett register här.
publishPackageMetadata
-
Publicera pipelinemetadata
boolean. Valfritt. Använd när command = publish && publishRegistry = useFeed. Standardvärde: true.
Associerar bygg-/versionspipelinens metadata (körningsnummer och källkodsinformation) med paketet.
publishEndpoint
-
externt register
string. Krävs när publishRegistry = useExternalRegistry && command = publish.
Anger de autentiseringsuppgifter som ska användas för publicering till ett externt register.
Kontrollalternativ för aktivitet
Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.
Utdatavariabler
Ingen.
Anmärkningar
Anmärkning
Project Collection Build Service och projektets Build Service- identitet måste anges till Deltagare för att publicera dina paket i en feed med Hjälp av Azure Pipelines. Mer information finns i Lägg till nya användare/grupper.
Var kan jag lära mig mer om npm-kommandona i listan?
Exempel
Krav
| Krav | Beskrivning |
|---|---|
| Pipelinetyper | YAML, klassisk version, klassisk version |
| Körs på | Agent, DeploymentGroup |
| kräver | Lokalt installerade agenter måste ha funktioner som matchar följande kräver att köra jobb som använder den här uppgiften: npm |
| funktioner | Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet. |
| Kommandobegränsningar | Vilken som helst |
| variabler som kan | Vilken som helst |
| Agentversion | 2.115.0 eller senare |
| Aktivitetskategori | Paket |