Connectez votre compte GitLab pour que vos sites soient déployés depuis un dépôt

Ce que cette connexion vous apporte

Connecter GitLab permet à un site de se déployer depuis 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 avec 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 jeton (GitLab peut nommer ceci Legacy token dans le menu Generate token). Nommez-le, définissez une date d’expiration et cochez ces portées :

• api
• write_repository

Cliquez 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 cliquez sur Connect account.

Nous testons ce que vous collez avant que quoi que ce soit ne soit enregistré. 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 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 à vous.

Que se passe-t-il ensuite

• Un site peut se déployer directement depuis un dépôt sur ce compte : choisissez-le sur la connexion de 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, afin que vous puissiez vérifier une modification avant qu’elle n’atteigne le site en ligne.
• Les hébergeurs statiques basés sur Git tels que Render et Azure Static Web Apps utilisent cette connexion comme source du code du site.

En cas d’échec de la connexion

Cela fonctionnait, puis s’est arrêté. Les jetons 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.

Une portée est manquante. Les portées d’un jeton ne peuvent pas être modifiées après sa création ; créez un nouveau jeton en cochant les deux portées.

Le message indique que la clé a été rejetée. Il s’agit presque toujours de l’une de ces trois causes : un espace ou un saut de ligne copié avec la clé, une clé expirée, ou une clé révoquée ou régénérée après que vous l’avez copiée. Créez-en une nouvelle et collez-la à nouveau.

La connexion réussit, mais une action échoue plus tard. La clé s’authentifie mais ne dispose pas d’une autorisation requise par l’action. Créez une nouvelle clé avec les autorisations indiquées ci-dessus, puis déconnectez l’ancienne connexion et connectez la nouvelle clé.

Déconnexion

Ouvrez Integrations, trouvez le compte et cliquez sur Disconnect. Cela supprime immédiatement la clé stockée. Tout ce qui l’utilisait s’arrête à l’action suivante, 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.