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

└─ 📂 GitLab Pages · May 25, 2020 · 2 minute read

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


Meet the writer

Anna e só is a documentarian who loves learning new things every day—and sometimes, if they are lucky, they learn something that may be useful for someone else. They are determined to put an end to the tragedy of Undocumented Issues, Unhelpful Answers, and Untranslated Content. ⌨️