Pakiety GitHub dla pakietów kodu
W poprzedniej lekcji pokazano, jak kompilować i publikować obrazy kontenerów za pomocą narzędzia GitHub Actions.
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.
Uwierzytelnianie w pakietach GitHub
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:
- Twoja nazwa użytkownika GitHub
- Osobisty token dostępu
- Punkt końcowy pakietów GitHub dla ekosystemu pakietów
Tworzenie 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ć osobisty token dostępu za pośrednictwem ustawień profilu.
Ostrzeżenie
Traktuj tokeny jak hasła i zachowaj ich poufność.
Logowanie do pakietów GitHub
Przed opublikowaniem lub zainstalowaniem pakietów z pakietów GitHub musisz się uwierzytelnić w menedżerze pakietów. Punkt końcowy będzie wyglądać następująco: https://PACKAGE_TYPE.pkg.github.com/OWNER/REPOSITORY
, gdzie PACKAGE_TYPE
to typ 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 pakietu | Wiersz polecenia do uwierzytelniania w pakiecie GitHub |
---|---|
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 i Gradle | Możesz bezpośrednio uwierzytelnić się podczas wypychania. |
Jeśli chcesz dowiedzieć się więcej na temat używania pakietów GitHub ze środowiskiem projektu, przeczytaj daną dokumentację dostępną tutaj.
Instalowanie pakietu
Po uwierzytelnieniu można łatwo używać opublikowanych pakietów w projektach. Na każdej stronie głównej pakietu wyświetlane jest 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 elementu webhook usługi GitHub można uruchomić kod po opublikowaniu nowego pakietu. Wyobraź sobie, że jesteś osobą odpowiedzialną za konserwację projektu typu open source. Za pomocą elementów webhook możesz automatycznie publikować nowy tweet lub wpis w blogu po opublikowaniu nowego pakietu.
Możesz również użyć funkcji GitHub Actions do zautomatyzowania zarządzania pakietami. Za pomocą akcji delete-package-versions można automatycznie przycinać najstarszą wersję pakietów podczas publikowania nowej wersji.