Será solicitado que você escolha uma organização em sua conta:

Em seguida, haverá uma solicitação para autorizar a monday.com na sua conta GitHub:

Depois dessa instalação, os usuários poderão adicionar novos templates do GitHub e serão autenticados automaticamente com sua conta GitHub.

Clique aqui para aprender o que essas permissões significam

É importante notar que a monday.com acessa apenas os dados necessários, como nomes e locais dos seus dados, a fim de garantir a funcionalidade. Essas permissões incluem:

• Acesso ao seu código - específico ao template de afazeres, a monday.com consulta as alterações na solicitação de pull, sem salvar o código, para conectá-lo ao seu elemento da monday.  
• Problemas - A monday.com precisa acessar informações sobre problemas para acionar a automação da monday relevante
• Metadados - A monday.com precisa acessar uma coleção de endpoints somente leitura com metadados para acionar a automação da monday relevante. Esses endpoints não fornecem informações confidenciais e particulares de repositórios.
• Solicitações de pull - a monday.com precisa consultar as alterações na solicitação de pull, bem como acessar permissões de escrita referentes às solicitações de pull, para acionar a automação relevante da monday e templates de sincronização bidirecional da monday.

Adicionar ao seu fluxo de trabalho 

Para adicionar os templates de integração do GitHub ao quadro desejado, vá para o quadro e clique em Integrar no canto superior direito:

Quando estiver na central de automações, procure por "GitHub" na barra de pesquisa:

Clique no banner GitHub, e você encontrará os templates oferecidos por nossa integração:

Depois você pode selecionar os templates que deseja adicionar ao seu quadro.

Os templates de integração compatíveis com a monday.com são os seguintes:

• Quando um tópico for etiquetado com algo neste repositório, criar um elemento
• Quando uma solicitação de busca for mesclada nesses repositórios, e um id de elemento for mencionado nele, mudar o status para algo
• Quando um tópico for criado nestes repositórios, criar um elemento
• Quando uma solicitação de busca for criada nesses repositórios, e um id de elemento for mencionado nele, mudar o status para algo
• Quando uma solicitação de busca for criada nesses repositórios, e um id de elemento for mencionado nele, adicionar um link de solicitação de busca na coluna de link
• Quando um ramal for criado nestes repositórios, criar um elemento
• Quando o status de um tópico mudar para algo nestes repositórios, e um id de elemento for mencionado nele, definir o status como algo
• Quando um usuário github enviar um comentário TODO para estes repositórios, criar um elemento
• Quando um tópico for criado nesses repositórios, e um id de elemento for mencionado nele, adicionar um link a essa coluna de link
• Quando o status de uma solicitação de chamada mudar para algo nestes repositórios, e um id de elemento for mencionado nele, definir o status como algo
• Quando um tópico for etiquetado como algo nestes repositórios, e um id de elemento for mencionado nele, definir o status como algo
• Quando o status de uma solicitação de chamada mudar para algo nestes repositórios, e um id de elemento for mencionado nele, criar uma atualização
• Quando uma solicitação de chamada for etiquetada como algo nestes repositórios, e um id de elemento for mencionado nele, definir o status como algo
• Quando um tópico for criado nestes repositórios, criar um elemento e sincronizar alterações futuras
• Quando um tópico for criado com essas etiquetas neste repositório, criar um elemento e sincronizar alterações futuras
• Quando uma solicitação de pull for criada ou atualizada nestes repositórios, criar um elemento e sincronizar alterações futuras
• Quando um elemento for criado ou atualizado, criar um problema neste repositório, com estes campos, e sincronizar alterações futuras

Criar uma sincronização bidirecional

Uma sincronização bidirecional ocorre quando os dados estão sendo enviados da monday.com para o GitHub e extraídos do GitHub para a monday.com. Dessa forma, seus dados correspondem em ambas as plataformas e permanecem atualizados.

Para criar uma sincronização bidirecional, selecione ambos os sentidos no menu suspenso.

Por exemplo, se você quiser associar a coluna Responsável do seu elemento na monday.com ao campo Titulares no GitHub, selecione esses campos em cada respectivo menu suspenso. Em seguida, no menu suspenso Escolher direção, escolha ambos os sentidos.

O que é ID de elemento?

Alguns dos templates de integração requerem uma "conexão única" entre a monday.com e o GitHub para sincronizar as duas plataformas, e o ID de elemento serve como um número exclusivo associado àquele elemento.

Nota: Será preciso colocar um símbolo "#" da frente do número no GitHub para que a Coluna de ID do elemento da monday.com reconheça a conexão. Por exemplo: No GitHub o número deve aparecer como "#376479", não "376479". 

Vamos pegar o template de integração como exemplo: "Quando uma solicitação de pull for criada neste repositório, e o ID de elemento for mencionado no nome da solicitação de pull, alterar o status para algo."

Assim que a solicitação de busca for criada no GitHub, o sistema usará o ID de elemento na monday.com para identificar qual elemento precisa ser alterado.

Dica: Você pode clicar na coluna de ID do elemento para copiar o valor automaticamente do seu quadro.

Ações do GitHub

Ações do GitHub é uma ferramenta incorporada ao GitHub que permite automatizar tarefas dentro do seu fluxo de trabalho de desenvolvimento de software. Ela ajudará a eliminar tarefas repetitivas, o que por sua vez agilizará o processo de desenvolvimento, tornando-o mais eficaz.

O que as Ações do GitHub podem fazer?

• Automatizar o pipeline de CI/CD: você poderá configurar processos automáticos para criar, testar e implementar seu código sempre que houver mudanças. Isso ajuda a identificar bugs com antecedência e otimizar o processo de lançamento.
• Executar fluxos de trabalho com base em eventos: as Ações do GitHub podem acionar fluxos de trabalho de acordo com eventos variados em seu repositório. Por exemplo, você pode criar um fluxo de trabalho que execute testes automaticamente sempre que uma solicitação de pull for enviada.
• Usar uma ampla comunidade de ações: há um grande conjunto de ações pré-criadas disponíveis que você pode usar para diversas tarefas. Elas podem variar desde implementar seu código em diferentes plataformas até criar tickets em ferramentas de gestão de projetos. Você também pode criar suas próprias ações personalizadas.

Você encontrará o template da nossa integração com o GitHub que abre um elemento em fluxos de trabalho específicos que terminam com conclusões específicas. O elemento pode ser preenchido com dados do fluxo de trabalho.

Para usar o template, acesse a central de automações e pesquise por GitHub. Em seguida, clique no template, conforme abaixo.

Nota: para usar as Ações do GitHub, o admin da organização do GitHub deve permitir a configuração "Permissão de leitura de ações". Se você encontrar quaisquer problemas, entre em contato. 

O que mais você precisa saber?

A integração vai funcionar mesmo se eu não instalar o aplicativo no GitHub?

• Não, a integração não é possível sem o aplicativo estar instalado no GitHub.

Posso conectar minha conta da monday.com a várias organizações no GitHub?

• Sim! Você pode conectar suas contas da monday.com a várias organizações do GitHub.

Depois, para desinstalar o aplicativo da monday.com do GitHub, você pode ir para sua conta GitHub > Configurações > Aplicativos e encontrar a monday.com. Role até a seção "Zona de perigo" e clique em "Desinstalar".