Zainstaluj aplikację GitHub firmy Zinn®, abyśmy mogli wdrażać bez długotrwałego tokena

Co daje Ci połączenie

Zainstalowanie aplikacji Zinn® GitHub pozwala witrynie na wdrażanie z twoich repozytoriów — a tablicy projektowej na bieżącą synchronizację z GitHub — bez przekazywania nam osobistego tokena. Przechowujemy wyłącznie numer instalacji aplikacji, który sam w sobie jest bezużyteczny, oraz generujemy token ważny przez godzinę za każdym razem, gdy jest potrzebny. Jest to lepszy wybór dla organizacji, ponieważ nie należy do żadnej pojedynczej osoby i nie przestaje działać, gdy ktoś z niej odchodzi.

Zanim zaczniesz

Konto GitHub lub uprawnienia właściciela w organizacji, w której chcesz zainstalować aplikację. Organizacje zabraniające korzystania z aplikacji innych firm wymagają zgody właściciela; jeśli nie jest to możliwe, użyj zamiast tego tokena o szczegółowych uprawnieniach (Połącz swoje konto GitHub).

1. Utwórz klucz w GitHub

Nie trzeba tworzyć żadnego klucza. Zainstaluj aplikację Zinn® GitHub na swoim koncie osobistym lub w organizacji i wybierz wszystkie repozytoria bądź tylko te, które mamy wdrażać.

Następnie znajdź numer instalacji:

• Konto osobiste — Ustawienia → Aplikacje → Zainstalowane aplikacje GitHub, a następnie Konfiguruj obok aplikacji Zinn®.
• Organizacja — twoje organizacje → Ustawienia → Aplikacje GitHub, a następnie Konfiguruj obok aplikacji Zinn®.

Numer na końcu paska adresu na tej stronie — na przykład github.com/settings/installations/12345678 — to numer instalacji.

2. Połącz tutaj

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

• W połączeniu repozytorium witryny wybierz GitHub (instalacja aplikacji).
• W łączu GitHub tablicy projektowej wybierz Aplikacja Zinn® GitHub.

Wklej Numer instalacji i kontynuuj. Przed zapisaniem czegokolwiek sprawdzamy instalację; numer, z którym nie możemy się połączyć, nigdy nie jest zapisywany.

Co dzieje się dalej

• Repozytoria przyznane aplikacji stają się dostępne do wdrażania witryny, a operacja push rozpoczyna wdrożenie.
• Każde podejmowane przez nas działanie pojawia się w dzienniku audytu instalacji w GitHub pod nazwą aplikacji, a nie twoją.
• Aby udostępnić nam więcej repozytoriów, zmień dostęp do repozytoriów dla aplikacji na tej samej stronie Konfiguruj — nie trzeba niczego ponownie łączyć.

Jeśli połączenie nie działa

Brakuje repozytorium. Instalacja obejmuje tylko wybrane repozytoria. Otwórz Konfiguruj i dodaj je.

Numer został odrzucony. Upewnij się, że jest to numer instalacji z paska adresu, a nie identyfikator samej aplikacji, oraz że aplikacja jest nadal zainstalowana — odinstalowana aplikacja nie posiada instalacji.

Komunikat informuje o odrzuceniu klucza. Prawie zawsze jest to jedna z trzech przyczyn: skopiowana spacja lub znak nowego wiersza, klucz, który wygasł, albo klucz, który został unieważniony lub wygenerowany ponownie po skopiowaniu. Wygeneruj nowy klucz i wklej go ponownie.

Połączenie powiodło się, ale późniejsza operacja kończy się błędem. Klucz został uwierzytelniony, lecz brakuje mu uprawnień wymaganych przez daną operację. Utwórz nowy klucz z uprawnieniami wymienionymi powyżej, a następnie odłącz stare połączenie i połącz nowy klucz.

Odłączanie

Otwórz Integracje, znajdź konto i naciśnij Odłącz. Spowoduje to natychmiastowe usunięcie zapisanego klucza. Wszystko, co z niego korzystało, zatrzyma się przy kolejnej operacji, a ekrany od niego zależne wyświetlą stosowną informację zamiast cichego zgłoszenia błędu.

Odłączenie nie cofa tego, co zostało już wykonane — rekordy, wdrożenia lub ustawienia zmienione przez nas na twoim koncie pozostają bez zmian. Jeśli zachodzi podejrzenie, że sam klucz mógł wyciec, należy go również unieważnić u dostawcy; odłączenie usuwa naszą kopię, a nie ich.