Instale o aplicativo GitHub da Zinn® para que possamos implantar sem um token de longa duração

O que a conexão faz por você

Instalar o aplicativo Zinn® GitHub permite que um site faça deploy a partir de seus repositórios — e que um quadro de projeto permaneça sincronizado com o GitHub — sem nos entregar um token pessoal. Mantemos apenas o número de instalação do aplicativo, que é inútil por si só, e geramos um token com duração de uma hora sempre que precisamos de um. É a melhor escolha para uma organização, pois não pertence a nenhuma pessoa específica e não para de funcionar quando alguém sai.

Antes de começar

Uma conta do GitHub ou permissões de proprietário na organização onde você deseja instalar o aplicativo. Organizações que proíbem aplicativos de terceiros precisam que um proprietário o autorize; se isso não for possível, use um token de granularidade fina (Conectar sua conta do GitHub).

1. Crie a chave no GitHub

Não há chave a ser criada. Instale o aplicativo Zinn® GitHub em sua conta pessoal ou em sua organização e selecione todos os repositórios ou apenas aqueles que deseja que façamos o deploy.

Em seguida, encontre o número de instalação:

• Conta pessoal — Settings → Applications → Installed GitHub Apps e Configure ao lado do aplicativo Zinn®.
• Organização — Your organizations → Settings → GitHub Apps e Configure ao lado do aplicativo Zinn®.

O número no final da barra de endereços nessa página — por exemplo, github.com/settings/installations/12345678 — é o número de instalação.

2. Conecte-o aqui

O aplicativo é selecionado onde for utilizado, em vez de na tela de Integrações:

• Na conexão de repositório de um site, escolha GitHub (app install).
• No link do GitHub de um quadro de projeto, escolha The Zinn® GitHub app.

Cole o Installation number e continue. Verificamos a instalação antes de salvar qualquer informação; um número que não conseguimos acessar nunca é armazenado.

O que acontece a seguir

• Os repositórios concedidos ao aplicativo ficam disponíveis para o site realizar deploys, e um push realiza o deploy.
• Cada ação que realizamos aparece no registro de auditoria da instalação no GitHub sob o nome do aplicativo, não o seu.
• Para nos conceder acesso a mais repositórios, altere o acesso aos repositórios do aplicativo na mesma página Configure — nada precisa ser reconectado.

Se não conectar

Falta um repositório. A instalação cobre apenas os repositórios selecionados. Abra Configure e adicione-o.

O número é recusado. Verifique se é o número de instalação da barra de endereços, e não o ID do próprio aplicativo, e se o aplicativo ainda está instalado — um aplicativo desinstalado não possui instalação.

A mensagem diz 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 expirada ou uma chave revogada ou gerada novamente após você tê-la copiado. Crie uma nova e cole-a novamente.

Conecta, mas algo falha posteriormente. A chave é autenticada, mas não possui a 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, localize a conta e pressione Disconnect. Isso exclui a chave armazenada imediatamente. Tudo o que a utilizava para na próxima ação, e as telas dependentes informam o erro em vez de falharem silenciosamente.

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