Freigeben über


Microsoft.DevOpsInfrastructure Pools

Bicep-Ressourcendefinition

Der Ressourcentyp "Pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DevOpsInfrastructure/pools-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep hinzu.

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'
  }
}

AgentProfile-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für stateful:

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

Verwenden Sie für stateless:

{
  kind: 'Stateless'
}

ResourcePredictionsProfile-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für automatischen:

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

Verwenden Sie für manuellen:

{
  kind: 'Manual'
}

FabricProfile-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für vmss:

{
  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'
  }
}

OrganizationProfile-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für AzureDevOps-:

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

Verwenden Sie für GitHub-:

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

Eigenschaftswerte

AgentProfile

Name Beschreibung Wert
Art Legen Sie für den Typ Statefulauf "Stateful" fest. Wird für den Typ StatelessAgentProfile-auf "Stateless" festgelegt. "Stateful"
"Stateless" (erforderlich)
resourcePredictions Definiert Poolpuffer/Stand-by-Agents. jegliche
resourcePredictionsProfile Definiert, wie der Poolpuffer/stand-by-Agents bereitgestellt wird. ResourcePredictionsProfile-

AutomaticResourcePredictionsProfile

Name Beschreibung Wert
Art Bestimmt, wie das stand-by-Schema bereitgestellt werden soll. "Automatisch" (erforderlich)
predictionPreference Bestimmt das Gleichgewicht zwischen Kosten und Leistung. "Ausgewogen"
'BestPerformance'
"MoreCostEffective"
'MorePerformance'
"MostCostEffective"

AzureDevOpsOrganizationProfile

Name Beschreibung Wert
Art Diskriminator-Eigenschaft für OrganizationProfile. "AzureDevOps" (erforderlich)
Organisationen Die Liste der Azure DevOps-Organisationen, in der der Pool vorhanden sein sollte. Organisation[] (erforderlich)
permissionProfile Der Berechtigungstyp, der bestimmt, welche Konten Administratoren im Azure DevOps-Pool sind. AzureDevOpsPermissionProfile-

AzureDevOpsPermissionProfile

Name Beschreibung Wert
Gruppen Gruppen-E-Mail-Adressen string[]
Art Bestimmt, wer über Administratorberechtigungen für den Azure DevOps-Pool verfügt. "CreatorOnly"
'Erben'
"SpecificAccounts" (erforderlich)
Benutzer E-Mail-Adressen des Benutzers string[]

DataDisk

Name Beschreibung Wert
Caching Der Typ der Zwischenspeicherung, die für die Datenträger aktiviert werden soll. Der Standardwert für die Zwischenspeicherung ist "readwrite". Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'None'
'ReadOnly'
'ReadWrite'
diskSizeGiB Die anfängliche Datenträgergröße in Gigabyte. Int
driveLetter Der Laufwerkbuchstaben für den leeren Datenträger. Wenn nicht angegeben, ist es der erste verfügbare Buchstabe. Schnur
storageAccountType Der Speicherkontotyp, der für den Datenträger verwendet werden soll. Wenn nicht angegeben, lautet der Standardwert "standard_lrs". "Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"

DevOpsAzureSku

Name Beschreibung Wert
Name Der Azure-SKU-Name der Computer im Pool. Zeichenfolge (erforderlich)

FabricProfile

Name Beschreibung Wert
Art Legen Sie für den Typ VmssFabricProfileauf "Vmss" fest. "Vmss" (erforderlich)

GitHubOrganization

Name Beschreibung Wert
repositorien Optionale Liste der Repositorys, in denen der Pool erstellt werden soll. string[]
URL Die GitHub-Organisations-URL, in der der Pool erstellt werden soll. Zeichenfolge (erforderlich)

GitHubOrganizationProfile

Name Beschreibung Wert
Art Diskriminator-Eigenschaft für OrganizationProfile. 'GitHub' (erforderlich)
Organisationen Die Liste der GitHub-Organisationen/Repositorys, in der der Pool vorhanden sein sollte. GitHubOrganization-[] (erforderlich)

ManagedServiceIdentity

Name Beschreibung Wert
Art Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). 'None'
'SystemAssigned'
"SystemAssigned,UserAssigned"
"UserAssigned" (erforderlich)
userAssignedIdentities Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. UserAssignedIdentities-

ManualResourcePredictionsProfile

Name Beschreibung Wert
Art Bestimmt, wie das stand-by-Schema bereitgestellt werden soll. "Manuell" (erforderlich)

Microsoft.DevOpsInfrastructure/pools

Name Beschreibung Wert
Identität Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. ManagedServiceIdentity-
Ort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Schnur

Zwänge:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (erforderlich)
Eigenschaften Die ressourcenspezifischen Eigenschaften für diese Ressource. PoolProperties-
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

NetworkProfile

Name Beschreibung Wert
subnetz-ID Die Subnetz-ID, auf der alle Computer im Pool erstellt werden sollen. Zeichenfolge (erforderlich)

Organisation

Name Beschreibung Wert
Parallelismus Anzahl der Computer, die maximal in dieser Organisation erstellt werden können, aus der maximalen Anzahl der Pools. Int
Projekte Optionale Liste der Projekte, in denen der Pool erstellt werden soll. string[]
URL Die Azure DevOps-Organisations-URL, in der der Pool erstellt werden soll. Zeichenfolge (erforderlich)

OrganizationProfile

Name Beschreibung Wert
Art Legen Sie für den Typ AzureDevOpsOrganizationProfileauf "AzureDevOpsOrganizationProfile" fest. Set to 'GitHub' for type GitHubOrganizationProfile. "AzureDevOps"
'GitHub' (erforderlich)

OsProfile

Name Beschreibung Wert
logonType Bestimmt, wie der Dienst ausgeführt werden soll. Standardmäßig wird dies auf "Dienst" festgelegt. "Interaktiv"
'Service'
secretsManagementSettings Die Einstellungen für die geheime Verwaltung der Computer im Pool. SecretsManagementSettings

PoolImage

Name Beschreibung Wert
decknamen Liste der Aliase, nach der auf das Bild verwiesen werden soll. string[]
Puffer Der Prozentsatz des Puffers, der diesem Bild zugeordnet werden soll. Schnur
resourceId Die Ressourcen-ID des Bilds. Schnur
wellKnownImageName Das Bild, das von einer bekannten Gruppe von Bildern verwendet werden soll, die Kunden zur Verfügung gestellt werden. Schnur

PoolProperties

Name Beschreibung Wert
agentProfile Definiert, wie der Computer verarbeitet wird, nachdem er einen Auftrag ausgeführt hat. AgentProfile- (erforderlich)
devCenterProjectResourceId Die Ressourcen-ID des DevCenter-Projekts, zu dem der Pool gehört. Zeichenfolge (erforderlich)
fabricProfile Definiert den Typ der Fabric, auf der der Agent ausgeführt wird. FabricProfile- (erforderlich)
maximumConcurrency Definiert, wie viele Ressourcen zu einem bestimmten Zeitpunkt erstellt werden können. Int

Zwänge:
Min.-Wert = 1
Maximalwert = 10000 (erforderlich)
organizationProfile Definiert die Organisation, in der der Pool verwendet wird. OrganizationProfile- (erforderlich)
provisioningState Der Status des aktuellen Vorgangs. "Akzeptiert"
'Abgebrochen'
"Löschen"
'Fehler'
'Bereitstellung'
"Erfolgreich"
"Aktualisieren"

ResourcePredictionsProfile

Name Beschreibung Wert
Art Legen Sie für den Typ AutomaticResourcePredictionsProfileauf "Automatisch" fest. Set to 'Manual' for type ManualResourcePredictionsProfile. "Automatisch"
"Manuell" (erforderlich)

SecretsManagementSettings

Name Beschreibung Wert
certificateStoreLocation Speicherort für Zertifikate auf dem Computer. Schnur
keyExportable Definiert, ob der Schlüssel der Zertifikate exportierbar sein soll. bool (erforderlich)
observedCertificates Die Liste der Zertifikate, die auf allen Computern im Pool installiert werden sollen. string[] (erforderlich)

Zustandsorientiert

Name Beschreibung Wert
gracePeriodTimeSpan Wie lange sollte der Computer beibehalten werden, nachdem er eine Workload ausgeführt hat, wenn keine eigenständigen Agents vorhanden sind. Das Maximum beträgt eine Woche. Schnur
Art Diskriminator-Eigenschaft für AgentProfile. "Stateful" (erforderlich)
maxAgentLifetime Wie lange zustandsbehaftete Computer beibehalten werden sollen. Das Maximum beträgt eine Woche. Schnur

StatelessAgentProfile

Name Beschreibung Wert
Art Diskriminator-Eigenschaft für AgentProfile. "Stateless" (erforderlich)

StorageProfile

Name Beschreibung Wert
dataDisks Eine Liste leerer Datenträger, die angefügt werden sollen. DataDisk-[]
osDiskStorageAccountType Der Azure-SKU-Name der Computer im Pool. "Premium"
"Standard"
"StandardSSD"

TrackedResourceTags

Name Beschreibung Wert

UserAssignedIdentities

Name Beschreibung Wert

UserAssignedIdentity

Name Beschreibung Wert

VmssFabricProfile

Name Beschreibung Wert
Bilder Die VM-Images der Computer im Pool. PoolImage-[] (erforderlich)
Art Diskriminator-Eigenschaft für FabricProfile. "Vmss" (erforderlich)
networkProfile Das Netzwerkprofil der Computer im Pool. NetworkProfile-
osProfile Das Betriebssystemprofil der Computer im Pool. OsProfile-
Sku Die Azure-SKU der Computer im Pool. DevOpsAzureSku- (erforderlich)
storageProfile Das Speicherprofil der Computer im Pool. StorageProfile-

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "Pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DevOpsInfrastructure/pools-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

{
  "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"
  }
}

AgentProfile-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für stateful:

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

Verwenden Sie für stateless:

{
  "kind": "Stateless"
}

ResourcePredictionsProfile-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für automatischen:

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

Verwenden Sie für manuellen:

{
  "kind": "Manual"
}

FabricProfile-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für vmss:

{
  "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"
  }
}

OrganizationProfile-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für AzureDevOps-:

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

Verwenden Sie für GitHub-:

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

Eigenschaftswerte

AgentProfile

Name Beschreibung Wert
Art Legen Sie für den Typ Statefulauf "Stateful" fest. Wird für den Typ StatelessAgentProfile-auf "Stateless" festgelegt. "Stateful"
"Stateless" (erforderlich)
resourcePredictions Definiert Poolpuffer/Stand-by-Agents. jegliche
resourcePredictionsProfile Definiert, wie der Poolpuffer/stand-by-Agents bereitgestellt wird. ResourcePredictionsProfile-

AutomaticResourcePredictionsProfile

Name Beschreibung Wert
Art Bestimmt, wie das stand-by-Schema bereitgestellt werden soll. "Automatisch" (erforderlich)
predictionPreference Bestimmt das Gleichgewicht zwischen Kosten und Leistung. "Ausgewogen"
'BestPerformance'
"MoreCostEffective"
'MorePerformance'
"MostCostEffective"

AzureDevOpsOrganizationProfile

Name Beschreibung Wert
Art Diskriminator-Eigenschaft für OrganizationProfile. "AzureDevOps" (erforderlich)
Organisationen Die Liste der Azure DevOps-Organisationen, in der der Pool vorhanden sein sollte. Organisation[] (erforderlich)
permissionProfile Der Berechtigungstyp, der bestimmt, welche Konten Administratoren im Azure DevOps-Pool sind. AzureDevOpsPermissionProfile-

AzureDevOpsPermissionProfile

Name Beschreibung Wert
Gruppen Gruppen-E-Mail-Adressen string[]
Art Bestimmt, wer über Administratorberechtigungen für den Azure DevOps-Pool verfügt. "CreatorOnly"
'Erben'
"SpecificAccounts" (erforderlich)
Benutzer E-Mail-Adressen des Benutzers string[]

DataDisk

Name Beschreibung Wert
Caching Der Typ der Zwischenspeicherung, die für die Datenträger aktiviert werden soll. Der Standardwert für die Zwischenspeicherung ist "readwrite". Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'None'
'ReadOnly'
'ReadWrite'
diskSizeGiB Die anfängliche Datenträgergröße in Gigabyte. Int
driveLetter Der Laufwerkbuchstaben für den leeren Datenträger. Wenn nicht angegeben, ist es der erste verfügbare Buchstabe. Schnur
storageAccountType Der Speicherkontotyp, der für den Datenträger verwendet werden soll. Wenn nicht angegeben, lautet der Standardwert "standard_lrs". "Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"

DevOpsAzureSku

Name Beschreibung Wert
Name Der Azure-SKU-Name der Computer im Pool. Zeichenfolge (erforderlich)

FabricProfile

Name Beschreibung Wert
Art Legen Sie für den Typ VmssFabricProfileauf "Vmss" fest. "Vmss" (erforderlich)

GitHubOrganization

Name Beschreibung Wert
repositorien Optionale Liste der Repositorys, in denen der Pool erstellt werden soll. string[]
URL Die GitHub-Organisations-URL, in der der Pool erstellt werden soll. Zeichenfolge (erforderlich)

GitHubOrganizationProfile

Name Beschreibung Wert
Art Diskriminator-Eigenschaft für OrganizationProfile. 'GitHub' (erforderlich)
Organisationen Die Liste der GitHub-Organisationen/Repositorys, in der der Pool vorhanden sein sollte. GitHubOrganization-[] (erforderlich)

ManagedServiceIdentity

Name Beschreibung Wert
Art Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). 'None'
'SystemAssigned'
"SystemAssigned,UserAssigned"
"UserAssigned" (erforderlich)
userAssignedIdentities Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. UserAssignedIdentities-

ManualResourcePredictionsProfile

Name Beschreibung Wert
Art Bestimmt, wie das stand-by-Schema bereitgestellt werden soll. "Manuell" (erforderlich)

Microsoft.DevOpsInfrastructure/pools

Name Beschreibung Wert
apiVersion Die API-Version '2024-10-19'
Identität Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. ManagedServiceIdentity-
Ort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Schnur

Zwänge:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (erforderlich)
Eigenschaften Die ressourcenspezifischen Eigenschaften für diese Ressource. PoolProperties-
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art Der Ressourcentyp "Microsoft.DevOpsInfrastructure/pools"

NetworkProfile

Name Beschreibung Wert
subnetz-ID Die Subnetz-ID, auf der alle Computer im Pool erstellt werden sollen. Zeichenfolge (erforderlich)

Organisation

Name Beschreibung Wert
Parallelismus Anzahl der Computer, die maximal in dieser Organisation erstellt werden können, aus der maximalen Anzahl der Pools. Int
Projekte Optionale Liste der Projekte, in denen der Pool erstellt werden soll. string[]
URL Die Azure DevOps-Organisations-URL, in der der Pool erstellt werden soll. Zeichenfolge (erforderlich)

OrganizationProfile

Name Beschreibung Wert
Art Legen Sie für den Typ AzureDevOpsOrganizationProfileauf "AzureDevOpsOrganizationProfile" fest. Set to 'GitHub' for type GitHubOrganizationProfile. "AzureDevOps"
'GitHub' (erforderlich)

OsProfile

Name Beschreibung Wert
logonType Bestimmt, wie der Dienst ausgeführt werden soll. Standardmäßig wird dies auf "Dienst" festgelegt. "Interaktiv"
'Service'
secretsManagementSettings Die Einstellungen für die geheime Verwaltung der Computer im Pool. SecretsManagementSettings

PoolImage

Name Beschreibung Wert
decknamen Liste der Aliase, nach der auf das Bild verwiesen werden soll. string[]
Puffer Der Prozentsatz des Puffers, der diesem Bild zugeordnet werden soll. Schnur
resourceId Die Ressourcen-ID des Bilds. Schnur
wellKnownImageName Das Bild, das von einer bekannten Gruppe von Bildern verwendet werden soll, die Kunden zur Verfügung gestellt werden. Schnur

PoolProperties

Name Beschreibung Wert
agentProfile Definiert, wie der Computer verarbeitet wird, nachdem er einen Auftrag ausgeführt hat. AgentProfile- (erforderlich)
devCenterProjectResourceId Die Ressourcen-ID des DevCenter-Projekts, zu dem der Pool gehört. Zeichenfolge (erforderlich)
fabricProfile Definiert den Typ der Fabric, auf der der Agent ausgeführt wird. FabricProfile- (erforderlich)
maximumConcurrency Definiert, wie viele Ressourcen zu einem bestimmten Zeitpunkt erstellt werden können. Int

Zwänge:
Min.-Wert = 1
Maximalwert = 10000 (erforderlich)
organizationProfile Definiert die Organisation, in der der Pool verwendet wird. OrganizationProfile- (erforderlich)
provisioningState Der Status des aktuellen Vorgangs. "Akzeptiert"
'Abgebrochen'
"Löschen"
'Fehler'
'Bereitstellung'
"Erfolgreich"
"Aktualisieren"

ResourcePredictionsProfile

Name Beschreibung Wert
Art Legen Sie für den Typ AutomaticResourcePredictionsProfileauf "Automatisch" fest. Set to 'Manual' for type ManualResourcePredictionsProfile. "Automatisch"
"Manuell" (erforderlich)

SecretsManagementSettings

Name Beschreibung Wert
certificateStoreLocation Speicherort für Zertifikate auf dem Computer. Schnur
keyExportable Definiert, ob der Schlüssel der Zertifikate exportierbar sein soll. bool (erforderlich)
observedCertificates Die Liste der Zertifikate, die auf allen Computern im Pool installiert werden sollen. string[] (erforderlich)

Zustandsorientiert

Name Beschreibung Wert
gracePeriodTimeSpan Wie lange sollte der Computer beibehalten werden, nachdem er eine Workload ausgeführt hat, wenn keine eigenständigen Agents vorhanden sind. Das Maximum beträgt eine Woche. Schnur
Art Diskriminator-Eigenschaft für AgentProfile. "Stateful" (erforderlich)
maxAgentLifetime Wie lange zustandsbehaftete Computer beibehalten werden sollen. Das Maximum beträgt eine Woche. Schnur

StatelessAgentProfile

Name Beschreibung Wert
Art Diskriminator-Eigenschaft für AgentProfile. "Stateless" (erforderlich)

StorageProfile

Name Beschreibung Wert
dataDisks Eine Liste leerer Datenträger, die angefügt werden sollen. DataDisk-[]
osDiskStorageAccountType Der Azure-SKU-Name der Computer im Pool. "Premium"
"Standard"
"StandardSSD"

TrackedResourceTags

Name Beschreibung Wert

UserAssignedIdentities

Name Beschreibung Wert

UserAssignedIdentity

Name Beschreibung Wert

VmssFabricProfile

Name Beschreibung Wert
Bilder Die VM-Images der Computer im Pool. PoolImage-[] (erforderlich)
Art Diskriminator-Eigenschaft für FabricProfile. "Vmss" (erforderlich)
networkProfile Das Netzwerkprofil der Computer im Pool. NetworkProfile-
osProfile Das Betriebssystemprofil der Computer im Pool. OsProfile-
Sku Die Azure-SKU der Computer im Pool. DevOpsAzureSku- (erforderlich)
storageProfile Das Speicherprofil der Computer im Pool. StorageProfile-

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "Pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.DevOpsInfrastructure/pools-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevOpsInfrastructure/pools@2024-10-19"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "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"
    }
  })
  tags = {
    {customized property} = "string"
  }
}

AgentProfile-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für stateful:

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

Verwenden Sie für stateless:

{
  kind = "Stateless"
}

ResourcePredictionsProfile-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für automatischen:

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

Verwenden Sie für manuellen:

{
  kind = "Manual"
}

FabricProfile-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für vmss:

{
  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"
  }
}

OrganizationProfile-Objekte

Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für AzureDevOps-:

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

Verwenden Sie für GitHub-:

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

Eigenschaftswerte

AgentProfile

Name Beschreibung Wert
Art Legen Sie für den Typ Statefulauf "Stateful" fest. Wird für den Typ StatelessAgentProfile-auf "Stateless" festgelegt. "Stateful"
"Stateless" (erforderlich)
resourcePredictions Definiert Poolpuffer/Stand-by-Agents. jegliche
resourcePredictionsProfile Definiert, wie der Poolpuffer/stand-by-Agents bereitgestellt wird. ResourcePredictionsProfile-

AutomaticResourcePredictionsProfile

Name Beschreibung Wert
Art Bestimmt, wie das stand-by-Schema bereitgestellt werden soll. "Automatisch" (erforderlich)
predictionPreference Bestimmt das Gleichgewicht zwischen Kosten und Leistung. "Ausgewogen"
'BestPerformance'
"MoreCostEffective"
'MorePerformance'
"MostCostEffective"

AzureDevOpsOrganizationProfile

Name Beschreibung Wert
Art Diskriminator-Eigenschaft für OrganizationProfile. "AzureDevOps" (erforderlich)
Organisationen Die Liste der Azure DevOps-Organisationen, in der der Pool vorhanden sein sollte. Organisation[] (erforderlich)
permissionProfile Der Berechtigungstyp, der bestimmt, welche Konten Administratoren im Azure DevOps-Pool sind. AzureDevOpsPermissionProfile-

AzureDevOpsPermissionProfile

Name Beschreibung Wert
Gruppen Gruppen-E-Mail-Adressen string[]
Art Bestimmt, wer über Administratorberechtigungen für den Azure DevOps-Pool verfügt. "CreatorOnly"
'Erben'
"SpecificAccounts" (erforderlich)
Benutzer E-Mail-Adressen des Benutzers string[]

DataDisk

Name Beschreibung Wert
Caching Der Typ der Zwischenspeicherung, die für die Datenträger aktiviert werden soll. Der Standardwert für die Zwischenspeicherung ist "readwrite". Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'None'
'ReadOnly'
'ReadWrite'
diskSizeGiB Die anfängliche Datenträgergröße in Gigabyte. Int
driveLetter Der Laufwerkbuchstaben für den leeren Datenträger. Wenn nicht angegeben, ist es der erste verfügbare Buchstabe. Schnur
storageAccountType Der Speicherkontotyp, der für den Datenträger verwendet werden soll. Wenn nicht angegeben, lautet der Standardwert "standard_lrs". "Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"

DevOpsAzureSku

Name Beschreibung Wert
Name Der Azure-SKU-Name der Computer im Pool. Zeichenfolge (erforderlich)

FabricProfile

Name Beschreibung Wert
Art Legen Sie für den Typ VmssFabricProfileauf "Vmss" fest. "Vmss" (erforderlich)

GitHubOrganization

Name Beschreibung Wert
repositorien Optionale Liste der Repositorys, in denen der Pool erstellt werden soll. string[]
URL Die GitHub-Organisations-URL, in der der Pool erstellt werden soll. Zeichenfolge (erforderlich)

GitHubOrganizationProfile

Name Beschreibung Wert
Art Diskriminator-Eigenschaft für OrganizationProfile. 'GitHub' (erforderlich)
Organisationen Die Liste der GitHub-Organisationen/Repositorys, in der der Pool vorhanden sein sollte. GitHubOrganization-[] (erforderlich)

ManagedServiceIdentity

Name Beschreibung Wert
Art Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). 'None'
'SystemAssigned'
"SystemAssigned,UserAssigned"
"UserAssigned" (erforderlich)
userAssignedIdentities Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. UserAssignedIdentities-

ManualResourcePredictionsProfile

Name Beschreibung Wert
Art Bestimmt, wie das stand-by-Schema bereitgestellt werden soll. "Manuell" (erforderlich)

Microsoft.DevOpsInfrastructure/pools

Name Beschreibung Wert
Identität Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. ManagedServiceIdentity-
Ort Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
Name Der Ressourcenname Schnur

Zwänge:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (erforderlich)
Eigenschaften Die ressourcenspezifischen Eigenschaften für diese Ressource. PoolProperties-
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte.
Art Der Ressourcentyp "Microsoft.DevOpsInfrastructure/pools@2024-10-19"

NetworkProfile

Name Beschreibung Wert
subnetz-ID Die Subnetz-ID, auf der alle Computer im Pool erstellt werden sollen. Zeichenfolge (erforderlich)

Organisation

Name Beschreibung Wert
Parallelismus Anzahl der Computer, die maximal in dieser Organisation erstellt werden können, aus der maximalen Anzahl der Pools. Int
Projekte Optionale Liste der Projekte, in denen der Pool erstellt werden soll. string[]
URL Die Azure DevOps-Organisations-URL, in der der Pool erstellt werden soll. Zeichenfolge (erforderlich)

OrganizationProfile

Name Beschreibung Wert
Art Legen Sie für den Typ AzureDevOpsOrganizationProfileauf "AzureDevOpsOrganizationProfile" fest. Set to 'GitHub' for type GitHubOrganizationProfile. "AzureDevOps"
'GitHub' (erforderlich)

OsProfile

Name Beschreibung Wert
logonType Bestimmt, wie der Dienst ausgeführt werden soll. Standardmäßig wird dies auf "Dienst" festgelegt. "Interaktiv"
'Service'
secretsManagementSettings Die Einstellungen für die geheime Verwaltung der Computer im Pool. SecretsManagementSettings

PoolImage

Name Beschreibung Wert
decknamen Liste der Aliase, nach der auf das Bild verwiesen werden soll. string[]
Puffer Der Prozentsatz des Puffers, der diesem Bild zugeordnet werden soll. Schnur
resourceId Die Ressourcen-ID des Bilds. Schnur
wellKnownImageName Das Bild, das von einer bekannten Gruppe von Bildern verwendet werden soll, die Kunden zur Verfügung gestellt werden. Schnur

PoolProperties

Name Beschreibung Wert
agentProfile Definiert, wie der Computer verarbeitet wird, nachdem er einen Auftrag ausgeführt hat. AgentProfile- (erforderlich)
devCenterProjectResourceId Die Ressourcen-ID des DevCenter-Projekts, zu dem der Pool gehört. Zeichenfolge (erforderlich)
fabricProfile Definiert den Typ der Fabric, auf der der Agent ausgeführt wird. FabricProfile- (erforderlich)
maximumConcurrency Definiert, wie viele Ressourcen zu einem bestimmten Zeitpunkt erstellt werden können. Int

Zwänge:
Min.-Wert = 1
Maximalwert = 10000 (erforderlich)
organizationProfile Definiert die Organisation, in der der Pool verwendet wird. OrganizationProfile- (erforderlich)
provisioningState Der Status des aktuellen Vorgangs. "Akzeptiert"
'Abgebrochen'
"Löschen"
'Fehler'
'Bereitstellung'
"Erfolgreich"
"Aktualisieren"

ResourcePredictionsProfile

Name Beschreibung Wert
Art Legen Sie für den Typ AutomaticResourcePredictionsProfileauf "Automatisch" fest. Set to 'Manual' for type ManualResourcePredictionsProfile. "Automatisch"
"Manuell" (erforderlich)

SecretsManagementSettings

Name Beschreibung Wert
certificateStoreLocation Speicherort für Zertifikate auf dem Computer. Schnur
keyExportable Definiert, ob der Schlüssel der Zertifikate exportierbar sein soll. bool (erforderlich)
observedCertificates Die Liste der Zertifikate, die auf allen Computern im Pool installiert werden sollen. string[] (erforderlich)

Zustandsorientiert

Name Beschreibung Wert
gracePeriodTimeSpan Wie lange sollte der Computer beibehalten werden, nachdem er eine Workload ausgeführt hat, wenn keine eigenständigen Agents vorhanden sind. Das Maximum beträgt eine Woche. Schnur
Art Diskriminator-Eigenschaft für AgentProfile. "Stateful" (erforderlich)
maxAgentLifetime Wie lange zustandsbehaftete Computer beibehalten werden sollen. Das Maximum beträgt eine Woche. Schnur

StatelessAgentProfile

Name Beschreibung Wert
Art Diskriminator-Eigenschaft für AgentProfile. "Stateless" (erforderlich)

StorageProfile

Name Beschreibung Wert
dataDisks Eine Liste leerer Datenträger, die angefügt werden sollen. DataDisk-[]
osDiskStorageAccountType Der Azure-SKU-Name der Computer im Pool. "Premium"
"Standard"
"StandardSSD"

TrackedResourceTags

Name Beschreibung Wert

UserAssignedIdentities

Name Beschreibung Wert

UserAssignedIdentity

Name Beschreibung Wert

VmssFabricProfile

Name Beschreibung Wert
Bilder Die VM-Images der Computer im Pool. PoolImage-[] (erforderlich)
Art Diskriminator-Eigenschaft für FabricProfile. "Vmss" (erforderlich)
networkProfile Das Netzwerkprofil der Computer im Pool. NetworkProfile-
osProfile Das Betriebssystemprofil der Computer im Pool. OsProfile-
Sku Die Azure-SKU der Computer im Pool. DevOpsAzureSku- (erforderlich)
storageProfile Das Speicherprofil der Computer im Pool. StorageProfile-