Wat een GitLab-gebruikersnaamwijziging feitelijk raakt
Behandel een wijziging van je GitLab-gebruikersnaam als een namespace-migratie met publieke gevolgen, niet als een profielaanpassing. De handle in je profiel en het pad in je project-URL’s zijn aan elkaar gekoppeld, dus een hernoeming kan alles raken dat naar het oude pad verwijst.
Het wijzigen van een GitLab-gebruikersnaam verandert ook de persoonlijke namespace van het account. Bron
Dat enkele feit verklaart waarom de controle vóór de hernoeming moet plaatsvinden, niet erna. Als een project, pagina, package of externe verwijzing afhankelijk is van het oude namespace-pad, moet je dat vooraf weten en beslissen hoe ermee wordt omgegaan.
De twee gedocumenteerde blokkades
GitLab noemt een specifieke voorwaarde voor een gebruikersnaamwijziging. Die is beperkt, maar het is de enige set blokkades die in de goedgekeurde bron hier is vastgelegd, dus gebruik die als je eerste poort.
Een voorwaarde voor een gebruikersnaamwijziging is dat de namespace geen project met Container Registry-tags heeft en geen project dat GitLab Pages host. Bron
In de praktijk betekent dit dat je de projecten in je persoonlijke namespace moet inventariseren en moet vaststellen welke Container Registry-tags gebruiken of GitLab Pages hosten. Dat zijn de projecten die moeten worden opgelost of verplaatst voordat de hernoeming kan doorgaan. Ga er niet van uit dat een project zonder deze functies automatisch veilig is; de bron legt deze voorwaarden vast, niet een volledige lijst van elk mogelijk downstream-effect.
Controleer redirectgedrag voordat je definitief wijzigt
De goedgekeurde bron zegt ook dat GitLab gebruikers erop wijst het gedrag van repository-redirects te controleren voordat ze de gebruikersnaam wijzigen, en dat het nieuwe gebruikersnaampad te vinden is in de accountinstellingen van het profiel met de actie Update username.
GitLab wijst gebruikers erop het gedrag van repository-redirects te controleren voordat ze de gebruikersnaam wijzigen; de accountinstellingen van het profiel bieden het pad naar de nieuwe gebruikersnaam en Update username. Bron
Redirectgedrag is waar een hernoeming onschuldig kan lijken en toch iets kan breken. Voordat je iets wijzigt, lees je de redirectrichtlijnen die op jouw account van toepassing zijn en leg je vast wat ze wel en niet dekken. Als je niet kunt verifiëren hoe redirects voor jouw projecten werken, stop dan en los dat eerst op. Een hernoeming mag niet als onschuldig worden beschouwd totdat je hebt gecontroleerd wat er van het oude pad afhankelijk is.
Afhankelijkheidswerkblad
Gebruik dit werkblad om vast te leggen wat je vindt. Vul het in voordat je de wijziging doorvoert en bewaar het als verslag van je beslissingen.
| Controle | Wat vast te leggen | Stop als |
|---|---|---|
| Projecten in persoonlijke namespace | Elk project in de namespace en of het Container Registry-tags of GitLab Pages gebruikt | Een project Container Registry-tags heeft of GitLab Pages host |
| Redirectgedrag | Wat de redirectrichtlijnen zeggen over oude paden en welke projecttypen ze dekken | Je niet kunt bevestigen hoe redirects op jouw projecten van toepassing zijn |
| Publieke verwijzingen | Pagina’s, documentatie, README’s of profielen die het oude namespace-pad tonen | Een verwijzing niet kan worden bijgewerkt of geredirect |
| Eigendom | Dat jij het account en de projecten die worden hernoemd beheert | Eigendom van een getroffen project onduidelijk is |
| Downstream-gebruikers | Iedereen die het oude pad kloont, erheen linkt of er afhankelijk van is | Je hen niet kunt informeren of geen werkend vervangend pad kunt bieden |
Dit werkblad is een startpunt, geen garantie. De goedgekeurde bron legt niet elke mogelijke afhankelijkheid vast, dus voeg rijen toe voor alles wat specifiek is voor jouw opzet.
Stapsgewijze controle
- Maak een lijst van de projecten in je persoonlijke namespace. Noteer voor elk project of het Container Registry-tags gebruikt of GitLab Pages host.
- Als een project een van beide afhankelijkheden heeft, beslis dan of je die vóór de hernoeming verwijdert, verplaatst of anderszins oplost. Ga niet verder zolang een gedocumenteerde blokkade blijft bestaan.
- Lees de richtlijnen voor repository-redirects en schrijf op wat ze voor jouw projecten dekken. Als het antwoord onduidelijk is, stop.
- Doorzoek je publiek gerichte materiaal op het oude namespace-pad: projectpagina’s, README’s, documentatie en profielen die naar je werk linken.
- Bevestig dat je het account en elk getroffen project beheert. Als eigendom onduidelijk is, stop.
- Ga pas nadat het werkblad compleet is en geen stopvoorwaarde van toepassing is naar de accountinstellingen van het profiel, voer de nieuwe gebruikersnaam in en gebruik Update username.
- Controleer na de wijziging de verwijzingen die je hebt vastgelegd en bevestig dat elke verwijzing nog werkt of is bijgewerkt.
Faalroutes om op te plannen
- Een blokkerend project blijft bestaan. Als een project met Container Registry-tags of GitLab Pages nog in de namespace staat, kan de hernoeming onder de gedocumenteerde voorwaarde niet doorgaan. Los het eerst op in plaats van eromheen te werken.
- Redirectdekking is onduidelijk. Als je niet kunt bevestigen hoe redirects werken, beschouw de hernoeming dan als ongeverifieerd en pauzeer. Verdergaan op een aanname is precies het faalpatroon dat deze controle moet voorkomen.
- Een publieke verwijzing wordt gemist. Oude namespace-paden kunnen blijven bestaan in documentatie, README’s of profielen. Loop na de wijziging je vastgelegde lijst door en herstel wat niet is meegekomen.
- Eigendom is onzeker. Als je niet zeker weet of je een project of het account beheert, stop. Een hernoeming zonder duidelijk eigendom creëert een moeilijker probleem om terug te draaien.
Wat deze controle je niet vertelt
De goedgekeurde bron beschrijft niet elk downstream-systeem dat naar je namespace kan verwijzen, en belooft niet dat een hernoeming onschadelijk is. Ze legt ook geen menudetails vast buiten het pad naar de accountinstellingen van het profiel en de actie Update username. Waar de bron zwijgt, leg je de leemte vast in je werkblad in plaats van die met een aanname op te vullen.
Een gerelateerde vervolgtaak
Zodra de hernoeming is gedaan en je projectverwijzingen stabiel zijn, is een aparte vraag wat je gebruikersnaam nu elders oplevert. Als je wilt zien waar een handle op publieke platforms voorkomt, behandelt de gids over hoe je socialmedia-accounts vindt op gebruikersnaam die taak. Houd de twee taken gescheiden: de GitLab-controle gaat over namespace-afhankelijkheden, terwijl een gebruikersnaamopzoeking over publieke profielen gaat, en een publieke match is een aanwijzing, geen bewijs van eigendom.