Dela via


Microsoft.DevOpsInfrastructure-pooler

Bicep-resursdefinition

Resurstypen pooler kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.DevOpsInfrastructure/poolresurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.DevOpsInfrastructure/pools@2025-01-21' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    agentProfile: {
      resourcePredictions: any(...)
      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'
  }
}

ResourcePredictionsProfile-objekt

Ange egenskapen typ för att ange typ av objekt.

För Automatisk använder du:

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

För Manuell använder du:

{
  kind: 'Manual'
}

AgentProfile-objekt

Ange egenskapen typ för att ange typ av objekt.

För Tillståndskänsliganvänder du:

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

För Tillståndslösanvänder du:

{
  kind: 'Stateless'
}

FabricProfile-objekt

Ange egenskapen typ för att ange typ av objekt.

För vmss använder du:

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

OrganizationProfile-objekt

Ange egenskapen typ för att ange typ av objekt.

För AzureDevOps använder du:

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

För GitHub använder du:

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

Egenskapsvärden

Microsoft.DevOpsInfrastructure/pooler

Namn Beskrivning Värde
identitet De hanterade tjänstidentiteter som tilldelats den här resursen. ManagedServiceIdentity (HanteradServiceIdentitet)
läge Den geo-plats där resursen finns sträng (krävs)
namn Resursnamnet sträng

Begränsningar:
Mönster = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (krävs)
egenskaper Resursspecifika egenskaper för den här resursen. PoolEgenskaper
Taggar Resursetiketter Ordlista med taggnamn och värden. Se taggar i mallar

AgentProfil

Namn Beskrivning Värde
typ Ange till "Stateful" för typen Stateful. Ange till "Stateless" för typen StatelessAgentProfile. "Tillståndskänslig"
"Tillståndslös" (krävs)
resursförutsägelser Definierar poolbuffert/stand-by-agenter. någon
resourcePredictionsProfil Definierar hur poolbufferten/stand-by-agenterna tillhandahålls. ResourcePredictionsProfil

AutomaticResourcePredictionsProfil

Namn Beskrivning Värde
typ Avgör hur stand-by-schemat ska tillhandahållas. "Automatisk" (krävs)
förutsägelse Preferens Avgör balansen mellan kostnad och prestanda. "Balanserad"
"BestPerformance"
"MoreCostEffective"
"MorePerformance"
"MostCostEffective"

AzureDevOpsOrganizationProfile

Namn Beskrivning Värde
typ Diskriminerande egenskap för OrganizationProfile. "AzureDevOps" (krävs)
organisationer Listan över Azure DevOps-organisationer som poolen ska finnas i. Organisation[] (krävs)
permissionProfil Den typ av behörighet som avgör vilka konton som är administratörer i Azure DevOps-poolen. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Namn Beskrivning Värde
grupper Gruppera e-postadresser sträng[]
typ Avgör vem som har administratörsbehörighet till Azure DevOps-poolen. "CreatorOnly"
"Ärv"
"SpecificAccounts" (krävs)
användare Användarens e-postadresser sträng[]

Datadisk (på engelska)

Namn Beskrivning Värde
Cachelagring Den typ av cachelagring som ska aktiveras för datadiskarna. Standardvärdet för cachelagring är skrivskyddat. Information om cachelagringsalternativen finns i: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. "Ingen"
"ReadOnly"
"Skriv upp"
diskSizeGiB Den ursprungliga diskstorleken i gigabyte. Int
driveLetter (på engelska) Enhetsbeteckningen för den tomma datadisken. Om det inte anges blir det den första tillgängliga bokstaven. snöre
lagringskontotyp Den lagringskontotyp som ska användas för datadisken. Om det utelämnas är standardvärdet "standard_lrs". "Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"

DevOpsAzureSku

Namn Beskrivning Värde
namn Azure SKU-namnet på datorerna i poolen. sträng (krävs)

FabricProfil

Namn Beskrivning Värde
typ Ange till "Vmss" för typen VmssFabricProfile. "Vmss" (krävs)

GitHub-organisation

Namn Beskrivning Värde
Lagringsplatser Valfri lista över lagringsplatser där poolen ska skapas. sträng[]
URL GitHub-organisations-URL:en där poolen ska skapas. sträng (krävs)

GitHubOrganizationProfile

Namn Beskrivning Värde
typ Diskriminerande egenskap för OrganizationProfile. "GitHub" (krävs)
organisationer Listan över GitHub-organisationer/lagringsplatser som poolen ska finnas i. GitHubOrganization[] (krävs)

ManagedServiceIdentity (HanteradServiceIdentitet)

Namn Beskrivning Värde
typ Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts). "Ingen"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (krävs)
användartilldelade identiteter Uppsättningen användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden. UserAssignedIdentiteter

ManualResourcePredictionsProfil

Namn Beskrivning Värde
typ Avgör hur stand-by-schemat ska tillhandahållas. "Manuell" (krävs)

NätverkProfil

Namn Beskrivning Värde
subnetId Det undernäts-ID som alla datorer som skapats i poolen ska placeras på. sträng (krävs)

Organisation

Namn Beskrivning Värde
openAccess (öppna Tillgång) Avgör om poolen ska ha öppen åtkomst till alla projekt i den här organisationen. Bool
Parallellitet Hur många datorer som kan skapas maximalt i den här organisationen av poolens maximalaconcurrency. Int
projekt Valfri lista över projekt där poolen ska skapas. sträng[]
URL Url:en för Azure DevOps-organisationen där poolen ska skapas. sträng (krävs)

Organisationsprofil

Namn Beskrivning Värde
typ Ange till "AzureDevOps" för typen AzureDevOpsOrganizationProfile. Ange till GitHub för typen GitHubOrganizationProfile. "AzureDevOps"
"GitHub" (krävs)

OsProfile

Namn Beskrivning Värde
logonType Avgör hur tjänsten ska köras. Som standard anges detta till Tjänst. "Interaktiv"
"Tjänst"
secretsManagementInställningar Inställningarna för hemlig hantering av datorerna i poolen. Inställningar för SecretsManagement

Slå ihopBild

Namn Beskrivning Värde
Alias Lista över alias som ska referera till avbildningen med. sträng[]
buffert Procentandelen av bufferten som ska allokeras till den här avbildningen. snöre
ephemeralType Bildens tillfälliga typ. "Automatisk"
"CacheDisk"
"ResourceDisk"
resursId Resurs-ID:t för avbildningen. snöre
wellKnownImageName Avbildningen som ska användas från en välkänd uppsättning avbildningar som görs tillgängliga för kunder. snöre

PoolEgenskaper

Namn Beskrivning Värde
agentProfil Definierar hur datorn ska hanteras när den har kört ett jobb. AgentProfile (krävs)
devCenterProjectResourceId Resurs-ID:t för DevCenter-projektet som poolen tillhör. sträng (krävs)
fabricProfil Definierar vilken typ av infrastrukturresurser agenten ska köras på. FabricProfile (krävs)
maximumConcurrency (maximalt samtidighet) Definierar hur många resurser som kan skapas vid en viss tidpunkt. Int

Begränsningar:
Minsta värde = 1
Maxvärde = 10 000 (krävs)
organizationProfil Definierar i vilken organisation poolen ska användas. OrganizationProfile (krävs)
försörjningsstatus Status för den aktuella åtgärden. "Accepterad"
"Avbröts"
"Ta bort"
"Misslyckades"
"Etablering"
"Lyckades"
"Uppdaterar"

ResourcePredictionsProfil

Namn Beskrivning Värde
typ Ställ in på "Automatisk" för typen AutomaticResourcePredictionsProfile. Ange till "Manuell" för typen ManualResourcePredictionsProfile. "Automatisk"
"Manuell" (krävs)

Inställningar för SecretsManagement

Namn Beskrivning Värde
certificateStoreLocation Var du kan lagra certifikat på datorn. snöre
certifikatStoreName Namnet på certifikatarkivet som ska användas på datorn stöds för närvarande "My" och "Root". "Min"
"Rot"
nyckelExportable (nyckelExporterbar) Definierar om nyckeln för certifikaten ska kunna exporteras. bool (krävs)
observedCertificates Listan över certifikat som ska installeras på alla datorer i poolen. string[] (krävs)

Tillståndsbevarande

Namn Beskrivning Värde
gracePeriodTimeSpan Hur länge ska datorn behållas efter att den kört en arbetsbelastning när det inte finns några stand-by-agenter. Maxvärdet är en vecka. snöre
typ Diskriminerande egenskap för AgentProfile. "Tillståndskänslig" (krävs)
maxAgentLifetime Hur länge ska tillståndskänsliga datorer hållas kvar. Maxvärdet är en vecka. snöre

StatelessAgentProfile

Namn Beskrivning Värde
typ Diskriminerande egenskap för AgentProfile. "Tillståndslös" (krävs)

StorageProfile (på engelska)

Namn Beskrivning Värde
dataDiskar En lista över tomma datadiskar som ska kopplas. DataDisk[]
osDiskStorageAccountType Azure SKU-namnet på datorerna i poolen. "Premium"
"Standard"
"StandardSSD"

Spårade resurstaggar

Namn Beskrivning Värde

UserAssignedIdentiteter

Namn Beskrivning Värde

Användartilldelad identitet

Namn Beskrivning Värde

VmssFabricProfile (på engelska)

Namn Beskrivning Värde
Bilder Vm-avbildningarna av datorerna i poolen. PoolImage[] (krävs)
typ Diskriminerande egenskap för FabricProfile. "Vmss" (krävs)
networkProfil Nätverksprofilen för datorerna i poolen. NätverkProfil
osProfile Os-profilen för datorerna i poolen. OsProfile
Sku Azure SKU för datorerna i poolen. DevOpsAzureSku (krävs)
storageProfile Lagringsprofilen för datorerna i poolen. StorageProfile (på engelska)

Användningsexempel

Azure-verifierade moduler

Följande Azure-verifierade moduler kan användas för att distribuera den här resurstypen.

Modul Beskrivning
DevOps-infrastrukturpool AVM-resursmodul för DevOps-infrastrukturpool

Resursdefinition för ARM-mall

Resurstypen pooler kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.DevOpsInfrastructure/poolresurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.DevOpsInfrastructure/pools",
  "apiVersion": "2025-01-21",
  "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"
  }
}

ResourcePredictionsProfile-objekt

Ange egenskapen typ för att ange typ av objekt.

För Automatisk använder du:

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

För Manuell använder du:

{
  "kind": "Manual"
}

AgentProfile-objekt

Ange egenskapen typ för att ange typ av objekt.

För Tillståndskänsliganvänder du:

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

För Tillståndslösanvänder du:

{
  "kind": "Stateless"
}

FabricProfile-objekt

Ange egenskapen typ för att ange typ av objekt.

För vmss använder du:

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

OrganizationProfile-objekt

Ange egenskapen typ för att ange typ av objekt.

För AzureDevOps använder du:

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

För GitHub använder du:

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

Egenskapsvärden

Microsoft.DevOpsInfrastructure/pooler

Namn Beskrivning Värde
apiVersion API-versionen '2025-01-21'
identitet De hanterade tjänstidentiteter som tilldelats den här resursen. ManagedServiceIdentity (HanteradServiceIdentitet)
läge Den geo-plats där resursen finns sträng (krävs)
namn Resursnamnet sträng

Begränsningar:
Mönster = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (krävs)
egenskaper Resursspecifika egenskaper för den här resursen. PoolEgenskaper
Taggar Resursetiketter Ordlista med taggnamn och värden. Se taggar i mallar
typ Resurstypen "Microsoft.DevOpsInfrastructure/pools"

AgentProfil

Namn Beskrivning Värde
typ Ange till "Stateful" för typen Stateful. Ange till "Stateless" för typen StatelessAgentProfile. "Tillståndskänslig"
"Tillståndslös" (krävs)
resursförutsägelser Definierar poolbuffert/stand-by-agenter. någon
resourcePredictionsProfil Definierar hur poolbufferten/stand-by-agenterna tillhandahålls. ResourcePredictionsProfil

AutomaticResourcePredictionsProfil

Namn Beskrivning Värde
typ Avgör hur stand-by-schemat ska tillhandahållas. "Automatisk" (krävs)
förutsägelse Preferens Avgör balansen mellan kostnad och prestanda. "Balanserad"
"BestPerformance"
"MoreCostEffective"
"MorePerformance"
"MostCostEffective"

AzureDevOpsOrganizationProfile

Namn Beskrivning Värde
typ Diskriminerande egenskap för OrganizationProfile. "AzureDevOps" (krävs)
organisationer Listan över Azure DevOps-organisationer som poolen ska finnas i. Organisation[] (krävs)
permissionProfil Den typ av behörighet som avgör vilka konton som är administratörer i Azure DevOps-poolen. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Namn Beskrivning Värde
grupper Gruppera e-postadresser sträng[]
typ Avgör vem som har administratörsbehörighet till Azure DevOps-poolen. "CreatorOnly"
"Ärv"
"SpecificAccounts" (krävs)
användare Användarens e-postadresser sträng[]

Datadisk (på engelska)

Namn Beskrivning Värde
Cachelagring Den typ av cachelagring som ska aktiveras för datadiskarna. Standardvärdet för cachelagring är skrivskyddat. Information om cachelagringsalternativen finns i: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. "Ingen"
"ReadOnly"
"Skriv upp"
diskSizeGiB Den ursprungliga diskstorleken i gigabyte. Int
driveLetter (på engelska) Enhetsbeteckningen för den tomma datadisken. Om det inte anges blir det den första tillgängliga bokstaven. snöre
lagringskontotyp Den lagringskontotyp som ska användas för datadisken. Om det utelämnas är standardvärdet "standard_lrs". "Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"

DevOpsAzureSku

Namn Beskrivning Värde
namn Azure SKU-namnet på datorerna i poolen. sträng (krävs)

FabricProfil

Namn Beskrivning Värde
typ Ange till "Vmss" för typen VmssFabricProfile. "Vmss" (krävs)

GitHub-organisation

Namn Beskrivning Värde
Lagringsplatser Valfri lista över lagringsplatser där poolen ska skapas. sträng[]
URL GitHub-organisations-URL:en där poolen ska skapas. sträng (krävs)

GitHubOrganizationProfile

Namn Beskrivning Värde
typ Diskriminerande egenskap för OrganizationProfile. "GitHub" (krävs)
organisationer Listan över GitHub-organisationer/lagringsplatser som poolen ska finnas i. GitHubOrganization[] (krävs)

ManagedServiceIdentity (HanteradServiceIdentitet)

Namn Beskrivning Värde
typ Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts). "Ingen"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (krävs)
användartilldelade identiteter Uppsättningen användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden. UserAssignedIdentiteter

ManualResourcePredictionsProfil

Namn Beskrivning Värde
typ Avgör hur stand-by-schemat ska tillhandahållas. "Manuell" (krävs)

NätverkProfil

Namn Beskrivning Värde
subnetId Det undernäts-ID som alla datorer som skapats i poolen ska placeras på. sträng (krävs)

Organisation

Namn Beskrivning Värde
openAccess (öppna Tillgång) Avgör om poolen ska ha öppen åtkomst till alla projekt i den här organisationen. Bool
Parallellitet Hur många datorer som kan skapas maximalt i den här organisationen av poolens maximalaconcurrency. Int
projekt Valfri lista över projekt där poolen ska skapas. sträng[]
URL Url:en för Azure DevOps-organisationen där poolen ska skapas. sträng (krävs)

Organisationsprofil

Namn Beskrivning Värde
typ Ange till "AzureDevOps" för typen AzureDevOpsOrganizationProfile. Ange till GitHub för typen GitHubOrganizationProfile. "AzureDevOps"
"GitHub" (krävs)

OsProfile

Namn Beskrivning Värde
logonType Avgör hur tjänsten ska köras. Som standard anges detta till Tjänst. "Interaktiv"
"Tjänst"
secretsManagementInställningar Inställningarna för hemlig hantering av datorerna i poolen. Inställningar för SecretsManagement

Slå ihopBild

Namn Beskrivning Värde
Alias Lista över alias som ska referera till avbildningen med. sträng[]
buffert Procentandelen av bufferten som ska allokeras till den här avbildningen. snöre
ephemeralType Bildens tillfälliga typ. "Automatisk"
"CacheDisk"
"ResourceDisk"
resursId Resurs-ID:t för avbildningen. snöre
wellKnownImageName Avbildningen som ska användas från en välkänd uppsättning avbildningar som görs tillgängliga för kunder. snöre

PoolEgenskaper

Namn Beskrivning Värde
agentProfil Definierar hur datorn ska hanteras när den har kört ett jobb. AgentProfile (krävs)
devCenterProjectResourceId Resurs-ID:t för DevCenter-projektet som poolen tillhör. sträng (krävs)
fabricProfil Definierar vilken typ av infrastrukturresurser agenten ska köras på. FabricProfile (krävs)
maximumConcurrency (maximalt samtidighet) Definierar hur många resurser som kan skapas vid en viss tidpunkt. Int

Begränsningar:
Minsta värde = 1
Maxvärde = 10 000 (krävs)
organizationProfil Definierar i vilken organisation poolen ska användas. OrganizationProfile (krävs)
försörjningsstatus Status för den aktuella åtgärden. "Accepterad"
"Avbröts"
"Ta bort"
"Misslyckades"
"Etablering"
"Lyckades"
"Uppdaterar"

ResourcePredictionsProfil

Namn Beskrivning Värde
typ Ställ in på "Automatisk" för typen AutomaticResourcePredictionsProfile. Ange till "Manuell" för typen ManualResourcePredictionsProfile. "Automatisk"
"Manuell" (krävs)

Inställningar för SecretsManagement

Namn Beskrivning Värde
certificateStoreLocation Var du kan lagra certifikat på datorn. snöre
certifikatStoreName Namnet på certifikatarkivet som ska användas på datorn stöds för närvarande "My" och "Root". "Min"
"Rot"
nyckelExportable (nyckelExporterbar) Definierar om nyckeln för certifikaten ska kunna exporteras. bool (krävs)
observedCertificates Listan över certifikat som ska installeras på alla datorer i poolen. string[] (krävs)

Tillståndsbevarande

Namn Beskrivning Värde
gracePeriodTimeSpan Hur länge ska datorn behållas efter att den kört en arbetsbelastning när det inte finns några stand-by-agenter. Maxvärdet är en vecka. snöre
typ Diskriminerande egenskap för AgentProfile. "Tillståndskänslig" (krävs)
maxAgentLifetime Hur länge ska tillståndskänsliga datorer hållas kvar. Maxvärdet är en vecka. snöre

StatelessAgentProfile

Namn Beskrivning Värde
typ Diskriminerande egenskap för AgentProfile. "Tillståndslös" (krävs)

StorageProfile (på engelska)

Namn Beskrivning Värde
dataDiskar En lista över tomma datadiskar som ska kopplas. DataDisk[]
osDiskStorageAccountType Azure SKU-namnet på datorerna i poolen. "Premium"
"Standard"
"StandardSSD"

Spårade resurstaggar

Namn Beskrivning Värde

UserAssignedIdentiteter

Namn Beskrivning Värde

Användartilldelad identitet

Namn Beskrivning Värde

VmssFabricProfile (på engelska)

Namn Beskrivning Värde
Bilder Vm-avbildningarna av datorerna i poolen. PoolImage[] (krävs)
typ Diskriminerande egenskap för FabricProfile. "Vmss" (krävs)
networkProfil Nätverksprofilen för datorerna i poolen. NätverkProfil
osProfile Os-profilen för datorerna i poolen. OsProfile
Sku Azure SKU för datorerna i poolen. DevOpsAzureSku (krävs)
storageProfile Lagringsprofilen för datorerna i poolen. StorageProfile (på engelska)

Användningsexempel

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen pooler kan distribueras med åtgärder som mål:

  • Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Resurs för Microsoft.DevOpsInfrastructure/pooler lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevOpsInfrastructure/pools@2025-01-21"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    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"
    }
  }
}

ResourcePredictionsProfile-objekt

Ange egenskapen typ för att ange typ av objekt.

För Automatisk använder du:

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

För Manuell använder du:

{
  kind = "Manual"
}

AgentProfile-objekt

Ange egenskapen typ för att ange typ av objekt.

För Tillståndskänsliganvänder du:

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

För Tillståndslösanvänder du:

{
  kind = "Stateless"
}

FabricProfile-objekt

Ange egenskapen typ för att ange typ av objekt.

För vmss använder du:

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

OrganizationProfile-objekt

Ange egenskapen typ för att ange typ av objekt.

För AzureDevOps använder du:

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

För GitHub använder du:

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

Egenskapsvärden

Microsoft.DevOpsInfrastructure/pooler

Namn Beskrivning Värde
identitet De hanterade tjänstidentiteter som tilldelats den här resursen. ManagedServiceIdentity (HanteradServiceIdentitet)
läge Den geo-plats där resursen finns sträng (krävs)
namn Resursnamnet sträng

Begränsningar:
Mönster = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (krävs)
egenskaper Resursspecifika egenskaper för den här resursen. PoolEgenskaper
Taggar Resursetiketter Ordlista med taggnamn och värden.
typ Resurstypen "Microsoft.DevOpsInfrastructure/pools@2025-01-21"

AgentProfil

Namn Beskrivning Värde
typ Ange till "Stateful" för typen Stateful. Ange till "Stateless" för typen StatelessAgentProfile. "Tillståndskänslig"
"Tillståndslös" (krävs)
resursförutsägelser Definierar poolbuffert/stand-by-agenter. någon
resourcePredictionsProfil Definierar hur poolbufferten/stand-by-agenterna tillhandahålls. ResourcePredictionsProfil

AutomaticResourcePredictionsProfil

Namn Beskrivning Värde
typ Avgör hur stand-by-schemat ska tillhandahållas. "Automatisk" (krävs)
förutsägelse Preferens Avgör balansen mellan kostnad och prestanda. "Balanserad"
"BestPerformance"
"MoreCostEffective"
"MorePerformance"
"MostCostEffective"

AzureDevOpsOrganizationProfile

Namn Beskrivning Värde
typ Diskriminerande egenskap för OrganizationProfile. "AzureDevOps" (krävs)
organisationer Listan över Azure DevOps-organisationer som poolen ska finnas i. Organisation[] (krävs)
permissionProfil Den typ av behörighet som avgör vilka konton som är administratörer i Azure DevOps-poolen. AzureDevOpsPermissionProfile

AzureDevOpsPermissionProfile

Namn Beskrivning Värde
grupper Gruppera e-postadresser sträng[]
typ Avgör vem som har administratörsbehörighet till Azure DevOps-poolen. "CreatorOnly"
"Ärv"
"SpecificAccounts" (krävs)
användare Användarens e-postadresser sträng[]

Datadisk (på engelska)

Namn Beskrivning Värde
Cachelagring Den typ av cachelagring som ska aktiveras för datadiskarna. Standardvärdet för cachelagring är skrivskyddat. Information om cachelagringsalternativen finns i: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. "Ingen"
"ReadOnly"
"Skriv upp"
diskSizeGiB Den ursprungliga diskstorleken i gigabyte. Int
driveLetter (på engelska) Enhetsbeteckningen för den tomma datadisken. Om det inte anges blir det den första tillgängliga bokstaven. snöre
lagringskontotyp Den lagringskontotyp som ska användas för datadisken. Om det utelämnas är standardvärdet "standard_lrs". "Premium_LRS"
"Premium_ZRS"
"StandardSSD_LRS"
"StandardSSD_ZRS"
"Standard_LRS"

DevOpsAzureSku

Namn Beskrivning Värde
namn Azure SKU-namnet på datorerna i poolen. sträng (krävs)

FabricProfil

Namn Beskrivning Värde
typ Ange till "Vmss" för typen VmssFabricProfile. "Vmss" (krävs)

GitHub-organisation

Namn Beskrivning Värde
Lagringsplatser Valfri lista över lagringsplatser där poolen ska skapas. sträng[]
URL GitHub-organisations-URL:en där poolen ska skapas. sträng (krävs)

GitHubOrganizationProfile

Namn Beskrivning Värde
typ Diskriminerande egenskap för OrganizationProfile. "GitHub" (krävs)
organisationer Listan över GitHub-organisationer/lagringsplatser som poolen ska finnas i. GitHubOrganization[] (krävs)

ManagedServiceIdentity (HanteradServiceIdentitet)

Namn Beskrivning Värde
typ Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts). "Ingen"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned" (krävs)
användartilldelade identiteter Uppsättningen användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden. UserAssignedIdentiteter

ManualResourcePredictionsProfil

Namn Beskrivning Värde
typ Avgör hur stand-by-schemat ska tillhandahållas. "Manuell" (krävs)

NätverkProfil

Namn Beskrivning Värde
subnetId Det undernäts-ID som alla datorer som skapats i poolen ska placeras på. sträng (krävs)

Organisation

Namn Beskrivning Värde
openAccess (öppna Tillgång) Avgör om poolen ska ha öppen åtkomst till alla projekt i den här organisationen. Bool
Parallellitet Hur många datorer som kan skapas maximalt i den här organisationen av poolens maximalaconcurrency. Int
projekt Valfri lista över projekt där poolen ska skapas. sträng[]
URL Url:en för Azure DevOps-organisationen där poolen ska skapas. sträng (krävs)

Organisationsprofil

Namn Beskrivning Värde
typ Ange till "AzureDevOps" för typen AzureDevOpsOrganizationProfile. Ange till GitHub för typen GitHubOrganizationProfile. "AzureDevOps"
"GitHub" (krävs)

OsProfile

Namn Beskrivning Värde
logonType Avgör hur tjänsten ska köras. Som standard anges detta till Tjänst. "Interaktiv"
"Tjänst"
secretsManagementInställningar Inställningarna för hemlig hantering av datorerna i poolen. Inställningar för SecretsManagement

Slå ihopBild

Namn Beskrivning Värde
Alias Lista över alias som ska referera till avbildningen med. sträng[]
buffert Procentandelen av bufferten som ska allokeras till den här avbildningen. snöre
ephemeralType Bildens tillfälliga typ. "Automatisk"
"CacheDisk"
"ResourceDisk"
resursId Resurs-ID:t för avbildningen. snöre
wellKnownImageName Avbildningen som ska användas från en välkänd uppsättning avbildningar som görs tillgängliga för kunder. snöre

PoolEgenskaper

Namn Beskrivning Värde
agentProfil Definierar hur datorn ska hanteras när den har kört ett jobb. AgentProfile (krävs)
devCenterProjectResourceId Resurs-ID:t för DevCenter-projektet som poolen tillhör. sträng (krävs)
fabricProfil Definierar vilken typ av infrastrukturresurser agenten ska köras på. FabricProfile (krävs)
maximumConcurrency (maximalt samtidighet) Definierar hur många resurser som kan skapas vid en viss tidpunkt. Int

Begränsningar:
Minsta värde = 1
Maxvärde = 10 000 (krävs)
organizationProfil Definierar i vilken organisation poolen ska användas. OrganizationProfile (krävs)
försörjningsstatus Status för den aktuella åtgärden. "Accepterad"
"Avbröts"
"Ta bort"
"Misslyckades"
"Etablering"
"Lyckades"
"Uppdaterar"

ResourcePredictionsProfil

Namn Beskrivning Värde
typ Ställ in på "Automatisk" för typen AutomaticResourcePredictionsProfile. Ange till "Manuell" för typen ManualResourcePredictionsProfile. "Automatisk"
"Manuell" (krävs)

Inställningar för SecretsManagement

Namn Beskrivning Värde
certificateStoreLocation Var du kan lagra certifikat på datorn. snöre
certifikatStoreName Namnet på certifikatarkivet som ska användas på datorn stöds för närvarande "My" och "Root". "Min"
"Rot"
nyckelExportable (nyckelExporterbar) Definierar om nyckeln för certifikaten ska kunna exporteras. bool (krävs)
observedCertificates Listan över certifikat som ska installeras på alla datorer i poolen. string[] (krävs)

Tillståndsbevarande

Namn Beskrivning Värde
gracePeriodTimeSpan Hur länge ska datorn behållas efter att den kört en arbetsbelastning när det inte finns några stand-by-agenter. Maxvärdet är en vecka. snöre
typ Diskriminerande egenskap för AgentProfile. "Tillståndskänslig" (krävs)
maxAgentLifetime Hur länge ska tillståndskänsliga datorer hållas kvar. Maxvärdet är en vecka. snöre

StatelessAgentProfile

Namn Beskrivning Värde
typ Diskriminerande egenskap för AgentProfile. "Tillståndslös" (krävs)

StorageProfile (på engelska)

Namn Beskrivning Värde
dataDiskar En lista över tomma datadiskar som ska kopplas. DataDisk[]
osDiskStorageAccountType Azure SKU-namnet på datorerna i poolen. "Premium"
"Standard"
"StandardSSD"

Spårade resurstaggar

Namn Beskrivning Värde

UserAssignedIdentiteter

Namn Beskrivning Värde

Användartilldelad identitet

Namn Beskrivning Värde

VmssFabricProfile (på engelska)

Namn Beskrivning Värde
Bilder Vm-avbildningarna av datorerna i poolen. PoolImage[] (krävs)
typ Diskriminerande egenskap för FabricProfile. "Vmss" (krävs)
networkProfil Nätverksprofilen för datorerna i poolen. NätverkProfil
osProfile Os-profilen för datorerna i poolen. OsProfile
Sku Azure SKU för datorerna i poolen. DevOpsAzureSku (krävs)
storageProfile Lagringsprofilen för datorerna i poolen. StorageProfile (på engelska)

Användningsexempel

Azure-verifierade moduler

Följande Azure-verifierade moduler kan användas för att distribuera den här resurstypen.

Modul Beskrivning
DevOps-pooler AVM-resursmodul för DevOps-pooler