Install the Zinn® GitHub app so we can deploy without a long-lived token

O que a conexão faz pelo senhor

Instalar o aplicativo do GitHub do Zinn® permite que um site seja implantado a partir de seus repositórios — e que um quadro de projetos permaneça sincronizado com o GitHub — sem nos fornecer um token pessoal. Armazenamos apenas o número de instalação do aplicativo, que é inútil por si só, e geramos um token com validade 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 da empresa.

Antes de começar

Uma conta do GitHub ou direitos de proprietário na organização onde deseja instalar o aplicativo. Organizações que proíbem aplicativos de terceiros exigem que um proprietário permita o uso; se isso não for possível, utilize um token de granulação fina (Conectar sua conta do GitHub).

1. Criar a chave no GitHub

Não há chave para criar. Instale o aplicativo do GitHub do Zinn® em sua conta pessoal ou em sua organização e escolha todos os repositórios ou apenas aqueles que deseja que sejam implantados por nós.

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

• Conta pessoal — Settings → Applications → Installed GitHub Apps, e clique em Configure ao lado do aplicativo do Zinn®.
• Organização — Your organizations → Settings → GitHub Apps, e clique em Configure ao lado do aplicativo do 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. Conectar aqui

O aplicativo é selecionado onde é utilizado, e não na tela Integrações:

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

Cole o Número de instalação e prossiga. Verificamos a instalação antes de salvar qualquer informação; um número que não pudermos alcançar nunca será armazenado.

O que acontece em seguida

• Os repositórios aos quais o senhor concedeu acesso ao aplicativo aparecem para que o site seja implantado a partir deles, e um envio (push) realiza a implantação.
• Cada ação executada por nós aparece no registro de auditoria da instalação no GitHub sob o nome do aplicativo, e não o do senhor.
• 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 a conexão falhar

Falta um repositório. A instalação abrange apenas os repositórios selecionados pelo senhor. Abra a página Configure e adicione-o.

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

A mensagem indica que a chave foi rejeitada. Quase sempre se trata de uma destas três situações: um espaço ou quebra de linha copiado junto com a chave, uma chave expirada ou uma chave que foi revogada ou gerada novamente após a cópia. Crie uma nova chave e cole-a novamente.

A conexão é estabelecida, mas ocorre uma falha posterior. A chave é autenticada, mas carece de uma permissão necessária para a ação. Crie uma nova chave com as permissões listadas acima, desconecte a conexão antiga e conecte a nova chave.

Desconectando

Abra Integrations, localize a conta e clique em Disconnect. Isso exclui imediatamente a chave armazenada. Qualquer recurso que estivesse utilizando a chave será interrompido na próxima ação, e as telas dependentes informarão o erro em vez de falharem silenciosamente.

A desconexão não desfaz o que já foi realizado — registros, implantações ou configurações alteradas por nós em sua conta permanecem inalterados. Se o senhor suspeitar que a chave possa ter vazado, revogue-a também junto ao fornecedor; a desconexão remove a nossa cópia, não a deles.