GitHub Packages voor codepakketten

Voltooid

In de vorige les hebt u gezien hoe u GitHub Actions kunt gebruiken om containerinstallatiekopieën te bouwen en te publiceren.

In deze les bekijken we de andere pakketten die worden ondersteund door GitHub Packages. GitHub Packages werken met de hulpprogramma's voor het ecosysteem van uw huidige project: npm voor npm-pakketten, nuget.exe of de dotnet CLI voor NuGet-pakketten, enzovoort.

Verifiëren bij GitHub Packages

De manier waarop u zich bij uw pakketbeheerder verifieert, is afhankelijk van het ecosysteem van uw project. Welk ecosysteem u ook gebruikt, u hebt drie stukjes informatie nodig:

  • Uw GitHub-gebruikersnaam
  • Een persoonlijk toegangstoken
  • Het GitHub Packages-eindpunt voor uw pakketecosysteem

Een persoonlijk toegangstoken genereren

Als u een pakket wilt installeren, publiceren of verwijderen, hebt u een toegangstoken nodig. Wanneer u pakketbeheer gebruikt, moet u een persoonlijk toegangstoken (PAT) genereren. U kunt een PAT genereren via uw profielinstellingen.

Waarschuwing

Behandel uw tokens als wachtwoorden en houd ze geheim.

Aanmelden bij GitHub Packages

Voordat u pakketten van GitHub Packages publiceert of installeert, moet u zich bij uw pakketbeheerder verifiëren. Het eindpunt ziet er als https://PACKAGE_TYPE.pkg.github.com/OWNER/REPOSITORYvolgt uit, waar PACKAGE_TYPE is het type pakketecosysteem dat u gebruikt.

In de volgende tabel ziet u de opdracht die moet worden uitgevoerd om te verifiëren bij GitHub Packages op basis van uw pakketecosysteem:

Het ecosysteem van uw pakket Opdrachtregel om te verifiëren bij 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 en Gradle U kunt zich rechtstreeks verifiëren tijdens het pushen.

Als u meer wilt weten over het gebruik van GitHub Packages met de omgeving van uw project, kunt u de documentatie hier lezen.

Een pakket installeren

Wanneer u zich hebt geverifieerd, kunt u eenvoudig gepubliceerde pakketten in uw projecten gebruiken. Op elke startpagina van een pakket ziet u de opdracht die moet worden uitgevoerd, afhankelijk van uw projectomgeving.

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

Pakketten beheren

GitHub Packages biedt u verschillende manieren om uw pakketlevenscycli en -werkstromen eenvoudig te beheren.

U kunt GitHub Packages beheren via de GitHub-API en de GraphQL-API. Met deze API's kunt u geavanceerde integratiescenario's ondersteunen. Met de webhookfunctie van GitHub kunt u bijvoorbeeld code uitvoeren wanneer een nieuw pakket wordt gepubliceerd. Stel dat u een opensource-project onderhoudt. Met webhooks kunt u automatisch een nieuwe tweet of een blogpost publiceren wanneer een nieuw pakket wordt gepubliceerd.

U kunt ook GitHub Actions gebruiken om pakketbeheer te automatiseren. Met de actie delete-package-versions kunt u automatisch de oudste versie van uw pakketten verwijderen tijdens het publiceren van een nieuwe versie.