Como podemos ajudar?

Integração com o GitHub

 

monday-dev-banner (2).png

 

Este recurso está disponível para:
Este recurso está disponível apenas no monday dev 

 

 

Ei desenvolvedores! Sabemos como é essencial ter uma integração robusta entre sua ferramenta de código fonte e a monday.com, então queremos apresentar para vocês a Integração com o GitHub.

Essa integração com o GitHub precisa de apenas uma instalação e oferece mais flexibilidade e modelos mais potentes, para que sua equipe possa ter um fluxo de desenvolvimento de software simplificado, desde o planejamento e acompanhamento de sprints na monday.com até a execução do código perfeito no GitHub!

A nova integração é uma integração com permissões de nível de conta. Assim que ela for pré-instalada em apenas alguns passos, qualquer desenvolvedor da sua equipe poderá criar novos modelos. Fácil, não é? 

 

Notas importantes

Para que a integração com o GitHub seja sincronizada com sucesso, você vai precisar primeiro instalar o aplicativo da monday.com no GitHub. Você também precisará ser um Admin da sua conta da monday.com e ter permissões de Admin na organização do GitHub para instalar o aplicativo.

 

Nota:  Apesar de você poder ter qualquer tipo de licença no GitHub para fazer a integração, ela estará disponível somente em nossos planos Padrão, Profissional e Corporativo. 
Para começar, acesse github.com/apps/monday-com-github e instale o app da monday.com no GitHub:

Devs Install GitHub.png

 

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

Devs Choose Organization.png

 

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

Devs monday Permissions.png

Depois dessa instalação, os usuários poderão adicionar novos modelos 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 modelo 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 modelos de sincronização bidirecional da monday

 

Adicionar ao seu fluxo de trabalho 

Para adicionar os novos modelos de integração do GitHub ao quadro desejado, vá para o quadro e clique em "Integrar" no canto superior direito:integrate.png

Quando estiver na Central de integrações, procure por "GitHub" na barra de pesquisa:

GitHubNew6.png

Nota:  Nossa integração "antiga" do GitHub continua na Central de integrações, então você precisará passar por ela e clicar em "GitHub (New Integration)" na seção Apps.

 

Clique no banner "GitHub (New Integration)", onde você encontrará os modelos oferecidos por nossa integração:

GitHub_Recipes3.png

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

 

Os modelos 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

 

Dica: Com os novos modelos de integração do GitHub, você pode selecionar vários repositórios do GitHub em um modelo. Nada mais de criar vários modelos de integração para cada repositório! 🥳

 

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. Isso faz com que seus dados sejam correspondentes em ambas as plataformas e permaneçam atualizados.

A natureza deste modelo permite que você escolha a direção de sua sincronização para criar uma sincronização bidirecional entre o GitHub e a monday.com.

GitHub 2 way sync.png

 

Configurando a sincronização bidirecional

Ao mapear "estes campos", você selecionará o campo no GitHub, o campo na monday.com e a direção que você deseja para a sincronização. Para criar uma sincronização bidirecional, selecione "ambos os sentidos".

Por exemplo, usando o GIF abaixo, se você quiser mapear a coluna "Responsável" do seu elemento na monday.com para o campo "Responsável" no GitHub, selecione esses campos abaixo do logotipo da respectiva empresa.Em seguida, no menu suspenso "Escolher direção", escolha "ambos os sentidos" para indicar que as informações trafegarão em ambos os sentidos.

GitHub Two-Way Sync.gif

 

O que "ID de elemento" significa em alguns modelos?

Ótima pergunta! Alguns modelos de integração precisam de 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". 

Frame_13.png

Vamos pegar, por exemplo, o modelo de integração: "Quando uma solicitação de busca for criada neste repositório, e o  id de elemento for mencionado no nome da solicitação de busca, 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 uma vez na coluna de ID do elemento para copiar o valor automaticamente do seu quadro.

 

A nova 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.

 

Como posso cancelar a sincronização do GitHub com a monday.com?

 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 "Zona do perigo" e clique em "Desinstalar":

GitHubUninstall2.png

 

O que vai acontecer com a integração com o GitHub antiga?

No momento, ainda é possível encontrar e usar a integração do GitHub antiga na Central de integrações, mas eventualmente ela será descontinuada conforme continuamos a receber feedback de nossos incríveis usuários (estamos falando de você!) e conforme adicionamos funcionalidades à nova integração.

 

Envie seu feedback para nossa equipe diretamente aqui, e fique ligado para mais atualizações empolgantes!

 

Se você precisar de ajuda para criar integrações personalizadas, também temos uma opção de ajuda paga por meio de nossa rede de parceiros certificados da monday.com. Se você tiver interesse, preencha este formulário, e entraremos em contato em breve! 

 

Se você tiver alguma dúvida, entre em contato com nossa equipe por aqui. Estamos disponíveis 24 horas e prontos para ajudar!