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

Co daje Ci połączenie

Połączenie z GitLab umożliwia wdrażanie witryny z jednego z twoich repozytoriów GitLab oraz pozwala nam publikować w usłudze GitLab Pages na twoim koncie, jeśli wybierzesz ją jako hosting witryny.

Zanim zaczniesz

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

1. Utwórz klucz w GitLab

W GitLab wybierz swój awatar w prawym górnym rogu, a następnie Edit profile → Access → Personal access tokens i wygeneruj nowy token (GitLab może oznaczyć go jako Legacy token w menu Generate token). Nadaj mu nazwę, ustaw datę wygaśnięcia i zaznacz następujące zakresy:

• api
• write_repository

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

2. Połącz go tutaj

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

Testujemy wklejoną zawartość przed zapisaniem czegokolwiek. Klucz, który nie działa, nigdy nie jest przechowywany, a odpowiedź wskazuje, co było z nim nie tak. Działający klucz jest przechowywany w postaci zaszyfrowanej w naszym magazynie wpisów tajnych — nigdy w naszej bazie danych — i nigdy więcej nie jest pokazywany, 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 uruchomi 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 i Azure Static Web Apps, używają tego połączenia jako źródła kodu witryny.

Jeśli połączenie się nie powiedzie

Działało, a potem przestało. Tokeny GitLab zawsze wygasają — zwykle maksymalnie po roku od ich utworzenia — a GitLab wysyła wiadomość e-mail przed upływem tego terminu. Utwórz nowy token i go połącz.

Brakuje zakresu. Zakresów tokena nie można zmienić po jego utworzeniu; utwórz nowy token z zaznaczonymi obydwoma zakresami.

Pojawia się informacja o odrzuceniu klucza. Prawie zawsze jest to jedna z trzech przyczyn: spacja lub podział wiersza skopiowany wraz z nim, klucz, który wygasł, albo klucz, który został unieważniony lub wygenerowany ponownie po skopiowaniu. Utwórz nowy klucz i wklej go ponownie.

Łączy się, ale coś później kończy się błędem. Klucz uwierzytelnia się poprawnie, lecz 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.

Odłą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 kolejnej akcji, a ekrany, które od niego zależały, poinformują o tym, zamiast kończyć działanie w sposób niewidoczny.

Odłączenie nie cofa tego, co zostało już zrobione — rekordy, wdrożenia lub 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; odłączenie usuwa naszą kopię, a nie ich.