Conecte sua conta do GitLab para que seus sites sejam implantados a partir de um repositório

O que a conexão faz por você

Conectar o GitLab permite que um site seja implantado a partir de um de seus repositórios do GitLab, e nos permite publicar no GitLab Pages em sua conta onde você o escolher como host de um site.

Antes de começar

Uma conta do GitLab com acesso aos projetos que você deseja implantar.

1. Crie a chave no GitLab

No GitLab, selecione seu avatar no canto superior direito, depois Edit profile → Access → Personal access tokens, e gere um novo token (o GitLab pode rotular isso como Legacy token no menu Generate token). Dê um nome a ele, defina uma data de expiração e marque estes escopos:

• api
• write_repository

Clique em Generate token e copie-o — o GitLab o exibe apenas uma vez.

2. Conecte-o aqui

Abra Integrations em seu painel e escolha Connect an account. Escolha Code hosting como o grupo e GitLab como a conta, preencha API token e pressione Connect account.

Testamos o que você cola antes de salvar qualquer informação. Uma chave que não funciona nunca é armazenada, e a resposta informa o que estava errado com ela. Uma chave que funciona é mantida criptografada em nosso cofre de segredos — nunca em nosso banco de dados — e nunca mais é exibida, nem mesmo para você.

O que acontece a seguir

• Um site pode ser implantado diretamente de um repositório nesta conta: escolha-o na conexão de repositório do site, selecione o repositório e a ramificação, e um push realiza a implantação.
• Todas as outras ramificações podem ter sua própria prévia, para que você possa verificar uma alteração antes que ela chegue ao site publicado.
• Hosts estáticos baseados em Git, como Render e Azure Static Web Apps, usam esta conexão como a fonte do código do site.

Se não conectar

Funcionou e depois parou. Os tokens do GitLab sempre expiram — geralmente no máximo um ano após sua criação — e o GitLab envia um e-mail antes que expirem. Crie um novo e conecte-o.

Um escopo está ausente. Os escopos de um token não podem ser alterados após sua criação; crie um novo token com ambos os escopos marcados.

Informa que a chave foi rejeitada. Quase sempre uma de três coisas: um espaço ou uma quebra de linha copiada junto com ela, uma chave que expirou ou uma chave que foi revogada ou regenerada após você tê-la copiado. Crie uma nova e cole-a novamente.

Conecta, mas algo falha depois. A chave autentica, mas não possui uma permissão necessária para a ação. Crie uma nova chave com as permissões listadas acima, depois desconecte a conexão antiga e conecte a nova chave.

Desconectando

Abra Integrations, encontre a conta e pressione Disconnect. Isso exclui a chave armazenada imediatamente. Tudo o que a estava utilizando é interrompido na ação seguinte, e as telas que dependiam dela informam isso em vez de falharem silenciosamente.

Desconectar não desfaz o que já foi feito — registros, implantações ou configurações que alteramos em sua conta permanecem como estão. Se você acredita que a chave em si pode ter vazado, também a revogue no provedor; desconectar remove a nossa cópia, não a deles.