Integração entre GitHub e Asana

A integração da Asana para o GitHub está disponível nas modalidades Asana Starter, Advanced , Enterprise e Enterprise+, bem como nas modalidades legadas Premium, Business e Legacy Enterprise.

Para mais informações, acesse a nossa página de preços.

Com a integração entre Asana e GitHub, você pode sincronizar automaticamente as atualizações de status das pull requests do GitHub com tarefas da Asana para melhorar a colaboração interdisciplinar.

Esta integração ajuda a aumentar a visibilidade e a transparência no trabalho de engenharia entre as equipes técnicas e não técnicas. Com ela, os desenvolvedores podem se comunicar facilmente pela Asana para manter as equipes e os participantes multidisciplinares informados, evitando que algum trabalho seja esquecido.

Esta integração não oferece suporte ao GitHub Enterprise Server.

Instalação para Asana e GitHub Actions

Conecte a Asana com o GitHub para sincronizar os status das pull requests. Defina as configurações na Asana para utilizar a integração e também no GitHub, para obter funcionalidades adicionais.

Parabéns, agora você pode conectar as pull requests do GitHub com as tarefas na Asana. Se quiser habilitar outras funcionalidades com a integração, verifique a próxima seção. Caso contrário, pule para Funcionalidade principal abaixo.

 

Como configurar o GitHub Actions:

Esta seção pressupõe alguma familiaridade com segredos de repositório do Git e do GitHub. Se você não tem acesso para configurar os segredos do repositório, entre em contato com o proprietário do repositório.

Oferecemos suporte para dois tipos de GitHub Actions:

1. Automatizar as notificações sobre pull requests na Asana: esta ação indica o status da pull request na tarefa da Asana. Inclui o título da pull request com um link para a tarefa associada da Asana. Para configurá-la, acesse a página do GitHub Action.
2. Conectar os anexos da pull request à Asana a partir da sua descrição no GitHub: esta ação conecta automaticamente a pull request do GitHub a uma ou mais tarefas da Asana, adicionando a URL da tarefa à descrição da pull request. Para configurá-la, acesse a página do GitHub Action.

Assim como toda GitHub Action, estas ações serão executadas apenas se ocorrer um evento no repositório no qual elas foram configuradas. Por exemplo, você pode definir que uma ação seja executada sempre que alguém mesclar ou comentar em uma pull request.

Cada ação do GitHub deve ser configurada separadamente, exceto quando forem ações múltiplas e idênticas no mesmo repositório. Por exemplo, você pode configurar uma ação que comenta na tarefa que está na descrição da pull request quando um teste for concluído, e outra ação que adiciona um comentário diferente na tarefa quando a pull request for mesclada.

As ações do GitHub também podem ser adicionadas como parte de um fluxo de trabalho existente. Para saber mais, consulte o guia de recursos do GitHub Actions.

Revogação de tokens secretos

Se você configurou as ações do Gitub na seção anterior, poderá revogar tokens secretos. Visite esta página de configuração e selecione Revogar tudo.

Isso revogará todos os tokens secretos existentes do GitHub Actions.

Você ainda poderá ver as informações sobre pull requests nos projetos da Asana aos quais esta integração foi adicionada.

Funcionalidade principal

Como anexar uma pull request a uma tarefa da Asana (na Asana):

Depois de instalar a integração do GitHub na Asana, você verá um campo do GitHub em todas as tarefas do projeto associado.

Para anexar uma pull request a uma tarefa da Asana, obtenha a URL da pull request e cole-a no campo vazio do GitHub. Um widget com os seguintes dados deve aparecer na tarefa da Asana: Status da revisão, Status da versão, Status da PR, Alterações de linhas e número de conversas no GitHub.

 

Como anexar uma pull request a uma tarefa da Asana (no GitHub):

Depois de instalar a integração do GitHub na Asana e configurar o GitHub Actions, você poderá anexar automaticamente uma pull request a uma tarefa da Asana a partir da descrição da pull request no GitHub.

Obtenha a URL da tarefa da Asana e cole-a na descrição da pull request no GitHub. Um widget com os seguintes dados deve aparecer ao visualizar a tarefa na Asana: Status da revisão, Status da versão, Status da PR e Alterações de linha.

Qualquer erro que ocorrer será mostrado na aba “Actions” do GitHub.

 

Como receber atualizações sobre a mesclagem e o fechamento da pull request:

As pull requests poderão ser fechadas no GitHub depois que as equipes apropriadas revisarem e mesclarem as alterações. O status no widget da Asana será atualizado automaticamente.

Se quiser anexar uma nova pull request, insira a URL da tarefa da Asana na descrição da nova pull request no GitHub e o widget será substituído automaticamente, ou remova a pull request fechada da Asana clicando no menu localizado no canto superior direito. Após a remoção, você poderá inserir a URL da nova pull request.

Depois de instalar a integração do GitHub na Asana e configurar o GitHub Actions, você receberá comentários nas tarefas da Asana com uma pull request aberta anexada. Isso incluirá atualizações se a pull request foi ou não mesclada ou fechada.

Perguntas frequentes

O mesmo segredo gerado pode ser usado em múltiplos repositórios?

Sim

 

Os meus colegas de equipe podem ver as informações sobre as pull requests que eu anexar na tarefa da Asana, mesmo que eles não tenham acesso à pull request?

Sim. Ao anexar uma pull request a uma tarefa, todos os que podem visualizar a tarefa conseguem ver as informações no widget.

 

Gerar um novo token desabilitará o meu token secreto antigo?

Não, os seus tokens secretos antigos ainda funcionarão. Caso queira, você pode desabilitá-los aqui.

 

O mesmo segredo gerado pode ser usado em múltiplos repositórios?

Sim

 

Ao tentar enviar por push o arquivo do fluxo de trabalho, o git diz que o meu token não tem acesso para criar fluxos. O que devo fazer?

Se estiver usando a autenticação em dois fatores e interagindo com o GitHub na linha de comando, o GitHub requer que você use o seu token de acesso pessoal como senha. Crie um novo token de acesso pessoal do GitHub com o escopo do fluxo de trabalho.

 

Por que solicitamos essas permissões do GitHub?

Apenas acessamos e criamos a partir de pull requests nesta integração. A permissão na página de autenticação é a mais restrita que o GitHub nos permite solicitar para acessar as pull requests.

 

O que acontecerá se a ação do GitHub anexar uma pull request à tarefa de um projeto que não possui a integração ativada?

Um anexo vinculado à pull request poderá ser visualizado na seção de comentários da tarefa, mas o widget que sincroniza com o status da pull request não aparecerá.

Gosta do que vê? Comece já uma avaliação gratuita de 30 dias da Asana. Experimente gratuitamente