Połącz swoje konto GitHub za pomocą tokena, aby twoje witryny były wdrażane z repozytorium

Co daje Ci połączenie

Połączenie z GitHub za pomocą tokena umożliwia wdrażanie witryny z jednego z twoich repozytoriów: wyślij zmiany (push) do gałęzi, a witryna się zaktualizuje. Pozwala nam to również publikować w usłudze GitHub Pages na twoim koncie, jeśli wybierzesz ją jako hosta witryny.

Jeśli twoje repozytoria należą do organizacji, zalecamy użycie aplikacji Zinn® GitHub — zobacz Zainstaluj aplikację Zinn® GitHub. Token należy do jednej osoby i przestaje działać, gdy ta osoba odejdzie.

Zanim zaczniesz

Konto GitHub z dostępem do repozytoriów, które chcesz wdrażać. Jeśli należą one do organizacji, jej właściciel może wymagać zatwierdzenia szczegółowych tokenów (fine-grained tokens).

1. Utwórz klucz w GitHub

W serwisie GitHub kliknij swoje zdjęcie profilowe, a następnie Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Nadaj mu nazwę i wybierz datę wygaśnięcia. W sekcji Repository access wybierz Only select repositories i wskaż te, które wdrażasz — najwęższy możliwy dostęp, który wystarczy do działania.

W sekcji Repository permissions nadaj uprawnienia Read and write dla:

• Contents
• Pages
• Administration

Kliknij Generate token i skopiuj go — GitHub wyświetla go tylko raz.

2. Połącz go tutaj

Otwórz Integrations w panelu i wybierz Connect an account. Jako grupę wybierz Code hosting, a jako konto GitHub, wypełnij pole API token i kliknij Connect account.

Testujemy wklejoną treść przed zapisaniem czegokolwiek. Klucz, który nie działa, nigdy nie jest przechowywany, a odpowiedź wyjaśnia, co było z nim nie tak. Klucz, który działa, jest przechowywany w postaci zaszyfrowanej w naszym magazynie sekretów — nigdy w naszej bazie danych — i nigdy więcej nie zostanie wyświetlony, nawet tobie.

Co dzieje się dalej

• Witryna może być wdrażana bezpośrednio z repozytorium na tym koncie: wybierz je w połączeniu repozytorium witryny, wskaż repozytorium oraz gałąź, a operacja push rozpocznie wdrożenie.
• Każda inna gałąź może otrzymać własny podgląd, dzięki czemu możesz sprawdzić zmianę, zanim trafi ona na działającą witrynę.
• Statyczne usługi hostingowe oparte na Git, takie jak Render oraz Azure Static Web Apps, używają tego połączenia jako źródła kodu witryny.

Jeśli połączenie się nie powiedzie

Repozytorium się nie wyświetla. Uprawnienia dostępu tokena do repozytoriów go nie obejmują. Zmodyfikuj token w GitHub i dodaj to repozytorium.

Działało, a potem przestało. Szczegółowe tokeny wygasają w wybranym dniu. Wygeneruj nowy i połącz go; GitHub wysyła wiadomość e-mail przed wygaśnięciem tokena.

Pojawia się komunikat, że klucz został odrzucony. Prawie zawsze jest to jedna z trzech przyczyn: skopiowana wraz z nim spacja lub znak nowego wiersza, klucz, który wygasł, albo klucz, który został unieważniony bądź wygenerowany ponownie po skopiowaniu. Utwórz nowy klucz i wklej go ponownie.

Łączy się, ale później coś kończy się błędem. Klucz uwierzytelnia się poprawnie, ale brakuje mu uprawnienia wymaganego przez daną akcję. Utwórz nowy klucz z uprawnieniami wymienionymi powyżej, a następnie odłącz stare połączenie i podłącz nowy klucz.

Rozłączanie

Otwórz Integrations, znajdź konto i kliknij Disconnect. Spowoduje to natychmiastowe usunięcie zapisanego klucza. Wszystko, co z niego korzystało, zatrzyma się przy następnej akcji, a ekrany, które od niego zależały, poinformują o tym zamiast kończyć działanie w milczeniu.

Rozłączenie nie cofa tego, co zostało już zrobione — rekordy, wdrożenia czy ustawienia zmienione przez nas na twoim koncie pozostają bez zmian. Jeśli podejrzewasz, że sam klucz mógł wyciec, unieważnij go również u dostawcy; rozłączenie usuwa naszą kopię, a nie ich.