Npm@1 – npm v1 feladat

Ezzel a feladatgal npm-csomagokat telepíthet és tehet közzé, vagy futtathat egy npm parancsot. Támogatja npmjs.com és hitelesíti a regisztrációs adatbázisokat, például az Azure Artifactst.

Megjegyzés

Az npm-hitelesítés feladat az Azure Artifacts-hitelesítés ajánlott módja. Ez a feladat már nem vesz igénybe új funkciókat, és csak a kritikus hibákat hárítja el.

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.

Bevitelek

command - Parancs
string. Kötelező. Engedélyezett értékek: ci, install, publish, custom. Alapértelmezett érték: install.

Megadja a végrehajtáshoz npm átadott parancsokat és argumentumokat.

Ha az argumentumok dupla idézőjeleket (") tartalmaznak, sztringgel (\) sztringet kell feloldani, és a feloldott sztringet idézőjelekkel (") kell körülvenni.

workingDir - Package.json tartalmazó munkamappa
string.

Megadja a célfájlt package.json és .npmrc a fájlokat tartalmazó mappa elérési útját. Válassza ki a mappát, ne a fájlt. Példa: /packages/mypackage.

verbose - Részletes naplózás
boolean. Választható. Használja a következőt: command = install || command = ci || command = publish.

További információt nyomtat ki a konzolra a feladat futtatásakor.

customCommand - Parancsok és argumentumok
string. Akkor szükséges, ha command = custom.

Egyéni parancsot futtat. Példa: dist-tag ls mypackage.

customRegistry - Használandó regisztrációs adatbázisok
string. Választható. Használja a következőt: command = install || command = ci || command = custom. Engedélyezett értékek: useNpmrc (Regisztrációs adatbázisok az .npmrc fájlban) useFeed (Itt kiválasztom a beállításjegyzéket). Alapértelmezett érték: useNpmrc.

Meghatározza a használni kívánt regisztrációs adatbázisokat. Véglegesítsen egy .npmrc fájlt a forráskódtárban, és állítsa be az elérési útját értékként, vagy adjon meg egy beállításjegyzéket az Azure Artifactsből értékként.

customFeed - Az Azure Artifacts/TFS-beállításjegyzékből származó csomagok használata
string. Akkor szükséges, ha customRegistry = useFeed && command = install || command = ci || command = custom.

Tartalmazza a kiválasztott hírcsatornát a létrehozott .npmrcfájlban. Projekthatókörű hírcsatornák esetén használja ProjectName/FeedName a vagy ProjectID/FeedIDa parancsot. A szervezeti hatókörű hírcsatornák esetében az értéknek a hírcsatorna neve kell, hogy legyen.

customEndpoint - Hitelesítő adatok a szervezeten/gyűjteményen kívüli regisztrációs adatbázisokhoz
string. Választható. Használja a következőt: customRegistry = useNpmrc && command = install || command = ci || command = custom.

A projektben .npmrctalálható külső regisztrációs adatbázisokhoz használandó hitelesítő adatok. Hagyja üresen ezt a mezőt az ebben a fiókban/gyűjteményben található regisztrációs adatbázisok esetében; a feladat automatikusan használja a build hitelesítő adatait.

publishRegistry - Beállításjegyzék helye
string. Választható. Használja a következőt: command = publish. Engedélyezett értékek: useExternalRegistry (Külső npm beállításjegyzék (más fiókokat/gyűjteményeket is beleértve)) useFeed (Itt kiválasztom a beállításjegyzéket). Alapértelmezett érték: useExternalRegistry.

Megadja azt a beállításjegyzéket, amelyet a parancs megcélz.

publishFeed - Célregisztrációs adatbázis
string. Akkor szükséges, ha publishRegistry = useFeed && command = publish.

A fiókban üzemeltetett beállításjegyzéket adja meg. Az itt található beállításjegyzék kiválasztásához telepítve és licencelve kell lennie a Csomagkezelés szolgáltatásnak.

publishPackageMetadata - Folyamat metaadatainak közzététele
boolean. Választható. Használja a következőt: command = publish && publishRegistry = useFeed && command = install || command = ci || command = publish. Alapértelmezett érték: true.

Társítja a buildelési/kiadási folyamat metaadatait (a futtatási # és a forráskód adatait) a csomaghoz.

publishEndpoint - Külső beállításjegyzék
string. Akkor szükséges, ha publishRegistry = useExternalRegistry && command = publish.

Megadja a külső beállításjegyzékben való közzétételhez használandó hitelesítő adatokat.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Megjegyzés

A projektgyűjtemény buildszolgáltatását és a projekt buildszolgáltatás-identitásátKözreműködő értékre kell állítani, hogy a csomagokat közzétehesse egy csatornán az Azure Pipelines használatával. További részletekért lásd: Új felhasználók/csoportok hozzáadása .

Hol tanulhatok npm-parancsokat és argumentumokat?

• npm-dokumentumok

Példák

• A Node.js-alkalmazás létrehozása a Gulp használatával

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	A saját üzemeltetésű ügynököknek olyan képességekkel kell rendelkezniük , amelyek megfelelnek az alábbi követelményeknek a feladatot használó feladatok futtatásához: npm
Képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	2.115.0 vagy újabb
Feladatkategória	Csomag