definizione pool.demands

Richieste (per un pool privato).

Definizioni che fanno riferimento a questa definizione: pool

Implementazioni

Implementazione Descrizione
richieste: stringa Specificare una richiesta per un pool privato.
richieste: elenco di stringhe Specificare un elenco di richieste per un pool privato.

Osservazioni:

Usare le richieste per assicurarsi che le funzionalità necessarie per la pipeline siano presenti negli agenti che lo eseguono. Le richieste vengono asserte automaticamente dalle attività o manualmente dall'utente.

Annotazioni

Le richieste e le capacità sono progettate per l'uso con agenti ospitati autonomamente in modo che le operazioni possano essere abbinate a un agente che soddisfi i requisiti dell'operazione. Quando si usano agenti ospitati da Microsoft, si seleziona un'immagine per l'agente che soddisfa i requisiti del processo, quindi anche se è possibile aggiungere funzionalità a un agente ospitato da Microsoft, non è necessario usare le funzionalità con gli agenti ospitati da Microsoft.

È possibile verificare la presenza di una funzionalità (operazione Exists) oppure è possibile verificare la presenza di una stringa specifica in una funzionalità (operazione Equals). Verificare l'esistenza di una funzionalità (esistente) e verificare la presenza di una stringa specifica in una funzionalità (uguale a) sono le uniche due operazioni supportate per le richieste.

Richieste di attività

Alcune attività non verranno eseguite a meno che non vengano soddisfatte una o più richieste dall'agente. Ad esempio, l'attività Di compilazione di Visual Studio richiede che msbuild e visualstudio siano installati nell'agente.

Richieste dell'agente immesse manualmente

Potrebbe essere necessario usare agenti self-hosted con funzionalità speciali. Ad esempio, la pipeline potrebbe richiedere SpecialSoftware sugli agenti nel Default pool. In alternativa, se si dispone di più agenti con sistemi operativi diversi nello stesso pool, potrebbe essere disponibile una pipeline che richiede un agente Linux.

Operazione Exists

L'operazione esiste verifica la presenza di una funzionalità con il nome specifico. Il confronto non fa distinzione tra maiuscole e minuscole.

pool:
  name: MyPool
  demands: myCustomCapability # exists check for myCustomCapability

Operazione uguale a

L'operazione di uguale verifica l'esistenza di una funzionalità e, se presente, controlla il relativo valore con il valore specificato. Se la funzionalità non è presente o i valori non corrispondono, l'operazione restituisce false. I confronti non fanno distinzione tra maiuscole e minuscole.

pool:
  name: MyPool
  demands: Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Variabili dell'agente come funzionalità di sistema

Gli agenti self-hosted hanno le funzionalità di sistema seguenti con nomi simili alle variabili dell'agente, ma non sono variabili e non richiedono la sintassi delle variabili durante il controllo di esiste o è uguale a una richiesta.

  • Agent.Name
  • Agent.Version
  • Agent.ComputerName
  • Agent.HomeDirectory
  • Agent.OS
  • Agent.OSArchitecture
  • Agent.OSVersion (solo agenti Windows)

Scansione delle capacità degli agenti

Quando il software agente si avvia, scansiona per i seguenti software e strumenti e registra le relative funzionalità.

Tip

Dopo aver installato il nuovo software in un agente self-hosted, è necessario riavviare l'agente per visualizzare la nuova funzionalità. Per altre informazioni, vedere Riavviare l'agente Windows, Riavviare l'agente Linux e Riavviare l'agente Mac.

Sugli agenti Windows, l'agente utilizza i seguenti script PowerShell per scansionare strumenti e software e registra le relative funzionalità. Questi script fanno parte del software open source agente e si trovano nella cartella /src/Misc/layoutbin/powershell.

La seguente tabella è stata generata da Copilot. Copilot è alimentato dall'IA, quindi sono possibili sorprese ed errori. Per ulteriori informazioni, consultare le FAQ generali sull'utilizzo di Copilot.

Script di scansione degli strumenti Capabilities
Add-AndroidSdkCapabilities.ps1 AndroidSDK
AndroidSDK_{version}
Add-AntCapabilities.ps1 ant
Add-ApplicationCapabilities.ps1 npm
gulp
node.js
bower
grunt
svn
cmake
docker
Add-AzureGuestAgentCapabilities.ps1 AzureGuestAgent
Add-AzurePowerShellCapabilities.ps1 AzurePS
Add-ChefCapabilities.ps1 Chef
KnifeReporting
Add-DotNetFrameworkCapabilities.ps1 DotNetFramework_{major.minor}
DotNetFramework_{major.minor}_x64
DotNetFramework
Add-JavaCapabilities.ps1 java_6
java_7
java_8
java_{major} (per le versioni 9 e successive)
java_6_x64
java_7_x64
java_8_x64
java_{major}_x64 (per le versioni 9 e successive)
java
jdk_6
jdk_7
jdk_8
jdk_{major} (per le versioni 9 e successive)
jdk_6_x64
jdk_7_x64
jdk_8_x64
jdk_{major}_x64 (per le versioni 9 e successive)
jdk

Le distribuzioni JDK rilevate includono Oracle JavaSoft, AdoptOpenJDK, Eclipse Adoptium, Eclipse Foundation e IBM Semeru.
Add-MavenCapabilities.ps1 maven
Add-MSBuildCapabilities.ps1 MSBuild_2.0
MSBuild_3.5
MSBuild_4.0
MSBuild_12.0
MSBuild_14.0
MSBuild_15.0
MSBuild_16.0
MSBuild_17.0
MSBuild_18.0
MSBuild
MSBuild_2.0_x64
MSBuild_3.5_x64
MSBuild_4.0_x64
MSBuild_12.0_x64
MSBuild_14.0_x64
MSBuild_15.0_x64
MSBuild_16.0_x64
MSBuild_17.0_x64
MSBuild_18.0_x64
MSBuild_x64
Add-PowerShellCapabilities.ps1 PowerShell
Add-ScvmmAdminConsoleCapabilities.ps1 SCVMMAdminConsole
Add-SqlPackageCapabilities.ps1 SqlPackage
Add-VisualStudioCapabilities.ps1 VisualStudio_10.0
VisualStudio_IDE_10.0
VisualStudio_11.0
VisualStudio_IDE_11.0
VisualStudio_12.0
VisualStudio_IDE_12.0
VSTest_12.0
VisualStudio_14.0
VisualStudio_IDE_14.0
VSTest_14.0
VisualStudio_15.0
VisualStudio_IDE_15.0
VSTest_15.0
VisualStudio_16.0
VisualStudio_IDE_16.0
VSTest_16.0
VisualStudio_17.0
VisualStudio_IDE_17.0
VSTest_17.0
VisualStudio_18.0
VisualStudio_IDE_18.0
VSTest_18.0
VisualStudio
VisualStudio_IDE
VSTest
Add-WindowsKitCapabilities.ps1 WindowsKit_{major.minor}
WindowsKit
Add-WindowsSdkCapabilities.ps1 WindowsSdk_{major.minor}
WindowsSdk_{major.minor}_{toolName}
WindowsSdk_{major.minor}_{toolName}_x64
WindowsSdk
Add-XamarinAndroidCapabilities.ps1 Xamarin.Android

richieste: stringa

Specificare una richiesta per un pool privato.

demands: string # Specify a demand for a private pool.

demands stringa.

Specificare una richiesta per un pool privato.

Esempi

Per aggiungere una singola richiesta alla pipeline di compilazione YAML, aggiungere la riga demands: alla sezione pool.

pool:
  name: Default
  demands: SpecialSoftware # exists check for SpecialSoftware

richieste: elenco di stringhe

Specificare un elenco di richieste per un pool privato.

demands: [ string ] # Specify a list of demands for a private pool.

Tipi di elenco

TIPO Descrizione
corda Specificare un elenco di richieste per un pool privato.

Esempi

Per specificare più richieste, aggiungere una per riga.

pool:
  name: MyPool
  demands:
  - myCustomCapability   # exists check for myCustomCapability
  - Agent.Version -equals 2.144.0 # equals check for Agent.Version 2.144.0

Vedere anche