Skip to main content

패키지 삭제 및 복원

패키지를 삭제하거나 복원하는 방법을 알아봅니다.

GitHub의 패키지 삭제 및 복원 지원

필요한 액세스 권한이 있는 경우 GitHub에서 다음을 삭제할 수 있습니다.

  • 전체 프라이빗 패키지
  • 전체 퍼블릭 패키지(패키지 버전의 다운로드 수가 5,000개 이하인 경우)
  • 프라이빗 패키지의 특정 버전
  • 특정 버전의 퍼블릭 패키지(패키지 버전의 다운로드 수가 5,000개를 초과하지 않는 경우)

참고:

  • 패키지 버전에 5,000개를 초과하는 다운로드가 있는 경우 퍼블릭 패키지를 삭제할 수 없습니다. 이 시나리오에서는 GitHub 고객 지원팀에 문의하여 추가 지원을 받으세요.
  • 퍼블릭 패키지를 삭제할 때는 패키지에 따라 프로젝트가 중단될 수 있습니다.

GitHub에서 다음과 같은 경우 전체 패키지 또는 패키지 버전을 복원할 수도 있습니다.

  • 패키지를 삭제한 후 30일 이내에 복원합니다.
  • 동일한 패키지 네임스페이스는 계속 사용할 수 있으며 새 패키지에 사용되지 않습니다.

패키지 API 지원

특정 레지스트리의 경우에서 GraphQL을 사용하여 프라이빗 패키지 버전을 삭제할 수 있습니다.

세분화된 권한을 지원하는 레지스트리에는 GitHub Packages GraphQL API를 사용할 수 없습니다. 리포지토리 범위 권한 지원하고 GraphQL API와 함께 사용할 수 있는 레지스트리의 경우 "GitHub Packages에 대한 권한 정보"를 참조하세요.

패키지를 삭제하거나 복원하는 데 필요한 권한

세분화된 권한을 지원하는 레지스트리를 사용하면 패키지의 범위를 사용자 또는 조직으로 지정하거나 리포지토리에 연결하도록 선택할 수 있습니다.

에 저장된 https://npm.pkg.github.com/OWNER/PACKAGE-NAME패키지와 같이 리포지토리와 별도로 세분화된 권한이 있는 패키지를 삭제하려면 패키지에 대한 관리자 액세스 권한이 있어야 합니다. 자세한 내용은 “GitHub Packages에 대한 권한 정보”를 참조하세요.

리포지토리에서 액세스 권한을 상속하는 패키지의 경우 리포지토리에 대한 관리자 권한이 있는 경우 패키지를 삭제할 수 있습니다.

일부 레지스트리는 리포지토리 범위 패키지 지원합니다. 이러한 레지스트리 목록은 "GitHub Packages에 대한 권한 정보"를 참조하세요.

패키지 버전 삭제

GitHub에서 리포지토리 범위 패키지의 버전 삭제

리포지토리 범위 패키지의 버전을 삭제하려면 패키지를 소유한 리포지토리에 대한 관리자 권한이 있어야 합니다. 자세한 내용은 “필요한 권한”을 참조하세요.

  1. your GitHub Enterprise Server instance에서 리포지토리의 기본 페이지로 이동합니다. 1. 파일 목록 오른쪽에 있는 패키지를 클릭합니다. 리포지토리 개요 페이지의 패키지 링크 3. 패키지를 검색하여 선택합니다.
  2. 패키지 방문 페이지의 오른쪽 위에서 패키지 설정을 클릭합니다. 패키지 설정 단추
  3. 왼쪽에서 버전 관리를 클릭합니다.
  4. 삭제하려는 버전의 오른쪽에 있는 아이콘을 클릭하고 버전 삭제를 클릭합니다. 패키지 버전 삭제 단추
  5. 삭제를 확인하려면 패키지 이름을 입력하고 결과를 이해하고 있으며 이 버전을 삭제합니다. 를 클릭합니다. 패키지 삭제 확인 단추

GraphQL을 사용하여 리포지토리 범위 패키지 버전 삭제

특정 레지스트리의 경우에서 GraphQL을 사용하여 프라이빗 패키지 버전을 삭제할 수 있습니다.

세분화된 권한을 지원하는 레지스트리에는 GitHub Packages GraphQL API를 사용할 수 없습니다. 리포지토리 범위 권한 지원하고 GraphQL API와 함께 사용할 수 있는 레지스트리의 경우 "GitHub Packages에 대한 권한 정보"를 참조하세요.

GraphQL API에서 deletePackageVersion 변형을 사용합니다. , delete:packagesrepo 범위와 함께 personal access token을(를read:packages) 사용해야 합니다. personal access tokens에 대한 자세한 내용은 "GitHub Packages정보"를 참조하세요.

다음 예제에서는 MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg라는 packageVersionId를 사용하여 패키지 버전을 삭제하는 방법을 보여 줍니다.

curl -X POST \
-H "Accept: application/vnd.github.package-deletes-preview+json" \
-H "Authorization: bearer TOKEN" \
-d '{"query":"mutation { deletePackageVersion(input:{packageVersionId:\"MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNg==\"}) { success }}"}' \
HOSTNAME/graphql

GitHub Packages에 게시한 모든 프라이빗 패키지를 패키지의 버전 ID와 함께 찾으려면 repository 개체를 통해 packages 연결을 사용할 수 있습니다. 및 repo 범위를 사용하여 personal access token이read:packages(가) 필요합니다. 자세한 내용은 packages 연결 또는 PackageOwner 인터페이스를 참조하세요.

deletePackageVersion 변형에 대한 자세한 내용은 “deletePackageVersion”을 참조하세요.

GraphQL을 사용하여 전체 패키지를 직접 삭제할 수는 없지만 패키지의 모든 버전을 삭제하면 패키지가 GitHub Enterprise Server에 더 이상 표시되지 않습니다.

전체 패키지 삭제

GitHub에서 전체 리포지토리 범위 패키지 삭제

전체 리포지토리 범위 패키지를 삭제하려면 패키지를 소유하는 리포지토리에 대한 관리자 권한이 있어야 합니다. 자세한 내용은 “필요한 권한”을 참조하세요.

  1. your GitHub Enterprise Server instance에서 리포지토리의 기본 페이지로 이동합니다. 1. 파일 목록 오른쪽에 있는 패키지를 클릭합니다. 리포지토리 개요 페이지의 패키지 링크 3. 패키지를 검색하여 선택합니다.
  2. 패키지 방문 페이지의 오른쪽 위에서 패키지 설정을 클릭합니다. 패키지 설정 단추
  3. “위험 영역”에서 이 패키지 삭제를 클릭합니다.
  4. 확인하려면 확인 메시지를 검토하고 패키지 이름을 입력한 다음 이 패키지를 삭제합니다. 를 클릭합니다. 패키지 삭제 확인 단추

패키지 복원

다음과 같은 경우 삭제된 패키지 또는 버전을 복원할 수 있습니다.

  • 패키지를 삭제한 후 30일 이내에 복원합니다.
  • 동일한 패키지 네임스페이스 및 버전을 여전히 사용할 수 있으며 새 패키지에 다시 사용되지 않습니다.

예를 들어 octo-repo-owner/octo-repo 리포지토리로 범위가 지정된 octo-package라는 RubyGems 패키지를 삭제한 경우, 패키지 네임스페이스 rubygem.pkg.github.com/octo-repo-owner/octo-repo/octo-package를 계속 사용할 수 있고 30일이 아직 지나지 않은 경우에만 패키지를 복원할 수 있습니다.

패키지를 삭제하려면 삭제된 패키지를 소유하는 리포지토리에 대한 관리자 권한도 있어야 합니다.

자세한 내용은 “필요한 권한”을 참조하세요.

패키지가 복원되면 패키지는 이전과 동일한 네임스페이스를 사용합니다. 동일한 패키지 네임스페이스를 사용할 수 없는 경우 패키지를 복원할 수 없습니다. 이 시나리오에서 삭제된 패키지를 복원하려면 먼저 삭제된 패키지의 네임스페이스를 사용하는 새 패키지를 삭제해야 합니다.

조직에서 패키지 복원

패키지가 조직 소유의 리포지토리에 있거나로 범위가 지정된 경우 조직 계정 설정을 통해 삭제된 패키지를 복원할 수 있습니다.

조직에서 패키지를 복원할 수 있는 사용자를 검토하려면 “필요한 권한”을 참조하세요.

  1. your GitHub Enterprise Server instance에서 조직의 기본 페이지로 이동합니다. 1. 조직 이름에서 설정을 클릭합니다.  조직 설정 단추
  2. 왼쪽에서 패키지를 클릭합니다.
  3. “삭제된 패키지”에서 복원하려는 패키지 옆에 있는 복원을 클릭합니다. 복원 단추
  4. 확인하려면 패키지 이름을 입력하고 결과를 이해하고 있으며 이 패키지를 복원합니다. 를 클릭합니다. 패키지 복원 확인 단추

패키지 버전 복원

패키지의 방문 페이지에서 패키지 버전을 복원할 수 있습니다. 패키지를 복원할 수 있는 사용자를 검토하려면 “필요한 권한”을 참조하세요.

  1. 패키지의 방문 페이지로 이동합니다.
  2. 오른쪽에서 패키지 설정을 클릭합니다.
  3. 왼쪽에서 버전 관리를 클릭합니다.
  4. 오른쪽 위에서 “버전” 드롭다운 메뉴를 사용하고 삭제됨을 선택합니다. 삭제됨 옵션을 보여 주는 버전 드롭다운 메뉴
  5. 복원하려는 삭제된 패키지 버전 옆에 있는 복원을 클릭합니다. 삭제된 패키지 버전 옆에 있는 복원 옵션
  6. 확인하려면 결과를 이해하고 있으며 이 버전을 복원합니다. 를 클릭합니다. 패키지 버전 복원 확인