Połącz swoje konto GitLab, aby Twoje strony były wdrażane z repozytorium

Co daje to połączenie

Połączenie GitLab umożliwia wdrażanie witryny z jednego z Twoich repozytoriów GitLab oraz pozwala nam publikować na GitLab Pages na Twoim koncie w miejscach, które wybierzesz jako host witryny.

Zanim zaczniesz

Konto GitLab z dostępem do projektów, które chcesz wdrożyć.

1. Utwórz klucz w GitLab

W GitLab wybierz swój awatar w prawym górnym rogu, a następnie przejdź do Edytuj profil → Dostęp → Osobiste tokeny dostępu (Edit profile → Access → Personal access tokens) i wygeneruj nowy token (GitLab może oznaczyć go jako Starszy token [Legacy token] w menu Generowanie tokena [Generate token]). Nazwij go, ustaw datę wygaśnięcia i zaznacz następujące zakresy uprawnień:

• api
• write_repository

Naciśnij przycisk Generuj token i skopiuj go — GitLab wyświetla go tylko raz.

2. Połącz tutaj

Otwórz sekcję Integracje w swoim panelu i wybierz Połącz konto. Wybierz Hosting kodu jako grupę oraz GitLab jako konto, wpisz Token API i naciśnij Połącz konto.

Przetestujemy wklejoną wartość przed zapisaniem czegokolwiek. Klucz, który nie działa, nigdy nie jest zapisywany, a komunikat informuje, co było w nim nie tak. Działający klucz jest przechowywany w formie zaszyfrowanej w naszym skarbcu sekretów — nigdy w naszej bazie danych — i nie jest już pokazywany, nawet Tobie.

Co dzieje się dalej

• Witrynę można wdrożyć bezpośrednio z repozytorium na tym koncie: wybierz je w ustawieniach połączenia repozytorium

witryny, wskazując repozytorium i gałąź, a każde wypchnięcie (push) spowoduje wdrożenie.

• Każda inna gałąź może mieć własny podgląd, co pozwala sprawdzić zmianę przed jej trafieniem na

żywą witrynę.

• Statyczne platformy hostingowe budowane za pomocą Gita, takie jak Render i Azure Static Web Apps, korzystają z tego połączenia jako

źródła kodu witryny.

Jeśli połączenie nie powiedzie się

Działało, a potem przestało. Tokeny GitLab zawsze wygasają — zazwyczaj najpóźniej po roku od ich utworzenia — a GitLab wysyła powiadomienie e-mail przed tym faktem. Utwórz nowy token i połącz go.

Brakuje zakresu uprawnień. Zakresów tokena nie można zmienić po jego utworzeniu; utwórz nowy token z zaznaczonymi obiema uprawnieniami.

Komunikat informuje, że klucz został odrzucony. Niemal zawsze wynika to z jednej z trzech przyczyn: spacji lub znaku nowej linii skopiowanego razem z kluczem, wygaśnięcia klucza lub unieważnienia/wygenerowania klucza na nowo po jego skopiowaniu. Utwórz nowy klucz i wklej go ponownie.

Połączenie powiodło się, ale późniejsze działanie kończy się błędem. Klucz uwierzytelnia, ale brakuje mu uprawnienia wymaganego przez daną akcję. Utwórz nowy klucz z uprawnieniami wymienionymi powyżej, a następnie rozłącz stare połączenie i połącz nowy klucz.

Rozłączanie

Otwórz Integracje, znajdź konto i naciśnij Rozłącz. Spowoduje to natychmiastowe usunięcie zapisanego klucza. Wszystko, co z niego korzystało, zatrzyma się przy najbliższej akcji, a ekrany, które od niego zależały, poinformują o tym zamiast kończyć się cichym błędem.

Rozłączenie nie cofa tego, co zostało już zrobione — rejestry, wdrożenia czy ustawienia, które zmieniliśmy 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.