Azure Repos con Slack

  • Articolo

Servizi di Azure DevOps

Se si usa Slack, è possibile usare l'app Azure Repos per Slack per monitorare facilmente i repository di Azure Repos. Configurare e gestire le sottoscrizioni per ricevere notifiche nel canale ogni volta che viene eseguito il push o l'archiviazione del codice e ogni volta che viene creata, aggiornata o unita una richiesta pull. Questa app supporta sia gli eventi Git che quelli di controllo della versione di Team Foundation.

Prerequisiti

Nota

  • Al momento è possibile collegare l'app Azure Repos per Slack a un progetto ospitato in Azure DevOps Services.
  • Le notifiche non sono attualmente supportate all'interno di messaggi diretti.

Aggiungere l'app Azure Repos all'area di lavoro slack

  1. Passare all'app Slack Azure Repos e selezionare Aggiungi a Slack.

    Screenshot della directory dell'app Slack, del pulsante Azure Repos e del pulsante Aggiungi a Slack.

    Dopo l'aggiunta, viene visualizzato un messaggio simile al seguente.

    Screenshot del messaggio di benvenuto da Slack.

  2. Usare l'handle /azrepos Slack per interagire con l'app. Un elenco completo dei comandi è disponibile nella sezione Informazioni di riferimento sui comandi di questo articolo.

Connessione'app Azure Repos ai repository

  1. Connessione e autenticarsi in Azure Repos usando il /azrepos signin comando .

    Screenshot della richiesta di accesso per Slack.

  2. Fare clic su Accedi.

  3. Accettare l'integrazione di Slack di Azure Repos.

    Screenshot del pulsante Accetta nella schermata di accesso risultante.

    Viene visualizzato un codice di verifica da usare nell'app di chat per completare l'autenticazione.

  4. Copiare il codice di autenticazione.

    Screenshot del codice di verifica fornito da Azure Repos.

  5. Selezionare Invio codice, incollare il codice e quindi selezionare Invia.

    Screenshot della schermata di autenticazione finale quando il codice di verifica viene incollato e quindi viene selezionato il pulsante Invia.

    La conferma dell'accesso viene visualizzata all'interno della chat.

    Screenshot della conferma dell'accesso nella chat.

Per avviare il monitoraggio di tutti i repository Git in un progetto, usare il comando barra seguente all'interno di un canale:

/azrepos subscribe [project url]

L'URL del progetto può essere in qualsiasi pagina all'interno del progetto (ad eccezione degli URL ai repository). Ad esempio:

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

È anche possibile monitorare un repository specifico usando il comando seguente:

/azrepos subscribe [repository url]

L'URL del repository può essere in qualsiasi pagina all'interno del repository con il nome del repository. Ad esempio, per i repository Git, usare:

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

Per i repository TFVC, usare:

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

Nota

È possibile sottoscrivere solo i repository pubblici.

Il comando subscribe consente di iniziare a usare una sottoscrizione predefinita. Per i repository Git, il canale viene sottoscritto all'evento creato dalla richiesta pull (con ramo di destinazione = main) e per i repository TFVC, il canale viene sottoscritto all'evento Code archiviato.

Screenshot che mostra il messaggio di creazione delle sottoscrizioni predefinite.

Gestire le sottoscrizioni

Per visualizzare, aggiungere o rimuovere sottoscrizioni per un canale, usare il comando seguente subscriptions :

/azrepos subscriptions

Questo comando elenca tutte le sottoscrizioni correnti per il canale e consente di aggiungere nuove sottoscrizioni o rimuovere quelle esistenti. Quando si aggiungono sottoscrizioni, è possibile personalizzare le notifiche ricevute usando vari filtri, come descritto nella sezione seguente.

Nota

Gli amministratori del team non possono rimuovere o modificare le sottoscrizioni create dagli amministratori di Project.

Screenshot che mostra l'elenco Visualizza sottoscrizioni.

Usare i filtri per personalizzare le sottoscrizioni

Quando un utente sottoscrive un repository usando il /azrepos subscribe comando , viene creata una sottoscrizione predefinita. Spesso, gli utenti devono personalizzare queste sottoscrizioni. Ad esempio, gli utenti potrebbero voler ricevere una notifica solo quando le richieste pull hanno un revisore specifico.

La procedura seguente illustra come personalizzare le sottoscrizioni.

  1. Eseguire il comando /azrepos subscriptions.
  2. Nell'elenco delle sottoscrizioni, se è presente una sottoscrizione indesiderata o che deve essere modificata (ad esempio: creazione di rumore nel canale), selezionare il pulsante Rimuovi .
  3. Selezionare il pulsante Aggiungi sottoscrizione .
  4. Selezionare il repository richiesto e l'evento desiderato.
  5. Selezionare i filtri appropriati.

Esempio: Ottenere notifiche solo quando il team è nell'elenco dei revisori per una richiesta pull

Screenshot che mostra che Il revisore ha il mio team.

Esempio: indica quando i tentativi di unione hanno esito negativo a causa di una violazione dei criteri

Screenshot che mostra il tentativo di merge non riuscito a causa di una violazione dei criteri.

Nota

  • Tutti i filtri sono in genere elenchi a discesa. Tuttavia, se l'elenco a discesa ha più di 100 elementi, gli utenti devono immettere manualmente i valori.
  • Per l'evento Di controllo del codice tfvc archiviato , il filtro In percorso deve essere del formato $/myproject/path.

Anteprima degli URL delle richieste pull

Quando un utente incolla l'URL di una richiesta pull, viene visualizzata un'anteprima simile all'immagine seguente, che consente di mantenere contestuali e accurate le conversazioni correlate alla richiesta pull.

Screenshot che mostra l'annullamento della creazione di URL.

Dopo l'accesso degli utenti, questa funzionalità funziona per tutti i canali in un'area di lavoro.

Rimuovere sottoscrizioni e repository da un canale

Usare il comando seguente per pulire il canale rimuovendo repository e sottoscrizioni.

/azrepos unsubscribe all [project url]

Ad esempio, il comando seguente elimina tutte le sottoscrizioni correlate a qualsiasi repository nel progetto e rimuove i repository dal canale. Solo gli amministratori del progetto possono eseguire questo comando.

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

Informazioni di riferimento sui comandi

Nella tabella seguente sono elencati tutti gli /azrepos commands elementi che è possibile usare nel canale Slack.

Comando barra Funzionalità
/azrepos subscribe [repository url/ project url] Sottoscrivere un repository o tutti i repository in un progetto per le notifiche
/azrepos subscriptions Aggiungere o rimuovere sottoscrizioni per questo canale
/azrepos signin Accedere all'organizzazione di Azure Repos
/azrepos signout Disconnettersi dall'organizzazione azure Repos
/azrepos feedback Segnalare un problema o suggerire una funzionalità
/azrepos unsubscribe all [project url] Rimuovere tutti i repository (appartenenti a un progetto) e le sottoscrizioni associate da un canale

Notifiche nei canali privati

L'app Azure Repos consente di monitorare anche gli eventi del repository nei canali privati. Invitare il bot al canale privato usando /invite @azrepos. È quindi possibile gestire le notifiche nello stesso modo in cui si farebbe per un canale pubblico.

Risoluzione dei problemi

Se si verificano gli errori seguenti quando si usa l'app Azure Repos per Slack, seguire le procedure descritte in questa sezione.

Si è verificato un errore. Riprova.

L'app Azure Repos usa il protocollo di autenticazione OAuth e richiede l'accesso dell'applicazione di terze parti tramite OAuth per l'abilitazione dell'organizzazione . Per abilitare questa impostazione, passare a Organizzazione Impostazioni> Criteni di sicurezza>e impostare l'accesso dell'applicazione di terze parti tramite OAuth per l'impostazione dell'organizzazione su Sì.

Abilitare l'accesso all'applicazione di terze parti tramite OAuth per l'impostazione dell'organizzazione

Configurazione non riuscita. Assicurarsi che l'organizzazione '{nome organizzazione}' esista e che si disponga di autorizzazioni sufficienti.

Disconnettersi da Azure DevOps passando a https://aka.ms/VsSignout usando il browser.

Aprire una finestra del browser in incognito o privata e passare a https://aex.dev.azure.com/me e accedere. Nell'elenco a discesa sotto l'icona del profilo a sinistra selezionare la directory che contiene l'organizzazione contenente il repository a cui si vuole eseguire la sottoscrizione.

Selezionare la directory che contiene l'organizzazione che contiene il progetto

Nello stesso browser avviare una nuova scheda, passare a https://slack.come accedere allo spazio di lavoro (usare il client Web). Eseguire il /azrepos signout comando seguito dal /azrepos signin comando .

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.

Screenshot che mostra il consenso per le autorizzazioni dell'app richieste.

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