Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 | AndroidSDKAndroidSDK_{version} |
| Add-AntCapabilities.ps1 | ant |
| Add-ApplicationCapabilities.ps1 | npmgulpnode.jsbowergruntsvncmakedocker |
| Add-AzureGuestAgentCapabilities.ps1 | AzureGuestAgent |
| Add-AzurePowerShellCapabilities.ps1 | AzurePS |
| Add-ChefCapabilities.ps1 | ChefKnifeReporting |
| Add-DotNetFrameworkCapabilities.ps1 | DotNetFramework_{major.minor}DotNetFramework_{major.minor}_x64DotNetFramework |
| Add-JavaCapabilities.ps1 | java_6java_7java_8java_{major} (per le versioni 9 e successive)java_6_x64java_7_x64java_8_x64java_{major}_x64 (per le versioni 9 e successive)javajdk_6jdk_7jdk_8jdk_{major} (per le versioni 9 e successive)jdk_6_x64jdk_7_x64jdk_8_x64jdk_{major}_x64 (per le versioni 9 e successive)jdkLe distribuzioni JDK rilevate includono Oracle JavaSoft, AdoptOpenJDK, Eclipse Adoptium, Eclipse Foundation e IBM Semeru. |
| Add-MavenCapabilities.ps1 | maven |
| Add-MSBuildCapabilities.ps1 | MSBuild_2.0MSBuild_3.5MSBuild_4.0MSBuild_12.0MSBuild_14.0MSBuild_15.0MSBuild_16.0MSBuild_17.0MSBuild_18.0MSBuildMSBuild_2.0_x64MSBuild_3.5_x64MSBuild_4.0_x64MSBuild_12.0_x64MSBuild_14.0_x64MSBuild_15.0_x64MSBuild_16.0_x64MSBuild_17.0_x64MSBuild_18.0_x64MSBuild_x64 |
| Add-PowerShellCapabilities.ps1 | PowerShell |
| Add-ScvmmAdminConsoleCapabilities.ps1 | SCVMMAdminConsole |
| Add-SqlPackageCapabilities.ps1 | SqlPackage |
| Add-VisualStudioCapabilities.ps1 | VisualStudio_10.0VisualStudio_IDE_10.0VisualStudio_11.0VisualStudio_IDE_11.0VisualStudio_12.0VisualStudio_IDE_12.0VSTest_12.0VisualStudio_14.0VisualStudio_IDE_14.0VSTest_14.0VisualStudio_15.0VisualStudio_IDE_15.0VSTest_15.0VisualStudio_16.0VisualStudio_IDE_16.0VSTest_16.0VisualStudio_17.0VisualStudio_IDE_17.0VSTest_17.0VisualStudio_18.0VisualStudio_IDE_18.0VSTest_18.0VisualStudioVisualStudio_IDEVSTest |
| Add-WindowsKitCapabilities.ps1 | WindowsKit_{major.minor}WindowsKit |
| Add-WindowsSdkCapabilities.ps1 | WindowsSdk_{major.minor}WindowsSdk_{major.minor}_{toolName}WindowsSdk_{major.minor}_{toolName}_x64WindowsSdk |
| 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