É crucial ter uma integração robusta entre sua ferramenta de código-fonte e a monday.com, por isso, é apresentado a você a Integração com GitHub.
A integração de instalação única com o GitHub oferece modelos poderosos para que sua equipe trabalhe com um fluxo de desenvolvimento de software contínuo, desde o planejamento e acompanhamento de sprints no monday dev até a execução do código perfeito no GitHub.
A integração é uma integração de permissão em nível de conta. Uma vez que a integração é pré-instalada em apenas alguns passos, qualquer pessoa da sua equipe pode criar novos modelos.
Você será solicitado a escolher uma organização na sua conta:
Em seguida, você será solicitado a autorizar a monday.com na sua conta do GitHub:
Uma vez que isso esteja instalado, os usuários podem adicionar novos modelos do GitHub e serão automaticamente autenticados com sua conta do GitHub.
É importante notar que monday.com acessa apenas os dados necessários, como nomes e locais dos seus dados, para garantir a funcionalidade. Essas permissões incluem:
- Acesso ao seu código – Específico para o modelo TODO, monday.com lê as alterações no PR, sem salvar o código, a fim de conectá-lo ao seu item da monday.
- Problemas – monday.com precisa acessar informações sobre problemas para acionar a automação relevante da monday
- Metadados – monday.com precisa de acesso a uma coleção de endpoints somente leitura com metadados para acionar a automação relevante da monday. Esses endpoints não fornecem informações sensíveis ou privadas do repositório.
- Pull requests – monday.com precisa ler as alterações no PR, bem como acessar permissões de escrita em relação aos pull requests, a fim de acionar a automação relevante da monday e os modelos de sincronização bidirecional da monday
Adicione ao seu fluxo de trabalho
Para adicionar os modelos de integração do GitHub ao seu quadro desejado, você pode ir até esse quadro e clicar em Integrar no canto superior direito:
Uma vez na página de Automação do Quadro, pesquise por GitHub na barra de pesquisa:
Clique no banner do GitHub e você encontrará os modelos que nossa integração oferece:
Então você pode selecionar os modelos que deseja adicionar ao seu quadro.
- Quando um problema é rotulado com algo neste repositório, crie um item
- Quando um pull request é mesclado em estes repositórios, e o ID do item é mencionado nele, altere o status para algo
- Quando um problema é criado em estes repositórios, crie um item
- Quando um pull request é criado em estes repositórios, e o ID do item é mencionado nele, altere o status para algo
- Quando um pull request é criado em estes repositórios, e o ID do item é mencionado nele, adicione o link do pull request à coluna de links
- Quando um branch é criado em estes repositórios, crie um item
- Quando o status de um problema muda para algo em estes repositórios, e o ID do item é mencionado nele, defina o status para algo
- Quando o usuário do github envia um comentário TODO para estes repositórios, crie um item
- Quando um problema é criado em estes repositórios, e o ID do item é mencionado nele, adicione o link a esta coluna de links
- Quando o status de um pull request muda para algo em estes repositórios, e o ID do item é mencionado nele, defina o status para algo
- Quando um problema é rotulado com algo em este repositório, e o ID do item é mencionado nele, defina o status para algo
- Quando o status de um pull request muda para algo em estes repositórios, e o ID do item é mencionado nele, crie uma atualização
- Quando um pull request é rotulado com algo em este repositório, e o ID do item é mencionado nele, defina o status para algo
- Quando um problema é criado em estes repositórios, crie um item e sincronize futuras alterações
- Quando um problema é criado com estes rótulos em este repositório, crie um item e sincronize futuras alterações
- Quando um pull request é criado ou atualizado em estes repositórios, crie um item e sincronize futuras alterações
- quando um item é criado ou atualizado, crie um problema em este repositório, com estes campos e sincronize futuras
Criar uma sincronização bidirecional
Uma sincronização bidirecional ocorre quando os dados são enviados tanto da monday.com para o GitHub quanto puxados 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 ambas as direções no menu suspenso.
Por exemplo, se você deseja mapear a coluna Proprietário do seu item na monday.com para o campo Atribuídos no GitHub, você selecionará esses campos em cada menu suspenso respectivo. Em seguida, sob o menu suspenso Escolher direção, escolha ambas as direções.
O que é o ID do item?
Alguns dos 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 do item serve como esse número único associado ao item.
Vamos usar o modelo de integração como exemplo: “Quando um pull request é criado neste repositório, e o ID do item é mencionado no nome do pull request, altere o status para algo.”
Uma vez que o pull request é criado no GitHub, o sistema usa o ID do item na monday.com para identificar qual item precisa ser alterado.
Essa menção também funcionará com o ID do item amigável (por exemplo, TASK-12)
Como rastrear um item de sprint
Receba atualizações instantâneas de status do monday dev toda vez que um branch for criado e um PR for mesclado. Para isso, recomenda-se usar a seguinte receita do GitHub para acompanhar sprints:
- Quando um branch é criado nestes repositórios, e o ID do item é mencionado nele, defina o status para algo.
Essa receita conecta itens ao GitHub usando o ID do item. Cole o ID do item no nome do branch para começar!
Essa conexão permite que você rastreie sprints em ambas as plataformas.
GitHub Actions
GitHub Actions é uma ferramenta integrada ao GitHub que permite automatizar tarefas dentro do seu fluxo de trabalho de desenvolvimento de software. Isso ajudará a eliminar tarefas repetitivas, tornando o processo de desenvolvimento mais eficiente.
O que o GitHub Actions pode fazer?
- Automatizar o pipeline de CI/CD: Isso permitirá que você configure processos automáticos para construir, testar e implantar seu código sempre que houver alterações. Isso ajuda a detectar bugs mais cedo e agiliza o processo de lançamento.
- Executar fluxos de trabalho com base em eventos: O GitHub Actions pode acionar fluxos de trabalho com base em vários eventos em seu repositório. Por exemplo, você pode criar um fluxo de trabalho que executa testes automaticamente sempre que um pull request é enviado.
- Usar uma grande comunidade de ações: Há uma vasta coleção de ações pré-construídas disponíveis que você pode usar para várias tarefas. Essas podem ser desde implantar seu código em diferentes plataformas até criar tickets em ferramentas de gerenciamento de projetos. Você também pode criar suas próprias ações personalizadas.
Você encontrará o modelo para a integração do GitHub que abre um item em fluxos de trabalho específicos que terminam com conclusões específicas. O item pode ser preenchido com dados do fluxo de trabalho.
Para usar o modelo, navegue até a página de automação do Quadro e pesquise por GitHub. A partir daí, clique no modelo conforme abaixo.
O que mais você precisa saber?
A integração funcionará mesmo se você não instalar o aplicativo no GitHub?
- Não, a integração não é possível sem que o aplicativo esteja instalado no GitHub.
Você pode 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 você pode desincronizar o GitHub da monday.com?
- Para desinstalar o aplicativo do GitHub da monday.com, você pode ir até a sua seção de Administração e clicar na aba Apps. Em seguida, role para baixo até ver o Aplicativo do GitHub e clique no ícone de três pontos sob Ações, e depois clique em Desinstalar.
Em seguida, para desinstalar o aplicativo da monday.com do GitHub, você pode ir até sua conta do GitHub > Configurações > Aplicativos e encontrar a monday.com. Role para baixo até a Zona de Perigo e clique em Desinstalar.
Obtenha o aplicativo Git UI
Leve sua integração um passo adiante com o aplicativo Git UI, que pode ser adicionado como um widget dentro da sua visualização do cartão do item para visualizar dados dos seus repositórios do GitHub. Personalize o aplicativo para mostrar branches, commits, pull requests e o status de CI/CD para suas tarefas de desenvolvimento.
Mais assistência
Precisa de mais ajuda? O suporte da monday.com está à disposição.
E se você busca otimizar o uso da monday.com no seu time, a Audatia (parceira oficial no Brasil) tem especialistas prontos para ajudar com consultoria e treinamentos. Fale com um consultor →