GitHub Packages voor codepakketten
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 bewaar ze geheim.
Aanmelden bij GitHub Packages
Voordat u pakketten publiceert of installeert vanuit GitHub Packages, moet u zich verifiëren in pakketbeheer. Het eindpunt ziet eruit als https://PACKAGE_TYPE.pkg.github.com/OWNER/REPOSITORY, waarbij PACKAGE_TYPE het type pakketecosysteem is 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:
| Uw pakketecosysteem | Opdrachtregel om in te loggen bij GitHub Package |
|---|---|
| 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 & Gradle | U kunt 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 bent geverifieerd, kunt u eenvoudig gepubliceerde pakketten in uw projecten gebruiken. Op elke startpagina van het pakket ziet u de opdracht die moet worden uitgevoerd, afhankelijk van uw projectomgeving.
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 onderhouder bent van een opensource-project. Met webhooks kunt u automatisch een nieuwe Tweet of een blogbericht 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 terwijl u een nieuwe versie publiceert.