npm 구성 및 사용 - Amazon CodeCatalyst
CodeCatalyst를 사용하여 npm 구성CodeCatalyst 패키지 리포지토리에서 npm 패키지 설치CodeCatalyst를 통해 npmjs에서 npm 패키지 설치CodeCatalyst 패키지 리포지토리에 npm 패키지 게시npm 명령 지원

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

npm 구성 및 사용

npm를 CodeCatalyst와 함께 사용하려면 패키지 리포지토리에 npm를 연결하고 인증을 위한 개인 액세스 토큰(PAT)을 제공해야 합니다. CodeCatalyst 콘솔에서 패키지 리포지토리에 npm을 연결하기 위한 지침을 볼 수 있습니다.

CodeCatalyst를 사용하여 npm 구성

다음 지침은 CodeCatalyst 패키지 리포지토리를 인증하고 npm에 연결하는 방법을 설명합니다. npm에 대한 자세한 내용은 공식 npm 설명서를 참조하세요.

CodeCatalyst 패키지 리포지토리npm에 연결하려면

  1. https://codecatalyst.aws/에서 CodeCatalyst 콘솔을 엽니다.

  2. 프로젝트로 이동합니다.

  3. 탐색 창에서 패키지를 선택합니다.

  4. 목록에서 패키지 리포지토리를 선택합니다.

  5. 리포지토리에 연결을 선택합니다.

  6. 구성 세부 정보의 패키지 관리자 클라이언트에서 npm 클라이언트를 선택합니다.

  7. 해당하는 구성 단계를 보기 위해 사용 중인 운영 체제를 선택합니다.

  8. CodeCatalyst를 사용하여 npm을 인증하려면 개인 액세스 토큰(PAT)이 필요합니다. 토큰이 이미 있으면 해당 토큰을 사용할 수 있습니다. 토큰이 없다면, 다음 단계를 통해 생성할 수 있습니다.

    1. (선택 사항): PAT 이름 및 만료 날짜를 업데이트합니다.

    2. 토큰 생성을 선택합니다.

    3. PAT를 복사하여 안전한 위치에 저장합니다.

      주의

      대화 상자를 닫으면 PAT를 다시 보거나 복사할 수 없습니다. 자격 증명은 공격자가 자격 증명을 유용한 후 사용할 수 있는 기간을 최소화하도록 수명이 짧아야 합니다.

  9. 프로젝트의 루트 디렉터리에서 다음 명령을 실행하여 패키지 리포지토리로 npm을 구성합니다. 명령은 다음을 수행합니다.

    • 프로젝트에 아무 파일도 없는 경우 프로젝트 수준의 .npmrc 파일을 생성합니다.

    • 패키지 리포지토리 엔드포인트 정보를 프로젝트 수준의 .npmrc 파일에 추가합니다.

    • 사용자 수준의 .npmrc 파일에 자격 증명(PAT)을 추가합니다.

    다음 값을 교체합니다.

    참고

    콘솔 지침에서 복사하는 경우 다음 명령의 값이 업데이트되므로 변경할 필요가 없습니다.

    • username을 CodeCatalyst 사용자 이름으로 바꿉니다.

    • PAT를 CodeCatalyst PAT로 바꿉니다.

    • space_name을 CodeCatalyst 스페이스 이름으로 바꿉니다.

    • proj_name을 CodeCatalyst 프로젝트 이름으로 바꿉니다.

    • my_repo를 CodeCatalyst 패키지 리포지토리 이름으로 바꿉니다.

    npm set registry=https://packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/ --location project
npm set //packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/:_authToken=username:PAT

    npm 6 이하의 경우: GET 요청이 있을 경우에도 npm이 항상 CodeCatalyst에 인증 토큰을 전달하도록 하려면 항시 인증 구성 변수를 npm config set로 다음과 같이 설정합니다.

    npm set //packages.region.codecatalyst.aws/npm/space-name/proj-name/repo-name/:always-auth=true --location project

CodeCatalyst 패키지 리포지토리에서 npm 패키지 설치

CodeCatalyst를 사용하여 npm 구성 섹션의 단계에 따라 npm을 리포지토리에 연결한 후 리포지토리에서 npm 명령을 실행할 수 있습니다.

npm install 명령을 사용하여 CodeCatalyst 패키지 리포지토리 또는 업스트림 리포지토리 중 하나에 있는 npm 패키지를 설치할 수 있습니다.

npm install lodash

CodeCatalyst를 통해 npmjs에서 npm 패키지 설치

npmjs.com, npm-public-registry-gateway에 연결된 게이트웨이 리포지토리에 대한 업스트림 연결로 리포지토리를 구성하여 CodeCatalyst 리포지토리를 통해 npmjs.com에서 npm 패키지를 설치할 수 있습니다. npmjs에서 설치된 패키지는 수집되어 게이트웨이 리포지토리와 가장 먼 다운스트림 패키지 리포지토리에 저장됩니다.

npmjs에서 패키지를 설치하려면

  1. 아직 구성하지 않은 경우 CodeCatalyst를 사용하여 npm 구성의 단계에 따라 CodeCatalyst 패키지 리포지토리로 npm을 구성합니다.

  2. 리포지토리가 게이트웨이 리포지토리 npm-public-registry-gateway를 업스트림 연결로 추가했는지 확인합니다. 업스트림 리포지토리 추가의 지침에 따라 npm-public-registry-gateway 리포지토리를 선택하여, 어떤 업스트림 소스가 추가되었는지 확인하거나 npm-public-registry-gateway를 업스트림 소스로 추가할 수 있습니다.

  3. npm install 명령을 사용하여 패키지를 설치합니다.

    npm install package_name

업스트림 리포지토리에서 패키지를 요청하는 방법에 대한 자세한 내용은 업스트림 리포지토리가 포함된 패키지 버전 요청 섹션을 참조하세요.

CodeCatalyst 패키지 리포지토리에 npm 패키지 게시

CodeCatalyst를 사용하여 npm 구성를 완료한 후 npm 명령을 실행할 수 있습니다.

npm publish 명령을 사용하여 CodeCatalyst 패키지 리포지토리에 npm 패키지를 게시할 수 있습니다.

npm publish

npm 패키지를 만드는 방법에 관한 자세한 내용은 npm Docs에서 Node.js 모듈 생성 섹션을 참조하세요.

npm 명령 지원

다음 섹션에는 지원되지 않는 특정 명령 외에도 CodeCatalyst 리포지토리에서 지원하는 npm 명령이 요약되어 있습니다.

리포지토리와 상호 작용하는 지원되는 명령

이 섹션에는 npm 클라이언트가 구성될 때 사용된 레지스트리(예: npm config set registry 포함)에 하나 이상의 요청을 보내는 npm 명령이 나열되어 있습니다. CodeCatalyst 패키지 리포지토리에 대해 이러한 명령을 간접적으로 호출했을 때 제대로 작동하는 것으로 확인되었습니다.

Command 설명

bugs

패키지의 버그 추적기 URL 위치를 추측한 후 URL 열기를 시도합니다.

ci

프로젝트를 새로 다시 설치합니다.

deprecate

패키지 버전을 더 이상 사용하지 않습니다.

dist-tag

패키지 배포 태그를 수정합니다.

docs

패키지 설명서 URL의 위치를 추측한 다음 --browser config 파라미터를 사용하여 URL 열기를 시도합니다.

doctor

일련의 검사를 실행하여 npm 설치가 JavaScript 패키지를 관리할 수 있는지 검증합니다.

install

패키지를 설치합니다.

install-ci-test

프로젝트를 새로 다시 설치하고 테스트를 실행합니다. 별칭: npm cit. 이 명령은 npm ci를 실행한 후 즉시 npm test를 실행합니다.

install-test

패키지를 설치하고 테스트를 실행합니다. npm install을 실행한 후 즉시 npm test를 실행합니다.

outdated

구성된 레지스트리를 검사하여 설치된 패키지가 만료되었는지 확인합니다.

ping

구성되거나 지정된 npm 레지스트리를 ping하고 인증을 확인합니다.

publish

패키지 버전을 레지스트리에 게시합니다.

update

패키지의 리포지토리 URL 위치를 추측한 다음, --browser config 파라미터를 사용하여 URL 열기를 시도합니다.

view

패키지 메타데이터를 표시합니다. 또한 메타데이터 속성을 인쇄하는 데 사용할 수 있습니다.

지원되는 클라이언트 측 명령

이러한 명령은 리포지토리와 직접 상호 작용할 필요가 없으므로 CodeCatalyst는 명령을 지원하기 위해 아무 것도 할 필요가 없습니다.

Command 설명

bin(legacy)

npm bin 디렉터리를 표시합니다.

build

패키지를 빌드합니다.

cache

패키지 캐시를 조작합니다.

completion

모든 npm 명령에서 탭 완성을 활성화합니다.

config

사용자 및 글로벌 npmrc 파일의 내용을 업데이트합니다.

dedupe

로컬 패키지 트리를 검색하고 종속성을 트리 위로 이동하여 구조를 단순화하려고 합니다. 여기서 종속성을 여러 종속 패키지에서 더 효과적으로 공유할 수 있습니다.

edit

설치된 패키지를 편집합니다. 현재 작업 디렉터리에서 종속성을 선택하고 기본 편집기에서 패키지 폴더를 엽니다.

explore

설치된 패키지를 찾아봅니다. 설치된 특정 패키지의 디렉터리에 서브셸을 생성합니다. 명령이 지정되면 해당 명령은 서브셸에서 실행된 후 즉시 종료됩니다.

help

npm에 관한 도움말을 가져옵니다.

help-search

npm 도움말 설명서를 검색합니다.

init

package.json 파일을 생성합니다.

link

패키지 디렉터리에 심볼릭 링크를 생성합니다.

ls

설치된 패키지를 나열합니다.

pack

패키지에서 tarball을 생성합니다.

접두사 

접두사를 표시합니다. -g도 지정되지 않는 한, 이 디렉터리는 package.json 파일을 포함하는 가장 가까운 상위 디렉터리입니다.

prune

상위 패키지의 종속성 목록에 나열되지 않은 패키지를 제거합니다.

rebuild

일치하는 폴더에서 npm build 명령을 실행합니다.

restart

패키지의 중지, 재시작, 시작 스크립트와 관련 사전/사후 스크립트를 실행합니다.

root

유효 node_modules 폴더를 표준 출력으로 출력합니다.

run-script

임의의 패키지 스크립트를 실행합니다.

shrinkwrap

게시할 종속 버전을 잠급니다.

uninstall

패키지를 제거합니다.

지원되지 않는 명령

아래 npm 명령은 CodeCatalyst 패키지 리포지토리에서 지원하지 않습니다.

Command 설명 참고

access

게시된 패키지에서 액세스 수준을 설정합니다.

CodeCatalyst는 퍼블릭 npmjs 리포지토리와는 다른 권한 모델을 사용합니다.

adduser

레지스트리 사용자 계정을 추가합니다.

CodeCatalyst는 퍼블릭 npmjs 리포지토리와는 다른 사용자 모델을 사용합니다.

audit

보안 감사를 실행합니다.

CodeCatalyst는 현재 보안 취약성 데이터를 제공하지 않습니다.

hook

추가, 제거, 나열 및 업데이트를 포함하여 npm 후크를 관리합니다.

CodeCatalyst는 현재 어떠한 변경 알림 메커니즘도 지원하지 않습니다.

login

사용자를 인증합니다. npm adduser에 대한 별칭입니다.

CodeCatalyst는 퍼블릭 npmjs 리포지토리와는 다른 인증 모델을 사용합니다. 자세한 내용은 CodeCatalyst를 사용하여 npm 구성을 참조하세요.

logout

레지스트리에서 로그아웃합니다.

CodeCatalyst는 퍼블릭 npmjs 리포지토리와는 다른 인증 모델을 사용합니다. CodeCatalyst 리포지토리에서 로그아웃할 수 있는 방법은 없지만, 인증 토큰은 구성 가능한 만료 시간이 지나면 만료됩니다. 기본 토큰 지속 시간은 12시간입니다.

owner

패키지 소유자를 관리합니다.

CodeCatalyst는 퍼블릭 npmjs 리포지토리와는 다른 권한 모델을 사용합니다.

profile

레지스트리 프로파일의 설정을 변경합니다.

CodeCatalyst는 퍼블릭 npmjs 리포지토리와는 다른 사용자 모델을 사용합니다.

search

레지스트리에서 검색어와 일치하는 패키지를 검색합니다.

CodeCatalyst는 search 명령을 지원하지 않습니다.

star

좋아하는 패키지를 표시합니다.

CodeCatalyst는 현재 즐겨찾기 메커니즘을 지원하지 않습니다.

stars

즐겨찾기로 표시된 패키지를 조회합니다.

CodeCatalyst는 현재 즐겨찾기 메커니즘을 지원하지 않습니다.

team

팀 및 팀 멤버십을 관리합니다.

CodeCatalyst는 퍼블릭 npmjs 리포지토리와는 다른 사용자 및 그룹 멤버 모델을 사용합니다.

token

인증 토큰을 관리합니다.

CodeCatalyst는 인증 토큰을 가져오기 위해 다른 모델을 사용합니다. 자세한 내용은 CodeCatalyst를 사용하여 npm 구성을 참조하세요.

unpublish

레지스트리에서 패키지를 제거합니다.

CodeCatalyst는 npm 클라이언트를 사용하여 리포지토리에서 패키지 버전을 제거하는 것을 지원하지 않습니다. 콘솔을 사용하여 에서 패키지를 삭제할 수 있습니다.

whoami

npm 사용자 이름을 표시합니다.

CodeCatalyst는 퍼블릭 npmjs 리포지토리와는 다른 사용자 모델을 사용합니다.