Usare Azure Pipelines con Microsoft Teams

  • Articolo

Servizi di Azure DevOps

L'app Azure Pipelines per Microsoft Teams consente di monitorare gli eventi per le pipeline. È possibile configurare e ricevere notifiche nel canale di Teams per le versioni, le approvazioni in sospeso, le compilazioni completate e così via. È anche possibile approvare le versioni dal canale di Teams.

Nota

Questa funzionalità è disponibile solo in Azure DevOps Services. In genere, le nuove funzionalità vengono introdotte prima nel servizio cloud e quindi rese disponibili in locale nella versione principale successiva o nell'aggiornamento di Azure DevOps Server. Per altre informazioni, vedere Sequenza temporale delle funzionalità di Azure DevOps.

Prerequisiti

  • È necessario avere un progetto Azure DevOps. Per ulteriori informazioni, vedere Creare un progetto.
  • Per configurare le sottoscrizioni della pipeline, è necessario essere un Amministrazione istrator di Project.

Configurare l'app Azure Pipelines

  1. In Microsoft Teams passare all'Archivio app , cercare Azure Pipelines e quindi selezionare Azure Pipelines.

    Screenshot della selezione del pulsante App, quindi del pulsante Azure Pipelines.

  2. Selezionare la freccia a discesa Apri e quindi selezionare Aggiungi a un team.

    Screenshot della selezione del pulsante Apri e quindi del pulsante Aggiungi a un team.

  3. Selezionare o immettere il nome del team e quindi scegliere Configura un bot.

    Selezionare il pulsante Configura un bot.

  4. Nel riquadro della conversazione di Teams immettere @azurePipelines signin.

  5. Selezionare Accedi e completare l'autenticazione ad Azure Pipelines.

Usare i comandi

Usare i comandi seguenti per monitorare tutte le pipeline in un progetto o solo pipeline specifiche.

  • Monitorare tutte le pipeline in un progetto. L'URL può essere in qualsiasi pagina all'interno del progetto, ad eccezione degli URL delle pipeline. Ad esempio: @azure pipelines subscribe https://dev.azure.com/myorg/myproject/.

    @azure pipelines subscribe [project url]

  • Monitorare una pipeline specifica: l'URL della pipeline può essere in qualsiasi pagina all'interno della pipeline con o definitionIdbuildId/releaseId presente nell'URL. Ad esempio: @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123.

    @azure pipelines subscribe [pipeline url]

    Un altro esempio di pipeline di versione sottoscritta per la distribuzione del rilascio avviata, la distribuzione del rilascio completata e l'approvazione della distribuzione di rilascio in sospeso è @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases.

Nota

  • Non sono supportate le approvazioni di distribuzione che hanno applicato l'identità riconvalida del responsabile approvazione prima di completare i criteri di approvazione .
  • Abilitare l'accesso alle applicazioni di terze parti tramite OAuth per ricevere notifiche per l'organizzazione in Azure DevOps.

Gestire le sottoscrizioni

Quando si sottoscrive una pipeline, alcune sottoscrizioni vengono create per impostazione predefinita senza filtri applicati. È possibile personalizzare queste sottoscrizioni. Ad esempio, è possibile ricevere una notifica solo quando le compilazioni hanno esito negativo o quando le distribuzioni vengono push in un ambiente di produzione. L'app Azure Pipelines supporta filtri per personalizzare ciò che viene visualizzato nel canale. Per gestire le sottoscrizioni, seguire questa procedura.

  1. Eseguire il comando @azure pipelines subscriptions.

  2. Selezionare Visualizza tutte le sottoscrizioni. Nell'elenco delle sottoscrizioni, se è presente una sottoscrizione che non si vuole, selezionare Rimuovi. Visualizzazione dell'elenco di sottoscrizioni.

  3. Scorrere verso il basso e selezionare Aggiungi sottoscrizione.

  4. Selezionare la pipeline e l'evento necessari.

  5. Selezionare i filtri appropriati e quindi Salva.

    Esempio 1: Ottenere notifiche per le compilazioni non riuscite.

    Oggetto visivo degli errori di compilazione in Teams.

    Esempio 2: Ottenere notifiche solo se le distribuzioni vengono inviate all'ambiente di produzione.

    Oggetto visivo della notifica di errore.

    Nota

    • I Amministrazione istrator del team non possono rimuovere o modificare le sottoscrizioni create da Project Amministrazione istrators.
    • Le notifiche non sono supportate all'interno di messaggi diretti/chat.

Approvare le distribuzioni dal canale

È possibile approvare le distribuzioni dal canale senza passare al portale di Azure Pipelines. Sottoscrivere la notifica di approvazione della distribuzione del rilascio in sospeso per le versioni classiche o la fase Di esecuzione in attesa della notifica di approvazione per le pipeline YAML. Entrambe queste sottoscrizioni vengono create per impostazione predefinita quando si sottoscrive la pipeline.

In Teams, si noti che è pronto per l'approvazione.

Ogni volta che l'esecuzione di una fase è in attesa di approvazione, una scheda di notifica con opzioni per approvare o rifiutare la richiesta viene pubblicata nel canale. I responsabili approvazione possono esaminare i dettagli della richiesta nella notifica e intervenire in modo appropriato. Nell'esempio seguente la distribuzione è stata approvata e lo stato dell'approvazione viene visualizzato nella scheda.

Scheda che mostra la distribuzione approvata.

L'app Azure Pipelines supporta tutti gli scenari di controllo e approvazione presenti nel portale di Azure Pipelines. È possibile approvare le richieste come utente singolo o per un team.

Cercare e condividere le informazioni sulla pipeline usando l'estensione compose

Per consentire agli utenti di cercare e condividere informazioni sulle pipeline, l'app Azure Pipelines per Microsoft Teams supporta l'estensione compose. È ora possibile cercare le pipeline in base all'ID pipeline o al nome della pipeline. Per consentire il funzionamento dell'estensione compose, gli utenti devono accedere al progetto di Azure Pipelines a cui sono interessati eseguendo @azure pipelines signin il comando o eseguendo direttamente l'accesso all'estensione compose.

Componi estensione.

Anteprime degli URL della pipeline

Quando si aggiunge un URL della pipeline a Teams, viene visualizzata un'anteprima simile alle immagini seguenti. L'anteprima consente di mantenere aggiornate e pertinenti le conversazioni correlate alla pipeline. È possibile scegliere tra schede compattate ed espanse.

Esempio 1: Anteprima dell'URL di compilazione

Creazione di un'istanza dell'URL.

Esempio 2: anteprima dell'URL di rilascio

Annullamento della furling dell'URL di rilascio.

Dopo aver eseguito l'accesso, questa funzionalità funziona per tutti i canali di un team in Microsoft Teams.

Annullare la sottoscrizione a un canale della pipeline

Usare il comando seguente per annullare la sottoscrizione a tutte le pipeline all'interno di un progetto.

@azure pipelines unsubscribe all [project url]

Esempio: Annullare la sottoscrizione a tutti con URL

@azure pipelines unsubscribe all https://dev.azure.com/myorg/myproject

Questo comando elimina tutte le sottoscrizioni correlate a qualsiasi pipeline nel progetto e rimuove le pipeline dal canale.

Importante

Solo Project Amministrazione istrators può eseguire questo comando.

Tutte le notifiche collegate a una determinata esecuzione di una pipeline vengono collegate insieme.

Esempio 1: visualizzazione compatta delle notifiche collegate.

Thread compatto

Esempio 2: visualizzazione espansa delle notifiche collegate.

Thread espanso

Usare i comandi nell'app Azure Pipelines

Vedere i comandi seguenti supportati dall'app Azure Pipelines:

Comando barra Funzionalità
@azure le pipeline sottoscrivono [URL pipeline/URL progetto] Sottoscrivere una pipeline o tutte le pipeline in un progetto per ricevere notifiche
@azure sottoscrizioni di pipeline Aggiungere o rimuovere sottoscrizioni per questo canale
@azure commenti e suggerimenti sulle pipeline Segnalare un problema o suggerire una funzionalità
@azure Guida alle pipeline Ottenere informazioni sui comandi della barra
@azure accesso alle pipeline Accedere all'account Azure Pipelines
@azure signout delle pipeline Disconnettersi dall'account Azure Pipelines
@azure le pipeline annullano la sottoscrizione a tutti [URL progetto] Rimuovere tutte le pipeline (appartenenti a un progetto) e le relative sottoscrizioni associate da un canale

Connessione multi-tenant

Se si usa un altro tenant o posta elettronica per Microsoft Teams e Azure DevOps, seguire questa procedura per accedere e connettersi in base al caso d'uso.

Caso d'uso ID e tenant di posta elettronica in Microsoft Teams ID e tenant di posta elettronica in Azure DevOps Azione di accesso
1 email1@abc.com (tenant 1) email1@abc.com (tenant 1) Seleziona Accedi
2 email1@abc.com (tenant 1) email2@pqr.com (tenant 2) - Accedere ad Azure DevOps.
- Nello stesso browser avviare una nuova scheda e passare a https://teams.microsoft.com/.
- Eseguire il sign in comando e selezionare Accedi.
3 email1@abc.com (tenant 1) email2@pqr.com (tenant 2) - Selezionare Accedi con un indirizzo di posta elettronica diverso.
- Nella selezione ID di posta elettronica usare email2 per accedere.
4 email1@abc.com (tenant 1) email2@pqr.com (tenant non predefinito 3) Attualmente non supportato.

Risoluzione dei problemi

Nello stesso browser avviare una nuova scheda e accedere a https://teams.microsoft.com/. Eseguire il @Azure Pipelines signout comando e quindi eseguire il @Azure Pipelines signin comando nel canale in cui è installata l'app Azure Pipelines per Microsoft Teams.

Selezionare il Sign in pulsante e si viene reindirizzati a una pagina di consenso come quella nell'esempio seguente. Assicurarsi che la directory visualizzata accanto al messaggio di posta elettronica corrisponda a quella scelta nel passaggio precedente. Accettare e completare il processo di accesso.

Consenso alle autorizzazioni dell'app richieste

Se questi passaggi non risolvono il problema di autenticazione, contattare Microsoft all'indirizzo Developer Community.