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

Qué le aporta esta conexión

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 alojamiento de un sitio.

Antes de empezar

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 y, a continuación, Edit profile → Access → Personal access tokens, y genere un nuevo token (es posible que GitLab lo etiquete como Legacy token en el menú Generate token). Asígnele un nombre, establezca una fecha de caducidad y marque estos ámbitos:

• api
• write_repository

Pulse Generate token y cópielo; GitLab solo lo muestra una vez.

2. Conéctela aquí

Abra Integraciones en su panel de control y elija Conectar una cuenta. Seleccione Alojamiento de código como grupo y GitLab como cuenta, introduzca el Token de API y pulse Conectar cuenta.

Comprobamos lo que pega antes de guardar nada. Una clave que no funciona nunca se almacena, y la respuesta indica cuál fue el problema. Una clave que funciona se guarda cifrada en nuestra cámara acorazada de secretos —nunca en nuestra base de datos— y no se vuelve a mostrar jamás, ni siquiera a usted.

Qué ocurre después

• Un sitio puede desplegarse directamente desde un repositorio de esta cuenta: elíjalo en la conexión de repositorio del sitio, seleccione el repositorio y la rama, y un push realiza el despliegue.
• Cualquier otra rama puede obtener su propia vista previa, de modo que pueda comprobar un cambio antes de que llegue al sitio en producción.
• Los alojamientos estáticos compilados con Git, como Render y Azure Static Web Apps, utilizan esta conexión como origen del código del sitio.

Si no se conecta

Funcionó y después se detuvo. Los ficheros de tokens de GitLab siempre caducan (normalmente como máximo 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 una vez creado; cree un nuevo token con ambos ámbitos marcados.

Indica que la clave ha sido rechazada. Casi siempre se debe a uno de estos tres motivos: un espacio o un salto de línea copiados junto con ella, una clave que ha caducado, o una clave que fue revocada o regenerada después de haberla copiado. Cree una nueva y vuelva a pegarla.

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, desconecte la conexión anterior y conecte la nueva clave.

Desconexión

Abra Integraciones, busque la cuenta y pulse Desconectar. Esto elimina de inmediato la clave almacenada. Cualquier elemento que la estuviera utilizando se detendrá en su siguiente acción, y las pantallas que dependían de ella lo indicarán en lugar de fallar silenciosamente.

Desconectar no deshace lo que ya se ha hecho; los registros, despliegues o configuraciones que hayamos modificado en su cuenta permanecerán tal como están. Si cree que la clave en sí puede haberse filtrado, revóquela también en el proveedor; la desconexión elimina nuestra copia, no la suya.