Skip to main content

このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2023-01-18. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの向上、新機能の向上を図るために、最新バージョンの GitHub Enterprise にアップグレードします。 アップグレードに関するヘルプについては、GitHub Enterprise サポートにお問い合わせく� さい

パッケージを削除および復元する

パッケージの削除と復元の方法を学びます。

GitHub Packages は、GitHub Free、GitHub Pro、Organization の GitHub Free、GitHub Team、GitHub Enterprise Cloud、GitHub Enterprise Server 3.0 以降、GitHub AE で利用できます。 GitHub Enterprise Server インスタンスのアップグレードについて詳しくは、「新しいリリースへのアップグレードについて」を参照してく� さい。また、現在のリリース バージョンからのアップグレード パスについては、アップグレード アシスタント を参照してく� さい。

GitHubにおけるパッケージの削除および復元のサポート

GitHubでは、必要なアクセス権がある� �合、以下を削除できます。

  • プライベートパッケージ全体
  • パッケージの全バージョンでダウンロード数が 5000 以下の� �合、パブリック パッケージ全体
  • プライベートパッケージの特定のバージョン
  • パッケージ バージョンのダウンロード数が 5,000 以下の� �合、パブリック パッケージの特定のバージョン

注:

  • パッケージのいずれかのパージョンでダウンロード数が 5,000 を超えている� �合は、パブリック パッケージを削除できません。 この� �合は、GitHub サポートまでお問い合わせく� さい。
  • パブリックパッケージを削除する� �合、そのパッケージに依存するプロジェクトを� �壊する可能性があることに注意してく� さい。

GitHubでは、以下の� �合にパッケージ全体またはパッケージバージョンを復元できます。

  • 削除後30日以内にパッケージを復元する。
  • 同じパッケージ名前空間が現在も使用可能であり、新しいパッケージに使用されていない� �合。

パッケージAPIのサポート

GraphQL を使ってプライベート パッケージのバージョンを削除することができます。

パッケージの削除や復元に必要な権限

パッケージが発行されるリポジトリに対する管理者アクセス許可がある� �合は、パッケージを削除できます。

パッケージのバージョンを削除する

GitHub 上のパッケージのバージョンを削除する

パッケージのバージョンを削除するには、パッケージを所有するリポジトリに対する管理者アクセス許可が必要です。 詳細については、「必要なアクセス許可」を参照してく� さい。

  1. で、リポジトリのメイン ページへ移動します。 1. ファイルの一覧の右側にある [パッケージ] をクリックします。 リポジトリの概要ページの [パッケージ] リンク 3. パッケージを検索して選択してく� さい。
  2. パッケージのランディング ページの右上にある [パッケージ設定] をクリックします。 [パッケージ設定] ボタン
  3. 左側の [バージョンの管理] をクリックします。
  4. 削除するバージョンの右側で、 をクリックした後、 [バージョンの削除] を選択します。 パッケージ バージョンの削除ボタン
  5. 削除を確認するために、パッケージ名を入力し、 [I understand the consequences, delete this version](影響を理解したうえで、このバージョンを削除します) をクリックします。 パッケージの削除の確認ボタン

GraphQL を使用してパッケージのバージョンを削除する

GraphQL を使ってプライベート パッケージのバージョンを削除することができます。

GraphQL API の deletePackageVersion ミューテーションを使ってく� さい。 read:packagesdelete:packagesrepo のスコープとともに personal access token を使う必要があります。 personal access tokens について詳しくは、「GitHub Packages について」をご覧く� さい。

以下の例では、MDIyOlJlZ2lzdHJ5UGFja2FnZVZlcnNpb243MTExNgpackageVersionId を使用して、パッケージ バージョンを削除する方法を示します。

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 コネクションを使うことができます。 read:packagesrepo スコープを含む personal access token が必要になります。 詳細については、packages コネクションまたは PackageOwner インターフェイスを参照してく� さい。

deletePackageVersion ミューテーションの詳細については、「deletePackageVersion」を参照してく� さい。

GraphQLを使用してパッケージ全体を直接削除することはできませんが、パッケージのすべてのバージョンを削除すれば、パッケージはGitHub Enterprise Server上に表示されなくなります。

パッケージ全体を削除する

GitHub上でリポジトリのスコープが付いたパッケージ全体を削除する

リポジトリのスコープが付いたパッケージ全体を削除するには、パッケージを所有するリポジトリの管理者権限が必要です。 詳細については、「必要なアクセス許可」を参照してく� さい。

  1. で、リポジトリのメイン ページへ移動します。 1. ファイルの一覧の右側にある [パッケージ] をクリックします。 リポジトリの概要ページの [パッケージ] リンク 3. パッケージを検索して選択してく� さい。
  2. パッケージのランディング ページの右上にある [パッケージ設定] をクリックします。 [パッケージ設定] ボタン
  3. [危険なゾーン] の [Delete this package](このパッケージを削除) をクリックします。
  4. 確認メッセージを読み、パッケージ名を入力してから、 [I understand, delete this package.](理解したうえで、このパッケージを削除します。) をクリックします。 パッケージの削除の確認ボタン

パッケージを復元する

以下の� �合、削除したパッケージまたはバージョンを復元できます。

  • 削除後30日以内にパッケージを復元する。
  • 同一のパッケージ名前空間がま� 使用可能であり、新しいパッケージで再使用されていない。

たとえば、リポジトリ octo-repo-owner/octo-repo のスコープが付いていた、octo-package という名前の Rubygem パッケージを削除した� �合、パッケージ名前空間 rubygem.pkg.github.com/octo-repo-owner/octo-repo/octo-package がま� 使用可能で、かつ 30 日が経過していない� �合にのみ、そのパッケージを復元できます。

削除されたパッケージについては、その削除されたパッケージを所有するリポジトリに対する管理権限も持っていなければなりません。

詳細については、「必要なアクセス許可」を参照してく� さい。

パッケージが復元されると、そのパッケージは以前使用していたものと同じ名前空間を使用します。 同一のパッケージ名前空間が使用可能でない� �合、パッケージを復元できません。 この� �合、削除したパッケージを復元するには、まず削除したパッケージの名前空間を使用する新しいパッケージを削除する必要があります。

Organization内のパッケージを復元する

削除されたパッケージは、そのパッケージがOrganizationの所有するリポジトリ内にあったなら、Organizationアカウントの設定を通じて復元できます。

組織でパッケージを復元できるユーザーを確認するには、「必要なアクセス許可」を参照してく� さい。

  1. で、Organization のメイン ページへ移動します。 1. Organization 名の下で、 [設定] をクリックします。 Organization の設定ボタン
  2. 左側の [パッケージ] をクリックします。
  3. [Deleted Packages](削除されたパッケージ) の、復元するパッケージの隣にある [復元] をクリックします。 [復元] ボタン
  4. 確認のため、パッケージ名を入力し、 [I understand the consequences, restore this package](影響を理解したうえで、このパッケージを復元します) をクリックします。 パッケージ復元の確認ボタン

パッケージのバージョンを復元する

パッケージのランディングページから、パッケージのバージョンを復元できます。 パッケージを復元できるユーザーを確認するには、「必要なアクセス許可」を参照してく� さい。

  1. パッケージのランディングページに移動します。
  2. 右側の [パッケージ設定] をクリックします。
  3. 左側の [バージョンの管理] をクリックします。
  4. 左上の [バージョン] ドロップダウン メニューで、 [削除済み] を選択します。 削除されたバージョンを表示するドロップダウン メニュー
  5. 復元する削除済みパッケージのバージョンの横にある [復元] をクリックします。 削除されたパッケージのバージョンの隣にある復元オプション
  6. 確認のために、 [I understand the consequences, restore this version](影響を理解したうえで、このバージョンを復元します) をクリックします。 パッケージ バージョン復元の確認