Qué afecta realmente un cambio de nombre de usuario en GitLab
Trata un cambio de nombre de usuario en GitLab como una migración de espacio de nombres con consecuencias públicas, no como una edición de perfil. El identificador de tu perfil y la ruta de las URL de tus proyectos están vinculados, por lo que un cambio de nombre puede afectar a todo lo que apunte a la ruta antigua.
Cambiar un nombre de usuario de GitLab también modifica el espacio de nombres personal de la cuenta. Fuente
Ese único hecho explica por qué la comprobación debe hacerse antes del cambio de nombre, no después. Si algún proyecto, página, paquete o referencia externa depende de la ruta del espacio de nombres antiguo, necesitas saberlo de antemano y decidir cómo se gestionará.
Los dos bloqueos documentados
GitLab establece un requisito previo específico para cambiar el nombre de usuario. Es limitado, pero es el único conjunto de bloqueos establecido en la fuente aprobada aquí, así que úsalo como tu primera barrera.
Un requisito previo para cambiar el nombre de usuario es que el espacio de nombres no tenga ningún proyecto con etiquetas de Container Registry ni ningún proyecto que aloje GitLab Pages. Fuente
En la práctica, esto significa que debes inventariar los proyectos de tu espacio de nombres personal e identificar los que usan etiquetas de Container Registry o alojan GitLab Pages. Esos son los proyectos que deben resolverse o reubicarse antes de que el cambio de nombre pueda continuar. No asumas que un proyecto sin estas características es automáticamente seguro; la fuente establece estos como requisitos previos, no como una lista completa de todos los efectos posteriores posibles.
Revisa el comportamiento de las redirecciones antes de confirmar
La fuente aprobada también indica que GitLab dirige a los usuarios a revisar el comportamiento de las redirecciones de repositorio antes de cambiar el nombre de usuario, y que la ruta del nuevo nombre de usuario está en la configuración de la cuenta del perfil con la acción Update username.
GitLab dirige a los usuarios a revisar el comportamiento de las redirecciones de repositorio antes de cambiar el nombre de usuario; la configuración de la cuenta del perfil ofrece la ruta del nuevo nombre de usuario y Update username. Fuente
El comportamiento de las redirecciones es donde un cambio de nombre puede parecer inofensivo y aun así romper algo. Antes de cambiar nada, lee la guía de redirecciones que se aplica a tu cuenta y anota qué cubre y qué no. Si no puedes verificar cómo se comportan las redirecciones para tus proyectos, detente y resuélvelo primero. Un cambio de nombre no debe considerarse inofensivo hasta que hayas comprobado qué depende de la ruta antigua.
Hoja de dependencias
Usa esta hoja para registrar lo que encuentres. Rellénala antes de hacer el cambio y consérvala como registro de lo que decidiste.
| Comprobación | Qué registrar | Detente si |
|---|---|---|
| Proyectos del espacio de nombres personal | Cada proyecto del espacio de nombres y si usa etiquetas de Container Registry o GitLab Pages | Algún proyecto tiene etiquetas de Container Registry o aloja GitLab Pages |
| Comportamiento de redirecciones | Lo que dice la guía de redirecciones sobre las rutas antiguas y qué tipos de proyecto cubre | No puedes confirmar cómo se aplican las redirecciones a tus proyectos |
| Referencias públicas | Páginas, documentación, READMEs o perfiles que muestran la ruta del espacio de nombres antiguo | Una referencia no se puede actualizar o redirigir |
| Propiedad | Que controlas la cuenta y los proyectos que se renombran | La propiedad de algún proyecto afectado no está clara |
| Usuarios posteriores | Cualquiera que clone, enlace o dependa de la ruta antigua | No puedes avisarles o proporcionar una ruta de reemplazo funcional |
Esta hoja es un punto de partida, no una garantía. La fuente aprobada no establece todas las dependencias posibles, así que añade filas para cualquier cosa específica de tu configuración.
Comprobación paso a paso
- Enumera los proyectos de tu espacio de nombres personal. Para cada uno, anota si usa etiquetas de Container Registry o aloja GitLab Pages.
- Si algún proyecto tiene cualquiera de estas dependencias, decide si eliminarla, reubicarla o resolverla de otro modo antes del cambio de nombre. No continúes mientras quede un bloqueo documentado.
- Lee la guía de redirecciones de repositorio y anota qué cubre para tus proyectos. Si la respuesta no está clara, detente.
- Busca la ruta del espacio de nombres antiguo en tu material público: páginas de proyectos, READMEs, documentación y perfiles que enlacen a tu trabajo.
- Confirma que controlas la cuenta y todos los proyectos afectados. Si la propiedad no está clara, detente.
- Solo después de completar la hoja y de que no se aplique ninguna condición de parada, ve a la configuración de la cuenta del perfil, introduce el nuevo nombre de usuario y usa Update username.
- Después del cambio, vuelve a comprobar las referencias que registraste y confirma que cada una sigue resolviéndose o se ha actualizado.
Rutas de fallo para las que planificar
- Queda un proyecto bloqueante. Si un proyecto con etiquetas de Container Registry o GitLab Pages sigue en el espacio de nombres, el cambio de nombre no puede continuar según el requisito previo documentado. Resuélvelo primero en lugar de intentar sortearlo.
- La cobertura de redirecciones no está clara. Si no puedes confirmar cómo se comportan las redirecciones, trata el cambio de nombre como no verificado y haz una pausa. Proceder basándote en una suposición es el modo de fallo que esta comprobación existe para prevenir.
- Se pasa por alto una referencia pública. Las rutas del espacio de nombres antiguo pueden persistir en documentación, READMEs o perfiles. Recorre tu lista registrada después del cambio y corrige lo que no haya seguido.
- La propiedad es incierta. Si no estás seguro de controlar un proyecto o la cuenta, detente. Un cambio de nombre realizado sin una propiedad clara crea un problema más difícil de deshacer.
Qué no te dice esta comprobación
La fuente aprobada no describe todos los sistemas posteriores que podrían hacer referencia a tu espacio de nombres, y no promete que un cambio de nombre sea inofensivo. Tampoco establece detalles del menú más allá de la ruta de configuración de la cuenta del perfil y la acción Update username. Donde la fuente calla, registra el vacío en tu hoja en lugar de rellenarlo con una suposición.
Una siguiente tarea relacionada
Una vez hecho el cambio de nombre y estabilizadas las referencias de tus proyectos, una cuestión aparte es qué muestra ahora tu nombre de usuario en otros lugares. Si quieres ver dónde aparece un identificador en plataformas públicas, la guía sobre cómo encontrar cuentas de redes sociales por nombre de usuario cubre esa tarea. Mantén los dos trabajos separados: la comprobación de GitLab trata de dependencias del espacio de nombres, mientras que una búsqueda de nombre de usuario trata de perfiles públicos, y una coincidencia pública es una pista, no una prueba de propiedad.