Condividi tramite

Pool Microsoft.DevOpsInfrastructure 2023-10-30-preview

  • 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@2023-10-30-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    agentProfile: {
      resourcePredictions: any(Azure.Bicep.Types.Concrete.AnyType)
      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 OrganizationProfile

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

Per AzureDevOps, usare:

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

Oggetti AgentProfile

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

Per con stato, usare:

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

Per senza stato, usare:

{
  kind: 'Stateless'
}

Oggetti FabricProfile

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

Per vmss, usare:

{
  images: [
    {
      aliases: [
        'string'
      ]
      buffer: 'string'
      resourceId: 'string'
    }
  ]
  kind: 'Vmss'
  networkProfile: {
    subnetId: 'string'
  }
  osProfile: {
    secretsManagementSettings: {
      certificateStoreLocation: 'string'
      keyExportable: bool
      observedCertificates: [
        'string'
      ]
    }
  }
  sku: {
    name: 'string'
    tier: 'string'
  }
}

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 il buffer del pool. qualunque

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)

DevOpsAzureSku

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

FabricProfile

Nome Descrizione Valore
gentile Impostare su "Vmss" per il tipo VmssFabricProfile. 'Vmss' (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

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-z][a-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. 'AzureDevOps' (obbligatorio)

OsProfile

Nome Descrizione Valore
secretsManagementSettings Impostazioni di gestione dei segreti dei computer nel pool. SecretsManagementSettings (obbligatorio)

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. stringa (obbligatorio)

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'

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
gentile Proprietà discriminatoria per AgentProfile. 'Con stato' (obbligatorio)
maxAgentLifetime Per quanto tempo devono essere mantenute le macchine con stato. Il valore massimo è una settimana. stringa (obbligatorio)

StatelessAgentProfile

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

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)

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": "2023-10-30-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "agentProfile": {
      "resourcePredictions": {},
      "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 OrganizationProfile

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

Per AzureDevOps, usare:

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

Oggetti AgentProfile

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

Per con stato, usare:

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

Per senza stato, usare:

{
  "kind": "Stateless"
}

Oggetti FabricProfile

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

Per vmss, usare:

{
  "images": [
    {
      "aliases": [ "string" ],
      "buffer": "string",
      "resourceId": "string"
    }
  ],
  "kind": "Vmss",
  "networkProfile": {
    "subnetId": "string"
  },
  "osProfile": {
    "secretsManagementSettings": {
      "certificateStoreLocation": "string",
      "keyExportable": "bool",
      "observedCertificates": [ "string" ]
    }
  },
  "sku": {
    "name": "string",
    "tier": "string"
  }
}

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 il buffer del pool. qualunque

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)

DevOpsAzureSku

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

FabricProfile

Nome Descrizione Valore
gentile Impostare su "Vmss" per il tipo VmssFabricProfile. 'Vmss' (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

Microsoft.DevOpsInfrastructure/pools

Nome Descrizione Valore
apiVersion Versione dell'API '2023-10-30-preview'
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-z][a-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. 'AzureDevOps' (obbligatorio)

OsProfile

Nome Descrizione Valore
secretsManagementSettings Impostazioni di gestione dei segreti dei computer nel pool. SecretsManagementSettings (obbligatorio)

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. stringa (obbligatorio)

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'

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
gentile Proprietà discriminatoria per AgentProfile. 'Con stato' (obbligatorio)
maxAgentLifetime Per quanto tempo devono essere mantenute le macchine con stato. Il valore massimo è una settimana. stringa (obbligatorio)

StatelessAgentProfile

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

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)

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@2023-10-30-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      agentProfile = {
        resourcePredictions = ?
        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 OrganizationProfile

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

Per AzureDevOps, usare:

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

Oggetti AgentProfile

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

Per con stato, usare:

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

Per senza stato, usare:

{
  kind = "Stateless"
}

Oggetti FabricProfile

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

Per vmss, usare:

{
  images = [
    {
      aliases = [
        "string"
      ]
      buffer = "string"
      resourceId = "string"
    }
  ]
  kind = "Vmss"
  networkProfile = {
    subnetId = "string"
  }
  osProfile = {
    secretsManagementSettings = {
      certificateStoreLocation = "string"
      keyExportable = bool
      observedCertificates = [
        "string"
      ]
    }
  }
  sku = {
    name = "string"
    tier = "string"
  }
}

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 il buffer del pool. qualunque

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)

DevOpsAzureSku

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

FabricProfile

Nome Descrizione Valore
gentile Impostare su "Vmss" per il tipo VmssFabricProfile. 'Vmss' (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

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-z][a-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@2023-10-30-preview"

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. 'AzureDevOps' (obbligatorio)

OsProfile

Nome Descrizione Valore
secretsManagementSettings Impostazioni di gestione dei segreti dei computer nel pool. SecretsManagementSettings (obbligatorio)

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. stringa (obbligatorio)

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'

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
gentile Proprietà discriminatoria per AgentProfile. 'Con stato' (obbligatorio)
maxAgentLifetime Per quanto tempo devono essere mantenute le macchine con stato. Il valore massimo è una settimana. stringa (obbligatorio)

StatelessAgentProfile

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

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)