← Página inicial

[GitLab Pages] · · 2 min de leitura

Como usar subdomínios do Namecheap em páginas do GitLab Pages

TL;DR

Ao configurar um subdomínio do Namecheap como domínio personalizado em páginas do GitLab Pages, é necessário inserir _gitlab-pages-verification-code.[subdomínio] no campo host ao criar um registro TXT para completar a verificação exigida pelo GitLab, ou o código de verificação não poderá ser confirmado.

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.
sub CNAME namespace.gitlab.io
  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.
_gitlab-pages-verification-code.sub TXT gitlab-pages-verification-code=00112233445566778899aabbccddeeff
  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

Não exclua o registro TXT após a primeira confirmação de verificação—o GitLab fará verificações periódicas dos registros de DNS de seu subdomínio.