Pakiety GitHub dla pakietów kodu

Ukończone

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.

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

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.