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

O que a conexão faz por você

Conectar o GitHub com um token permite que um site seja implantado a partir de um de seus repositórios: envie um push para a ramificação e o site será atualizado. Isso também nos permite publicar no GitHub Pages em sua conta quando você o escolher como o host de um site.

Se os seus repositórios pertencerem a uma organização, prefira o aplicativo Zinn® GitHub — consulte Instalar o aplicativo Zinn® GitHub. Um token pertence a uma pessoa e para de funcionar quando ela sai.

Antes de começar

Uma conta do GitHub com acesso aos repositórios que deseja implantar. Se pertencerem a uma organização, um proprietário poderá ter que aprovar tokens de granularidade fina (fine-grained) para ela.

1. Crie a chave no GitHub

No GitHub, clique na foto do seu perfil e, em seguida, em Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Dê um nome a ele e escolha uma data de expiração. Em Repository access, escolha Only select repositories e selecione aqueles que você implanta — o acesso mais restrito que funcione.

Em Repository permissions, conceda Read and write em:

• Contents
• Pages
• Administration

Pressione Generate token e copie-o — o GitHub o exibe apenas uma vez.

2. Conecte aqui

Abra Integrações no seu painel e escolha Conectar uma conta. Escolha Hospedagem de código como o grupo e GitHub como a conta, preencha o Token de API e pressione Conectar conta.

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 incorreto nela. Uma chave funcional é 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 realizará a implantação.
• Cada uma das outras ramificações pode obter sua própria prévia, para que você possa verificar uma alteração antes que ela chegue ao site de produção.
• 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

Um repositório não aparece. O acesso a repositórios do token não o inclui. Edite o token no GitHub e adicione o repositório.

Funcionou e depois parou. Os tokens de granularidade fina expiram na data que você escolheu. Gere um novo e conecte-o; o GitHub envia um e-mail a você antes que um token expire.

Informa que a chave foi rejeitada. Quase sempre uma de três coisas: um espaço ou uma quebra de linha copiada com ela, uma chave que expirou ou uma chave que foi revogada ou gerada novamente após você tê-la copiado. Crie uma nova chave 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 Integrações, encontre a conta e pressione Desconectar. Isso exclui a chave armazenada imediatamente. Tudo o que a estava utilizando para em sua próxima ação, e as telas que dependiam dela informam isso em vez de falharem silenciosamente.

A desconexão não desfaz o que já foi feito — registros, implantações ou configurações que alteramos em sua conta permanecem como estão. Se achar que a própria chave pode ter vazado, revogue-a também no fornecedor; a desconexão remove a nossa cópia, não a deles.