GitHub e Asana | Guia do produto

Visão geral

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.

A integração entre a Asana e o GitHub está disponível para todos os clientes Premium, Business e Enterprise.

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.

imagem indicando o botão adicionar aplicativo no menu personalizar

Como configurar na Asana:

  1. Vá até o projeto no qual deseja instalar a integração da Asana para o GitHub. Clique no menu suspenso Personalizar, localizado no canto superior direito.
  2. Role a tela para baixo até Aplicativos e selecione +Adicionar aplicativo.

aplicativo Github

  • Selecione o GitHub clicando em +Adicionar ao projeto.
  • Siga as instruções para autorizar o uso da sua conta do GitHub.
  • A integração da Asana para o GitHub será instalada no projeto.
  • Na tela seguinte, você pode selecionar outros projetos aos quais deseja adicionar esta integração.

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 Git e segredos de repositório 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 o recebimento das notificações sobre pull requests do GitHub na Asana: esta ação adiciona um comentário sobre o status da pull request na tarefa da Asana e inclui o título da pull request com o link para a tarefa correspondente. 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 GitHub na seção anterior, poderá revogar tokens secretos acessando esta página de configuração e selecionando Revoke all (revogar todos).

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.

campo do Github na tarefa

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.

link da pull request do 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.

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.

atualizações

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, 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á.

Desculpe, este navegador não é compatível com o nosso aplicativo

A Asana não funciona corretamente no navegador de Internet que você está usando. Faça o seu cadastro através de um destesnavegadores compatíveis.

Escolha o idioma

Escolher um idioma também poderá alterar o conteúdo em asana.com