Ce que la connexion vous apporte
Connecter GitLab permet à un site de se déployer à partir de l'un de vos dépôts GitLab, et nous permet de publier sur GitLab Pages sur votre compte lorsque vous le choisissez comme hébergeur d'un site.
Avant de commencer
Un compte GitLab ayant accès aux projets que vous souhaitez déployer.
1. Créer la clé sur GitLab
Dans GitLab, sélectionnez votre avatar en haut à droite, puis Edit profile → Access → Personal access tokens, et générez un nouveau token (GitLab peut le nommer Legacy token dans le menu Generate token). Donnez-lui un nom, définissez une date d'expiration et cochez ces portées :
Appuyez sur Generate token et copiez-le — GitLab ne l'affiche qu'une seule fois.
2. La connecter ici
Ouvrez Integrations dans votre tableau de bord et choisissez Connect an account. Sélectionnez Code hosting comme groupe et GitLab comme compte, renseignez API token, puis appuyez sur Connect account.
Nous testons ce que vous collez avant qu'un enregistrement ne soit effectué. Une clé qui ne fonctionne pas n'est jamais stockée, et la réponse indique ce qui n'allait pas. Une clé qui fonctionne est conservée de manière chiffrée dans notre coffre-fort de secrets — jamais dans notre base de données — et n'est plus jamais affichée, pas même pour vous.
Que se passe-t-il ensuite
- Un site peut se déployer directement à partir d'un dépôt sur ce compte : choisissez-le sur la connexion au dépôt du site, sélectionnez le dépôt et la branche, et un push déclenche le déploiement.
- Chaque autre branche peut obtenir son propre aperçu, ce qui vous permet de vérifier une modification avant qu'elle n'atteigne le site en direct.
- Les hébergeurs statiques construits sur Git tels que Render et Azure Static Web Apps utilisent cette connexion comme source du code du site.
Si la connexion échoue
Cela a fonctionné puis s'est arrêté. Les tokens GitLab expirent toujours — généralement au maximum un an après leur création — et GitLab vous envoie un e-mail avant qu'ils n'expirent. Créez-en un nouveau et connectez-le.
Il manque une portée. Les portées d'un token ne peuvent pas être modifiées après sa création ; créez un nouveau token en cochant les deux portées.
Il est indiqué que la clé a été rejetée. C'est presque toujours l'une de ces trois causes : un espace ou un saut de ligne copié avec la clé, une clé qui a expiré, ou une clé qui a été révoquée ou régénérée après que vous l'avez copiée. Créez une nouvelle clé et collez-la à nouveau.
La connexion s'établit, mais une action ultérieure échoue. La clé s'authentifie mais il lui manque une autorisation requise par l'action. Créez une nouvelle clé avec les autorisations listées ci-dessus, puis déconnectez l'ancienne connexion et connectez la nouvelle clé.
Déconnexion
Ouvrez Integrations, trouvez le compte et appuyez sur Disconnect. Cela supprime immédiatement la clé stockée. Tout ce qui l'utilisait s'arrête lors de sa prochaine action, et les écrans qui en dépendaient le signalent au lieu d'échouer silencieusement.
La déconnexion n'annule pas ce qui a déjà été fait — les enregistrements, déploiements ou paramètres que nous avons modifiés sur votre compte restent tels quels. Si vous pensez que la clé elle-même a pu fuiter, révoquez-la également auprès du fournisseur ; la déconnexion supprime notre copie, pas la leur.