Delen via


Microsoft.DevOpsInfrastructure-pools

Bicep-resourcedefinitie

Het resourcetype pools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een resource voor Microsoft.DevOpsInfrastructure/pools wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

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-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor Stateful:

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

Gebruik voor stateless:

{
  kind: 'Stateless'
}

ResourcePredictionsProfile-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor Automatische:

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

Voor Handmatigegebruikt u:

{
  kind: 'Manual'
}

FabricProfile-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor 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-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor AzureDevOps-:

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

Gebruik voor GitHub:

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

Eigenschapswaarden

AgentProfile

Naam Beschrijving Waarde
soort Ingesteld op Stateful voor het type Stateful. Ingesteld op Staatloos voor het type StatelessAgentProfile. 'Stateful'
Staatloos (vereist)
resourcePredictions Definieert poolbuffer/stand-by-agents. enig
resourcePredictionsProfile Hiermee definieert u hoe de poolbuffer/stand-by-agents worden geleverd. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Naam Beschrijving Waarde
soort Bepaalt hoe het standaardschema moet worden verstrekt. 'Automatisch' (vereist)
predictionPreference Bepaalt de balans tussen kosten en prestaties. 'Evenwichtig'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Naam Beschrijving Waarde
soort De eigenschap Discriminator voor OrganizationProfile. 'AzureDevOps' (vereist)
Organisaties De lijst met Azure DevOps-organisaties waarin de pool moet aanwezig zijn. Organisatie[] (vereist)
permissionProfile Het type machtiging dat bepaalt welke accounts beheerders zijn in de Azure DevOps-pool. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Naam Beschrijving Waarde
groepen E-mailadressen groeperen tekenreeks[]
soort Bepaalt wie beheerdersmachtigingen heeft voor de Azure DevOps-pool. 'CreatorOnly'
'Overnemen'
'SpecificAccounts' (vereist)
Gebruikers E-mailadressen van gebruikers tekenreeks[]

DataDisk

Naam Beschrijving Waarde
Caching Het type caching dat moet worden ingeschakeld voor de gegevensschijven. De standaardwaarde voor opslaan in cache is readwrite. Zie voor meer informatie over de cacheopties: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'Geen'
'ReadOnly'
'ReadWrite'
diskSizeGiB De initiële schijfgrootte in gigabytes. Int
driveLetter De stationsletter voor de lege gegevensschijf. Als dit niet is opgegeven, is dit de eerste beschikbare letter. snaar
storageAccountType Het type opslagaccount dat moet worden gebruikt voor de gegevensschijf. Als u dit weglaat, is de standaardwaarde 'standard_lrs'. 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Naam Beschrijving Waarde
naam De Azure SKU-naam van de machines in de pool. tekenreeks (vereist)

FabricProfile

Naam Beschrijving Waarde
soort Ingesteld op 'Vmss' voor het type VmssFabricProfile. 'Vmss' (vereist)

GitHubOrganization

Naam Beschrijving Waarde
Repositories Optionele lijst met opslagplaatsen waarin de pool moet worden gemaakt. tekenreeks[]
URL De URL van de GitHub-organisatie waarin de pool moet worden gemaakt. tekenreeks (vereist)

GitHubOrganizationProfile

Naam Beschrijving Waarde
soort De eigenschap Discriminator voor OrganizationProfile. 'GitHub' (vereist)
Organisaties De lijst met GitHub-organisaties/opslagplaatsen waarin de pool moet aanwezig zijn. GitHubOrganization[] (vereist)

ManagedServiceIdentity

Naam Beschrijving Waarde
type Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). 'Geen'
'SystemAssigned'
'SystemAssigned, UserAssigned'
UserAssigned (vereist)
userAssignedIdentities De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. UserAssignedId-entiteiten

ManualResourcePredictionsProfile

Naam Beschrijving Waarde
soort Bepaalt hoe het standaardschema moet worden verstrekt. 'Handmatig' (vereist)

Microsoft.DevOpsInfrastructure/pools

Naam Beschrijving Waarde
identiteit De beheerde service-identiteiten die zijn toegewezen aan deze resource. ManagedServiceIdentity-
plaats De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
naam De resourcenaam snaar

Beperkingen:
Patroon = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (vereist)
Eigenschappen De resourcespecifieke eigenschappen voor deze resource. PoolProperties-
Tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen

NetworkProfile

Naam Beschrijving Waarde
subnetId De subnet-id waarop alle machines die in de pool zijn gemaakt, moeten worden geplaatst. tekenreeks (vereist)

Organisatie

Naam Beschrijving Waarde
Parallellisme Hoeveel machines maximaal in deze organisatie kunnen worden gemaakt uit de maximaleconcurrency van de pool. Int
Projecten Optionele lijst met projecten waarin de pool moet worden gemaakt. tekenreeks[]
URL De URL van de Azure DevOps-organisatie waarin de pool moet worden gemaakt. tekenreeks (vereist)

OrganizationProfile

Naam Beschrijving Waarde
soort Ingesteld op 'AzureDevOps' voor het type AzureDevOpsOrganizationProfile. Ingesteld op 'GitHub' voor het type GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (vereist)

OsProfile

Naam Beschrijving Waarde
logonType Bepaalt hoe de service moet worden uitgevoerd. Dit wordt standaard ingesteld op Service. 'Interactief'
'Service'
secretsManagementSettings De geheime beheerinstellingen van de machines in de pool. SecretsManagementSettings

PoolImage

Naam Beschrijving Waarde
Aliassen Lijst met aliassen om naar de afbeelding te verwijzen. tekenreeks[]
buffer Het percentage van de buffer dat aan deze afbeelding moet worden toegewezen. snaar
resourceId De resource-id van de installatiekopieën. snaar
wellKnownImageName De installatiekopieën die moeten worden gebruikt vanuit een bekende set afbeeldingen die beschikbaar worden gesteld aan klanten. snaar

PoolProperties

Naam Beschrijving Waarde
agentProfile Hiermee definieert u hoe de machine wordt verwerkt zodra deze een taak heeft uitgevoerd. AgentProfile (vereist)
devCenterProjectResourceId De resource-id van het DevCenter-project waartoe de pool behoort. tekenreeks (vereist)
fabricProfile Definieert het type infrastructuur waarop de agent wordt uitgevoerd. FabricProfile (vereist)
maximumConcurrency Hiermee definieert u hoeveel resources er op elk gewenst moment kunnen worden gemaakt. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 10000 (vereist)
organizationProfile Definieert de organisatie waarin de pool wordt gebruikt. OrganizationProfile (vereist)
provisioningState De status van de huidige bewerking. 'Geaccepteerd'
'Geannuleerd'
'Verwijderen'
'Mislukt'
'Inrichting'
'Geslaagd'
'Bijwerken'

ResourcePredictionsProfile

Naam Beschrijving Waarde
soort Ingesteld op Automatisch voor type AutomaticResourcePredictionsProfile. Ingesteld op 'Handmatig' voor type ManualResourcePredictionsProfile. 'Automatisch'
'Handmatig' (vereist)

SecretsManagementSettings

Naam Beschrijving Waarde
certificateStoreLocation Waar certificaten op de computer worden opgeslagen. snaar
keyExportable Hiermee wordt gedefinieerd of de sleutel van de certificaten moet kunnen worden geëxporteerd. bool (vereist)
observedCertificates De lijst met certificaten die op alle computers in de groep moeten worden geïnstalleerd. tekenreeks[] (vereist)

Stateful

Naam Beschrijving Waarde
gracePeriodTimeSpan Hoe lang moet de machine worden bewaard nadat er een workload is uitgevoerd wanneer er geen zelfstandige agents zijn. Het maximum is één week. snaar
soort De eigenschap Discriminator voor AgentProfile. Stateful (vereist)
maxAgentLifetime Hoe lang stateful machines moeten worden bewaard. Het maximum is één week. snaar

StatelessAgentProfile

Naam Beschrijving Waarde
soort De eigenschap Discriminator voor AgentProfile. Staatloos (vereist)

StorageProfile

Naam Beschrijving Waarde
dataDisks Een lijst met lege gegevensschijven die moeten worden gekoppeld. DataDisk[]
osDiskStorageAccountType De Azure SKU-naam van de machines in de pool. 'Premium'
'Standaard'
'StandardSSD'

TrackedResourceTags

Naam Beschrijving Waarde

UserAssignedIdentities

Naam Beschrijving Waarde

UserAssignedIdentity

Naam Beschrijving Waarde

VmssFabricProfile

Naam Beschrijving Waarde
beelden De VM-installatiekopieën van de machines in de pool. PoolImage[] (vereist)
soort De eigenschap Discriminator voor FabricProfile. 'Vmss' (vereist)
networkProfile Het netwerkprofiel van de machines in de groep. NetworkProfile
osProfile Het besturingssysteemprofiel van de machines in de pool. OsProfile
Sku De Azure-SKU van de machines in de pool. DevOpsAzureSku (vereist)
storageProfile Het opslagprofiel van de machines in de pool. StorageProfile

Resourcedefinitie van ARM-sjabloon

Het resourcetype pools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource microsoft.DevOpsInfrastructure/pools wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

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

Stel de eigenschap type in om het type object op te geven.

Gebruik voor Stateful:

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

Gebruik voor stateless:

{
  "kind": "Stateless"
}

ResourcePredictionsProfile-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor Automatische:

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

Voor Handmatigegebruikt u:

{
  "kind": "Manual"
}

FabricProfile-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor 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-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor AzureDevOps-:

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

Gebruik voor GitHub:

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

Eigenschapswaarden

AgentProfile

Naam Beschrijving Waarde
soort Ingesteld op Stateful voor het type Stateful. Ingesteld op Staatloos voor het type StatelessAgentProfile. 'Stateful'
Staatloos (vereist)
resourcePredictions Definieert poolbuffer/stand-by-agents. enig
resourcePredictionsProfile Hiermee definieert u hoe de poolbuffer/stand-by-agents worden geleverd. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Naam Beschrijving Waarde
soort Bepaalt hoe het standaardschema moet worden verstrekt. 'Automatisch' (vereist)
predictionPreference Bepaalt de balans tussen kosten en prestaties. 'Evenwichtig'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Naam Beschrijving Waarde
soort De eigenschap Discriminator voor OrganizationProfile. 'AzureDevOps' (vereist)
Organisaties De lijst met Azure DevOps-organisaties waarin de pool moet aanwezig zijn. Organisatie[] (vereist)
permissionProfile Het type machtiging dat bepaalt welke accounts beheerders zijn in de Azure DevOps-pool. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Naam Beschrijving Waarde
groepen E-mailadressen groeperen tekenreeks[]
soort Bepaalt wie beheerdersmachtigingen heeft voor de Azure DevOps-pool. 'CreatorOnly'
'Overnemen'
'SpecificAccounts' (vereist)
Gebruikers E-mailadressen van gebruikers tekenreeks[]

DataDisk

Naam Beschrijving Waarde
Caching Het type caching dat moet worden ingeschakeld voor de gegevensschijven. De standaardwaarde voor opslaan in cache is readwrite. Zie voor meer informatie over de cacheopties: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'Geen'
'ReadOnly'
'ReadWrite'
diskSizeGiB De initiële schijfgrootte in gigabytes. Int
driveLetter De stationsletter voor de lege gegevensschijf. Als dit niet is opgegeven, is dit de eerste beschikbare letter. snaar
storageAccountType Het type opslagaccount dat moet worden gebruikt voor de gegevensschijf. Als u dit weglaat, is de standaardwaarde 'standard_lrs'. 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Naam Beschrijving Waarde
naam De Azure SKU-naam van de machines in de pool. tekenreeks (vereist)

FabricProfile

Naam Beschrijving Waarde
soort Ingesteld op 'Vmss' voor het type VmssFabricProfile. 'Vmss' (vereist)

GitHubOrganization

Naam Beschrijving Waarde
Repositories Optionele lijst met opslagplaatsen waarin de pool moet worden gemaakt. tekenreeks[]
URL De URL van de GitHub-organisatie waarin de pool moet worden gemaakt. tekenreeks (vereist)

GitHubOrganizationProfile

Naam Beschrijving Waarde
soort De eigenschap Discriminator voor OrganizationProfile. 'GitHub' (vereist)
Organisaties De lijst met GitHub-organisaties/opslagplaatsen waarin de pool moet aanwezig zijn. GitHubOrganization[] (vereist)

ManagedServiceIdentity

Naam Beschrijving Waarde
type Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). 'Geen'
'SystemAssigned'
'SystemAssigned, UserAssigned'
UserAssigned (vereist)
userAssignedIdentities De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. UserAssignedId-entiteiten

ManualResourcePredictionsProfile

Naam Beschrijving Waarde
soort Bepaalt hoe het standaardschema moet worden verstrekt. 'Handmatig' (vereist)

Microsoft.DevOpsInfrastructure/pools

Naam Beschrijving Waarde
apiVersion De API-versie '2024-10-19'
identiteit De beheerde service-identiteiten die zijn toegewezen aan deze resource. ManagedServiceIdentity-
plaats De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
naam De resourcenaam snaar

Beperkingen:
Patroon = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (vereist)
Eigenschappen De resourcespecifieke eigenschappen voor deze resource. PoolProperties-
Tags Resourcetags Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen
type Het resourcetype 'Microsoft.DevOpsInfrastructure/pools'

NetworkProfile

Naam Beschrijving Waarde
subnetId De subnet-id waarop alle machines die in de pool zijn gemaakt, moeten worden geplaatst. tekenreeks (vereist)

Organisatie

Naam Beschrijving Waarde
Parallellisme Hoeveel machines maximaal in deze organisatie kunnen worden gemaakt uit de maximaleconcurrency van de pool. Int
Projecten Optionele lijst met projecten waarin de pool moet worden gemaakt. tekenreeks[]
URL De URL van de Azure DevOps-organisatie waarin de pool moet worden gemaakt. tekenreeks (vereist)

OrganizationProfile

Naam Beschrijving Waarde
soort Ingesteld op 'AzureDevOps' voor het type AzureDevOpsOrganizationProfile. Ingesteld op 'GitHub' voor het type GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (vereist)

OsProfile

Naam Beschrijving Waarde
logonType Bepaalt hoe de service moet worden uitgevoerd. Dit wordt standaard ingesteld op Service. 'Interactief'
'Service'
secretsManagementSettings De geheime beheerinstellingen van de machines in de pool. SecretsManagementSettings

PoolImage

Naam Beschrijving Waarde
Aliassen Lijst met aliassen om naar de afbeelding te verwijzen. tekenreeks[]
buffer Het percentage van de buffer dat aan deze afbeelding moet worden toegewezen. snaar
resourceId De resource-id van de installatiekopieën. snaar
wellKnownImageName De installatiekopieën die moeten worden gebruikt vanuit een bekende set afbeeldingen die beschikbaar worden gesteld aan klanten. snaar

PoolProperties

Naam Beschrijving Waarde
agentProfile Hiermee definieert u hoe de machine wordt verwerkt zodra deze een taak heeft uitgevoerd. AgentProfile (vereist)
devCenterProjectResourceId De resource-id van het DevCenter-project waartoe de pool behoort. tekenreeks (vereist)
fabricProfile Definieert het type infrastructuur waarop de agent wordt uitgevoerd. FabricProfile (vereist)
maximumConcurrency Hiermee definieert u hoeveel resources er op elk gewenst moment kunnen worden gemaakt. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 10000 (vereist)
organizationProfile Definieert de organisatie waarin de pool wordt gebruikt. OrganizationProfile (vereist)
provisioningState De status van de huidige bewerking. 'Geaccepteerd'
'Geannuleerd'
'Verwijderen'
'Mislukt'
'Inrichting'
'Geslaagd'
'Bijwerken'

ResourcePredictionsProfile

Naam Beschrijving Waarde
soort Ingesteld op Automatisch voor type AutomaticResourcePredictionsProfile. Ingesteld op 'Handmatig' voor type ManualResourcePredictionsProfile. 'Automatisch'
'Handmatig' (vereist)

SecretsManagementSettings

Naam Beschrijving Waarde
certificateStoreLocation Waar certificaten op de computer worden opgeslagen. snaar
keyExportable Hiermee wordt gedefinieerd of de sleutel van de certificaten moet kunnen worden geëxporteerd. bool (vereist)
observedCertificates De lijst met certificaten die op alle computers in de groep moeten worden geïnstalleerd. tekenreeks[] (vereist)

Stateful

Naam Beschrijving Waarde
gracePeriodTimeSpan Hoe lang moet de machine worden bewaard nadat er een workload is uitgevoerd wanneer er geen zelfstandige agents zijn. Het maximum is één week. snaar
soort De eigenschap Discriminator voor AgentProfile. Stateful (vereist)
maxAgentLifetime Hoe lang stateful machines moeten worden bewaard. Het maximum is één week. snaar

StatelessAgentProfile

Naam Beschrijving Waarde
soort De eigenschap Discriminator voor AgentProfile. Staatloos (vereist)

StorageProfile

Naam Beschrijving Waarde
dataDisks Een lijst met lege gegevensschijven die moeten worden gekoppeld. DataDisk[]
osDiskStorageAccountType De Azure SKU-naam van de machines in de pool. 'Premium'
'Standaard'
'StandardSSD'

TrackedResourceTags

Naam Beschrijving Waarde

UserAssignedIdentities

Naam Beschrijving Waarde

UserAssignedIdentity

Naam Beschrijving Waarde

VmssFabricProfile

Naam Beschrijving Waarde
beelden De VM-installatiekopieën van de machines in de pool. PoolImage[] (vereist)
soort De eigenschap Discriminator voor FabricProfile. 'Vmss' (vereist)
networkProfile Het netwerkprofiel van de machines in de groep. NetworkProfile
osProfile Het besturingssysteemprofiel van de machines in de pool. OsProfile
Sku De Azure-SKU van de machines in de pool. DevOpsAzureSku (vereist)
storageProfile Het opslagprofiel van de machines in de pool. StorageProfile

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype pools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

  • resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een resource voor Microsoft.DevOpsInfrastructure/pools wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

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-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor Stateful:

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

Gebruik voor stateless:

{
  kind = "Stateless"
}

ResourcePredictionsProfile-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor Automatische:

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

Voor Handmatigegebruikt u:

{
  kind = "Manual"
}

FabricProfile-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor 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-objecten

Stel de eigenschap type in om het type object op te geven.

Gebruik voor AzureDevOps-:

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

Gebruik voor GitHub:

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

Eigenschapswaarden

AgentProfile

Naam Beschrijving Waarde
soort Ingesteld op Stateful voor het type Stateful. Ingesteld op Staatloos voor het type StatelessAgentProfile. 'Stateful'
Staatloos (vereist)
resourcePredictions Definieert poolbuffer/stand-by-agents. enig
resourcePredictionsProfile Hiermee definieert u hoe de poolbuffer/stand-by-agents worden geleverd. ResourcePredictionsProfile

AutomaticResourcePredictionsProfile

Naam Beschrijving Waarde
soort Bepaalt hoe het standaardschema moet worden verstrekt. 'Automatisch' (vereist)
predictionPreference Bepaalt de balans tussen kosten en prestaties. 'Evenwichtig'
'BestPerformance'
'MoreCostEffective'
'MorePerformance'
'MostCostEffective'

AzureDevOpsOrganizationProfile

Naam Beschrijving Waarde
soort De eigenschap Discriminator voor OrganizationProfile. 'AzureDevOps' (vereist)
Organisaties De lijst met Azure DevOps-organisaties waarin de pool moet aanwezig zijn. Organisatie[] (vereist)
permissionProfile Het type machtiging dat bepaalt welke accounts beheerders zijn in de Azure DevOps-pool. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Naam Beschrijving Waarde
groepen E-mailadressen groeperen tekenreeks[]
soort Bepaalt wie beheerdersmachtigingen heeft voor de Azure DevOps-pool. 'CreatorOnly'
'Overnemen'
'SpecificAccounts' (vereist)
Gebruikers E-mailadressen van gebruikers tekenreeks[]

DataDisk

Naam Beschrijving Waarde
Caching Het type caching dat moet worden ingeschakeld voor de gegevensschijven. De standaardwaarde voor opslaan in cache is readwrite. Zie voor meer informatie over de cacheopties: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. 'Geen'
'ReadOnly'
'ReadWrite'
diskSizeGiB De initiële schijfgrootte in gigabytes. Int
driveLetter De stationsletter voor de lege gegevensschijf. Als dit niet is opgegeven, is dit de eerste beschikbare letter. snaar
storageAccountType Het type opslagaccount dat moet worden gebruikt voor de gegevensschijf. Als u dit weglaat, is de standaardwaarde 'standard_lrs'. 'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'

DevOpsAzureSku

Naam Beschrijving Waarde
naam De Azure SKU-naam van de machines in de pool. tekenreeks (vereist)

FabricProfile

Naam Beschrijving Waarde
soort Ingesteld op 'Vmss' voor het type VmssFabricProfile. 'Vmss' (vereist)

GitHubOrganization

Naam Beschrijving Waarde
Repositories Optionele lijst met opslagplaatsen waarin de pool moet worden gemaakt. tekenreeks[]
URL De URL van de GitHub-organisatie waarin de pool moet worden gemaakt. tekenreeks (vereist)

GitHubOrganizationProfile

Naam Beschrijving Waarde
soort De eigenschap Discriminator voor OrganizationProfile. 'GitHub' (vereist)
Organisaties De lijst met GitHub-organisaties/opslagplaatsen waarin de pool moet aanwezig zijn. GitHubOrganization[] (vereist)

ManagedServiceIdentity

Naam Beschrijving Waarde
type Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). 'Geen'
'SystemAssigned'
'SystemAssigned, UserAssigned'
UserAssigned (vereist)
userAssignedIdentities De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. UserAssignedId-entiteiten

ManualResourcePredictionsProfile

Naam Beschrijving Waarde
soort Bepaalt hoe het standaardschema moet worden verstrekt. 'Handmatig' (vereist)

Microsoft.DevOpsInfrastructure/pools

Naam Beschrijving Waarde
identiteit De beheerde service-identiteiten die zijn toegewezen aan deze resource. ManagedServiceIdentity-
plaats De geografische locatie waar de resource zich bevindt tekenreeks (vereist)
naam De resourcenaam snaar

Beperkingen:
Patroon = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (vereist)
Eigenschappen De resourcespecifieke eigenschappen voor deze resource. PoolProperties-
Tags Resourcetags Woordenlijst met tagnamen en -waarden.
type Het resourcetype "Microsoft.DevOpsInfrastructure/pools@2024-10-19"

NetworkProfile

Naam Beschrijving Waarde
subnetId De subnet-id waarop alle machines die in de pool zijn gemaakt, moeten worden geplaatst. tekenreeks (vereist)

Organisatie

Naam Beschrijving Waarde
Parallellisme Hoeveel machines maximaal in deze organisatie kunnen worden gemaakt uit de maximaleconcurrency van de pool. Int
Projecten Optionele lijst met projecten waarin de pool moet worden gemaakt. tekenreeks[]
URL De URL van de Azure DevOps-organisatie waarin de pool moet worden gemaakt. tekenreeks (vereist)

OrganizationProfile

Naam Beschrijving Waarde
soort Ingesteld op 'AzureDevOps' voor het type AzureDevOpsOrganizationProfile. Ingesteld op 'GitHub' voor het type GitHubOrganizationProfile. 'AzureDevOps'
'GitHub' (vereist)

OsProfile

Naam Beschrijving Waarde
logonType Bepaalt hoe de service moet worden uitgevoerd. Dit wordt standaard ingesteld op Service. 'Interactief'
'Service'
secretsManagementSettings De geheime beheerinstellingen van de machines in de pool. SecretsManagementSettings

PoolImage

Naam Beschrijving Waarde
Aliassen Lijst met aliassen om naar de afbeelding te verwijzen. tekenreeks[]
buffer Het percentage van de buffer dat aan deze afbeelding moet worden toegewezen. snaar
resourceId De resource-id van de installatiekopieën. snaar
wellKnownImageName De installatiekopieën die moeten worden gebruikt vanuit een bekende set afbeeldingen die beschikbaar worden gesteld aan klanten. snaar

PoolProperties

Naam Beschrijving Waarde
agentProfile Hiermee definieert u hoe de machine wordt verwerkt zodra deze een taak heeft uitgevoerd. AgentProfile (vereist)
devCenterProjectResourceId De resource-id van het DevCenter-project waartoe de pool behoort. tekenreeks (vereist)
fabricProfile Definieert het type infrastructuur waarop de agent wordt uitgevoerd. FabricProfile (vereist)
maximumConcurrency Hiermee definieert u hoeveel resources er op elk gewenst moment kunnen worden gemaakt. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 10000 (vereist)
organizationProfile Definieert de organisatie waarin de pool wordt gebruikt. OrganizationProfile (vereist)
provisioningState De status van de huidige bewerking. 'Geaccepteerd'
'Geannuleerd'
'Verwijderen'
'Mislukt'
'Inrichting'
'Geslaagd'
'Bijwerken'

ResourcePredictionsProfile

Naam Beschrijving Waarde
soort Ingesteld op Automatisch voor type AutomaticResourcePredictionsProfile. Ingesteld op 'Handmatig' voor type ManualResourcePredictionsProfile. 'Automatisch'
'Handmatig' (vereist)

SecretsManagementSettings

Naam Beschrijving Waarde
certificateStoreLocation Waar certificaten op de computer worden opgeslagen. snaar
keyExportable Hiermee wordt gedefinieerd of de sleutel van de certificaten moet kunnen worden geëxporteerd. bool (vereist)
observedCertificates De lijst met certificaten die op alle computers in de groep moeten worden geïnstalleerd. tekenreeks[] (vereist)

Stateful

Naam Beschrijving Waarde
gracePeriodTimeSpan Hoe lang moet de machine worden bewaard nadat er een workload is uitgevoerd wanneer er geen zelfstandige agents zijn. Het maximum is één week. snaar
soort De eigenschap Discriminator voor AgentProfile. Stateful (vereist)
maxAgentLifetime Hoe lang stateful machines moeten worden bewaard. Het maximum is één week. snaar

StatelessAgentProfile

Naam Beschrijving Waarde
soort De eigenschap Discriminator voor AgentProfile. Staatloos (vereist)

StorageProfile

Naam Beschrijving Waarde
dataDisks Een lijst met lege gegevensschijven die moeten worden gekoppeld. DataDisk[]
osDiskStorageAccountType De Azure SKU-naam van de machines in de pool. 'Premium'
'Standaard'
'StandardSSD'

TrackedResourceTags

Naam Beschrijving Waarde

UserAssignedIdentities

Naam Beschrijving Waarde

UserAssignedIdentity

Naam Beschrijving Waarde

VmssFabricProfile

Naam Beschrijving Waarde
beelden De VM-installatiekopieën van de machines in de pool. PoolImage[] (vereist)
soort De eigenschap Discriminator voor FabricProfile. 'Vmss' (vereist)
networkProfile Het netwerkprofiel van de machines in de groep. NetworkProfile
osProfile Het besturingssysteemprofiel van de machines in de pool. OsProfile
Sku De Azure-SKU van de machines in de pool. DevOpsAzureSku (vereist)
storageProfile Het opslagprofiel van de machines in de pool. StorageProfile