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

Was das Verbinden Ihnen bringt

Das Verbinden von GitLab ermöglicht die Bereitstellung einer Website über eines Ihrer GitLab-Repositories und erlaubt uns die Veröffentlichung auf GitLab Pages in Ihrem Konto, sofern Sie diesen Dienst als Host für eine Website auswählen.

Bevor Sie beginnen

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

1. Den Schlüssel bei GitLab erstellen

Wählen Sie in GitLab oben rechts Ihren Avatar aus, dann Edit profile → Access → Personal access tokens, und generieren Sie ein neues Token (GitLab bezeichnet dies im Menü Generate token möglicherweise als Legacy token). Benennen Sie es, legen Sie ein Ablaufdatum fest und aktivieren Sie diese Bereiche (Scopes):

• api
• write_repository

Klicken Sie auf Generate token und kopieren Sie es – GitLab zeigt es nur ein einziges Mal an.

2. Hier verbinden

Öffnen Sie Integrations in Ihrem Dashboard und wählen Sie Connect an account. Wählen Sie Code hosting als Gruppe und GitLab als Konto, tragen Sie den Wert unter API token ein und klicken Sie auf Connect account.

Wir testen Ihre Eingabe, bevor etwas gespeichert wird. Ein Schlüssel, der nicht funktioniert, wird niemals gespeichert, und die Rückmeldung gibt an, was damit nicht stimmte. Ein funktionierender Schlüssel wird verschlüsselt in unserem Schlüsseltresor aufbewahrt – niemals in unserer Datenbank – und wird nie wieder angezeigt, auch nicht Ihnen.

Was als Nächstes passiert

• Eine Website kann direkt aus einem Repository in diesem Konto bereitgestellt werden: Wählen Sie dieses bei der Repository-Verbindung der Website aus, bestimmen Sie das Repository sowie den Branch, und ein Push löst das Deployment aus.
• Jeder andere Branch kann eine eigene Vorschau erhalten, sodass Sie eine Änderung prüfen können, bevor sie die Live-Website erreicht.
• Auf Git basierende statische Hosts wie Render und Azure Static Web Apps nutzen diese Verbindung als Quelle für den Code der Website.

Wenn keine Verbindung hergestellt werden kann

Es hat funktioniert und dann aufgehört. GitLab-Tokens laufen immer ab – in der Regel spätestens ein Jahr nach ihrer Erstellung – und GitLab benachrichtigt Sie vorab per E-Mail. Erstellen Sie ein neues Token und verbinden Sie es.

Ein Scope fehlt. Die Scopes eines Tokens können nach der Erstellung nicht mehr geändert werden; erstellen Sie ein neues Token, bei dem beide Scopes aktiviert sind.

Es wird gemeldet, dass der Schlüssel abgelehnt wurde. Fast immer liegt dies an einem von drei Gründen: 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 Schlüssel und fügen Sie ihn erneut ein.

Die Verbindung klappt, aber später schlägt etwas fehl. Der Schlüssel authentifiziert sich zwar, besitzt aber nicht die 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 Integrations, suchen Sie das Konto und klicken Sie auf Disconnect. Dadurch wird der gespeicherte Schlüssel sofort gelöscht. Alles, was ihn verwendet hat, stoppt bei der nächsten Aktion, und die davon abhängigen Ansichten weisen darauf hin, anstatt stillschweigend fehlzuschlagen.

Das Trennen der Verbindung macht bereits Durchgeführtes nicht rückgängig – Datensätze, Deployments oder Einstellungen, die wir in 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; durch das Trennen der Verbindung wird nur unsere Kopie entfernt, nicht deren Kopie.