Como usar subdomínios do Namecheap em páginas do GitLab Pages – 2020-05-25

Requisitos

Segundo a documentação do GitLab, o uso de subdomínios requer:

• Um registro CNAME apontando o seu subdomínio para o servidor do GitLab Pages.
• Um registro TXT com um código de verificação de posse.

Para fins de demonstração, usaremos um subdomínio chamado sub.example.com.

Modificações a serem feitas no gitlab.com

1. Acesse o repositório em que você deseja servir a página.
2. Caso deseje deixar a página disponível para todos, acesse Settings > General e expanda a seção Visibility, project features, permissions. Na subseção Pages, selecione a opção Everyone.
3. Ainda em Settings, acesse a opção Pages e clique em New domain.
4. Insira o seu subdomínio no campo Domain e clique em Create New Domain.
5. O GitLab exigirá a verificação do domínio, te dando instruções de preenchimento dos registros CNAME e TXT. Guarde essas informações.

Modificações a serem feitas no painel de Advanced DNS do Namecheap

• Crie um registro CNAME conforme proposto nas configurações de domínio do GitLab Pages.

1. Campo host
2. Tipo de registro
3. Espaço nominal nos servidores do GitLab Pages

• Crie um registro TXT com o código de verificação fornecido pelo GitLab.

1. Campo host, reproduzindo as instruções do GitLab mas substituindo sub.example.com por sub
2. Tipo de registro
3. Código de verificação

Requisitando a verificação do subdomínio

1. Acesse novamente Settings > Pages no seu repositório
2. Procure pelo seu domínio e clique em Details
3. Clique no botão Retry verification localizado no campo de Verification status

O GitLab resgatará os registros do seu subdomínio e verificará o código. Esse processo não tem prazo certo, já que a propagação de registros DNS pode demorar até 24h embora geralmente se complete em poucos minutos