Install the Zinn® GitHub app so we can deploy without a long-lived token

Co to dla Państwa oznacza

Zainstalowanie aplikacji Zinn® GitHub umożliwia wdrażanie witryny z posiadanych repozytoriów oraz utrzymanie synchronizacji tablicy projektu z platformą GitHub bez przekazywania nam osobistego tokenu. Przechowujemy wyłącznie numer instalacji aplikacji, który sam w sobie jest bezużyteczny, i generujemy nowy token ważny przez godzinę za każdym razem, gdy jest on potrzebny. Jest to lepsze rozwiązanie dla organizacji, ponieważ nie należy ono do żadnej konkretnej osoby i nie przestaje działać w momencie odejścia pracownika.

Przed rozpoczęciem

Konto GitHub lub uprawnienia właściciela w organizacji, w której chcą Państwo zainstalować aplikację. Organizacje, które zabraniają używania aplikacji innych firm, wymagają zgody właściciela; jeśli nie jest to możliwe, należy zamiast tego użyć tokenu o ogranicionym zakresie (Połączenie konta GitHub).

1. Tworzenie klucza w usłudze GitHub

Nie trzeba tworzyć żadnego klucza. Należy zainstalować aplikację Zinn® GitHub na koncie osobistym lub w organizacji oraz wybrać wszystkie repozytoria bądź tylko te, z których ma odbywać się wdrażanie.

Następnie należy znaleźć numer instalacji:

• Konto osobiste — Settings → Applications → Installed GitHub Apps, a następnie Configure obok aplikacji Zinn®.
• Organizacja — Your organizations → Settings → GitHub Apps, a następnie Configure obok aplikacji Zinn®.

Numer znajdujący się na końcu paska adresu na tej stronie — na przykład github.com/settings/installations/12345678 — jest numerem instalacji.

2. Połączenie w tym miejscu

Aplikację wybiera się w miejscu jej użycia, a nie na ekranie Integracje:

• W ustawieniach połączenia repozytorium witryny należy wybrać GitHub (app install).
• W odnośniku GitHub tablicy projektu należy wybrać The Zinn® GitHub app.

Należy wkleić numer instalacji i kontynuować. Przed zapisaniem czegokolwiek sprawdzamy poprawność instalacji; numer, z którym nie możemy nawiązać połączenia, nigdy nie jest zapisywany.

Co dzieje się dalej

• Wybrane repozytoria, do których przyznano dostęp aplikacji, pojawiają się jako źródło wdrażania witryny, a każde przesłanie zmian powoduje jej wdrożenie.
• Każda podejmowana przez nas akcja jest rejestrowana w dzienniku audytu instalacji w usłudze GitHub pod nazwą aplikacji, a nie Państwa nazwą.
• Aby udostępnić nam kolejne repozytoria, należy zmienić uprawnienia dostępu aplikacji do repozytoriów na tej samej stronie Configure — ponowne łączenie nie jest wymagane.

W przypadku problemów z połączeniem

Brak repozytorium. Instalacja obejmuje wyłącznie wybrane repozytoria. Należy otworzyć stronę Configure i dodać odpowiednie repozytorium.

Odrzucenie numeru. Należy sprawdzić, czy podano numer instalacji z paska adresu, a nie identyfikator aplikacji, oraz czy aplikacja jest nadal zainstalowana — odinstalowana aplikacja nie posiada numeru instalacji.

Komunikat o odrzuceniu klucza. W prawie wszystkich przypadkach przyczyną jest jedna z trzech rzeczy: skopiowany wraz z tekstem spacja lub znak nowego wiersza, wygasły klucz bądź klucz, który został unieważniony lub wygenerowany ponownie po jego skopiowaniu. Należy utworzyć nowy klucz i wkleić go ponownie.

Połączenie powiodło się, ale późniejsza akcja zakończyła się niepowodzeniem. Klucz przechodzi uwierzytelnianie, lecz brakuje mu uprawnienia wymaganego do wykonania danej akcji. Należy utworzyć nowy klucz z uprawnieniami wymienionymi powyżej, rozłączyć poprzednie połączenie, a następnie połączyć przy użyciu nowego klucza.

Rozłączanie

Należy otworzyć sekcję Integrations, znaleźć konto i kliknąć przycisk Disconnect. Spowoduje to natychmiastowe usunięcie zapisanego klucza. Wszystkie elementy, które z niego korzystały, zatrzymają się przy następnej próbie wykonania akcji, a ekrany zależne od tych elementów wyświetlą stosowny komunikat zamiast cicho ulegać awarii.

Rozłączenie nie powoduje cofnięcia zmian, które zostały już dokonane — zapisy, wdrożenia lub ustawienia zmienione przez nas na Państwa koncie pozostają bez zmian. Jeśli podejrzewają Państwo, że sam klucz mógł zostać ujawniony, należy go również unieważnić u dostawcy; rozłączenie usuwa naszą kopię, a nie kopię dostawcy.