Condividi tramite

Pool Microsoft.DevOpsInfrastructure

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa pool può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DevOpsInfrastructure/pools, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.DevOpsInfrastructure/pools@2024-10-19' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    agentProfile: {
      resourcePredictions: any(Azure.Bicep.Types.Concrete.AnyType)
      resourcePredictionsProfile: {
        kind: 'string'
        // For remaining properties, see ResourcePredictionsProfile objects
      }
      kind: 'string'
      // For remaining properties, see AgentProfile objects
    }
    devCenterProjectResourceId: 'string'
    fabricProfile: {
      kind: 'string'
      // For remaining properties, see FabricProfile objects
    }
    maximumConcurrency: int
    organizationProfile: {
      kind: 'string'
      // For remaining properties, see OrganizationProfile objects
    }
    provisioningState: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Oggetti FabricProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per vmss, usare:

{
  images: [
    {
      aliases: [
        'string'
      ]
      buffer: 'string'
      resourceId: 'string'
      wellKnownImageName: 'string'
    }
  ]
  kind: 'Vmss'
  networkProfile: {
    subnetId: 'string'
  }
  osProfile: {
    logonType: 'string'
    secretsManagementSettings: {
      certificateStoreLocation: 'string'
      keyExportable: bool
      observedCertificates: [
        'string'
      ]
    }
  }
  sku: {
    name: 'string'
  }
  storageProfile: {
    dataDisks: [
      {
        caching: 'string'
        diskSizeGiB: int
        driveLetter: 'string'
        storageAccountType: 'string'
      }
    ]
    osDiskStorageAccountType: 'string'
  }
}

Oggetti OrganizationProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per AzureDevOps, usare:

{
  kind: 'AzureDevOps'
  organizations: [
    {
      parallelism: int
      projects: [
        'string'
      ]
      url: 'string'
    }
  ]
  permissionProfile: {
    groups: [
      'string'
    ]
    kind: 'string'
    users: [
      'string'
    ]
  }
}

Per GitHub, usare:

{
  kind: 'GitHub'
  organizations: [
    {
      repositories: [
        'string'
      ]
      url: 'string'
    }
  ]
}

Oggetti AgentProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per con stato, usare:

{
  gracePeriodTimeSpan: 'string'
  kind: 'Stateful'
  maxAgentLifetime: 'string'
}

Per senza stato, usare:

{
  kind: 'Stateless'
}

Oggetti ResourcePredictionsProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per automatico, usare:

{
  kind: 'Automatic'
  predictionPreference: 'string'
}

Per Manuale, usare:

{
  kind: 'Manual'
}

Valori delle proprietà

AgentProfile

Nome Descrizione Valore
gentile Impostare su "Con stato" per il tipo con stato . Impostare su "Senza stato" per il tipo StatelessAgentProfile. 'Con stato'
'Senza stato' (obbligatorio)
resourcePredictions Definisce gli agenti di buffer/stand-by del pool. qualunque
resourcePredictionsProfile Definisce il modo in cui vengono forniti gli agenti buffer/stand-by del pool. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Nome Descrizione Valore
gentile Determina il modo in cui deve essere fornito lo schema stand-by. 'Automatic' (obbligatorio)
predictionPreference Determina l'equilibrio tra costi e prestazioni. 'Bilanciato'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Nome Descrizione Valore
gentile Proprietà discriminatoria per OrganizationProfile. 'AzureDevOps' (obbligatorio)
Organizzazioni L'elenco delle organizzazioni di Azure DevOps in cui deve essere presente il pool. 'organizzazione[] (obbligatorio)
permissionProfile Tipo di autorizzazione che determina quali account sono amministratori nel pool di Azure DevOps. azureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Nome Descrizione Valore
Gruppi Indirizzi di posta elettronica del gruppo string[]
gentile Determina chi dispone delle autorizzazioni di amministratore per il pool di Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obbligatorio)
Gli utenti Indirizzi di posta elettronica utente string[]

DataDisk

Nome Descrizione Valore
Memorizzazione nella cache Tipo di memorizzazione nella cache da abilitare per i dischi dati. Il valore predefinito per la memorizzazione nella cache è readwrite. Per informazioni sulle opzioni di memorizzazione nella cache, vedere: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'Nessuno'
'ReadOnly'
'ReadWrite'
diskSizeGiB Dimensioni iniziali del disco in gigabyte. Int
driveLetter Lettera di unità per il disco dati vuoto. Se non specificato, sarà la prima lettera disponibile. corda
storageAccountType Tipo di account di archiviazione da usare per il disco dati. Se omesso, il valore predefinito è "standard_lrs". 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Nome Descrizione Valore
nome Nome dello SKU di Azure dei computer nel pool. stringa (obbligatorio)

FabricProfile

Nome Descrizione Valore
gentile Impostare su "Vmss" per il tipo VmssFabricProfile. 'Vmss' (obbligatorio)

GitHubOrganization

Nome Descrizione Valore
Repository Elenco facoltativo di repository in cui creare il pool. string[]
URL URL dell'organizzazione GitHub in cui deve essere creato il pool. stringa (obbligatorio)

GitHubOrganizationProfile

Nome Descrizione Valore
gentile Proprietà discriminatoria per OrganizationProfile. 'GitHub' (obbligatorio)
Organizzazioni L'elenco di organizzazioni/repository GitHub in cui deve essere presente il pool. GitHubOrganization[] (obbligatorio)

ManagedServiceIdentity

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentities Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. UserAssignedIdentities

ManualResourcePredictionsProfile

Nome Descrizione Valore
gentile Determina il modo in cui deve essere fornito lo schema stand-by. 'Manual' (obbligatorio)

Microsoft.DevOpsInfrastructure/pools

Nome Descrizione Valore
identità Identità del servizio gestito assegnate a questa risorsa. ManagedServiceIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (obbligatorio)
proprietà Proprietà specifiche della risorsa. PoolProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

NetworkProfile

Nome Descrizione Valore
subnetId ID subnet in cui inserire tutti i computer creati nel pool. stringa (obbligatorio)

Organizzazione

Nome Descrizione Valore
parallelismo Numero massimo di computer che possono essere creati in questa organizzazione al di fuori della concorrenza massima del pool. Int
Progetti Elenco facoltativo di progetti in cui creare il pool. string[]
URL URL dell'organizzazione di Azure DevOps in cui creare il pool. stringa (obbligatorio)

OrganizationProfile

Nome Descrizione Valore
gentile Impostare su "AzureDevOps" per il tipo AzureDevOpsOrganizationProfile. Impostare su "GitHub" per il tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (obbligatorio)

OsProfile

Nome Descrizione Valore
logonType Determina la modalità di esecuzione del servizio. Per impostazione predefinita, questa opzione verrà impostata su Servizio. 'Interactive'
'Service'
secretsManagementSettings Impostazioni di gestione dei segreti dei computer nel pool. SecretsManagementSettings

PoolImage

Nome Descrizione Valore
Alias Elenco di alias per cui fare riferimento all'immagine. string[]
buffer Percentuale del buffer da allocare a questa immagine. corda
resourceId ID risorsa dell'immagine. corda
wellKnownImageName Immagine da usare da un set noto di immagini rese disponibili ai clienti. corda

PoolProprietà

Nome Descrizione Valore
agentProfile Definisce la modalità di gestione del computer dopo l'esecuzione di un processo. AgentProfile (obbligatorio)
devCenterProjectResourceId ID risorsa del progetto DevCenter a cui appartiene il pool. stringa (obbligatorio)
fabricProfile Definisce il tipo di infrastruttura in cui verrà eseguito l'agente. FabricProfile (obbligatorio)
maximumConcurrency Definisce il numero di risorse che è possibile creare in qualsiasi momento. Int

Vincoli:
Valore minimo = 1
Valore massimo = 10000 (obbligatorio)
organizationProfile Definisce l'organizzazione in cui verrà usato il pool. OrganizationProfile (obbligatorio)
provisioningState Stato dell'operazione corrente. 'Accepted'
'Annullato'
'Eliminazione'
'Failed'
'Provisioning'
'Succeeded'
'Aggiornamento'

ResourcePredictionsProfile

Nome Descrizione Valore
gentile Impostare su 'Automatic' per il tipo AutomaticResourcePredictionsProfile. Impostare su 'Manual' per il tipo ManualResourcePredictionsProfile. 'Automatico'
'Manual' (obbligatorio)

SecretsManagementSettings

Nome Descrizione Valore
certificateStoreLocation Dove archiviare i certificati nel computer. corda
keyExportable Definisce se la chiave dei certificati deve essere esportabile. bool (obbligatorio)
observedCertificates Elenco di certificati da installare in tutti i computer nel pool. string[] (obbligatorio)

Stateful

Nome Descrizione Valore
gracePeriodTimeSpan Quanto tempo deve essere mantenuto il computer dopo l'esecuzione di un carico di lavoro quando non sono presenti agenti stand-by. Il valore massimo è una settimana. corda
gentile Proprietà discriminatoria per AgentProfile. 'Con stato' (obbligatorio)
maxAgentLifetime Per quanto tempo devono essere mantenute le macchine con stato. Il valore massimo è una settimana. corda

StatelessAgentProfile

Nome Descrizione Valore
gentile Proprietà discriminatoria per AgentProfile. 'Senza stato' (obbligatorio)

StorageProfile

Nome Descrizione Valore
dataDisks Elenco di dischi dati vuoti da collegare. DataDisk[]
osDiskStorageAccountType Nome dello SKU di Azure dei computer nel pool. 'Premium'
'Standard'
'StandardSSD'

TrackedResourceTags

Nome Descrizione Valore

UserAssignedIdentities

Nome Descrizione Valore

UserAssignedIdentity

Nome Descrizione Valore

VmssFabricProfile

Nome Descrizione Valore
Immagini Immagini di macchine virtuali dei computer nel pool. PoolImage[] (obbligatorio)
gentile Proprietà discriminatoria per FabricProfile. 'Vmss' (obbligatorio)
networkProfile Profilo di rete dei computer nel pool. NetworkProfile
osProfile Profilo del sistema operativo dei computer nel pool. OsProfile
Sku SKU di Azure dei computer nel pool. DevOpsAzureSku (obbligatorio)
storageProfile Profilo di archiviazione dei computer nel pool. StorageProfile

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa pool può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DevOpsInfrastructure/pools, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.DevOpsInfrastructure/pools",
  "apiVersion": "2024-10-19",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "agentProfile": {
      "resourcePredictions": {},
      "resourcePredictionsProfile": {
        "kind": "string"
        // For remaining properties, see ResourcePredictionsProfile objects
      },
      "kind": "string"
      // For remaining properties, see AgentProfile objects
    },
    "devCenterProjectResourceId": "string",
    "fabricProfile": {
      "kind": "string"
      // For remaining properties, see FabricProfile objects
    },
    "maximumConcurrency": "int",
    "organizationProfile": {
      "kind": "string"
      // For remaining properties, see OrganizationProfile objects
    },
    "provisioningState": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Oggetti FabricProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per vmss, usare:

{
  "images": [
    {
      "aliases": [ "string" ],
      "buffer": "string",
      "resourceId": "string",
      "wellKnownImageName": "string"
    }
  ],
  "kind": "Vmss",
  "networkProfile": {
    "subnetId": "string"
  },
  "osProfile": {
    "logonType": "string",
    "secretsManagementSettings": {
      "certificateStoreLocation": "string",
      "keyExportable": "bool",
      "observedCertificates": [ "string" ]
    }
  },
  "sku": {
    "name": "string"
  },
  "storageProfile": {
    "dataDisks": [
      {
        "caching": "string",
        "diskSizeGiB": "int",
        "driveLetter": "string",
        "storageAccountType": "string"
      }
    ],
    "osDiskStorageAccountType": "string"
  }
}

Oggetti OrganizationProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per AzureDevOps, usare:

{
  "kind": "AzureDevOps",
  "organizations": [
    {
      "parallelism": "int",
      "projects": [ "string" ],
      "url": "string"
    }
  ],
  "permissionProfile": {
    "groups": [ "string" ],
    "kind": "string",
    "users": [ "string" ]
  }
}

Per GitHub, usare:

{
  "kind": "GitHub",
  "organizations": [
    {
      "repositories": [ "string" ],
      "url": "string"
    }
  ]
}

Oggetti AgentProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per con stato, usare:

{
  "gracePeriodTimeSpan": "string",
  "kind": "Stateful",
  "maxAgentLifetime": "string"
}

Per senza stato, usare:

{
  "kind": "Stateless"
}

Oggetti ResourcePredictionsProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per automatico, usare:

{
  "kind": "Automatic",
  "predictionPreference": "string"
}

Per Manuale, usare:

{
  "kind": "Manual"
}

Valori delle proprietà

AgentProfile

Nome Descrizione Valore
gentile Impostare su "Con stato" per il tipo con stato . Impostare su "Senza stato" per il tipo StatelessAgentProfile. 'Con stato'
'Senza stato' (obbligatorio)
resourcePredictions Definisce gli agenti di buffer/stand-by del pool. qualunque
resourcePredictionsProfile Definisce il modo in cui vengono forniti gli agenti buffer/stand-by del pool. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Nome Descrizione Valore
gentile Determina il modo in cui deve essere fornito lo schema stand-by. 'Automatic' (obbligatorio)
predictionPreference Determina l'equilibrio tra costi e prestazioni. 'Bilanciato'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Nome Descrizione Valore
gentile Proprietà discriminatoria per OrganizationProfile. 'AzureDevOps' (obbligatorio)
Organizzazioni L'elenco delle organizzazioni di Azure DevOps in cui deve essere presente il pool. 'organizzazione[] (obbligatorio)
permissionProfile Tipo di autorizzazione che determina quali account sono amministratori nel pool di Azure DevOps. azureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Nome Descrizione Valore
Gruppi Indirizzi di posta elettronica del gruppo string[]
gentile Determina chi dispone delle autorizzazioni di amministratore per il pool di Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obbligatorio)
Gli utenti Indirizzi di posta elettronica utente string[]

DataDisk

Nome Descrizione Valore
Memorizzazione nella cache Tipo di memorizzazione nella cache da abilitare per i dischi dati. Il valore predefinito per la memorizzazione nella cache è readwrite. Per informazioni sulle opzioni di memorizzazione nella cache, vedere: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'Nessuno'
'ReadOnly'
'ReadWrite'
diskSizeGiB Dimensioni iniziali del disco in gigabyte. Int
driveLetter Lettera di unità per il disco dati vuoto. Se non specificato, sarà la prima lettera disponibile. corda
storageAccountType Tipo di account di archiviazione da usare per il disco dati. Se omesso, il valore predefinito è "standard_lrs". 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Nome Descrizione Valore
nome Nome dello SKU di Azure dei computer nel pool. stringa (obbligatorio)

FabricProfile

Nome Descrizione Valore
gentile Impostare su "Vmss" per il tipo VmssFabricProfile. 'Vmss' (obbligatorio)

GitHubOrganization

Nome Descrizione Valore
Repository Elenco facoltativo di repository in cui creare il pool. string[]
URL URL dell'organizzazione GitHub in cui deve essere creato il pool. stringa (obbligatorio)

GitHubOrganizationProfile

Nome Descrizione Valore
gentile Proprietà discriminatoria per OrganizationProfile. 'GitHub' (obbligatorio)
Organizzazioni L'elenco di organizzazioni/repository GitHub in cui deve essere presente il pool. GitHubOrganization[] (obbligatorio)

ManagedServiceIdentity

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentities Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. UserAssignedIdentities

ManualResourcePredictionsProfile

Nome Descrizione Valore
gentile Determina il modo in cui deve essere fornito lo schema stand-by. 'Manual' (obbligatorio)

Microsoft.DevOpsInfrastructure/pools

Nome Descrizione Valore
apiVersion Versione dell'API '2024-10-19'
identità Identità del servizio gestito assegnate a questa risorsa. ManagedServiceIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (obbligatorio)
proprietà Proprietà specifiche della risorsa. PoolProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.DevOpsInfrastructure/pools'

NetworkProfile

Nome Descrizione Valore
subnetId ID subnet in cui inserire tutti i computer creati nel pool. stringa (obbligatorio)

Organizzazione

Nome Descrizione Valore
parallelismo Numero massimo di computer che possono essere creati in questa organizzazione al di fuori della concorrenza massima del pool. Int
Progetti Elenco facoltativo di progetti in cui creare il pool. string[]
URL URL dell'organizzazione di Azure DevOps in cui creare il pool. stringa (obbligatorio)

OrganizationProfile

Nome Descrizione Valore
gentile Impostare su "AzureDevOps" per il tipo AzureDevOpsOrganizationProfile. Impostare su "GitHub" per il tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (obbligatorio)

OsProfile

Nome Descrizione Valore
logonType Determina la modalità di esecuzione del servizio. Per impostazione predefinita, questa opzione verrà impostata su Servizio. 'Interactive'
'Service'
secretsManagementSettings Impostazioni di gestione dei segreti dei computer nel pool. SecretsManagementSettings

PoolImage

Nome Descrizione Valore
Alias Elenco di alias per cui fare riferimento all'immagine. string[]
buffer Percentuale del buffer da allocare a questa immagine. corda
resourceId ID risorsa dell'immagine. corda
wellKnownImageName Immagine da usare da un set noto di immagini rese disponibili ai clienti. corda

PoolProprietà

Nome Descrizione Valore
agentProfile Definisce la modalità di gestione del computer dopo l'esecuzione di un processo. AgentProfile (obbligatorio)
devCenterProjectResourceId ID risorsa del progetto DevCenter a cui appartiene il pool. stringa (obbligatorio)
fabricProfile Definisce il tipo di infrastruttura in cui verrà eseguito l'agente. FabricProfile (obbligatorio)
maximumConcurrency Definisce il numero di risorse che è possibile creare in qualsiasi momento. Int

Vincoli:
Valore minimo = 1
Valore massimo = 10000 (obbligatorio)
organizationProfile Definisce l'organizzazione in cui verrà usato il pool. OrganizationProfile (obbligatorio)
provisioningState Stato dell'operazione corrente. 'Accepted'
'Annullato'
'Eliminazione'
'Failed'
'Provisioning'
'Succeeded'
'Aggiornamento'

ResourcePredictionsProfile

Nome Descrizione Valore
gentile Impostare su 'Automatic' per il tipo AutomaticResourcePredictionsProfile. Impostare su 'Manual' per il tipo ManualResourcePredictionsProfile. 'Automatico'
'Manual' (obbligatorio)

SecretsManagementSettings

Nome Descrizione Valore
certificateStoreLocation Dove archiviare i certificati nel computer. corda
keyExportable Definisce se la chiave dei certificati deve essere esportabile. bool (obbligatorio)
observedCertificates Elenco di certificati da installare in tutti i computer nel pool. string[] (obbligatorio)

Stateful

Nome Descrizione Valore
gracePeriodTimeSpan Quanto tempo deve essere mantenuto il computer dopo l'esecuzione di un carico di lavoro quando non sono presenti agenti stand-by. Il valore massimo è una settimana. corda
gentile Proprietà discriminatoria per AgentProfile. 'Con stato' (obbligatorio)
maxAgentLifetime Per quanto tempo devono essere mantenute le macchine con stato. Il valore massimo è una settimana. corda

StatelessAgentProfile

Nome Descrizione Valore
gentile Proprietà discriminatoria per AgentProfile. 'Senza stato' (obbligatorio)

StorageProfile

Nome Descrizione Valore
dataDisks Elenco di dischi dati vuoti da collegare. DataDisk[]
osDiskStorageAccountType Nome dello SKU di Azure dei computer nel pool. 'Premium'
'Standard'
'StandardSSD'

TrackedResourceTags

Nome Descrizione Valore

UserAssignedIdentities

Nome Descrizione Valore

UserAssignedIdentity

Nome Descrizione Valore

VmssFabricProfile

Nome Descrizione Valore
Immagini Immagini di macchine virtuali dei computer nel pool. PoolImage[] (obbligatorio)
gentile Proprietà discriminatoria per FabricProfile. 'Vmss' (obbligatorio)
networkProfile Profilo di rete dei computer nel pool. NetworkProfile
osProfile Profilo del sistema operativo dei computer nel pool. OsProfile
Sku SKU di Azure dei computer nel pool. DevOpsAzureSku (obbligatorio)
storageProfile Profilo di archiviazione dei computer nel pool. StorageProfile

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa pool può essere distribuito con operazioni destinate a:

  • gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DevOpsInfrastructure/pools, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevOpsInfrastructure/pools@2024-10-19"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      agentProfile = {
        resourcePredictions = ?
        resourcePredictionsProfile = {
          kind = "string"
          // For remaining properties, see ResourcePredictionsProfile objects
        }
        kind = "string"
        // For remaining properties, see AgentProfile objects
      }
      devCenterProjectResourceId = "string"
      fabricProfile = {
        kind = "string"
        // For remaining properties, see FabricProfile objects
      }
      maximumConcurrency = int
      organizationProfile = {
        kind = "string"
        // For remaining properties, see OrganizationProfile objects
      }
      provisioningState = "string"
    }
  })
}

Oggetti FabricProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per vmss, usare:

{
  images = [
    {
      aliases = [
        "string"
      ]
      buffer = "string"
      resourceId = "string"
      wellKnownImageName = "string"
    }
  ]
  kind = "Vmss"
  networkProfile = {
    subnetId = "string"
  }
  osProfile = {
    logonType = "string"
    secretsManagementSettings = {
      certificateStoreLocation = "string"
      keyExportable = bool
      observedCertificates = [
        "string"
      ]
    }
  }
  sku = {
    name = "string"
  }
  storageProfile = {
    dataDisks = [
      {
        caching = "string"
        diskSizeGiB = int
        driveLetter = "string"
        storageAccountType = "string"
      }
    ]
    osDiskStorageAccountType = "string"
  }
}

Oggetti OrganizationProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per AzureDevOps, usare:

{
  kind = "AzureDevOps"
  organizations = [
    {
      parallelism = int
      projects = [
        "string"
      ]
      url = "string"
    }
  ]
  permissionProfile = {
    groups = [
      "string"
    ]
    kind = "string"
    users = [
      "string"
    ]
  }
}

Per GitHub, usare:

{
  kind = "GitHub"
  organizations = [
    {
      repositories = [
        "string"
      ]
      url = "string"
    }
  ]
}

Oggetti AgentProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per con stato, usare:

{
  gracePeriodTimeSpan = "string"
  kind = "Stateful"
  maxAgentLifetime = "string"
}

Per senza stato, usare:

{
  kind = "Stateless"
}

Oggetti ResourcePredictionsProfile

Impostare la proprietà tipo di per specificare il tipo di oggetto.

Per automatico, usare:

{
  kind = "Automatic"
  predictionPreference = "string"
}

Per Manuale, usare:

{
  kind = "Manual"
}

Valori delle proprietà

AgentProfile

Nome Descrizione Valore
gentile Impostare su "Con stato" per il tipo con stato . Impostare su "Senza stato" per il tipo StatelessAgentProfile. 'Con stato'
'Senza stato' (obbligatorio)
resourcePredictions Definisce gli agenti di buffer/stand-by del pool. qualunque
resourcePredictionsProfile Definisce il modo in cui vengono forniti gli agenti buffer/stand-by del pool. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Nome Descrizione Valore
gentile Determina il modo in cui deve essere fornito lo schema stand-by. 'Automatic' (obbligatorio)
predictionPreference Determina l'equilibrio tra costi e prestazioni. 'Bilanciato'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Nome Descrizione Valore
gentile Proprietà discriminatoria per OrganizationProfile. 'AzureDevOps' (obbligatorio)
Organizzazioni L'elenco delle organizzazioni di Azure DevOps in cui deve essere presente il pool. 'organizzazione[] (obbligatorio)
permissionProfile Tipo di autorizzazione che determina quali account sono amministratori nel pool di Azure DevOps. azureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Nome Descrizione Valore
Gruppi Indirizzi di posta elettronica del gruppo string[]
gentile Determina chi dispone delle autorizzazioni di amministratore per il pool di Azure DevOps. 'CreatorOnly'
'Inherit'
'SpecificAccounts' (obbligatorio)
Gli utenti Indirizzi di posta elettronica utente string[]

DataDisk

Nome Descrizione Valore
Memorizzazione nella cache Tipo di memorizzazione nella cache da abilitare per i dischi dati. Il valore predefinito per la memorizzazione nella cache è readwrite. Per informazioni sulle opzioni di memorizzazione nella cache, vedere: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'Nessuno'
'ReadOnly'
'ReadWrite'
diskSizeGiB Dimensioni iniziali del disco in gigabyte. Int
driveLetter Lettera di unità per il disco dati vuoto. Se non specificato, sarà la prima lettera disponibile. corda
storageAccountType Tipo di account di archiviazione da usare per il disco dati. Se omesso, il valore predefinito è "standard_lrs". 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Nome Descrizione Valore
nome Nome dello SKU di Azure dei computer nel pool. stringa (obbligatorio)

FabricProfile

Nome Descrizione Valore
gentile Impostare su "Vmss" per il tipo VmssFabricProfile. 'Vmss' (obbligatorio)

GitHubOrganization

Nome Descrizione Valore
Repository Elenco facoltativo di repository in cui creare il pool. string[]
URL URL dell'organizzazione GitHub in cui deve essere creato il pool. stringa (obbligatorio)

GitHubOrganizationProfile

Nome Descrizione Valore
gentile Proprietà discriminatoria per OrganizationProfile. 'GitHub' (obbligatorio)
Organizzazioni L'elenco di organizzazioni/repository GitHub in cui deve essere presente il pool. GitHubOrganization[] (obbligatorio)

ManagedServiceIdentity

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentities Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. UserAssignedIdentities

ManualResourcePredictionsProfile

Nome Descrizione Valore
gentile Determina il modo in cui deve essere fornito lo schema stand-by. 'Manual' (obbligatorio)

Microsoft.DevOpsInfrastructure/pools

Nome Descrizione Valore
identità Identità del servizio gestito assegnate a questa risorsa. ManagedServiceIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (obbligatorio)
proprietà Proprietà specifiche della risorsa. PoolProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.DevOpsInfrastructure/pools@2024-10-19"

NetworkProfile

Nome Descrizione Valore
subnetId ID subnet in cui inserire tutti i computer creati nel pool. stringa (obbligatorio)

Organizzazione

Nome Descrizione Valore
parallelismo Numero massimo di computer che possono essere creati in questa organizzazione al di fuori della concorrenza massima del pool. Int
Progetti Elenco facoltativo di progetti in cui creare il pool. string[]
URL URL dell'organizzazione di Azure DevOps in cui creare il pool. stringa (obbligatorio)

OrganizationProfile

Nome Descrizione Valore
gentile Impostare su "AzureDevOps" per il tipo AzureDevOpsOrganizationProfile. Impostare su "GitHub" per il tipo GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (obbligatorio)

OsProfile

Nome Descrizione Valore
logonType Determina la modalità di esecuzione del servizio. Per impostazione predefinita, questa opzione verrà impostata su Servizio. 'Interactive'
'Service'
secretsManagementSettings Impostazioni di gestione dei segreti dei computer nel pool. SecretsManagementSettings

PoolImage

Nome Descrizione Valore
Alias Elenco di alias per cui fare riferimento all'immagine. string[]
buffer Percentuale del buffer da allocare a questa immagine. corda
resourceId ID risorsa dell'immagine. corda
wellKnownImageName Immagine da usare da un set noto di immagini rese disponibili ai clienti. corda

PoolProprietà

Nome Descrizione Valore
agentProfile Definisce la modalità di gestione del computer dopo l'esecuzione di un processo. AgentProfile (obbligatorio)
devCenterProjectResourceId ID risorsa del progetto DevCenter a cui appartiene il pool. stringa (obbligatorio)
fabricProfile Definisce il tipo di infrastruttura in cui verrà eseguito l'agente. FabricProfile (obbligatorio)
maximumConcurrency Definisce il numero di risorse che è possibile creare in qualsiasi momento. Int

Vincoli:
Valore minimo = 1
Valore massimo = 10000 (obbligatorio)
organizationProfile Definisce l'organizzazione in cui verrà usato il pool. OrganizationProfile (obbligatorio)
provisioningState Stato dell'operazione corrente. 'Accepted'
'Annullato'
'Eliminazione'
'Failed'
'Provisioning'
'Succeeded'
'Aggiornamento'

ResourcePredictionsProfile

Nome Descrizione Valore
gentile Impostare su 'Automatic' per il tipo AutomaticResourcePredictionsProfile. Impostare su 'Manual' per il tipo ManualResourcePredictionsProfile. 'Automatico'
'Manual' (obbligatorio)

SecretsManagementSettings

Nome Descrizione Valore
certificateStoreLocation Dove archiviare i certificati nel computer. corda
keyExportable Definisce se la chiave dei certificati deve essere esportabile. bool (obbligatorio)
observedCertificates Elenco di certificati da installare in tutti i computer nel pool. string[] (obbligatorio)

Stateful

Nome Descrizione Valore
gracePeriodTimeSpan Quanto tempo deve essere mantenuto il computer dopo l'esecuzione di un carico di lavoro quando non sono presenti agenti stand-by. Il valore massimo è una settimana. corda
gentile Proprietà discriminatoria per AgentProfile. 'Con stato' (obbligatorio)
maxAgentLifetime Per quanto tempo devono essere mantenute le macchine con stato. Il valore massimo è una settimana. corda

StatelessAgentProfile

Nome Descrizione Valore
gentile Proprietà discriminatoria per AgentProfile. 'Senza stato' (obbligatorio)

StorageProfile

Nome Descrizione Valore
dataDisks Elenco di dischi dati vuoti da collegare. DataDisk[]
osDiskStorageAccountType Nome dello SKU di Azure dei computer nel pool. 'Premium'
'Standard'
'StandardSSD'

TrackedResourceTags

Nome Descrizione Valore

UserAssignedIdentities

Nome Descrizione Valore

UserAssignedIdentity

Nome Descrizione Valore

VmssFabricProfile

Nome Descrizione Valore
Immagini Immagini di macchine virtuali dei computer nel pool. PoolImage[] (obbligatorio)
gentile Proprietà discriminatoria per FabricProfile. 'Vmss' (obbligatorio)
networkProfile Profilo di rete dei computer nel pool. NetworkProfile
osProfile Profilo del sistema operativo dei computer nel pool. OsProfile
Sku SKU di Azure dei computer nel pool. DevOpsAzureSku (obbligatorio)
storageProfile Profilo di archiviazione dei computer nel pool. StorageProfile