# GitHub 패키지 소개

GitHub Packages 는 소프트웨어 패키지를 비공개 또는 공개적으로 호스트하고 프로젝트의 종속성으로 패키지를 사용할 수 있는 소프트웨어 패키지 호스팅 서비스입니다.

<!-- 2148AF7B-5FF8-4B28-A808-D692FEE2225A -->

## 정보 GitHub Packages

GitHub Packages 는 컨테이너 및 기타 종속성을 포함하여 패키지를 호스팅하고 관리하기 위한 플랫폼입니다.
GitHub Packages 는 소스 코드와 패키지를 한 곳에 결합하여 통합된 권한 관리 제공하므로 소프트웨어 개발을 GitHub중앙 집중화할 수 있습니다.

GitHub Packages와 GitHub의 API, GitHub Actions, 웹훅을 통합하여 코드, CI, 배포 솔루션을 포함한 엔드 투 엔드 DevOps 워크플로를 만들 수 있습니다.

GitHub Packages 는 npm, RubyGems, Apache Maven, Gradle, Docker 및 NuGet과 같이 일반적으로 사용되는 패키지 관리자를 위한 다양한 패키지 레지스트리를 제공합니다.
지원하는 다른 패키지 레지스트리 GitHub Packages 에 대한 자세한 내용은 [GitHub 패키지 레지스트리 작업](/ko/enterprise-server@3.23/packages/working-with-a-github-packages-registry)을 참조하세요.

패키지의 추가 정보 및 라이선스, 다운로드 통계, 버전 기록 등의 메타데이터를 볼 수 있습니다 GitHub. 자세한 내용은 [패키지 보기](/ko/enterprise-server@3.23/packages/learn-github-packages/viewing-packages)을(를) 참조하세요.

GitHub Packages의 GitHub Enterprise Server에 대한 구성에 대한 자세한 내용은 [엔터프라이즈용 GitHub 패키지 시작](/ko/enterprise-server@3.23/admin/configuring-packages/getting-started-with-github-packages-for-your-enterprise)을 참조하세요.

### 패키지 권한 개요

패키지에 대한 권한은 해당 패키지가 호스팅되는 리포지토리에서 상속받거나, 특정 사용자 또는 조직에 대해 정의된 리포지토리에서 설정할 수 있습니다. 일부 레지스트리는 리포지토리에서 상속된 권한만 제공합니다. 이러한 레지스트리의 목록은 [GitHub 패키지에 대한 사용 권한 정보](/ko/enterprise-server@3.23/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)을(를) 참조하세요. 패키지 액세스 권한에 대한 자세한 내용은 [패키지의 액세스 제어 및 표시 여부 구성](/ko/enterprise-server@3.23/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)을(를) 참조하세요.

### 패키지 표시 여부 개요

퍼블릭 리포지토리(퍼블릭 패키지)에 패키지를 게시하여 엔터프라이즈의 모든 사용자와 공유하거나 프라이빗 리포지토리의 패키지(프라이빗 패키지)를 게시하여 협력자 또는 조직과 공유할 수 있습니다.

## 지원되는 클라이언트 및 형식

<!-- If you make changes to this feature, check whether any of the changes affect languages listed in /get-started/learning-about-github/github-language-support. If so, please update the language support article accordingly. -->

GitHub Packages 는 패키지 버전을 게시하고 설치하는 데 이미 익숙한 네이티브 패키지 도구 명령을 사용합니다.

### 패키지 레지스트리 지원

| 언어                                   | 설명                           | 패키지 형식         | 패키지 클라이언트 |
| ------------------------------------ | ---------------------------- | -------------- | --------- |
| JavaScript                           | Node 패키지 관리자                 | `package.json` | `npm`     |
| Ruby                                 | RubyGems 패키지 관리자             | `Gemfile`      | `gem`     |
| Java                                 | Apache Maven 프로젝트 관리 및 종합 도구 | `pom.xml`      | `mvn`     |
| Java                                 | Java에 대한 Gradle 빌드 자동화 도구    |                |           |
| `build.gradle` 또는 `build.gradle.kts` | `gradle`                     |                |           |
| .NET                                 | .NET에 대한 NuGet 패키지 관리        | `nupkg`        |           |
| `dotnet` 커맨드 라인 인터페이스 (CLI)          |                              |                |           |
| 해당 없음                                | Docker 컨테이너 관리               | `Dockerfile`   | `Docker`  |

> [!NOTE]
> Docker 레지스트리를 사용할 때는 하위 도메인 격리를 활성화하는 것이 좋습니다. 자세한 내용은 [하위 도메인 격리 활성화](/ko/enterprise-server@3.23/admin/configuring-settings/hardening-security-for-your-enterprise/enabling-subdomain-isolation)을(를) 참조하세요.

사용할 GitHub Packages패키지 클라이언트를 구성하는 방법에 대한 자세한 내용은 [GitHub 패키지 레지스트리 작업](/ko/enterprise-server@3.23/packages/working-with-a-github-packages-registry)을 참조하세요.

## 인증 진행 중 GitHub Packages

> [!NOTE]
> GitHub Packages 은 .를 사용하는 personal access token (classic)인증만 지원합니다. 자세한 내용은 [개인용 액세스 토큰 관리](/ko/enterprise-server@3.23/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)을(를) 참조하세요.

프라이빗, 내부, 퍼블릭 패키지를 게시, 설치, 삭제하려면 액세스 토큰이 필요합니다.

personal access token (classic)을 사용하여 GitHub Packages 또는 GitHub API에 인증할 수 있습니다. personal access token (classic)을(를) 만들 때 필요에 따라 토큰의 범위를 다르게 할당할 수 있습니다. personal access token (classic)의 패키지 관련 범위에 대한 자세한 내용은 [GitHub 패키지에 대한 사용 권한 정보](/ko/enterprise-server@3.23/packages/learn-github-packages/about-permissions-for-github-packages#about-scopes-and-permissions-for-package-registries)를 참조하세요.

GitHub Actions 워크플로 내에서 GitHub Packages 레지스트리에 인증하려면 다음을 사용할 수 있습니다.

* 워크플로 리포지토리와 연결된 패키지를 게시하려면 `GITHUB_TOKEN`을 사용합니다.
* 다른 프라이빗 리포지토리와 연결된 패키지를 설치하기 위한 최소한 `read:packages` 범위가 있는 personal access token (classic)(리포지토리에 패키지에 대한 읽기 액세스 권한이 부여된 경우 `GITHUB_TOKEN`을 사용할 수 있습니다. [패키지의 액세스 제어 및 표시 여부 구성](/ko/enterprise-server@3.23/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility)을(를) 참조하세요).

워크플로에서 `GITHUB_TOKEN` 사용되는 방법에 대한 GitHub Actions 자세한 내용은 [워크플로에서 인증에 GITHUB\_TOKEN 사용](/ko/enterprise-server@3.23/actions/tutorials/authenticate-with-github_token#using-the-github_token-in-a-workflow)을 참조하세요.

## 패키지 관리

사용자 인터페이스 또는 REST API를 GitHub 사용하여 패키지를 삭제할 수 있습니다. 자세한 내용은 [패키지 삭제 및 복원](/ko/enterprise-server@3.23/packages/learn-github-packages/deleting-and-restoring-a-package) 및 [패키지에 대한 REST API 엔드포인트](/ko/enterprise-server@3.23/rest/packages)을 참조하세요. 특정 레지스트리의 경우 GraphQL을 사용하여 프라이빗 패키지의 버전을 삭제할 수 있습니다.

GitHub Packages GraphQL API는 세분화된 권한을 지원하는 레지스트리와 사용할 수 없습니다. 리포지토리 범위 권한**만** 지원하고 GraphQL API와 함께 사용할 수 있는 레지스트리는 [GitHub 패키지에 대한 사용 권한 정보](/ko/enterprise-server@3.23/packages/learn-github-packages/about-permissions-for-github-packages#permissions-for-repository-scoped-packages)을(를) 참조하세요.

GraphQL API를 사용하여 프라이빗 패키지를 쿼리하고 삭제하는 경우 인증personal access token (classic)에 사용하는 것과 동일하게 GitHub Packages 사용해야 합니다.

자세한 내용은
및 [](/ko/enterprise-server@3.23/packages/learn-github-packages/deleting-and-restoring-a-package)을 참조 [](/ko/enterprise-server@3.23/graphql/guides/forming-calls-with-graphql) 하세요.

패키지가 게시되거나 업데이트되는 경우와 같은 패키지 관련 이벤트를 구독하도록 웹후크를 구성할 수 있습니다. 자세한 내용은 [웹후크 이벤트 및 페이로드](/ko/enterprise-server@3.23/webhooks/webhook-events-and-payloads#package)을 참조하세요.

## 고객 지원팀에 연락

지원이 GitHub Packages필요한 경우 사이트 관리자에게 문의하세요.