Verbind uw GitLab-account zodat uw sites vanuit een repository worden geïmplementeerd

Wat het koppelen voor u doet

Door GitLab te koppelen, kan een site worden geïmplementeerd vanuit een van uw GitLab-repositories en kunnen we publiceren naar GitLab Pages op uw account wanneer u dit kiest als host voor een site.

Voordat u begint

Een GitLab-account met toegang tot de projecten die u wilt implementeren.

1. Maak de sleutel aan bij GitLab

Selecteer in GitLab uw avatar rechtsboven, vervolgens Edit profile → Access → Personal access tokens, en genereer een nieuw token (GitLab kan dit aanduiden als Legacy token in het menu Generate token). Geef het een naam, stel een vervaldatum in en vink deze scopes aan:

• api
• write_repository

Druk op Generate token en kopieer het — GitLab toont het eenmalig.

2. Koppel het hier

Open Integrations in uw dashboard en kies Connect an account. Kies Code hosting als groep en GitLab als account, vul API token in 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 voor geheimen — nooit in onze database — en wordt nooit meer getoond, zelfs niet aan u.

Wat er nu gebeurt

• Een site kan rechtstreeks worden geïmplementeerd vanuit een repository op dit account: kies deze bij de repositorykoppeling van de site, selecteer de repository en branch, en een push start de implementatie.
• Elke andere branch kan een eigen preview krijgen, zodat u een wijziging kunt controleren voordat deze de live site bereikt.
• Statische hosts die met Git worden gebouwd, zoals Render en Azure Static Web Apps, gebruiken deze verbinding als bron voor de code van de site.

Als het niet koppelt

Het werkte en stopte vervolgens. GitLab-tokens verlopen altijd — meestal maximaal een jaar nadat u ze hebt aangemaakt — en GitLab stuurt u een e-mail voordat dit gebeurt. Maak een nieuwe aan en koppel deze.

Er ontbreekt een scope. De scopes van een token kunnen na aanmaak niet worden gewijzigd; maak een nieuw token aan waarbij beide scopes zijn aangevinkt.

Er staat dat de sleutel is geweigerd. Bijna altijd een van deze drie dingen: een spatie of regeleinde die is meegekopieerd, 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 later mislukt er iets. De sleutel authenticeert, 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 Integrations, zoek het account en druk op Disconnect. Daarmee wordt de opgeslagen sleutel direct verwijderd. Alles wat er gebruik van maakte, stopt bij de volgende actie, en de schermen die ervan afhingen geven dit aan in plaats van stilzwijgend te mislukken.

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.