Verbinden Sie Ihr GitLab-Konto, damit Ihre Websites aus einem Repository bereitgestellt werden.

Was Ihnen das Verbinden bringt

Durch das Verbinden von GitLab kann eine Website aus einem Ihrer GitLab-Repositorys bereitgestellt werden und wir können auf GitLab Pages in Ihrem Konto veröffentlichen, wenn Sie dies als Host einer Website auswählen.

Bevor Sie beginnen

Ein GitLab-Konto mit Zugriff auf die Projekte, die Sie bereitstellen möchten.

1. Den Schlüssel in GitLab erstellen

Wählen Sie in GitLab oben rechts Ihr Profilbild aus, gehen Sie dann auf Profil bearbeiten → Zugriff → Persönliche Zugriffstoken und generieren Sie ein neues Token (GitLab bezeichnet dies im Menü Token generieren möglicherweise als Legacy-Token). Benennen Sie es, legen Sie ein Ablaufdatum fest und aktivieren Sie diese Bereiche:

• api
• write_repository

Klicken Sie auf Token generieren und kopieren Sie es – GitLab zeigt es nur einmal an.

2. Hier verbinden

Öffnen Sie Integrationen in Ihrem Dashboard und wählen Sie Konto verbinden aus. Wählen Sie Code-Hosting als Gruppe und GitLab als Konto aus, füllen Sie API-Token aus und klicken Sie auf Konto verbinden.

Wir testen, was Sie einfügen, bevor etwas gespeichert wird. Ein Schlüssel, der nicht funktioniert, wird niemals gespeichert, und die Rückmeldung gibt an, was daran falsch war. Ein funktionierender Schlüssel wird verschlüsselt in unserem Geheimhaltungsspeicher aufbewahrt – niemals in unserer Datenbank – und wird nie wieder angezeigt, nicht einmal Ihnen.

Was als Nächstes passiert

• Eine Website kann direkt aus einem Repository in diesem Konto bereitgestellt werden: Wählen Sie es bei der Repository-Verbindung der Website aus, wählen Sie Repository und Branch aus, und ein Push führt die Bereitstellung durch.
• Jeder andere Branch kann eine eigene Vorschau erhalten, sodass Sie eine Änderung überprüfen können, bevor sie die Live-Website erreicht.
• Von Git erstellte statische Hosts wie Render und Azure Static Web Apps verwenden diese Verbindung als Quelle für den Code der Website.

Wenn keine Verbindung hergestellt werden kann

Es hat funktioniert und dann aufgehört. GitLab-Token laufen immer ab – in der Regel höchstens ein Jahr nach ihrer Erstellung – und GitLab sendet Ihnen vorab eine E-Mail. Erstellen Sie ein neues und verbinden Sie es.

Ein Berechtigungsbereich fehlt. Die Bereiche eines Tokens können nach seiner Erstellung nicht mehr geändert werden; erstellen Sie ein neues Token, bei dem beide Bereiche ausgewählt sind.

Es wird angezeigt, dass der Schlüssel abgelehnt wurde. Fast immer eines von drei Dingen: Ein mitkopiertes Leerzeichen oder ein Zeilenumbruch, ein abgelaufener Schlüssel oder ein Schlüssel, der nach dem Kopieren widerrufen oder neu generiert wurde. Erstellen Sie einen neuen und fügen Sie ihn erneut ein.

Die Verbindung wird hergestellt, aber ein späterer Vorgang schlägt fehl. Der Schlüssel authentifiziert sich, verfügt jedoch nicht über eine Berechtigung, die für die Aktion erforderlich ist. Erstellen Sie einen neuen Schlüssel mit den oben aufgeführten Berechtigungen, trennen Sie dann die alte Verbindung und verbinden Sie den neuen Schlüssel.

Verbindung trennen

Öffnen Sie Integrationen, suchen Sie das Konto und klicken Sie auf Verbindung trennen. Dadurch wird der gespeicherte Schlüssel sofort gelöscht. Alles, was ihn verwendet hat, stoppt bei der nächsten Aktion, und die Bildschirme, die davon abhängig waren, zeigen dies an, anstatt stillschweigend fehlschlagen.

Das Trennen der Verbindung macht das bereits Geschehene nicht rückgängig – Datensätze, Bereitstellungen oder Einstellungen, die wir an Ihrem Konto geändert haben, bleiben unverändert. Wenn Sie vermuten, dass der Schlüssel selbst kompromittiert wurde, widerrufen Sie ihn zusätzlich beim Anbieter; das Trennen der Verbindung entfernt unsere Kopie, nicht deren.