Pakiety GitHub dla pakietów kodu
W poprzedniej lekcji pokazano, jak używać funkcji GitHub Actions do kompilowania i publikowania obrazów kontenerów.
W tej lekcji przyjrzymy się innym pakietom obsługiwanym przez pakiety GitHub. Pakiety GitHub współpracują z narzędziami ekosystemu bieżącego projektu: npm dla pakietów npm, nuget.exe lub interfejsu wiersza polecenia dotnet dla pakietów NuGet itp.
Uwierzytelnij się w usłudze GitHub Packages
Sposób uwierzytelniania w menedżerze pakietów zależy od ekosystemu projektu. Niezależnie od ekosystemu, z którym pracujesz, potrzebne będą trzy informacje:
- Nazwa użytkownika usługi GitHub
- Osobisty token dostępu
- Punkt dostępu GitHub Packages dla ekosystemu Twoich pakietów
Generowanie osobistego tokenu dostępu
Aby zainstalować, opublikować lub usunąć pakiet, potrzebny jest token dostępu. W przypadku korzystania z menedżera pakietów należy wygenerować osobisty token dostępu (PAT). Możesz wygenerować pat za pomocą ustawień profilu.
Ostrzeżenie
Traktuj tokeny, takie jak hasła, i przechowuj je w tajemnicy.
Zaloguj się do pakietów GitHub
Przed opublikowaniem lub zainstalowaniem pakietów z pakietów GitHub należy uwierzytelnić się w menedżerze pakietów. Punkt końcowy będzie wyglądać jak https://PACKAGE_TYPE.pkg.github.com/OWNER/REPOSITORY, gdzie PACKAGE_TYPE jest typem używanego ekosystemu pakietów.
W poniższej tabeli przedstawiono polecenie do uruchomienia w celu uwierzytelnienia w pakietach GitHub w oparciu o ekosystem pakietów:
| Ekosystem Twoich pakietów | Polecenie do autoryzacji w 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 & Gradle | Możesz przeprowadzić bezpośrednie uwierzytelnianie podczas wypychania. |
Jeśli chcesz dowiedzieć się więcej o sposobie używania pakietów GitHub ze środowiskiem projektu, możesz przeczytać dokumentację tutaj.
Instalowanie pakietu
Po uwierzytelnieniu można łatwo używać opublikowanych pakietów w projektach. Każda strona główna pakietu zawiera polecenie do uruchomienia w zależności od środowiska projektu.
Zarządzanie pakietami
Pakiety GitHub oferują kilka sposobów łatwego zarządzania cyklami życia pakietów i przepływami pracy.
Pakiety GitHub można zarządzać za pomocą interfejsu API usługi GitHub i interfejsu API GraphQL. Te interfejsy API umożliwiają obsługę zaawansowanych scenariuszy integracji. Na przykład za pomocą funkcji Webhook GitHub można uruchomić kod, gdy opublikowany zostanie nowy pakiet. Wyobraź sobie, że jesteś opiekunem projektu open source. W przypadku elementów webhook można automatycznie opublikować nowy tweet lub wpis w blogu po opublikowaniu nowego pakietu.
Możesz również użyć funkcji GitHub Actions do zautomatyzowania zarządzania pakietami. Dzięki akcji delete-package-versions można automatycznie usuwać najstarsze wersje Twoich pakietów podczas publikowania nowej wersji.