Creare e gestire pool di agenti

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

Un pool di agenti è una raccolta di agenti. Invece di gestire ogni agente singolarmente, è possibile organizzare gli agenti in pool di agenti. Quando si configura un agente, viene registrato con un singolo pool e, quando si crea una pipeline, si specifica il pool in cui viene eseguita la pipeline. Quando si esegue la pipeline, viene eseguita su un agente da tale pool che soddisfa le esigenze della pipeline.

Nota

I pool di agenti di Pool DevOps gestiti vengono gestiti nel portale di Azure. Se si usano pool DevOps gestiti, vedere Creare il primo pool DevOps gestito.

In Azure Pipelines i pool hanno come ambito l'intera organizzazione; in modo da poter condividere i computer agente tra progetti.

Nota

I processi del pool di agenti eseguono un processo in un singolo agente. Se è necessario eseguire un processo in tutti gli agenti, ad esempio un gruppo di distribuzione per le pipeline di versione classiche, vedere Effettuare il provisioning dei gruppi di distribuzione.

Gli amministratori dell'organizzazione creano e gestiscono i pool di agenti dalla scheda Pool di agenti nelle impostazioni di amministrazione.

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

2. Scegliere Azure DevOps, Impostazioni organizzazione.

   

3. Scegliere Pool di agenti.

   

Se si è membri del team di progetto, creare e gestire i pool di agenti dalla scheda Pool di agenti nelle impostazioni del progetto.

Passare al progetto e scegliere Impostazioni progetto, Pool di agenti.

Pool di agenti predefiniti

Per impostazione predefinita, vengono forniti i pool di agenti seguenti:

• Pool predefinito : usarlo per registrare gli agenti self-hosted configurati.

• Pool ospitato di Azure Pipelines con varie immagini Windows, Linux e macOS. Per un elenco completo delle immagini disponibili e del relativo software installato, vedere Agenti ospitati da Microsoft.

  Nota

  Il pool ospitato di Azure Pipelines sostituisce i pool ospitati precedenti con nomi mappati alle immagini corrispondenti. Tutti i processi presenti nei pool ospitati precedenti vengono reindirizzati automaticamente all'immagine corretta nel nuovo pool ospitato di Azure Pipelines. In alcune circostanze, è comunque possibile visualizzare i nomi dei pool precedenti, ma in background i processi ospitati vengono eseguiti usando il pool di Azure Pipelines. Per altre informazioni, vedere le note sulla versione del pool ospitato singolo dalle note sulla versione del 1° luglio 2019 - Sprint 154.

Per impostazione predefinita, tutti i collaboratori di un progetto sono membri del ruolo Utente nei pool ospitati. Ciò consente a ogni collaboratore di un progetto di creare ed eseguire pipeline usando agenti ospitati da Microsoft.

Designare un pool nella pipeline

YAML

Per scegliere un agente ospitato da Microsoft dal pool di Azure Pipelines nella pipeline YAML di Azure DevOps Services, specificare il nome dell'immagine usando l'etichetta dell'immagine della macchina virtuale YAML da questa tabella.

pool:
  vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.

Per usare un pool privato senza richieste:

pool: MyPool

Per altre informazioni, vedere lo schema YAML per i pool.

Classico

Per scegliere un pool e un agente nell'editor classico, passare alle impostazioni della pipeline, selezionare il pool di agenti desiderato e quindi l'immagine desiderata dall'elenco a discesa Specifica agente. La specifica dell'agente predefinita è windows-2019. Per altre informazioni sul software installato nelle immagini ospitate da Microsoft, vedere la voce corrispondente nella colonna Pool di editor classici di questa tabella.

Gestire pool e code

Interfaccia utente di Azure Pipelines

Gli amministratori dell'organizzazione creano e gestiscono i pool di agenti dalla scheda Pool di agenti nelle impostazioni di amministrazione.

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

2. Scegliere Azure DevOps, Impostazioni organizzazione.

   

3. Scegliere Pool di agenti.

   

Se si è membri del team di progetto, creare e gestire i pool di agenti dalla scheda Pool di agenti nelle impostazioni del progetto.

Passare al progetto e scegliere Impostazioni progetto, Pool di agenti.

Per eliminare un pool, passare all'elenco Pool di agenti , scegliere Altre opzioni, Elimina.

Interfaccia della riga di comando di Azure DevOps

Elencare i pool | di agenti Mostra i dettagli | del pool di agenti Elencare le code degli | agenti Mostra i dettagli della coda dell'agente

Nota

In questo momento è possibile visualizzare informazioni sui pool di agenti e sulle code, ma non modificarli, usando l'interfaccia della riga di comando di Azure.

Se è la prima volta che si usano az devops pipelines i comandi, vedere Introduzione all'interfaccia della riga di comando di Azure DevOps.

Elencare i pool di agenti

az pipelines pool list [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]
                       [--pool-name]
                       [--pool-type {automation, deployment}]

Parametri

• action: filtrare l'elenco con l'azione dell'utente consentita. Valori accettati: manage, none, use
• detect: rileva automaticamente l'organizzazione. Valori accettati: false, true
• organizzazione o organizzazione: 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 selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.
• pool-name: filtrare l'elenco con il nome del pool corrispondente.
• pool-type: filtrare l'elenco con il tipo di pool. Valori accettati: automazione, distribuzione

Esempio

Nell'esempio seguente vengono elencati tutti i pool in formato tabella. In questo esempio viene usata la configurazione predefinita seguente: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines pool list --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
1     Default                          False        automation
2     Hosted                           True         automation
3     Hosted VS2017                    True         automation
4     Hosted Windows 2019 with VS2019  True         automation
5     Hosted Windows Container         True         automation
6     Hosted macOS                     True         automation
7     Hosted macOS High Sierra         True         automation
8     Hosted Ubuntu 1604               True         automation
9     Azure Pipelines                  True         automation
10    MyAgentPool                      False        automation

Visualizzare i dettagli del pool di agenti

az pipelines pool show --id
                       [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]

Parametri

• id o pool-id: ID (obbligatorio) del pool per elencare i dettagli.
• action: filtrare l'elenco con l'azione dell'utente consentita. Valori accettati: manage, none, use
• detect: rileva automaticamente l'organizzazione. Valori accettati: false, true
• organizzazione o organizzazione: 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 selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

Esempio

Nell'esempio seguente vengono visualizzati i dettagli del pool per il pool Ospitato di Windows 2019 con il pool VS2019. In questo esempio viene usata la configurazione predefinita seguente: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines pool show --id 4

{
  "agentCloudId": 1,
  "autoProvision": true,
  "autoSize": null,

  <Some properties omitted for space>

  "poolType": "automation",
  "properties": null,
  "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
  "size": 1,
  "targetSize": 1
}

È anche possibile usare --output table che restituisce le stesse informazioni del list comando.

az pipelines pool show --id 4 --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
4     Hosted Windows 2019 with VS2019  True         automation

Elencare le code degli agenti

az pipelines queue list [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--queue-name]

Parametri

• action: filtrare l'elenco con l'azione dell'utente consentita. Valori accettati: manage, none, use
• detect: rileva automaticamente l'organizzazione. Valori accettati: false, true
• organizzazione o organizzazione: 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 selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.
• project o p: nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.
• queue-name: filtrare l'elenco con il nome della coda corrispondente regex, ad esempio ubuntu per la coda con nome 'Hosted Ubuntu 1604'.

Esempio

Nell'esempio seguente vengono elencate tutte le code in formato tabella. In questo esempio viene usata la configurazione predefinita seguente: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines queue list --output table
This command group is in preview. It may be changed/removed in a future release.
ID    Name                             Pool IsHosted    Pool Type
----  -------------------------------  ---------------  -----------
11    Default                          False            automation
12    Hosted                           True             automation
13    Hosted VS2017                    True             automation
14    Hosted Windows 2019 with VS2019  True             automation
15    Hosted Windows Container         True             automation
16    Hosted macOS                     True             automation
17    Hosted macOS High Sierra         True             automation
18    Hosted Ubuntu 1604               True             automation
19    Azure Pipelines                  True             automation

Visualizzare i dettagli della coda dell'agente

az pipelines queue show --id
                        [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]

Parametri

• id o queue-id: ID della coda dell'agente per ottenere informazioni su .
• action: filtrare l'elenco con l'azione dell'utente consentita. Valori accettati: manage, none, use
• detect: rileva automaticamente l'organizzazione. Valori accettati: false, true
• organizzazione o organizzazione: 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 selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.
• project o p: nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

Esempio

Nell'esempio seguente vengono visualizzati i dettagli della coda per la coda Ospitata di Windows 2019 con VS2019. In questo esempio viene usata la configurazione predefinita seguente: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines queue show --id 14

{
  "id": 14,
  "name": "Hosted Windows 2019 with VS2019",
  "pool": {
    "id": 4,
    "isHosted": true,
    "isLegacy": true,
    "name": "Hosted Windows 2019 with VS2019",
    "poolType": "automation",
    "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
    "size": 1
  },
  "projectId": "16836457-4ce1-4e77-b97a-e7e0c6508e84"
}

I pool vengono usati per eseguire processi. Informazioni sulla specifica dei pool per i processi.

Se sono disponibili molti agenti self-hosted destinati a team o scopi diversi, è possibile creare pool aggiuntivi, come illustrato di seguito.

Creare pool di agenti

Ecco alcune situazioni tipiche in cui è possibile creare pool di agenti self-hosted:

• Si è membri di un progetto e si vuole usare un set di computer di proprietà del team per l'esecuzione di processi di compilazione e distribuzione. Prima di tutto, assicurarsi di avere le autorizzazioni per creare pool nel progetto selezionando Sicurezza nella pagina Pool di agenti nelle impostazioni di Project. Per creare nuovi pool, è necessario avere il ruolo di amministratore . Selezionare quindi Aggiungi pool e selezionare l'opzione per creare un nuovo pool. Installare e configurare infine gli agenti in modo che facciano parte di tale pool di agenti.

• Si è membri del team dell'infrastruttura e si vuole configurare un pool di agenti da usare in tutti i progetti. Prima di tutto, assicurarsi di avere le autorizzazioni per creare pool nel progetto selezionando Sicurezza nella pagina pool di agenti nelle impostazioni organizzazione. Creare quindi un nuovo pool di agenti e selezionare l'opzione Provisioning automatico di questo pool di agenti in tutti i progetti durante la creazione del pool. Questa impostazione garantisce che tutti i progetti abbiano accesso a questo pool di agenti. Installare e configurare infine gli agenti in modo che facciano parte di tale pool di agenti.

• Si vuole condividere un set di computer agenti con più progetti, ma non tutti. Passare prima di tutto alle impostazioni per uno dei progetti, aggiungere un pool di agenti e selezionare l'opzione per creare un nuovo pool a livello di organizzazione. Passare quindi a ognuno degli altri progetti e creare un pool in ognuno di essi selezionando l'opzione Usa un pool di agenti esistente dall'organizzazione. Infine, installare e configurare gli agenti come parte del pool di agenti condivisi.

Sicurezza dei pool di agenti

Comprendere il funzionamento della sicurezza dei pool di agenti consente di controllarne la condivisione e l'uso.

I ruoli vengono definiti in ogni pool di agenti e l'appartenenza a questi ruoli determina le operazioni che è possibile eseguire in un pool di agenti.

Impostazioni di sicurezza a livello di organizzazione

Ruolo in un pool di agenti nelle impostazioni dell'organizzazione	Scopo
Lettore	I membri di questo ruolo possono visualizzare il pool di agenti e gli agenti. In genere si usa questa opzione per aggiungere operatori responsabili del monitoraggio degli agenti e della relativa integrità.
Account di servizio	I membri di questo ruolo possono usare il pool di agenti dell'organizzazione per creare un pool di agenti di progetto in un progetto. Se si seguono le linee guida precedenti per la creazione di nuovi pool di agenti di progetto, in genere non è necessario aggiungere membri qui.
Amministratore	Oltre a tutte le autorizzazioni precedenti, i membri di questo ruolo possono registrare o annullare la registrazione degli agenti dal pool di agenti dell'organizzazione. Possono anche fare riferimento al pool di agenti dell'organizzazione durante la creazione di un pool di agenti di progetto in un progetto. Infine, possono anche gestire l'appartenenza per tutti i ruoli del pool di agenti dell'organizzazione. L'utente che ha creato il pool di agenti dell'organizzazione viene aggiunto automaticamente al ruolo Di amministratore per tale pool.

Il nodo Tutti i pool di agenti nella scheda Pool di agenti viene usato per controllare la sicurezza di tutti i pool di agenti dell'organizzazione. Le appartenenze ai ruoli per i singoli pool di agenti dell'organizzazione vengono ereditate automaticamente da quelle del nodo "Tutti i pool di agenti". Per impostazione predefinita, gli amministratori di TFS e Azure DevOps Server sono amministratori del nodo "Tutti i pool di agenti" quando si usano TFS o Azure DevOps Server.

Impostazioni di sicurezza a livello di progetto

I ruoli vengono definiti anche in ogni pool di agenti di progetto e le appartenenze in questi ruoli determinano le operazioni che è possibile eseguire in un pool di agenti a livello di progetto.

Ruolo in un pool di agenti nelle impostazioni del progetto	Scopo
Lettore	I membri di questo ruolo possono visualizzare il pool di agenti del progetto. In genere viene usato per aggiungere operatori responsabili del monitoraggio dei processi di compilazione e distribuzione in tale pool di agenti di progetto.
Utente	I membri di questo ruolo possono usare il pool di agenti del progetto durante la creazione di pipeline.
Amministratore	Oltre a tutte le operazioni precedenti, i membri di questo ruolo possono gestire l'appartenenza per tutti i ruoli del pool di agenti del progetto. L'utente che ha creato il pool viene aggiunto automaticamente al ruolo Amministratore per tale pool.

Autorizzazioni della pipeline

Le autorizzazioni della pipeline controllano quali pipeline YAML sono autorizzate a usare un pool di agenti. Le autorizzazioni della pipeline non limitano l'accesso dalle pipeline classiche.

Puoi scegliere tra le opzioni seguenti:

• Aprire l'accesso per tutte le pipeline per usare il pool di agenti dalle altre opzioni nell'angolo superiore destro della sezione Autorizzazioni pipeline nella scheda sicurezza di un pool di agenti.

• Bloccare il pool di agenti e consentire solo le pipeline YAML selezionate per usarlo. Se qualsiasi altra pipeline YAML fa riferimento al pool di agenti, viene generata una richiesta di autorizzazione, che deve essere approvata da un amministratore del pool di agenti. Questo non limita l'accesso dalle pipeline classiche.

Non è possibile configurare le autorizzazioni della pipeline per il pool di agenti di Azure Pipelines , perché il pool è accessibile, per impostazione predefinita, a tutte le pipeline.

L'azione Sicurezza nella scheda Pool di agenti viene usata per controllare la sicurezza di tutti i pool di agenti di progetto in un progetto. Le appartenenze ai ruoli per i singoli pool di agenti del progetto vengono ereditate automaticamente da ciò che si definisce qui. Per impostazione predefinita, i gruppi seguenti vengono aggiunti al ruolo Amministratore di "Tutti i pool di agenti": Amministratori di compilazione, Amministratori di versione, Amministratori di progetto.

Domande frequenti

Se non si pianifica una finestra di manutenzione, quando gli agenti eseguono la manutenzione?

Se non è pianificata alcuna finestra, gli agenti in tale pool non eseguiranno il processo di manutenzione.

Che cos'è un processo di manutenzione?

È possibile configurare i pool di agenti per pulire periodicamente directory e repository di lavoro non aggiornati. Ciò dovrebbe ridurre il rischio che gli agenti esauriscano lo spazio su disco. I processi di manutenzione vengono configurati a livello di organizzazione nelle impostazioni del pool di agenti.

Per configurare le impostazioni del processo di manutenzione:

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

2. Scegliere Azure DevOps, Impostazioni organizzazione.

   

3. Scegliere Pool di agenti.

   

Scegliere il pool desiderato e scegliere Impostazioni per configurare le impostazioni del processo di manutenzione per il pool di agenti.

Importante

È necessario disporre dell'autorizzazione Gestisci code di compilazione per configurare le impostazioni del processo di manutenzione. Se non viene visualizzata la scheda Impostazioni o la scheda Cronologia manutenzione, non si dispone di tale autorizzazione, che viene concessa per impostazione predefinita al ruolo Amministratore. Per altre informazioni, vedere Sicurezza dei pool di agenti.

Configurare le impostazioni desiderate e scegliere Salva.

Selezionare Cronologia manutenzione per visualizzare la cronologia dei processi di manutenzione per il pool di agenti corrente. È possibile scaricare ed esaminare i log per visualizzare i passaggi e le azioni di pulizia eseguiti.

La manutenzione viene eseguita per ogni pool di agenti, non per computer; pertanto, se si dispone di più pool di agenti in un singolo computer, è comunque possibile che si verifichino problemi di spazio su disco.

Il processo di manutenzione del pool di agenti self-hosted sembra bloccato. Perché?

In genere, un processo di manutenzione è "bloccato" quando è in attesa di essere eseguito su un agente che non si trova più nel pool di agenti. Ciò accade quando, ad esempio, l'agente viene portato offline in modo intenzionale o quando si verificano problemi di comunicazione con esso.

I processi di manutenzione accodati per l'esecuzione rimarranno in attesa per sette giorni, dopodiché verranno impostati automaticamente sullo stato non riuscito se non vengono eseguiti. Questo limite di tempo non può essere modificato.

Il limite di sette giorni è diverso dall'impostazione del timeout del processo di manutenzione. Quest'ultima controlla il numero massimo di minuti che un agente può impiegare per eseguire la manutenzione. Il timer viene avviato insieme al processo stesso, non quando il processo viene accodato su un agente.

Si sta tentando di creare un pool di agenti di progetto che usa un pool di agenti dell'organizzazione esistente, ma i controlli sono disattivati. Perché?

Nella finestra di dialogo "Crea un pool di agenti di progetto" non è possibile usare un pool di agenti dell'organizzazione esistente se fa già riferimento a un altro pool di agenti di progetto. A ogni pool di agenti dell'organizzazione può essere fatto riferimento da un solo pool di agenti di progetto all'interno di una determinata raccolta di progetti.

Non è possibile selezionare un pool ospitato da Microsoft e non è possibile accodare la compilazione. Com'è possibile risolvere il problema?

Chiedere al proprietario dell'organizzazione Azure DevOps di concedere l'autorizzazione per l'uso del pool. Vedere Sicurezza dei pool di agenti.

Sono necessarie altre risorse di compilazione ospitate. Cosa posso fare?

R: Il pool di Azure Pipelines offre a tutte le organizzazioni di Azure DevOps agenti di compilazione ospitati nel cloud e minuti di compilazione gratuiti ogni mese. Se sono necessarie più risorse di compilazione ospitate da Microsoft o se è necessario eseguire più processi in parallelo, è possibile:

• Ospitare i propri agenti nell'infrastruttura gestita
• Acquistare processi paralleli aggiuntivi