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 website worden geïmplementeerd vanuit een van uw GitLab-repositories, en kunnen wij publiceren naar GitLab Pages op uw account wanneer u hiervoor kiest als host van de website.

Voordat u begint

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

1. Maak de sleutel aan in GitLab

Selecteer in GitLab rechtsboven uw avatar en ga naar Edit profile → Access → Personal access tokens. Genereer vervolgens een nieuwe token (GitLab noemt dit mogelijk Legacy token in het menu Generate token). Geef deze een naam, stel een vervaldatum in en vink de volgende scopes aan:

• api
• write_repository

Klik op Generate token en kopieer deze; GitLab toont de token slechts 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 klik op Connect account.

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

Wat er hierna gebeurt

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

Als het verbinden niet lukt

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

Een scope ontbreekt. De scopes van een token kunnen niet meer worden gewijzigd nadat deze is aangemaakt; maak een nieuwe token aan waarbij beide scopes zijn aangevinkt.

Er wordt aangegeven dat de sleutel is geweigerd. Dit komt bijna altijd door één van de volgende drie oorzaken: een meegekopieerde spatie of regelteken, 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 verbinden lukt, maar een latere actie mislukt. De sleutel verifieert de identiteit, maar mist een toestemming die voor de actie nodig is. Maak een nieuwe sleutel aan met de hierboven vermelde toestemmingen, verbreek vervolgens de oude verbinding en koppel de nieuwe sleutel.

Loskoppelen

Open Integrations, zoek het account op en klik op Disconnect. Hiermee wordt de opgeslagen sleutel direct verwijderd. Alles wat hiervan gebruik maakte, stopt bij de volgende actie en schermen die hiervhankelijk waren geven dit aan in plaats van stil te falen.

Het 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 vermoedt dat de sleutel zelf is gelekt, trek deze dan ook in bij de leverancier; loskoppelen verwijdert alleen onze kopie, niet die van hen.