Repositórios do Azure com o Slack

Azure DevOps Services

Se utilizar o Slack, poderá utilizar a aplicação Repositórios do Azure para o Slack para monitorizar facilmente os repositórios dos Repositórios do Azure. Pode configurar e gerir subscrições para receber notificações no canal sempre que é emitido/registado código e sempre que um pedido pull (PR) é criado, atualizado ou uma intercalação é tentada. Esta aplicação suporta eventos de Controlo de Versões do Team Foundation (TFVC) e do Git.

Leia este artigo para saber como:

• Adicionar a aplicação Repositórios do Azure à área de trabalho do Slack
• Ligar a aplicação repositórios do Azure aos repositórios
• Gerir subscrições para repositórios de eventos relacionados no seu canal do Slack
• Utilizar filtros de forma eficaz para personalizar subscrições
• Obter notificações em canais privados do Slack

Pré-requisitos

• Para criar subscrições num canal do Slack para eventos relacionados com o repositório, tem de ser membro do grupo Administradores do Projeto ou administrador de equipa. Para ser adicionado, veja Alterar permissões ao nível do projeto ou Adicionar um administrador de equipa.
• Para receber notificações, o acesso da aplicação de terceiros através da definição OAuth tem de estar ativado para a organização. Veja Alterar políticas de acesso a aplicações para a sua organização.

Nota

• Atualmente, as notificações não são suportadas dentro de mensagens diretas.
• Neste momento, só pode ligar a aplicação Repositórios do Azure para Slack a um projeto alojado nos Serviços do Azure DevOps.

Adicionar a aplicação Repositórios do Azure à área de trabalho do Slack

1. Navegue para a aplicação Azure Repos Slack para instalar a aplicação Repositórios do Azure na sua área de trabalho do Slack.

2. Depois de adicionado, verá uma mensagem de boas-vindas da aplicação, conforme mostrado na imagem seguinte.

   

3. Utilize a alça do /azrepos Slack para interagir com a aplicação. É fornecida uma lista completa de comandos na secção Referência de comandos deste artigo.

Ligar a aplicação repositórios do Azure aos repositórios

1. Assim que a aplicação estiver instalada na área de trabalho do Slack, ligue-se e autentique-se nos Repositórios do Azure com o /azrepos signin comando .

   

2. Para começar a monitorizar todos os repositórios git num projeto, utilize o seguinte comando de barra dentro de um canal:

   /azrepos subscribe [project url]
   

   O URL do projeto pode ser para qualquer página no seu projeto (exceto URLs para repositórios).

   Por exemplo:

   /azrepos subscribe https://dev.azure.com/myorg/myproject/
   

   Também pode monitorizar um repositório específico com o seguinte comando:

   /azrepos subscribe [repository url]
   

   O URL do repositório pode ser para qualquer página no seu repositório que tenha o seu nome de repositório.

   Por exemplo, para repositórios git, utilize:

   /azrepos subscribe https://dev.azure.com/myorg/myproject/_git/myrepository
   

   Para repositórios TFVC, utilize:

   /azrepos subscribe https://dev.azure.com/myorg/myproject/_versionControl
   

   Nota

   Só pode subscrever repositórios públicos.

3. O comando subscrever permite-lhe começar com uma subscrição predefinida. Para os repositórios do Git, o canal é subscrito ao evento criado pelo pedido Pull (com o ramo de destino = master) e, para repositórios TFVC, o canal é subscrito no evento Código verificado.

   

Gerir subscrições

Para ver, adicionar e remover subscrições de um canal, utilize o subscriptions comando:

/azrepos subscriptions    

Este comando lista todas as subscrições atuais do canal e permite-lhe adicionar novas subscrições ou remover as existentes. Ao adicionar subscrições, pode personalizar as notificações que recebe com vários filtros, conforme descrito na secção seguinte.

[! NOTA] Os administradores de equipa não conseguem remover ou modificar subscrições criadas pelos administradores do Project.

Utilizar filtros de forma eficaz para personalizar subscrições

Quando um utilizador subscreve um repositório com /azrepos subscribe o comando, é criada uma subscrição predefinida. Muitas vezes, os utilizadores têm a necessidade de personalizar estas subscrições. Por exemplo, os utilizadores podem querer ser notificados apenas quando os PRs têm um revisor específico.

Os passos seguintes demonstram como personalizar subscrições.

1. Execute o comando /azrepos subscriptions.
2. Na lista de subscrições, se existir uma subscrição indesejada ou tiver de ser modificada (Exemplo: criar ruído no canal), selecione o botão Remover .
3. Selecione o botão Adicionar subscrição .
4. Selecione o repositório necessário e o evento pretendido.
5. Selecione os filtros adequados para personalizar a sua subscrição.

Exemplo: Receber notificações apenas quando a minha equipa estiver na lista de revisores de um PR

Exemplo: Diga-me quando as tentativas de intercalação falham devido a uma violação de política

Nota

• Normalmente, todos os filtros são listas pendentes. No entanto, se o menu pendente tiver mais de 100 itens, é pedido aos utilizadores que introduzam os valores manualmente.
• Para o evento Código TFVC Verificado, o filtro Em caminho tem de ser do formato $/myproject/path.

Pré-visualizações de URLs de pedido Pull

Quando um utilizador cola o URL de um PR, é apresentada uma pré-visualização como a da imagem seguinte. Isto ajuda a manter as conversações relacionadas com o PR contextuais e precisas.

Para que esta funcionalidade funcione, os utilizadores têm de ter sessão iniciada. Assim que tiverem sessão iniciada, esta funcionalidade funcionará para todos os canais numa área de trabalho.

Remover subscrições e repositórios de um canal

• Muitas vezes, os utilizadores querem limpar o canal removendo repositórios e subscrições. Utilize o comando abaixo para obter o mesmo.

    /azrepos unsubscribe all [project url]
  

  Por exemplo:

    /azrepos unsubscribe all https://dev.azure.com/myorg/myproject
  

Este comando eliminará todas as subscrições relacionadas com qualquer repositório no projeto e removerá os repositórios do canal. Apenas os administradores de projetos podem executar este comando.

Referência de comandos

A tabela seguinte lista todas as /azrepos commands funcionalidades que pode utilizar no seu canal do Slack.

Comando Barra	Funcionalidade
/azrepos subscribe [url do repositório/ url do projeto]	Subscrever um repositório ou todos os repositórios num projeto para receber notificações
/azrepos subscriptions	Adicionar ou remover subscrições para este canal
/azrepos signin	Iniciar sessão na sua organização de Repositórios do Azure
/azrepos signout	Terminar sessão na sua organização de Repositórios do Azure
/azrepos feedback	Comunicar um problema ou sugerir uma funcionalidade
/azrepos anular a subscrição de todos [url do projeto]	Remover todos os repositórios (pertencentes a um projeto) e as respetivas subscrições associadas de um canal

Notificações em Canais privados

A aplicação Repositórios do Azure também pode ajudá-lo a monitorizar os eventos do repositório nos seus canais privados. Terá de convidar o bot para o seu canal privado com /invite @azrepos. Publique isto, pode configurar e gerir as suas notificações da mesma forma que faria para um canal público.

Resolução de problemas

Se estiver a deparar-se com os seguintes erros ao utilizar a Aplicação de Repositórios do Azure para Slack, siga os procedimentos nesta secção.

• Ocorreu um problema. Tente novamente.
• A configuração falhou. Certifique-se de que a organização "{organization name}" existe e que tem permissões suficientes.

Ocorreu um problema. Tente novamente.

A aplicação Repositórios do Azure utiliza o protocolo de autenticação OAuth e requer o acesso de aplicações de terceiros através do OAuth para que a organização esteja ativada. Para ativar esta definição, navegue paraPolíticas deSegurança>das Definições> da Organização e defina o acesso da aplicação de terceiros através de OAuth para a definição da organização como Ativado.

A configuração falhou. Certifique-se de que a organização "{organization name}" existe e que tem permissões suficientes.

Termine sessão no Azure DevOps ao navegar para https://aka.ms/VsSignout utilizar o browser.

Abra uma janela do browser Em privado ou incógnito e navegue para https://aex.dev.azure.com/me e inicie sessão. Na lista pendente sob o ícone de perfil à esquerda, selecione o diretório que contém a organização que contém o repositório ao qual pretende subscrever.

No mesmo browser, inicie um novo separador, navegue até https://slack.come inicie sessão no seu espaço de trabalho (utilize o cliente Web). Execute o /azrepos signout comando seguido do /azrepos signin comando .

Selecione o Sign in botão e será redirecionado para uma página de consentimento como a do exemplo seguinte. Certifique-se de que o diretório apresentado ao lado do e-mail é igual ao que foi escolhido no passo anterior. Aceite e conclua o processo de início de sessão.

Se estes passos não resolverem o problema de autenticação, contacte-nos na Comunidade de Programadores.

Artigos relacionados

• Quadros do Azure com o Slack
• Pipelines do Azure com o Slack
• Criar um service hook para o Azure DevOps com o Slack