Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Bicep-resursdefinition
Resurstypen pooler kan distribueras med åtgärder som mål:
- Resursgrupper – Se resursgruppsdistributionskommandon
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:
- Resursgrupper – Se resursgruppsdistributionskommandon
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 |