코드 패키지용 GitHub 패키지

완료됨

앞 단원에서는 GitHub Actions를 사용하여 컨테이너 이미지를 빌드하고 게시하는 방법을 알아보았습니다.

이 단원에서는 GitHub 패키지에서 지원하는 다른 패키지를 살펴봅니다. GitHub 패키지는 npm 패키지의 경우 npm, NuGet 패키지의 경우 nuget.exe 또는 dotnet CLI 등 현재 프로젝트의 에코시스템 도구와 함께 작동합니다.

GitHub 패키지 인증

패키지 관리자에 대해 인증받는 방법은 프로젝트의 에코시스템에 따라 달라집니다. 어느 에코시스템을 사용 중이든, 다음과 같은 세 가지 정보가 필요합니다.

  • GitHub 사용자 이름
  • 개인용 액세스 토큰
  • 패키지 에코시스템의 GitHub 패키지 엔드포인트

개인용 액세스 토큰 생성

패키지를 설치, 게시 또는 삭제하려면 액세스 토큰이 필요합니다. 패키지 관리자를 사용할 때는 PAT(개인용 액세스 토큰)를 생성해야 합니다. PAT는 프로필 설정을 통해 생성할 수 있습니다.

경고

토큰은 암호처럼 취급하고 비밀로 유지하세요.

GitHub 패키지에 로그인

패키지를 게시하거나 GitHub 패키지에서 패키지를 설치하려면 먼저 패키지 관리자에 대해 인증받아야 합니다. 엔드포인트는 https://PACKAGE_TYPE.pkg.github.com/OWNER/REPOSITORY와 같은 형태입니다. 여기서 PACKAGE_TYPE은 사용 중인 패키지 에코시스템의 유형입니다.

다음 표에는 패키지 에코시스템을 기반으로 GitHub 패키지에 인증하기 위해 실행해야 하는 명령이 나와 있습니다.

패키지 에코시스템 GitHub 패키지에 대해 인증받기 위해 실행할 명령줄
NuGet dotnet nuget add source https://nuget.pkg.github.com/OWNER/index.json -n github -u OWNER -p [Your PAT Token]
npm bash npm login --registry=https://npm.pkg.github.com
RubyGems echo ":github: Bearer GH_TOKEN" >> ~/.gem/credentials
Maven 및 Gradle 푸시할 때 직접 인증할 수 있습니다.

사용 중인 프로젝트 환경에서 GitHub 패키지를 사용하는 방법을 자세히 알아보려면 이 문서를 참조하세요.

패키지 설치

인증받은 후에는 손쉽게 프로젝트에 패키지를 게시할 수 있습니다. 각 패키지 홈페이지에는 프로젝트 환경에 따라 실행해야 하는 명령이 표시됩니다.

A Package page displays information about how to install it into your project, depending on the project environment.

패키지 관리

GitHub 패키지는 패키지 수명 주기와 워크플로를 쉽게 관리할 수 있는 여러 가지 방법을 제공합니다.

GitHub API와 GraphQL API를 사용하여 GitHub 패키지를 관리할 수 있습니다. 이러한 API를 사용하면 고급 통합 시나리오를 지원할 수 있습니다. 예를 들어, GitHub의 웹후크 기능을 사용하면 새 패키지가 게시되었을 때 코드를 실행할 수 있습니다. 오픈 소스 프로젝트의 관리를 담당하는 담당자라면 웹후크를 사용하여, 새 패키지가 게시되었을 때 새 트윗이나 블로그 게시물이 자동으로 게시되도록 할 수 있습니다.

GitHub Actions를 사용하여 패키지 관리를 자동화할 수도 있습니다. delete-package-versions 작업을 사용하여 패키지의 새 버전을 게시할 때 가장 오래된 버전을 자동으로 정리할 수 있습니다.