Verknüpfen Sie Ihr Bitbucket-Konto, damit Ihre Websites über ein Repository bereitgestellt werden

Welche Vorteile Ihnen die Verknüpfung bringt

Durch die Verknüpfung von Bitbucket kann eine Website über eines Ihrer Bitbucket Cloud-Repositories bereitgestellt werden: Führen Sie einen Push in den Branch aus und die Website wird aktualisiert.

Bevor Sie beginnen

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

1. Erstellen Sie den Schlüssel bei Bitbucket

Bitbucket bietet zwei Arten von Anmeldedaten an, und beide funktionieren:

• Ein Zugriffstoken für ein Repository, ein Projekt oder einen Workspace, erstellt in den jeweiligen Einstellungen dieses Repositories, Projekts oder Workspaces unter Zugriffstoken. Es ist an dieses Repository, dieses Projekt oder diesen Workspace gebunden und nicht an eine Person. Vergeben Sie Lesezugriff auf Repositories.
• Ein API-Token in Ihrem Atlassian-Konto. Wählen Sie Ihr Profil, dann Kontoeinstellungen → Sicherheit → API-Token erstellen und verwalten → API-Token mit Berechtigungsbereichen erstellen. Benennen Sie es, legen Sie ein Ablaufdatum fest, wählen Sie Bitbucket als App und wählen Sie den Lesezugriff auf Repositories aus. Bitbucket zeigt das Token nur einmal an; kopieren Sie es direkt.

2. Hier verknüpfen

Öffnen Sie Integrationen in Ihrem Dashboard und wählen Sie Ein Konto verknüpfen. Wählen Sie Code-Hosting als Gruppe und Bitbucket als Konto, füllen Sie API-Token aus — und, falls Sie ein Token in Ihrem Atlassian-Konto anstelle eines Zugriffstokens erstellt haben, ebenfalls den Konto-Benutzernamen, und klicken Sie auf Konto verknüpfen.

Wir testen Ihre Eingabe, bevor irgendetwas gespeichert wird. Ein Schlüssel, der nicht funktioniert, wird niemals gespeichert, und die Antwort gibt an, was damit nicht stimmte. Ein Schlüssel, der funktioniert, wird verschlüsselt in unserem Secrets-Vault 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 einen solchen wird abgelehnt.

Was als Nächstes passiert

• Eine Website kann direkt aus einem Repository dieses Kontos bereitgestellt werden: Wählen Sie es bei der Repository-Verbindung der Website aus, wählen 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.

Falls keine Verbindung hergestellt wird

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

Es funktionierte und brach dann ab. Beide Token-Arten können ablaufen. Erstellen Sie ein neues Token und verknüpfen Sie es.

Es wird gemeldet, dass der Schlüssel abgelehnt wurde. Fast immer liegt es 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 steht, aber später schlägt etwas 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 verknüpfen Sie den neuen Schlüssel.

Verbindung trennen

Öffnen Sie Integrationen, suchen Sie das Konto und klicken Sie auf Trennen. 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 das, was bereits getan wurde, 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 auch beim Anbieter; das Trennen entfernt unsere Kopie, nicht deren Kopie.