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

Was die Verbindung für Sie bewirkt

Durch das Verbinden von Bitbucket kann eine Website aus einem Ihrer Bitbucket Cloud-Repositorys bereitgestellt werden: Pushen Sie Änderungen an den Branch und die Website wird aktualisiert.

Bevor Sie beginnen

Ein Bitbucket Cloud-Konto mit Zugriff auf die Repositorys, die Sie bereitstellen möchten.

1. Erstellen des Schlüssels bei Bitbucket

Bitbucket bietet zwei Arten von Anmeldeinformationen an, die beide funktionieren:

• Ein Zugriffstoken für ein Repository, Projekt oder einen Arbeitsbereich, das bzw. der in den Einstellungen des jeweiligen Repositorys, Projekts oder Arbeitsbereichs unter Zugriffstoken erstellt wird. Es ist an dieses Repository, dieses Projekt oder diesen Arbeitsbereich statt an eine Person gebunden. Gewähren Sie Lesezugriff auf Repositorys.
• Ein API-Token in Ihrem Atlassian-Konto. Wählen Sie Ihr Profil aus, dann Kontoeinstellungen → Sicherheit → API-Tokens erstellen und verwalten → API-Token mit Berechtigungsbereichen erstellen. Benennen Sie es, legen Sie ein Ablaufdatum fest, wählen Sie Bitbucket als App aus und wählen Sie den Lesezugriff auf Repositorys aus. Bitbucket zeigt das Token einmal an; kopieren Sie es zu diesem Zeitpunkt.

2. Hier verbinden

Öffnen Sie Integrationen in Ihrem Dashboard und wählen Sie Ein Konto verbinden. Wählen Sie Code-Hosting als Gruppe und Bitbucket als Konto aus, füllen Sie API-Token aus – und, falls Sie ein Token für Ihr Atlassian-Konto statt eines Zugriffstokens erstellt haben, auch Kontobenutzername, und drücken 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 Geheimtresor aufbewahrt – niemals in unserer Datenbank – und wird nie wieder angezeigt, nicht einmal Ihnen.

Der Benutzername bestimmt, wie wir das Token senden, geben Sie ihn daher nur für ein Kontotoken ein. Ein mit einem Benutzernamen eingegebenes Zugriffstoken oder ein Kontotoken ohne Benutzername wird abgelehnt.

Was als Nächstes geschieht

• 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.
• Git-basierte statische Hosting-Anbieter wie Render und Azure Static Web Apps verwenden diese Verbindung als Quelle für den Code der Website.

Wenn die Verbindung nicht hergestellt wird

Ein Repository fehlt. Ein Zugriffstoken erreicht nur das Repository, das Projekt oder den Arbeitsbereich, in dem es erstellt wurde. Erstellen Sie eines auf der Ebene, die jedes von Ihnen benötigte Repository abdeckt.

Es hat funktioniert und funktionierte dann nicht mehr. Beide Token-Arten können ablaufen. Erstellen Sie ein neues und verbinden Sie es.

Es wird angezeigt, dass der Schlüssel abgelehnt wurde. Fast immer liegt dies an einem der folgenden drei Dinge: einem mitkopierten Leerzeichen oder Zeilenumbruch, einem abgelaufenen Schlüssel oder einem 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 den Vorgang 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.

Trennen der Verbindung

Öffnen Sie Integrationen, suchen Sie das Konto und drücken Sie auf Verbindung trennen. Dadurch wird der gespeicherte Schlüssel sofort gelöscht. Alles, was diesen verwendet hat, wird beim nächsten Vorgang 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.