Npm@1 — zadanie npm v1

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

Uwaga

Zadanie npm Authenticate to zalecany sposób uwierzytelniania za pomocą usługi Azure Artifacts. To zadanie nie zajmuje już nowych funkcji i dotyczy tylko krytycznych usterek.

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

Dane wejściowe

command - Polecenia
string. Wymagane. Dozwolone wartości: ci, , publishinstall, custom. Wartość domyślna: install.

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

Jeśli argumenty zawierają cudzysłowy podwójne ("), uniknij ich ukośnikiem (\) i otaczają ciąg ucieczki podwójnym cudzysłowem (").

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

Określa ścieżkę do folderu zawierającego element docelowy package.json i .npmrc pliki. 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 do konsoli po uruchomieniu zadania.

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

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

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

Określa rejestry do użycia. .npmrc Zatwierdź plik w 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żywanie pakietów z tego rejestru usługi Azure Artifacts/TFS
string. Wymagane, gdy customRegistry = useFeed && command = install || command = ci || command = custom.

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

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

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

publishRegistry - Lokalizacja rejestru
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, dla którego będzie przeznaczone polecenie.

publishFeed - Rejestr docelowy
string. Wymagane, gdy publishRegistry = useFeed && command = publish.

Określa rejestr hostowany na koncie. Aby wybrać rejestr, musisz mieć zainstalowane i licencjonowane zarządzanie pakietami.

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

Kojarzy metadane potoku kompilacji/wydania (informacje o kodzie uruchomienia i kodu źródłowego) z pakietem.

publishEndpoint - Rejestr zewnętrzny
string. Wymagane, gdy publishRegistry = useExternalRegistry && command = publish.

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

Opcje sterowania zadania

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

Zmienne wyjściowe

Brak.

Uwagi

Uwaga

Usługa kompilacji kolekcji projektów i tożsamość usługi kompilacji projektu muszą mieć wartość Współautor, aby publikować 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?

• dokumentacja narzędzia npm

Przykłady

• Tworzenie aplikacji Node.js za pomocą narzędzia gulp

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa w	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami dotyczącymi 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ń	Dowolne
Zmienne ustawialne	Dowolne
Wersja agenta	2.115.0 lub nowsza
Kategoria zadania	Pakiet