O que uma mudança de nome de usuário no GitLab realmente afeta
Trate uma mudança de nome de usuário no GitLab como uma migração de namespace com consequências públicas, não como uma edição de perfil. O identificador no seu perfil e o caminho nas URLs dos seus projetos estão ligados, então uma renomeação pode afetar qualquer coisa que aponte para o caminho antigo.
Mudar o nome de usuário no GitLab também altera o namespace pessoal da conta. Fonte
Esse único fato explica por que a verificação deve acontecer antes da renomeação, não depois. Se qualquer projeto, página, pacote ou referência externa depende do caminho do namespace antigo, você precisa saber disso com antecedência e decidir como será tratado.
Os dois bloqueios documentados
O GitLab declara um pré-requisito específico para mudar o nome de usuário. É restrito, mas é o único conjunto de bloqueios estabelecido na fonte aprovada aqui, então use-o como seu primeiro portão.
Um pré-requisito para mudar o nome de usuário é que o namespace não tenha projeto com tags do Container Registry nem projeto hospedando GitLab Pages. Fonte
Na prática, isso significa que você deve inventariar os projetos no seu namespace pessoal e identificar quais usam tags do Container Registry ou hospedam GitLab Pages. Esses são os projetos que precisam ser resolvidos ou realocados antes que a renomeação possa prosseguir. Não presuma que um projeto sem esses recursos esteja automaticamente seguro; a fonte estabelece esses como pré-requisitos, não como uma lista completa de todos os possíveis efeitos posteriores.
Revise o comportamento de redirecionamento antes de confirmar
A fonte aprovada também diz que o GitLab orienta os usuários a revisar o comportamento de redirecionamento de repositório antes de mudar o nome de usuário, e que o caminho para o novo nome de usuário fica nas configurações de conta do perfil, com a ação Update username.
O GitLab orienta os usuários a revisar o comportamento de redirecionamento de repositório antes de mudar o nome de usuário; as configurações de conta do perfil oferecem o caminho para o novo nome de usuário e a ação Update username. Fonte
O comportamento de redirecionamento é onde uma renomeação pode parecer inofensiva e ainda quebrar algo. Antes de mudar qualquer coisa, leia a orientação de redirecionamento aplicável à sua conta e registre o que ela cobre e o que não cobre. Se você não conseguir verificar como os redirecionamentos se comportam para seus projetos, pare e resolva isso primeiro. Uma renomeação não deve ser tratada como inofensiva até que você tenha verificado o que depende do caminho antigo.
Planilha de dependências
Use esta planilha para registrar o que encontrar. Preencha-a antes de fazer a mudança e mantenha-a como registro do que você decidiu.
| Verificação | O que registrar | Pare se |
|---|---|---|
| Projetos do namespace pessoal | Cada projeto no namespace e se ele usa tags do Container Registry ou GitLab Pages | Qualquer projeto tiver tags do Container Registry ou hospedar GitLab Pages |
| Comportamento de redirecionamento | O que a orientação de redirecionamento diz sobre caminhos antigos e quais tipos de projeto ela cobre | Você não conseguir confirmar como os redirecionamentos se aplicam aos seus projetos |
| Referências públicas | Páginas, documentação, READMEs ou perfis que mostram o caminho do namespace antigo | Uma referência não puder ser atualizada ou redirecionada |
| Propriedade | Que você controla a conta e os projetos sendo renomeados | A propriedade de qualquer projeto afetado estiver incerta |
| Usuários downstream | Qualquer pessoa que clona, vincula ou depende do caminho antigo | Você não puder avisá-los ou fornecer um caminho de substituição funcional |
Esta planilha é um ponto de partida, não uma garantia. A fonte aprovada não estabelece todas as dependências possíveis, então adicione linhas para qualquer coisa específica da sua configuração.
Verificação passo a passo
- Liste os projetos no seu namespace pessoal. Para cada um, anote se ele usa tags do Container Registry ou hospeda GitLab Pages.
- Se algum projeto tiver qualquer uma das dependências, decida se deve removê-la, realocá-la ou resolvê-la de outra forma antes da renomeação. Não prossiga enquanto um bloqueio documentado permanecer.
- Leia a orientação de redirecionamento de repositório e anote o que ela cobre para seus projetos. Se a resposta não estiver clara, pare.
- Pesquise no seu material público o caminho do namespace antigo: páginas de projeto, READMEs, documentação e perfis que vinculam ao seu trabalho.
- Confirme que você controla a conta e todos os projetos afetados. Se a propriedade não estiver clara, pare.
- Somente depois que a planilha estiver completa e nenhuma condição de parada se aplicar, vá para as configurações de conta do perfil, insira o novo nome de usuário e use Update username.
- Após a mudança, verifique novamente as referências que você registrou e confirme se cada uma ainda resolve ou foi atualizada.
Caminhos de falha para planejar
- Um projeto bloqueador permanece. Se um projeto com tags do Container Registry ou GitLab Pages ainda estiver no namespace, a renomeação não pode prosseguir sob o pré-requisito documentado. Resolva-o primeiro em vez de tentar contorná-lo.
- A cobertura de redirecionamento não está clara. Se você não conseguir confirmar como os redirecionamentos se comportam, trate a renomeação como não verificada e pause. Prosseguir com base em uma suposição é o modo de falha que esta verificação existe para prevenir.
- Uma referência pública é esquecida. Caminhos antigos do namespace podem persistir em documentação, READMEs ou perfis. Percorra sua lista registrada após a mudança e corrija o que não acompanhou.
- A propriedade é incerta. Se você não tiver certeza de que controla um projeto ou a conta, pare. Uma renomeação feita sem propriedade clara cria um problema mais difícil de desfazer.
O que esta verificação não informa
A fonte aprovada não descreve todos os sistemas downstream que podem referenciar seu namespace, e não promete que uma renomeação seja inofensiva. Ela também não estabelece detalhes de menu além do caminho das configurações de conta do perfil e da ação Update username. Onde a fonte é omissa, registre a lacuna na sua planilha em vez de preenchê-la com uma suposição.
Uma próxima tarefa relacionada
Depois que a renomeação estiver feita e as referências dos seus projetos estiverem estáveis, uma questão separada é o que seu nome de usuário agora expõe em outros lugares. Se você quiser ver onde um identificador aparece em plataformas públicas, o guia sobre como encontrar contas de mídia social por nome de usuário cobre essa tarefa. Mantenha os dois trabalhos separados: a verificação no GitLab é sobre dependências de namespace, enquanto uma busca de nome de usuário é sobre perfis públicos, e uma correspondência pública é uma pista, não prova de propriedade.