GitHub Packages für Codepakete

  • 3 Minuten

In der vorherigen Lerneinheit haben Sie erfahren, wie Sie GitHub Actions verwenden, um Containerimages zu erstellen und zu veröffentlichen.

In dieser Lerneinheit werden die anderen Pakete vorgestellt, die von GitHub Packages unterstützt werden. GitHub Packages funktioniert mit den Tools Ihres aktuellen Projekts, zum Beispiel npm für npm-Pakete und „nuget.exe“ oder die .NET-CLI für NuGet-Pakete.

Authentifizieren bei GitHub Packages

Die Art, wie Sie sich bei Ihrem Paket-Manager authentifizieren, hängt vom Ökosystem Ihres Projekts ab. Je nachdem, mit welchem Ökosystem Sie arbeiten, benötigen Sie drei Informationen:

  • Ihr GitHub-Benutzername
  • Ein persönliches Zugriffstoken
  • Den GitHub Packages-Endpunkt für Ihr Paketökosystem

Generieren eines persönlichen Zugriffstokens

Um ein Paket zu installieren, zu veröffentlichen oder zu löschen, benötigen Sie ein Zugriffstoken. Wenn Sie den Paket-Manager verwenden, müssen Sie ein persönliches Zugriffstoken (PAT, Personal Access Token) generieren. Sie können ein PAT über Ihre Profileinstellungen generieren.

Warnung

Behandeln Sie Ihre Token wie Kennwörter, und halten Sie sie geheim.

Anmelden bei GitHub Packages

Bevor Sie Pakete aus GitHub Packages veröffentlichen oder installieren, müssen Sie Ihren Paket-Manager authentifizieren. Der Endpunkt sieht aus wie https://PACKAGE_TYPE.pkg.github.com/OWNER/REPOSITORY, wobei PACKAGE_TYPE der Typ des von Ihnen verwendeten Paketökosystems ist.

In der folgenden Tabelle finden Sie die Befehle, die Sie für die jeweiligen Paketökosysteme zum Authentifizieren bei GitHub Packages verwenden müssen:

Ihr Paketökosystem Befehlszeile für die Authentifizierung bei GitHub Packages
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 und Gradle Sie können sich beim Pushen direkt authentifizieren.

Wenn Sie mehr über die Verwendung von GitHub Packages in der Umgebung Ihres Projekts erfahren möchten, können Sie die Dokumentation lesen.

Installieren eines Pakets

Wenn Sie authentifiziert sind, können Sie in Ihren Projekten problemlos veröffentlichte Pakete verwenden. Jede Paketstartseite zeigt den Befehl an, der je nach Projektumgebung ausgeführt werden soll.

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

Verwalten von Paketen

Mit GitHub Packages haben Sie mehrere Möglichkeiten, Ihren Paketlebenszyklen und Ihre Paketworkflows problemlos zu verwalten.

Sie können GitHub Packages-Pakete über die GitHub-API und die GraphQL-API verwalten. Mit diesen APIs können Sie erweiterte Integrationsszenarios unterstützen. Mit dem Webhook-Feature von GitHub können Sie beispielsweise Code ausführen, wenn ein Paket veröffentlicht wird. Nehmen wir an, Sie sind ein Maintainer eines Open-Source-Projekts. Mit Webhooks können Sie automatisch einen neuen Tweet oder einen Blogbeitrag veröffentlichen, wenn ein neues Paket veröffentlicht wird.

Sie können auch GitHub-Aktionen verwenden, um die Paketverwaltung zu automatisieren. Mit der Aktion delete-package-versions können Sie die ältesten Versionen Ihrer Pakete automatisch löschen, während Sie eine neue Version veröffentlichen.