Verbind uw Bitbucket-account zodat uw websites vanuit een repository worden gedeployed

Wat het koppelen voor u doet

Door Bitbucket te koppelen kan een website worden geïmplementeerd vanuit een van uw Bitbucket Cloud-repositories: push naar de branch en de website wordt bijgewerkt.

Voordat u begint

Een Bitbucket Cloud-account met toegang tot de repositories die u wilt implementeren.

1. Maak de sleutel aan bij Bitbucket

Bitbucket biedt twee soorten inloggegevens en beide werken:

• Een toegangstoken voor een repository, project of werkruimte, aangemaakt via de eigen instellingen van die repository, dat project of die werkruimte onder Access tokens. Dit is gekoppeld aan die repository, dat project of die werkruimte in plaats van aan een persoon. Geef dit leestoegang tot repositories.
• Een API-token op uw Atlassian-account. Selecteer uw profiel, ga naar Account settings → Security → Create and manage API tokens → Create API token with scopes. Geef het een naam, stel een vervaldatum in, kies Bitbucket als de app en selecteer leestoegang tot repositories. Bitbucket toont het token slechts één keer; kopieer het dan.

2. Koppel het hier

Open Integrations in uw dashboard en kies Connect an account. Kies Code hosting als de groep en Bitbucket als het account, vul API token in — en, als u een token op uw Atlassian-account hebt aangemaakt in plaats van een toegangstoken, ook Account username, en druk op Connect account.

We testen wat u plakt voordat er iets wordt opgeslagen. Een sleutel die niet werkt, wordt nooit opgeslagen en het antwoord vermeldt wat er mis mee was. Een sleutel die werkt, wordt versleuteld bewaard in onze kluis met geheimen — nooit in onze database — en wordt nooit meer getoond, zelfs niet aan u.

De gebruikersnaam bepaalt hoe we het token versturen, dus voer deze alleen in voor een accounttoken. Een toegangstoken dat is ingevoerd met een gebruikersnaam, of een accounttoken zonder, wordt geweigerd.

Wat er hierna gebeurt

• Een website kan rechtstreeks worden geïmplementeerd vanuit een repository op dit account: kies dit bij de repositoryverbinding van de website, selecteer de repository en branch, en een push zorgt voor de implementatie.
• Elke andere branch kan zijn eigen voorbeeldweergave krijgen, zodat u een wijziging kunt controleren voordat deze de live website bereikt.
• Git-gebouwde statische hosts zoals Render en Azure Static Web Apps gebruiken deze verbinding als bron voor de code van de website.

Als het niet lukt om te verbinden

Er ontbreekt een repository. Een toegangstoken bereikt alleen de repository, het project of de werkruimte waarin het is aangemaakt. Maak er een aan op het niveau dat alle repositories dekt die u nodig hebt.

Het werkte en stopte toen. Beide soorten tokens kunnen verlopen. Maak een nieuwe aan en verbind deze.

Er wordt gezegd dat de sleutel is geweigerd. Vrijwel altijd een van drie dingen: een spatie of regeleinde dat is mee gekopieerd, een sleutel die is verlopen, of een sleutel die is ingetrokken of opnieuw is gegenereerd nadat u deze hebt gekopieerd. Maak een nieuwe aan en plak deze opnieuw.

Het verbindt, maar iets mislukt later. De sleutel verifieert maar mist een machtiging die de actie nodig heeft. Maak een nieuwe sleutel aan met de hierboven vermelde machtigingen, verbreek vervolgens de oude verbinding en verbind de nieuwe sleutel.

Loskoppelen

Open Integrations, zoek het account op en druk op Disconnect. Daardoor wordt de opgeslagen sleutel onmiddellijk verwijderd. Alles wat hiervan gebruik maakte, stopt bij de volgende actie en de schermen die ervan afhankelijk waren, geven dit aan in plaats van stilletjes te falen.

Loskoppelen maakt niet ongedaan wat al is gedaan — records, implementaties of instellingen die we op uw account hebben gewijzigd, blijven zoals ze zijn. Als u vermoekt dat de sleutel zelf is uitgelekt, trek deze dan ook in bij de leverancier; loskoppelen verwijdert onze kopie, niet die van hen.