GitLab Pages y dominios
El pipeline deja preparada una publicación oficial desde main y previews manuales para otras ramas.
Estado del proyecto
GitLab Pages está configurado para publicar la web de schoolsuite/docs con fuente privada y acceso público al sitio.
Dominios registrados en GitLab Pages:
| Dominio | Rol | TLS | Estado inicial |
|---|---|---|---|
taikosuite.com | Canónico | Let's Encrypt automático | Pendiente de verificación DNS |
taikoverso.com | Alias de marca | Let's Encrypt automático | Pendiente de verificación DNS |
Flujo configurado
| Origen | Resultado | Caducidad |
|---|---|---|
Rama por defecto (main) | Deployment principal de Pages | No caduca |
| Cualquier otra rama | preview-<slug-de-rama> | Una semana |
Los previews usan parallel deployments de GitLab Pages. Esta capacidad requiere que el namespace disponga de slots y, en GitLab.com, pertenece a los niveles Premium o Ultimate. Si el grupo usa Free, la build seguirá validándose, pero para URLs de preview será necesario subir de nivel o adoptar Cloudflare Pages como canal de previews.
Activar GitLab Pages
- Haz push de esta versión a una rama y revisa que
validate-docstermine correctamente. - Fusiona en
mainpara ejecutardeploy-pages. - En GitLab, abre Deploy > Pages y comprueba la URL generada.
- Mantén activado Use unique domain para aislar cookies del resto del grupo.
- Comprueba que Access control permita acceso público a Pages aunque el repositorio siga siendo privado.
Dominio canónico
Se recomienda:
taikosuite.com: dominio principal.taikoverso.com: alias de marca.www.taikosuite.comywww.taikoverso.com: redirecciones a sus dominios raíz.
En Deploy > Pages, añade primero ambos dominios raíz. Cuando estén activos, selecciona taikosuite.com como Primary domain para que GitLab redirija los demás accesos con un 308 permanente.
DNS en Cloudflare
Para cada dominio raíz, GitLab.com documenta actualmente estos registros de origen:
| Tipo | Nombre | Valor | Proxy durante alta |
|---|---|---|---|
A | @ | 35.185.44.232 | DNS only |
AAAA | @ | 2600:1901:0:7b8a:: | DNS only |
TXT | _gitlab-pages-verification-code | Código exacto mostrado por GitLab para cada dominio | No aplicable |
Códigos de verificación emitidos por GitLab:
| Dominio | Registro TXT | Valor |
|---|---|---|
taikosuite.com | _gitlab-pages-verification-code.taikosuite.com | 33074476f815097219c46bee0b0af447 |
taikoverso.com | _gitlab-pages-verification-code.taikoverso.com | 09aa64883db40fb31acf3c3070cd357b |
Cloudflare añade el nombre de zona automáticamente; introduce solo _gitlab-pages-verification-code en el campo de nombre. Conserva el TXT después de verificar: GitLab repite la verificación periódicamente.
Para www, crea un CNAME hacia el dominio raíz y una regla de redirección permanente al dominio sin www.
Orden recomendado
Mantén los registros web en DNS only hasta que GitLab haya verificado dominios y emitido certificados. Activa Force HTTPS en GitLab. Si después habilitas el proxy de Cloudflare, usa SSL/TLS Full, nunca Flexible, y comprueba de nuevo certificados, redirecciones y caché.
Previews por rama
En una rama distinta de main, ejecuta manualmente el job deploy-pages. El pipeline asigna el mismo prefijo tanto al build de VitePress como al deployment de Pages:
feature/nueva-home → /preview-feature-nueva-home/La URL exacta aparece en Operate > Environments y en Deploy > Pages. El job es manual para no consumir slots con cada rama efímera.
Comprobaciones antes del lanzamiento
- Reemplazar textos provisionales y validar marca, información legal y contacto.
- Confirmar propiedad de
taikosuite.comytaikoverso.com. - Verificar que ambos dominios resuelven y que solo uno es canónico.
- Probar una preview desde una rama real.
- Revisar enlaces, búsqueda, modo oscuro, móvil y página 404.
- Añadir analítica solo con una decisión explícita de privacidad y consentimiento.