GitHub Packages について
GitHub Packages は、コンテナーやその他の依存関係を含むパッケージをホストおよび管理するためのプラットフォー� です。 GitHub Packagesは、ソースコードとパッケージを 1 か所にまとめ、統合された権限管理を提供し、GitHub Enterprise Server 上でのソフトウェア開発を一元化できるようにします。
GitHub Packagesは、GitHub Enterprise Server API、GitHub Actions、webhookと統合して、コード、CI、デプロイメントのソリューションを含むエンドツーエンドのDevOpsワークフローを作成できます。
GitHub Packagesは、nmp、RubyGems、Apache Maven、Gradle、Docker、NuGetといった、広く使われているパッケージマネージャーに対する様々なパッケージレジストリを提供しています。 GitHub Packages がサポートするさまざまなパッケージ レジストリについての詳しい情� �は、「GitHub Packages レジストリの操作」をご覧く� さい。
GitHub Enterprise Serverでは、ライセンスのようなメタデータやパッケージのREADMEを表示したり、統計をダウンロードしたり、バージョン履歴を見たりできます。 詳しくは、「パッケージの表示」をご覧く� さい。
GitHub Enterprise Server での GitHub Packages の構成について詳しくは、「Enterprise 向けの GitHub Packages を使い始める」を参照してく� さい。
パッケージの権限と可視性の概要
| アクセス許可 | それぞれのパッケージは、ホストされているリポジトリの権限を継承します。 たとえば、リポジトリの読み取り権限を持つ人であれば、プロジェクトに依存関係としてパッケージをインストールでき、書き込み権限を持つ人であれば、新しいパッケージバージョンを公開できます。 |
| 視程 | パブリックリポジトリで (パブリックパッケージ) パッケージを公開して、Enterpriseの全員と、もしくはプライベートリポジトリ (プライベートパッケージ) でパッケージを公開して、コラボレータあるいは Organization と共有できます。 |
サポートされているクライアントとフォーマット
GitHub Packagesは、パッケージのバージョンの公開とインストールに、すでにおなじみのネイティブのパッケージツールコマンドを使います。
パッケージレジストリのサポート
| Language | 説明 | パッケージの形式 | パッケージクライアント |
|---|---|---|---|
| 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 |
注: Docker レジストリを有効にする� �合は、サブドメインの分離も有効にすることを強くお勧めします。 詳細については、「サブドメイン分離の有効化」を参照してく� さい。
GitHub Packages と使用するようにパッケージ クライアントを構成する方法について詳しくは、「GitHub Packages レジストリの操作」をご覧く� さい。
GitHub Packages への認証を行う
パッケージを発行、インストール、および削除するには、アクセス トークンが必要です。
個人アクセス トークン (PAT) を使用し、GitHub Packages または GitHub Enterprise Server API の認証を受けることができます。 個人トークンを作成する際には、必要に応じて様々なスコープをトークンに割り当てできます。 PAT のパッケージ関連のスコープの詳細については、「GitHub パッケージのアクセス許可について」を参照してく� さい。
GitHub Actionsワークフロー内でGitHub Packagesレジストリに認証を受けるには、以下の方法が使えます。
GITHUB_TOKENでは、ワークフロー リポジトリに関連付けられているパッケージを発行します。packages:read以上のスコープが設定された PAT では、(GITHUB_TOKENではアクセスできない) 他のプライベート リポジトリに関連付けられているパッケージがインストールされます。
GitHub Actions ワークフローで使用される GITHUB_TOKEN の詳細については、「ワークフローで認証する」を参照してく� さい。
パッケージを管理する
パッケージの削除は、GitHub Enterprise Server のユーザー インターフェイス GraphQL を使ってプライベート パッケージのバージョンを削除することができます。
GraphQL API を使ってプライベート パッケージに対するクエリや削除を行う� �合、GitHub Packages の認証に使うのと同じ personal access token を使わなければなりません。
詳しくは、「パッケージを削除および復元する」および「GraphQL での呼び出しの作成」をご覧く� さい。
webhookを設定して、パッケージの公開や更新といったパッケージ関連のイベントにサブスクライブできます。 詳細については、「package webhook イベント」を参照してく� さい。
サポートへの問い合わせ
GitHub Packages のサポートが必要な� �合は、サイト管理者にお問い合わせく� さい。