Condividi tramite

Installazione di estensioni

  • Articolo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Installare, assegnare, disabilitare e disinstallare le estensioni, che aggiungono nuove funzionalità e funzionalità per Azure DevOps.

Per altre informazioni sulle estensioni, vedere le panoramiche sullo sviluppo e la pubblicazione.

Prerequisiti

  • Autorizzazioni: È necessario essere membri del gruppo Amministratori raccolta progetti per installare le estensioni. I proprietari dell'organizzazione sono automaticamente membri di questo gruppo. Se non si dispone delle autorizzazioni, è possibile richiedere estensioni o cercare un amministratore della raccolta di progetti.
  • Condivisione delle estensioni: le estensioni private devono essere condivise con l'organizzazione per poter essere installate. Per ulteriori informazioni sulla condivisione delle estensioni private, consulta la documentazione sulla pubblicazione di .
  • Autorizzazioni: Essere un membro del gruppo Project Collection Administrators o disporre delle autorizzazioni "Modifica informazioni a livello di raccolta". I proprietari dell'organizzazione sono automaticamente membri di questo gruppo. Se non si dispone delle autorizzazioni, è possibile richiedere estensioni o cercare un amministratore della raccolta di progetti.
  • Condivisione dell'estensione: Le estensioni private devono essere condivise con la tua organizzazione per essere installate. Per ulteriori informazioni sulla condivisione delle estensioni private, vedere la documentazione di pubblicazione .

Nota

Per usare una sottoscrizione di Azure esistente per la fatturazione, sono necessarie almeno le autorizzazioni di coamministratore per tale sottoscrizione. Se non si dispone delle autorizzazioni, un amministratore account di Azure o un amministratore del servizio può aggiungere l'utente come coamministratore alla sottoscrizione di Azure nel portale di Azure.

La raccolta di progetti riutilizza la sottoscrizione di Azure per gli acquisti futuri del Marketplace. Dove è possibile trovare altre informazioni sulla fatturazione di Azure?

Installare un'estensione

Installare un'estensione per l'organizzazione seguendo questa procedura.

  1. Accedere all'organizzazione (https://dev.azure.com/{yourorganization}).

  2. Selezionare l'icona del carrello acquisti e quindi selezionare Sfoglia marketplace.

    Screenshot che mostra l'icona del carrello acquisti evidenziata e la selezione del pulsante Sfoglia marketplace.

  3. Trovare l'estensione che si vuole installare e selezionare Scarica gratuitamente.

    Screenshot che mostra l'evidenziazione del quadrato rosso con il pulsante Scarica gratis.

  4. Selezionare l'organizzazione dal menu a discesa e quindi selezionare Installa per installare l'estensione.

    Selezionare l'organizzazione per questa estensione

L'estensione è ora installata. È ora possibile passare all'organizzazione per usare l'estensione. Inoltre, comunicare al team questa estensione, in modo che possano iniziare a usare le relative funzionalità.

Estensione installata

  1. Passare a Marketplace.visualstudio.com.

  2. Accedere usando le credenziali di Azure DevOps.

  3. Trovare l'estensione da installare. Usare la casella di ricerca per filtrare l'elenco delle estensioni.

    Screenshot della selezione di un'estensione.

  4. Selezionare l'estensione e selezionare Scarica o Scarica gratuitamente. In alternativa, per alcune estensioni non Microsoft, selezionare Introduzione per visualizzare le informazioni sui prezzi e le istruzioni di installazione specifiche dell'estensione.

    Screenshot del recupero delle estensioni.

    Se non si dispone dell'autorizzazione per installare l'estensione, è possibile richiedere a un amministratore di installarlo automaticamente. La richiesta viene archiviata in Azure DevOps Server ed è pronta per l'attenzione di un amministratore.

  5. Selezionare Scarica per scaricare il file vsix.

  6. Caricare il vsix nel Marketplace locale. Aprire la home page di Azure DevOps Server (https://{server}:DefaultCollection).

  7. Passare a Impostazioni>raccolta Sfoglia le estensioni locali.

    Screenshot della selezione, pulsante Sfoglia estensioni locali.

  8. Selezionare Gestisci estensioni e quindi Caricare il file vsix.

    Screenshot della selezione, Gestisci estensioni.

  9. Installare l'estensione nella raccolta di progetti nella pagina Gestisci estensioni . Selezionare la raccolta di progetti in cui si vuole installare l'estensione e scegliere Installa.

Screenshot di Selezionare la raccolta di progetti e scegliere Installa.

  1. Al termine dell'installazione, passare alla raccolta di progetti o tornare al Marketplace per trovare altre estensioni.

Screenshot che mostra l'installazione dell'estensione completata.

Disinstallare o disabilitare un'estensione

  1. Accedere all'organizzazione (https://dev.azure.com/{yourorganization}).

  2. Selezionare Icona a forma di ingranaggioImpostazioni organizzazione.

    Screenshot che mostra le impostazioni apri organizzazione.

  3. Selezionare Estensioni e quindi selezionare l'estensione da disinstallare o disabilitare.

    Screenshot che mostra La selezione della disinstallazione o la disabilitazione per l'estensione.

  4. Selezionare Disinstalla o selezionare i puntini di sospensione (...), quindi selezionare Disabilita.

    Screenshot che mostra le azioni di disabilitazione o disinstallazione dell'estensione.

Per disinstallare le estensioni in una raccolta, seguire questa procedura.

  1. Passare al portale di gestione della raccolta locale (http://{server}:8080/tfs/_gallery/manage).

  2. Per l'estensione desiderata, selezionare i puntini di sospensione (...) e quindi selezionare Rimuovi.

    Screenshot che mostra l'azione Rimuovi estensione.

Abilitare o elencare le estensioni tramite la riga di comando

Abilitare un'estensione con il comando az devops extension enable . Per iniziare, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps.

az devops extension enable --extension-name
                           --publisher-name
                           [--org]

Parametri : abilitare l'estensione

  • extension-name: nome dell'estensione da abilitare.
  • publisher-name: nome del server di pubblicazione dell'estensione.
  • org: URL dell'organizzazione di Azure DevOps. Configurare l'organizzazione predefinita con az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o prelevato tramite git config. Esempio: --org https://dev.azure.com/MyOrganizationName/.

Esempio: abilitare l'estensione

Il comando seguente abilita l'estensione Timetracker e mostra il risultato in formato tabella.

az devops extension enable --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       none

Elencare le estensioni

È possibile elencare le estensioni installate nell'organizzazione con il comando az devops extension list . Per iniziare, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps.

az devops extension list [--include-built-in {false, true}]
                         [--include-disabled {false, true}]
                         [--org]

Parametri facoltativi - Estensioni elenco

  • include-built-in: includere le estensioni predefinite. I valori accettati sono true (impostazione predefinita) e false.
  • include-disabled: includere le estensioni disabilitate. I valori accettati sono true (impostazione predefinita) e false.
  • org: URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o prelevato tramite git config. Esempio: --org https://dev.azure.com/MyOrganizationName/.

Esempio - Elencare le estensioni

Il comando seguente elenca le estensioni nell'organizzazione. Esclude le estensioni disabilitate e predefinite e mostra i risultati in formato tabella.

az devops extension list --include-built-in false --include-disabled false -output table

Publisher Id    Extension Id             Name                     Version              Last Updated     States         		 Flags
--------------  -----------------------  -----------------------  -------------------  ---------------  -----------------------  -------
ms              vss-analytics            Analytics                18.160.0.2130149925  2019-11-22       multiVersion, truste...  trusted
ms              vss-code-search          Code Search              18.160.0.1640944814  2019-11-22       multiVersion, truste...  trusted
ms              vss-plans                Delivery Plans           18.160.0.1266795967  2019-11-25       multiVersion, truste...  trusted
ms-eswm         dependencytracker        Dependency Tracker       2.1910.12801         2019-10-28       none
ms-devlabs      workitem-feature-tim...  Feature timeline and...  0.0.357              2019-10-14       none
AgileParts      gantt                    GANTT chart              1.0.79               2019-10-25       none
gordon-bee...   github                   GitHub Widget            0.10.0               2016-03-16       none
ms-devlabs      vsts-extensions-mult...  Multivalue control       2.2.26               2019-11-15       none
agile-exte...   product-vision           Product Vision           2.0.6                2019-06-04       none
mohitbagra      related-workitems        Related Work items       2.0.4                2017-11-12       none
YodLabs         TagsManager2             Tags Manager             0.9.31               2019-02-04       none
ms-devlabs      team-calendar            Team Calendar            2.0.15               2019-11-01       none
ms              vss-testmanager-web      Test Manager for TFS...  18.160.0.2130893445  2019-11-25       multiVersion, truste...  trusted
mmanela         vsts-workitem-recent...  Who recently viewed ...  1.0.4                2019-03-22       none
ottostreif...   wiql-editor              Wiql Editor              2.0.90               2019-06-21       none
mohitbagra      workitem-checklist       Work item checklist      3.2.4                2019-06-24       none
mohitbagra      witoneclickactions       Work item form one c...  2.3.2                2018-04-03       none
ms-devlabs      WorkItemVisualizatio...  Work Item Visualizat...  1.4.64               2018-04-03       none

Elencare le informazioni sull'estensione

È possibile elencare i dettagli di un'estensione con il comando az devops extension show . Per iniziare, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps.

az devops extension show --extension-name
                         --publisher-name
                         [--org]

Parametri - Informazioni sull'estensione dell'elenco

  • extension-name: nome dell'estensione.
  • publisher-name: nome del server di pubblicazione dell'estensione.
  • org: URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o prelevato tramite git config. Esempio: --org https://dev.azure.com/MyOrganizationName/.

Esempio : informazioni sull'estensione elenco

Il comando seguente mostra informazioni sull'estensione Timetracker in formato tabella.

az devops extension show --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       disabled

Risolvere i problemi di installazione dell'estensione

Per risolvere i problemi comuni, seguire questa procedura di risoluzione dei problemi:

  • L'estensione non si installa:

    • Controllare le autorizzazioni: Assicurarsi di avere le autorizzazioni necessarie per installare le estensioni. È necessario essere un amministratore della raccolta di progetti o disporre delle autorizzazioni necessarie concesse da un amministratore.
    • Verificare la compatibilità delle estensioni: Assicurarsi che l'estensione sia compatibile con la versione di Azure DevOps. Per informazioni sulla compatibilità, vedere la pagina dei dettagli dell'estensione.
    • Problemi di rete: Verificare che la connessione di rete sia stabile e che non siano presenti impostazioni firewall o proxy che bloccano il processo di installazione.

  • l'estensione si arresta in modo anomalo o causa errori:

    • Raccogliere informazioni di diagnostica: Se un'estensione si arresta in modo anomalo o causa errori, raccogliere informazioni di diagnostica per identificare il problema. Queste informazioni includono messaggi di errore, log e screenshot del problema.
    • Controllare i log delle estensioni: Alcune estensioni forniscono log che consentono di diagnosticare i problemi. Per informazioni su come accedere e interpretare questi log, vedere la documentazione dell'estensione.
    • Contattare il supporto tecnico: Se non è possibile risolvere il problema, contattare il team di supporto dell'estensione con le informazioni di diagnostica raccolte. Fornire il maggior numero di dettagli possibile per aiutarli a risolvere il problema.

  • Estensione non visibile dopo l'installazione:

    • Aggiornare la pagina: A volte, l'estensione potrebbe non essere visualizzata immediatamente dopo l'installazione.
    • Controllare le autorizzazioni: Assicurarsi di disporre delle autorizzazioni necessarie per visualizzare e usare l'estensione. Alcune estensioni potrebbero richiedere autorizzazioni specifiche per essere visibili.
    • Reinstallare l'estensione: Se l'estensione non è ancora visibile, provare a disinstallarla e reinstallarla.

Domande frequenti

D: Perché l'organizzazione non viene visualizzata dalla pagina di installazione del Marketplace?

R: Se l'organizzazione non viene visualizzata durante l'acquisto da Azure DevOps Marketplace, provare la procedura seguente:

  1. Controllare l'identità usata per accedere a Visual Studio Marketplace. Nell'angolo superiore destro selezionare il nome utente per visualizzare il profilo.
  2. Assicurarsi che l'indirizzo di posta elettronica e la directory siano corretti.
  3. Chiudere tutte le finestre del browser.
  4. Aprire una sessione di esplorazione privata o in incognito.
  5. Accedere a Visual Studio Marketplace. Usare l'identità di un utente nell'organizzazione desiderata.

Suggerimento

Azure DevOps potrebbe chiedere di scegliere tra "account aziendale o dell'istituto di istruzione" o "account personale". In tal caso, è stato usato un indirizzo di posta elettronica identico per un account Microsoft e un "account aziendale o dell'istituto di istruzione" gestito dall'organizzazione in Microsoft Entra ID. Anche se queste identità hanno lo stesso indirizzo di posta elettronica, sono comunque identità separate con profili, impostazioni di sicurezza e autorizzazioni diversi. Scegliere l'identità per l'utente nell'organizzazione da selezionare.

D: Perché non è possibile installare un'estensione?

R: Non è possibile installare le estensioni per uno dei motivi seguenti.

  • Essere parte del gruppo amministratori della raccolta di progetti o il proprietario dell'organizzazione . Se non si dispone delle autorizzazioni, ma si è membri del progetto, è possibile richiedere le estensioni .
  • Per un errore "già installato o richiesto", rivolgersi all'amministratore della raccolta di progetti e chiedere loro di assegnare l'estensione.

D: Perché gli utenti non possono accedere alle funzionalità dell'estensione?

R: Gli utenti non possono accedere a un'estensione per uno dei motivi seguenti.

  • La maggior parte delle estensioni richiede che gli utenti abbiano almeno l'accesso Basic, non stakeholder. Ad esempio, è possibile installare l'estensione free Code Search, ma ogni utente deve avere almeno l'accesso Basic per cercare il codice. Per aiutare il team a migliorare la qualità delle app, è possibile installare l'estensione test e feedback gratuita. Si riscontrano funzionalità diverse, in base al livello di accesso e al funzionamento offline o connessi ad Azure DevOps Services o a Azure DevOps Server locale. Per altre informazioni, vedere la descrizione dell'estensione nella scheda Visual Studio Marketplace, Azure DevOps.

  • Se si usa un'organizzazione e si è avviata una versione di valutazione gratuita dell'estensione, la versione di valutazione potrebbe essere scaduta. Controllare se la versione di valutazione è scaduta.

    1. Sulla barra degli strumenti dell'organizzazione selezionare Utenti.
    2. Passare al riquadro dell'estensione.
    3. Verificare la presenza di un messaggio di scadenza per trovare se o quando l'estensione è scaduta.

  • Se si usa un'organizzazione e si paga per questa estensione, assicurarsi di aver assegnato questa estensione agli utenti.

    1. Sulla barra degli strumenti dell'organizzazione passare a Utenti.
    2. Passare al riquadro dell'estensione.
    3. Controllare se l'estensione è assegnata all'utente. In caso contrario, assegnare l'estensione all'utente.

Per altre informazioni, vedere Assegnare estensioni agli utenti.

D: Cosa è successo all'estensione di anteprima?

R: L'estensione potrebbe non essere disponibile in anteprima. Dopo un periodo di anteprima, un'estensione più lunga è disponibile a livello generale come estensione a pagamento. Un periodo di tolleranza potrebbe essere offerto prima di dover acquistare l'estensione. Tutte le estensioni di anteprima vengono convertite automaticamente in una versione di valutazione gratuita prima di dover acquistare l'estensione.

D: Perché non è possibile installare le estensioni per Azure DevOps Server?

R: Non è possibile installare le estensioni per Azure DevOps Server per uno dei motivi seguenti:

  • Essere membri del gruppo Amministratori raccolta progetti o disporre dell'autorizzazione modifica informazioni di livello raccolta impostata su Consenti nella raccolta di progetti dove si desidera installare estensioni. Se non si dispone delle autorizzazioni, è possibile richiedere invece le estensioni .
  • È possibile che venga visualizzato un errore che indica che l'estensione è già stata installata o richiesta. In tal caso, rivolgersi a un membro del gruppo Project Collection Administrators e chiedere loro di assegnare l'estensione. Per altre informazioni, vedere Richiedere un aumento dei livelli di autorizzazione.

D: Perché non viene visualizzata la raccolta di progetti desiderata (locale)?

R: Essere un membro della raccolta di progetti. Seguire questa procedura per verificare l'identità usata per accedere al Marketplace.

  1. Nella home page del portale Web di Azure DevOps Server (https://{server}:8080/tfs/) passare all'angolo superiore destro della pagina e selezionare il nome utente per visualizzare il profilo.
  2. Sul lato sinistro del profilo assicurarsi che l'indirizzo di posta elettronica e la directory siano corretti.
  3. Chiudere tutte le finestre del browser.
  4. Aprire una sessione di esplorazione privata o in incognito.
  5. Accedere alla home page di Azure DevOps Server (https://{server}:8080/tfs/) con l'identità di un utente nella raccolta di progetti in cui si vuole installare l'estensione.

Azure DevOps potrebbe chiedere di scegliere tra un"organizzazione aziendale o dell'istituto di istruzione" o un "account personale". Questo messaggio indica che è stato usato un indirizzo di posta elettronica identico per un account Microsoft e un "account aziendale o dell'istituto di istruzione" gestito dall'organizzazione in Microsoft Entra ID. Anche se queste identità hanno lo stesso indirizzo di posta elettronica, sono comunque identità separate con profili, impostazioni di sicurezza e autorizzazioni diversi. Scegliere l'identità dell'utente nella raccolta di progetti.

  1. Dalla raccolta di progetti passare al Marketplace.

D: Perché l'estensione che voglio visualizzare un pulsante di download (locale)?

R: Alcune estensioni funzionano solo con Azure DevOps Services per uno dei motivi seguenti:

  • L'estensione usa le funzionalità di Azure DevOps non ancora rilasciate per Azure DevOps Server.
  • Il manifesto dell'estensione indica che l'estensione è disponibile solo per Azure DevOps Services (destinazioni = Microsoft.Visualstudio.Services.Cloud).
  • Il manifesto dell'estensione indica che l'estensione è un'integrazione (targets = Microsoft.Visualstudio.Services.Integration).

D: Perché non è possibile caricare le estensioni in Azure DevOps Server?

R: Essere un membro del gruppo amministratori di Team Foundation. È anche necessario disporre delle autorizzazioni di modifica delle informazioni a livello di istanza per azure DevOps Server in cui si vogliono caricare le estensioni.

Passaggi successivi

Gestire autorizzazioni estensioni