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'
}
}
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 vmssanvä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 AzureDevOpsanvänder du:
{
kind: 'AzureDevOps'
organizations: [
{
openAccess: bool
parallelism: int
projects: [
'string'
]
url: 'string'
}
]
permissionProfile: {
groups: [
'string'
]
kind: 'string'
users: [
'string'
]
}
}
För GitHubanvänder du:
{
kind: 'GitHub'
organizations: [
{
repositories: [
'string'
]
url: 'string'
}
]
}
ResourcePredictionsProfile-objekt
Ange egenskapen typ för att ange typ av objekt.
För Automatiskanvänder du:
{
kind: 'Automatic'
predictionPreference: 'string'
}
För Manuellanvänder du:
{
kind: 'Manual'
}
Egenskapsvärden
AgentProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Ange till "Stateful" för typen Stateful. Ange till "Tillståndslös" för typen StatelessAgentProfile. | "Tillståndskänslig" "Tillståndslös" (krävs) |
resourcePredictions | Definierar poolbuffert/stand-by-agenter. | någon |
resourcePredictionsProfile | Definierar hur poolbufferten/stand-by-agenterna tillhandahålls. | ResourcePredictionsProfile |
AutomaticResourcePredictionsProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Avgör hur stand-by-schemat ska tillhandahållas. | "Automatisk" (krävs) |
predictionPreference | Avgör balansen mellan kostnad och prestanda. | "Balanserad" "BestPerformance" "MoreCostEffective" "MorePerformance" "MostCostEffective" |
AzureDevOpsOrganizationProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Diskriminerande egenskap för OrganizationProfile. | "AzureDevOps" (krävs) |
Organisationer | Listan över Azure DevOps-organisationer som poolen ska finnas i. | Organisation[] (krävs) |
permissionProfile | 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 | string[] |
sort | Avgör vem som har administratörsbehörighet till Azure DevOps-poolen. | "CreatorOnly" "Ärv" "SpecificAccounts" (krävs) |
Användare | Användarens e-postadresser | string[] |
DataDisk
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 | Enhetsbeteckningen för den tomma datadisken. Om det inte anges blir det den första tillgängliga bokstaven. | sträng |
storageAccountType | 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) |
FabricProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Ange till "Vmss" för typ VmssFabricProfile. | "Vmss" (krävs) |
GitHubOrganization
Namn | Beskrivning | Värde |
---|---|---|
Databaser | Valfri lista över lagringsplatser där poolen ska skapas. | string[] |
URL | GitHub-organisations-URL:en där poolen ska skapas. | sträng (krävs) |
GitHubOrganizationProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Diskriminerande egenskap för OrganizationProfile. | "GitHub" (krävs) |
Organisationer | Listan över GitHub-organisationer/lagringsplatser som poolen ska finnas i. | GitHubOrganization[] (krävs) |
ManagedServiceIdentity
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) |
userAssignedIdentities | 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 |
ManualResourcePredictionsProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Avgör hur stand-by-schemat ska tillhandahållas. | "Manuell" (krävs) |
Microsoft.DevOpsInfrastructure/pooler
Namn | Beskrivning | Värde |
---|---|---|
identitet | De hanterade tjänstidentiteter som tilldelats den här resursen. | ManagedServiceIdentity |
plats | 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 | Resurstaggar | Ordlista med taggnamn och värden. Se taggar i mallar |
NetworkProfile
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 | 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. | string[] |
URL | Url:en för Azure DevOps-organisationen där poolen ska skapas. | sträng (krävs) |
OrganizationProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | 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" |
secretsManagementSettings | Inställningarna för hemlig hantering av datorerna i poolen. | SecretsManagementSettings |
PoolImage
Namn | Beskrivning | Värde |
---|---|---|
Alias | Lista över alias som ska referera till avbildningen med. | string[] |
buffert | Procentandelen av bufferten som ska allokeras till den här avbildningen. | sträng |
ephemeralType | Bildens tillfälliga typ. | "Automatisk" "CacheDisk" "ResourceDisk" |
resourceId | Resurs-ID:t för avbildningen. | sträng |
wellKnownImageName | Avbildningen som ska användas från en välkänd uppsättning avbildningar som görs tillgängliga för kunder. | sträng |
PoolEgenskaper
Namn | Beskrivning | Värde |
---|---|---|
agentProfile | 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) |
fabricProfile | Definierar vilken typ av infrastrukturresurser agenten ska köras på. | FabricProfile (krävs) |
maximumConcurrency | 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) |
organizationProfile | Definierar i vilken organisation poolen ska användas. | OrganizationProfile (krävs) |
provisioningState | Status för den aktuella åtgärden. | "Accepterad" "Avbröts" "Ta bort" "Misslyckades" "Etablering" "Lyckades" "Uppdaterar" |
ResourcePredictionsProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Ange till "Automatisk" för typen AutomaticResourcePredictionsProfile. Ange till "Manuell" för typen ManualResourcePredictionsProfile. | "Automatisk" "Manuell" (krävs) |
SecretsManagementSettings
Namn | Beskrivning | Värde |
---|---|---|
certificateStoreLocation | Var du kan lagra certifikat på datorn. | sträng |
certificateStoreName | Namnet på certifikatarkivet som ska användas på datorn stöds för närvarande "My" och "Root". | "Min" "Rot" |
keyExportable | 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) |
Stateful
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. | sträng |
sort | 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. | sträng |
StatelessAgentProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Diskriminerande egenskap för AgentProfile. | "Tillståndslös" (krävs) |
StorageProfile
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" |
TrackedResourceTags
Namn | Beskrivning | Värde |
---|
UserAssignedIdentiteter
Namn | Beskrivning | Värde |
---|
UserAssignedIdentity
Namn | Beskrivning | Värde |
---|
VmssFabricProfile
Namn | Beskrivning | Värde |
---|---|---|
Bilder | Vm-avbildningarna av datorerna i poolen. | PoolImage[] (krävs) |
sort | Diskriminerande egenskap för FabricProfile. | "Vmss" (krävs) |
networkProfile | Nätverksprofilen för datorerna i poolen. | NetworkProfile |
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 |
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"
}
}
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 vmssanvä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 AzureDevOpsanvänder du:
{
"kind": "AzureDevOps",
"organizations": [
{
"openAccess": "bool",
"parallelism": "int",
"projects": [ "string" ],
"url": "string"
}
],
"permissionProfile": {
"groups": [ "string" ],
"kind": "string",
"users": [ "string" ]
}
}
För GitHubanvänder du:
{
"kind": "GitHub",
"organizations": [
{
"repositories": [ "string" ],
"url": "string"
}
]
}
ResourcePredictionsProfile-objekt
Ange egenskapen typ för att ange typ av objekt.
För Automatiskanvänder du:
{
"kind": "Automatic",
"predictionPreference": "string"
}
För Manuellanvänder du:
{
"kind": "Manual"
}
Egenskapsvärden
AgentProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Ange till "Stateful" för typen Stateful. Ange till "Tillståndslös" för typen StatelessAgentProfile. | "Tillståndskänslig" "Tillståndslös" (krävs) |
resourcePredictions | Definierar poolbuffert/stand-by-agenter. | någon |
resourcePredictionsProfile | Definierar hur poolbufferten/stand-by-agenterna tillhandahålls. | ResourcePredictionsProfile |
AutomaticResourcePredictionsProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Avgör hur stand-by-schemat ska tillhandahållas. | "Automatisk" (krävs) |
predictionPreference | Avgör balansen mellan kostnad och prestanda. | "Balanserad" "BestPerformance" "MoreCostEffective" "MorePerformance" "MostCostEffective" |
AzureDevOpsOrganizationProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Diskriminerande egenskap för OrganizationProfile. | "AzureDevOps" (krävs) |
Organisationer | Listan över Azure DevOps-organisationer som poolen ska finnas i. | Organisation[] (krävs) |
permissionProfile | 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 | string[] |
sort | Avgör vem som har administratörsbehörighet till Azure DevOps-poolen. | "CreatorOnly" "Ärv" "SpecificAccounts" (krävs) |
Användare | Användarens e-postadresser | string[] |
DataDisk
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 | Enhetsbeteckningen för den tomma datadisken. Om det inte anges blir det den första tillgängliga bokstaven. | sträng |
storageAccountType | 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) |
FabricProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Ange till "Vmss" för typ VmssFabricProfile. | "Vmss" (krävs) |
GitHubOrganization
Namn | Beskrivning | Värde |
---|---|---|
Databaser | Valfri lista över lagringsplatser där poolen ska skapas. | string[] |
URL | GitHub-organisations-URL:en där poolen ska skapas. | sträng (krävs) |
GitHubOrganizationProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Diskriminerande egenskap för OrganizationProfile. | "GitHub" (krävs) |
Organisationer | Listan över GitHub-organisationer/lagringsplatser som poolen ska finnas i. | GitHubOrganization[] (krävs) |
ManagedServiceIdentity
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) |
userAssignedIdentities | 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 |
ManualResourcePredictionsProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Avgör hur stand-by-schemat ska tillhandahållas. | "Manuell" (krävs) |
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 |
plats | 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 | Resurstaggar | Ordlista med taggnamn och värden. Se taggar i mallar |
typ | Resurstypen | "Microsoft.DevOpsInfrastructure/pools" |
NetworkProfile
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 | 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. | string[] |
URL | Url:en för Azure DevOps-organisationen där poolen ska skapas. | sträng (krävs) |
OrganizationProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | 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" |
secretsManagementSettings | Inställningarna för hemlig hantering av datorerna i poolen. | SecretsManagementSettings |
PoolImage
Namn | Beskrivning | Värde |
---|---|---|
Alias | Lista över alias som ska referera till avbildningen med. | string[] |
buffert | Procentandelen av bufferten som ska allokeras till den här avbildningen. | sträng |
ephemeralType | Bildens tillfälliga typ. | "Automatisk" "CacheDisk" "ResourceDisk" |
resourceId | Resurs-ID:t för avbildningen. | sträng |
wellKnownImageName | Avbildningen som ska användas från en välkänd uppsättning avbildningar som görs tillgängliga för kunder. | sträng |
PoolEgenskaper
Namn | Beskrivning | Värde |
---|---|---|
agentProfile | 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) |
fabricProfile | Definierar vilken typ av infrastrukturresurser agenten ska köras på. | FabricProfile (krävs) |
maximumConcurrency | 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) |
organizationProfile | Definierar i vilken organisation poolen ska användas. | OrganizationProfile (krävs) |
provisioningState | Status för den aktuella åtgärden. | "Accepterad" "Avbröts" "Ta bort" "Misslyckades" "Etablering" "Lyckades" "Uppdaterar" |
ResourcePredictionsProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Ange till "Automatisk" för typen AutomaticResourcePredictionsProfile. Ange till "Manuell" för typen ManualResourcePredictionsProfile. | "Automatisk" "Manuell" (krävs) |
SecretsManagementSettings
Namn | Beskrivning | Värde |
---|---|---|
certificateStoreLocation | Var du kan lagra certifikat på datorn. | sträng |
certificateStoreName | Namnet på certifikatarkivet som ska användas på datorn stöds för närvarande "My" och "Root". | "Min" "Rot" |
keyExportable | 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) |
Stateful
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. | sträng |
sort | 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. | sträng |
StatelessAgentProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Diskriminerande egenskap för AgentProfile. | "Tillståndslös" (krävs) |
StorageProfile
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" |
TrackedResourceTags
Namn | Beskrivning | Värde |
---|
UserAssignedIdentiteter
Namn | Beskrivning | Värde |
---|
UserAssignedIdentity
Namn | Beskrivning | Värde |
---|
VmssFabricProfile
Namn | Beskrivning | Värde |
---|---|---|
Bilder | Vm-avbildningarna av datorerna i poolen. | PoolImage[] (krävs) |
sort | Diskriminerande egenskap för FabricProfile. | "Vmss" (krävs) |
networkProfile | Nätverksprofilen för datorerna i poolen. | NetworkProfile |
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 |
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"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
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"
}
}
}
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 vmssanvä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 AzureDevOpsanvänder du:
{
kind = "AzureDevOps"
organizations = [
{
openAccess = bool
parallelism = int
projects = [
"string"
]
url = "string"
}
]
permissionProfile = {
groups = [
"string"
]
kind = "string"
users = [
"string"
]
}
}
För GitHubanvänder du:
{
kind = "GitHub"
organizations = [
{
repositories = [
"string"
]
url = "string"
}
]
}
ResourcePredictionsProfile-objekt
Ange egenskapen typ för att ange typ av objekt.
För Automatiskanvänder du:
{
kind = "Automatic"
predictionPreference = "string"
}
För Manuellanvänder du:
{
kind = "Manual"
}
Egenskapsvärden
AgentProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Ange till "Stateful" för typen Stateful. Ange till "Tillståndslös" för typen StatelessAgentProfile. | "Tillståndskänslig" "Tillståndslös" (krävs) |
resourcePredictions | Definierar poolbuffert/stand-by-agenter. | någon |
resourcePredictionsProfile | Definierar hur poolbufferten/stand-by-agenterna tillhandahålls. | ResourcePredictionsProfile |
AutomaticResourcePredictionsProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Avgör hur stand-by-schemat ska tillhandahållas. | "Automatisk" (krävs) |
predictionPreference | Avgör balansen mellan kostnad och prestanda. | "Balanserad" "BestPerformance" "MoreCostEffective" "MorePerformance" "MostCostEffective" |
AzureDevOpsOrganizationProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Diskriminerande egenskap för OrganizationProfile. | "AzureDevOps" (krävs) |
Organisationer | Listan över Azure DevOps-organisationer som poolen ska finnas i. | Organisation[] (krävs) |
permissionProfile | 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 | string[] |
sort | Avgör vem som har administratörsbehörighet till Azure DevOps-poolen. | "CreatorOnly" "Ärv" "SpecificAccounts" (krävs) |
Användare | Användarens e-postadresser | string[] |
DataDisk
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 | Enhetsbeteckningen för den tomma datadisken. Om det inte anges blir det den första tillgängliga bokstaven. | sträng |
storageAccountType | 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) |
FabricProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Ange till "Vmss" för typ VmssFabricProfile. | "Vmss" (krävs) |
GitHubOrganization
Namn | Beskrivning | Värde |
---|---|---|
Databaser | Valfri lista över lagringsplatser där poolen ska skapas. | string[] |
URL | GitHub-organisations-URL:en där poolen ska skapas. | sträng (krävs) |
GitHubOrganizationProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Diskriminerande egenskap för OrganizationProfile. | "GitHub" (krävs) |
Organisationer | Listan över GitHub-organisationer/lagringsplatser som poolen ska finnas i. | GitHubOrganization[] (krävs) |
ManagedServiceIdentity
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) |
userAssignedIdentities | 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 |
ManualResourcePredictionsProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Avgör hur stand-by-schemat ska tillhandahållas. | "Manuell" (krävs) |
Microsoft.DevOpsInfrastructure/pooler
Namn | Beskrivning | Värde |
---|---|---|
identitet | De hanterade tjänstidentiteter som tilldelats den här resursen. | ManagedServiceIdentity |
plats | 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 | Resurstaggar | Ordlista med taggnamn och värden. |
typ | Resurstypen | "Microsoft.DevOpsInfrastructure/pools@2025-01-21" |
NetworkProfile
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 | 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. | string[] |
URL | Url:en för Azure DevOps-organisationen där poolen ska skapas. | sträng (krävs) |
OrganizationProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | 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" |
secretsManagementSettings | Inställningarna för hemlig hantering av datorerna i poolen. | SecretsManagementSettings |
PoolImage
Namn | Beskrivning | Värde |
---|---|---|
Alias | Lista över alias som ska referera till avbildningen med. | string[] |
buffert | Procentandelen av bufferten som ska allokeras till den här avbildningen. | sträng |
ephemeralType | Bildens tillfälliga typ. | "Automatisk" "CacheDisk" "ResourceDisk" |
resourceId | Resurs-ID:t för avbildningen. | sträng |
wellKnownImageName | Avbildningen som ska användas från en välkänd uppsättning avbildningar som görs tillgängliga för kunder. | sträng |
PoolEgenskaper
Namn | Beskrivning | Värde |
---|---|---|
agentProfile | 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) |
fabricProfile | Definierar vilken typ av infrastrukturresurser agenten ska köras på. | FabricProfile (krävs) |
maximumConcurrency | 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) |
organizationProfile | Definierar i vilken organisation poolen ska användas. | OrganizationProfile (krävs) |
provisioningState | Status för den aktuella åtgärden. | "Accepterad" "Avbröts" "Ta bort" "Misslyckades" "Etablering" "Lyckades" "Uppdaterar" |
ResourcePredictionsProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Ange till "Automatisk" för typen AutomaticResourcePredictionsProfile. Ange till "Manuell" för typen ManualResourcePredictionsProfile. | "Automatisk" "Manuell" (krävs) |
SecretsManagementSettings
Namn | Beskrivning | Värde |
---|---|---|
certificateStoreLocation | Var du kan lagra certifikat på datorn. | sträng |
certificateStoreName | Namnet på certifikatarkivet som ska användas på datorn stöds för närvarande "My" och "Root". | "Min" "Rot" |
keyExportable | 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) |
Stateful
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. | sträng |
sort | 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. | sträng |
StatelessAgentProfile
Namn | Beskrivning | Värde |
---|---|---|
sort | Diskriminerande egenskap för AgentProfile. | "Tillståndslös" (krävs) |
StorageProfile
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" |
TrackedResourceTags
Namn | Beskrivning | Värde |
---|
UserAssignedIdentiteter
Namn | Beskrivning | Värde |
---|
UserAssignedIdentity
Namn | Beskrivning | Värde |
---|
VmssFabricProfile
Namn | Beskrivning | Värde |
---|---|---|
Bilder | Vm-avbildningarna av datorerna i poolen. | PoolImage[] (krävs) |
sort | Diskriminerande egenskap för FabricProfile. | "Vmss" (krävs) |
networkProfile | Nätverksprofilen för datorerna i poolen. | NetworkProfile |
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 |
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 |