Npm@1 — zadanie npm v1

Artykuł
03/24/2025

To zadanie służy do instalowania i publikowania pakietów npm lub uruchamiania polecenia npm. Obsługuje npmjs.com i uwierzytelnione rejestry, takie jak Azure Artifacts.

Uwaga

zadania uwierzytelniania npm jest zalecanym sposobem uwierzytelniania za pomocą usługi Azure Artifacts. To zadanie nie wymaga już nowych funkcji i są rozwiązywane tylko krytyczne usterki.

Składnia

# 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.

Dane wejściowe

command - polecenia
string. To jest wymagane. Dozwolone wartości: ci, , installpublish, custom. Wartość domyślna: install.

Określa polecenie i argumenty, które są przekazywane do npm do wykonania.

Jeśli argumenty zawierają cudzysłowy podwójne ("), należy je użyć ukośnika (\) i otoczyć ciąg ucieczki podwójnymi cudzysłowami (").

Domyślnie pakiety są instalowane lokalnie. Aby zainstalować pakiety globalnie, określ install -g jako polecenie. Aby uzyskać więcej informacji, zobacz Pobieranie i instalowanie pakietów globalnie oraz Pobieranie i instalowanie pakietów lokalnie.

workingDir - folder roboczy zawierający package.json
string.

Określa ścieżkę do folderu zawierającego package.json docelową i pliki .npmrc. Wybierz folder, a nie plik. Przykład: /packages/mypackage.

verbose - pełne rejestrowanie
boolean. Opcjonalny. Użyj polecenia , gdy command = install || command = ci || command = publish.

Wyświetla więcej informacji w konsoli po uruchomieniu zadania.

customCommand - polecenia i argumenty
string. Wymagane, gdy command = custom.

Uruchamia polecenie niestandardowe. Przykład: dist-tag ls mypackage.

rejestry customRegistry - do używania
string. Opcjonalny. Użyj polecenia , gdy command = install || command = ci || command = custom. Dozwolone wartości: useNpmrc (rejestry w pliku npmrc), useFeed (rejestr wybieram tutaj). Wartość domyślna: useNpmrc.

Określa rejestry do użycia. Zatwierdź plik .npmrc do repozytorium kodu źródłowego i ustaw jego ścieżkę jako wartość lub określ rejestr z usługi Azure Artifacts jako wartość.

customFeed - Użyj pakietów z tego rejestru Azure Artifacts/TFS
string. Wymagane, gdy (command = install || command = ci || command = custom) && customRegistry = useFeed.

Zawiera wybrane źródło danych w wygenerowanych .npmrc. W przypadku źródeł danych o zakresie projektu użyj ProjectName/FeedName lub ProjectID/FeedID. W przypadku źródeł danych o zakresie organizacji wartość powinna być nazwą źródła danych.

customEndpoint - poświadczenia dla rejestrów spoza tej organizacji/kolekcji
string. Opcjonalny. Użyj polecenia , gdy (command = install || command = ci || command = custom) && customRegistry = useNpmrc.

Poświadczenia do użycia w rejestrach zewnętrznych znajdujących się w .npmrcprojektu . Pozostaw to pole puste dla rejestrów w tym koncie/kolekcji; zadanie automatycznie używa poświadczeń kompilacji.

lokalizacji rejestru publishRegistry -
string. Opcjonalny. Użyj polecenia , gdy command = publish. Dozwolone wartości: useExternalRegistry (zewnętrzny rejestr npm (w tym inne konta/kolekcje)), useFeed (rejestr wybieram tutaj). Wartość domyślna: useExternalRegistry.

Określa rejestr, na który będzie kierowane polecenie.

publishFeed - rejestru docelowego
string. Wymagane, gdy publishRegistry = useFeed && command = publish.

Określa rejestr hostowany na koncie. Musisz mieć zainstalowane i licencjonowane zarządzanie pakietami, aby wybrać rejestr tutaj.

publishPackageMetadata - publikowanie metadanych potoku
boolean. Opcjonalny. Użyj polecenia , gdy command = publish && publishRegistry = useFeed. Wartość domyślna: true.

Kojarzy metadane potoku kompilacji/wydania (uruchom # i informacje o kodzie źródłowym) z pakietem.

publishEndpoint - rejestru zewnętrznego
string. Wymagane, gdy publishRegistry = useExternalRegistry && command = publish.

Określa poświadczenia do użycia do publikowania w rejestrze zewnętrznym.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

Uwaga

Tożsamość Project Collection Build Service, a tożsamość usługi Build Service projektu musi być ustawiona na wartość Współautor, aby opublikować pakiety w kanale informacyjnym przy użyciu usługi Azure Pipelines. Aby uzyskać więcej informacji, zobacz Dodawanie nowych użytkowników/grup.

Gdzie można nauczyć się poleceń i argumentów npm?

docs npm

Przykłady

Tworzenie aplikacji Node.js za pomocą gulp

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Agenci self-hosted muszą mieć możliwości, które są zgodne z następującymi wymaganiami do uruchamiania zadań korzystających z tego zadania: npm
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	2.115.0 lub nowsza
Kategoria zadań	Pakiet

Udostępnij za pośrednictwem