Conecte su cuenta de GitLab para que sus sitios se implementen desde un repositorio

Qué le aporta conectarlo

Conectar GitLab permite que un sitio se despliegue desde uno de sus repositorios de GitLab, y nos permite publicar en GitLab Pages en su cuenta cuando lo elija como host de un sitio.

Antes de comenzar

Una cuenta de GitLab con acceso a los proyectos que desea desplegar.

1. Cree la clave en GitLab

En GitLab, seleccione su avatar en la parte superior derecha, luego Edit profile → Access → Personal access tokens, y genere un nuevo token (GitLab puede etiquetar esto como Legacy token en el menú Generate token). Asígnele un nombre, establezca una fecha de expiración y marque estos ámbitos:

• api
• write_repository

Presione Generate token y cópielo; GitLab lo muestra una sola vez.

2. Conéctela aquí

Abra Integraciones en su panel y elija Conectar una cuenta. Seleccione Alojamiento de código como grupo y GitLab como cuenta, complete Token de API y presione Conectar cuenta.

Probamos lo que pega antes de guardar cualquier elemento. Una clave que no funciona nunca se almacena, y la respuesta indica qué falló en ella. Una clave que funciona se mantiene cifrada en nuestra bóveda de secretos —nunca en nuestra base de datos— y nunca se vuelve a mostrar, ni siquiera a usted.

Qué sucede después

• Un sitio puede desplegarse directamente desde un repositorio en esta cuenta: elíjalo en la conexión del repositorio del sitio, seleccione el repositorio y la rama, y un push realiza el despliegue.
• Cada una de las demás ramas puede obtener su propia vista previa, para que pueda revisar un cambio antes de que llegue al sitio activo.
• Los hosts estáticos basados en Git, como Render y Azure Static Web Apps, utilizan esta conexión como la fuente del código del sitio.

Si no se conecta

Funcionaba y luego dejó de hacerlo. Los tokens de GitLab siempre caducan —generalmente a lo sumo un año después de crearlos— y GitLab le envía un correo electrónico antes de que lo hagan. Cree uno nuevo y conéctelo.

Falta un ámbito. Los ámbitos de un token no se pueden cambiar después de crearlo; cree un nuevo token con ambos ámbitos marcados.

Indica que la clave fue rechazada. Casi siempre se debe a una de estas tres cosas: un espacio o un salto de línea copiado con ella, una clave que ha caducado, o una clave que fue revocada o regenerada después de haberla copiado. Cree una nueva y péguela otra vez.

Se conecta, pero algo falla más adelante. La clave se autentica pero carece de un permiso que la acción necesita. Cree una nueva clave con los permisos indicados anteriormente, luego desconecte la conexión anterior y conecte la nueva clave.

Desconexión

Abra Integraciones, busque la cuenta y presione Desconectar. Eso elimina la clave almacenada de inmediato. Cualquier elemento que la estuviera usando se detiene en su siguiente acción, y las pantallas que dependían de ella lo indican en lugar de fallar silenciosamente.

Desconectar no deshace lo que ya se hizo: los registros, despliegues o ajustes que modificamos en su cuenta permanecen como están. Si cree que la clave en sí misma puede haberse filtrado, revoquela también en el proveedor; desconectar elimina nuestra copia, no la de ellos.