Koppel uw Bitbucket-account zodat uw sites vanuit een repository worden geïmplementeerd

Wat het koppelen voor u doet

Door Bitbucket te koppelen, kan een site implementeren vanuit een van uw Bitbucket Cloud-repositories: push naar de branch en de site 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 workspace, aangemaakt vanuit de eigen instellingen van die repository, dat project of die workspace onder Toegangstokens. Deze is gekoppeld aan die repository, dat project of die workspace in plaats van aan een persoon. Geef deze leestoegang tot repositories.
• Een API-token op uw Atlassian-account. Selecteer uw profiel en ga vervolgens naar Accountinstellingen → Beveiliging → API-tokens maken en beheren → API-token met scopes maken. Geef het een naam, stel een vervaldatum in, kies Bitbucket als de app en selecteer leestoegang tot repositories. Bitbucket toont het token eenmalig; kopieer het direct.

2. Koppel het hier

Open Integraties in uw dashboard en kies Een account koppelen. Kies Codehosting 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 Gebruikersnaam van account, en druk op Account koppelen.

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

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

Wat er nu gebeurt

• Een site kan rechtstreeks implementeren vanuit een repository op dit account: kies deze bij de repositorykoppeling van de site, selecteer de repository en branch, en een push implementeert.
• Elke andere branch kan een eigen voorbeeldweergave krijgen, zodat u een wijziging kunt controleren voordat deze de live site bereikt.
• Met Git gebouwde statische hosts zoals Render en Azure Static Web Apps gebruiken deze verbinding als de bron van de code van de site.

Als het niet koppelt

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

Het werkte en stopte vervolgens. Beide soorten tokens kunnen verlopen. Maak een nieuwe aan en koppel deze.

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

Het maakt verbinding, maar er mislukt later iets. 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 koppel de nieuwe sleutel.

Ontkoppelen

Open Integraties, zoek het account en druk op Ontkoppelen. Dat verwijdert de opgeslagen sleutel onmiddellijk. Alles wat er gebruik van maakte, stopt bij de volgende actie, en de schermen die ervan afhankelijk waren geven dit aan in plaats van geruisloos te falen.

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