Verbinden Sie Ihr GitHub-Konto mit einem Token, damit Ihre Websites aus einem Repository bereitgestellt werden

Was Ihnen die Verbindung bringt

Durch das Verbinden von GitHub mithilfe eines Tokens kann eine Website direkt aus einem Ihrer Repositories bereitgestellt werden: Pushen Sie in den Branch, und die Website wird aktualisiert. Außerdem ermöglicht es uns, auf GitHub Pages in Ihrem Konto zu veröffentlichen, sofern Sie dies als Host für eine Website auswählen.

Wenn Ihre Repositories zu einer Organisation gehören, bevorzugen Sie stattdessen die Zinn® GitHub-App – siehe Installieren der Zinn® GitHub-App. Ein Token gehört zu einer einzelnen Person und funktioniert nicht mehr, wenn diese Person ausscheidet.

Bevor Sie beginnen

Ein GitHub-Konto mit Zugriff auf die Repositories, die Sie bereitstellen möchten. Falls diese zu einer Organisation gehören, muss ein Inhaber möglicherweise granulare Token (Fine-grained Tokens) dafür genehmigen.

1. Erstellen Sie den Schlüssel bei GitHub

Klicken Sie auf GitHub auf Ihr Profilbild und gehen Sie auf Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Benennen Sie ihn und wählen Sie ein Ablaufdatum. Wählen Sie unter Repository access die Option Only select repositories und wählen Sie die Repositories aus, die Sie bereitstellen – verwenden Sie den geringstmöglichen Zugriff, der funktioniert.

Geben Sie unter Repository permissions die Berechtigung Read and write für folgende Elemente an:

• Contents
• Pages
• Administration

Klicken Sie auf Generate token und kopieren Sie ihn – GitHub zeigt ihn nur einmal an.

2. Hier verbinden

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

Wir testen Ihre Eingabe, bevor etwas gespeichert wird. Ein Schlüssel, der nicht funktioniert, wird niemals gespeichert, und die Antwort gibt an, was daran fehlerhaft war. Ein funktionierender Schlüssel wird verschlüsselt in unserem Secrets-Tresor aufbewahrt – niemals in unserer Datenbank – und wird niemals wieder angezeigt, nicht einmal Ihnen.

Was als Nächstes geschieht

• Eine Website kann direkt von einem Repository in diesem Konto aus bereitgestellt werden: Wählen Sie es in der Repository-Verbindung der Website aus, bestimmen Sie das Repository und den Branch, und ein Push führt die Bereitstellung aus.
• Jeder andere Branch kann eine eigene Vorschau erhalten, sodass Sie eine Änderung überprüfen können, bevor sie die Live-Website erreicht.
• Git-basierte 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

Ein Repository wird nicht angezeigt. Der Repository-Zugriff des Tokens umfasst dieses Repository nicht. Bearbeiten Sie das Token auf GitHub und fügen Sie das Repository hinzu.

Es hat funktioniert und funktionierte dann nicht mehr. Granulare Token laufen an dem von Ihnen gewählten Datum ab. Generieren Sie ein neues Token und stellen Sie die Verbindung her; GitHub sendet Ihnen vor dem Ablauf eines Tokens eine E-Mail.

Es wird angezeigt, dass der Schlüssel abgelehnt wurde. Fast immer liegt einer von drei Gründen vor: Ein Leerzeichen oder ein Zeilenumbruch wurde mitkopiert, der Schlüssel ist abgelaufen, oder der Schlüssel wurde nach dem Kopieren widerrufen oder neu generiert. Erstellen Sie einen neuen Schlüssel und fügen Sie ihn erneut ein.

Die Verbindung wird hergestellt, aber ein späterer Vorgang schlägt fehl. Der Schlüssel authentifiziert sich, es fehlt jedoch 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 diesen Schlüssel verwendet hat, wird bei der nächsten Aktion angehalten, und die Bildschirme, die davon abhängig waren, zeigen dies an, anstatt stillschweigend fehlzuschlagen.

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.