Npm@1 - npm v1 작업

이 작업을 사용하여 npm 패키지를 설치 및 게시하거나 명령을 실행합니다 npm . Azure Artifacts npmjs.com 와 같은 인증된 레지스트리를 지원합니다.

참고

npm 인증 작업은 Azure Artifacts를 사용하여 인증하는 데 권장되는 방법입니다. 이 작업은 더 이상 새로운 기능을 사용하지 않으며 중요한 버그만 해결됩니다.

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.

입력

command - 명령
string. 필수 요소. 허용되는 값: ci, , , publish. custominstall 기본값은 install입니다.

실행을 위해 에 전달되는 명령 및 인수를 npm 지정합니다.

인수에 큰따옴표()가 포함된 경우 슬래시("\)로 이스케이프하고 이스케이프된 문자열을 큰따옴표(")로 묶습니다.

workingDir - package.json 포함하는 작업 폴더
string.

대상 package.json 및 .npmrc 파일을 포함하는 폴더의 경로를 지정합니다. 파일이 아닌 폴더를 선택합니다. 예: /packages/mypackage.

verbose - 자세한 정보 로깅
boolean. 선택 사항입니다. 을 사용할 때 command = install || command = ci || command = publish사용합니다.

작업이 실행되면 콘솔에 자세한 정보를 출력합니다.

customCommand - 명령 및 인수
string. 필요한 경우 command = custom입니다.

사용자 지정 명령을 실행합니다. 예: dist-tag ls mypackage.

customRegistry - 사용할 레지스트리
string. 선택 사항입니다. 을 사용할 때 command = install || command = ci || command = custom사용합니다. 허용되는 값: useNpmrc (내 .npmrc의 레지스트리), useFeed (여기서 선택한 레지스트리). 기본값은 useNpmrc입니다.

사용할 레지스트리를 지정합니다. .npmrc 소스 코드 리포지토리에 파일을 커밋하고 해당 경로를 값으로 설정하거나 Azure Artifacts의 레지스트리를 값으로 지정합니다.

customFeed - 이 Azure Artifacts/TFS 레지스트리의 패키지 사용
string. 필요한 경우 customRegistry = useFeed && command = install || command = ci || command = custom입니다.

생성된 .npmrc에 선택한 피드를 포함합니다. 프로젝트 범위 피드의 경우 또는 ProjectID/FeedID를 사용합니다ProjectName/FeedName. organization 범위 피드의 경우 값은 피드 이름이어야 합니다.

customEndpoint - 이 organization/컬렉션 외부의 레지스트리에 대한 자격 증명
string. 선택 사항입니다. 을 사용할 때 customRegistry = useNpmrc && command = install || command = ci || command = custom사용합니다.

프로젝트의 에 있는 외부 레지스트리에 사용할 자격 증명입니다 .npmrc. 이 계정/컬렉션의 레지스트리에 대해 이 값을 비워 둡니다. 작업은 빌드의 자격 증명을 자동으로 사용합니다.

publishRegistry - 레지스트리 위치
string. 선택 사항입니다. 을 사용할 때 command = publish사용합니다. 허용되는 값: useExternalRegistry (외부 npm 레지스트리(다른 계정/컬렉션 포함), useFeed (여기서 선택한 레지스트리). 기본값은 useExternalRegistry입니다.

명령이 대상으로 지정할 레지스트리를 지정합니다.

publishFeed - 대상 레지스트리
string. 필요한 경우 publishRegistry = useFeed && command = publish입니다.

계정에서 호스트되는 레지스트리를 지정합니다. 여기에서 레지스트리를 선택하려면 패키지 관리가 설치되고 라이선스가 있어야 합니다.

publishPackageMetadata - 파이프라인 메타데이터 게시
boolean. 선택 사항입니다. 을 사용할 때 command = publish && publishRegistry = useFeed && command = install || command = ci || command = publish사용합니다. 기본값은 true입니다.

빌드/릴리스 파이프라인의 메타데이터(실행 # 및 소스 코드 정보)를 패키지와 연결합니다.

publishEndpoint - 외부 레지스트리
string. 필요한 경우 publishRegistry = useExternalRegistry && command = publish입니다.

외부 레지스트리에 게시하는 데 사용할 자격 증명을 지정합니다.

작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.

출력 변수

없음

설명

참고

Azure Pipelines를 사용하여 피드에 패키지를 게시하려면 프로젝트 컬렉션 빌드 서비스 및 프로젝트의 Build Service ID를 기여자로 설정해야 합니다. 자세한 내용은 새 사용자/그룹 추가 를 참조하세요.

npm 명령 및 인수는 어디에서 배울 수 있나요?

• npm 문서

예제

• gulp를 사용하여 Node.js 앱 빌드

요구 사항

요구 사항	Description
파이프라인 유형	YAML, 클래식 빌드, 클래식 릴리스
실행 중	에이전트, DeploymentGroup
요청	자체 호스팅 에이전트에는 이 작업을 사용하는 작업을 실행하기 위한 다음 요구 사항과 일치하는 기능이 있어야 합니다. npm
Capabilities	이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항	모두
Settable 변수	모두
에이전트 버전	2.115.0 이상
작업 범주	패키지