Microsoft.DevOpsInfrastructure-pools
Bicep-resourcedefinitie
Het resourcetype pools kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een resource voor Microsoft.DevOpsInfrastructure/pools wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.
resource symbolicname 'Microsoft.DevOpsInfrastructure/pools@2024-10-19' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
agentProfile: {
resourcePredictions: any(Azure.Bicep.Types.Concrete.AnyType)
resourcePredictionsProfile: {
kind: 'string'
// For remaining properties, see ResourcePredictionsProfile objects
}
kind: 'string'
// For remaining properties, see AgentProfile objects
}
devCenterProjectResourceId: 'string'
fabricProfile: {
kind: 'string'
// For remaining properties, see FabricProfile objects
}
maximumConcurrency: int
organizationProfile: {
kind: 'string'
// For remaining properties, see OrganizationProfile objects
}
provisioningState: 'string'
}
tags: {
{customized property}: 'string'
}
}
AgentProfile-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor Stateful:
{
gracePeriodTimeSpan: 'string'
kind: 'Stateful'
maxAgentLifetime: 'string'
}
Gebruik voor stateless:
{
kind: 'Stateless'
}
ResourcePredictionsProfile-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor Automatische:
{
kind: 'Automatic'
predictionPreference: 'string'
}
Voor Handmatigegebruikt u:
{
kind: 'Manual'
}
FabricProfile-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor Vmss:
{
images: [
{
aliases: [
'string'
]
buffer: 'string'
resourceId: 'string'
wellKnownImageName: 'string'
}
]
kind: 'Vmss'
networkProfile: {
subnetId: 'string'
}
osProfile: {
logonType: 'string'
secretsManagementSettings: {
certificateStoreLocation: 'string'
keyExportable: bool
observedCertificates: [
'string'
]
}
}
sku: {
name: 'string'
}
storageProfile: {
dataDisks: [
{
caching: 'string'
diskSizeGiB: int
driveLetter: 'string'
storageAccountType: 'string'
}
]
osDiskStorageAccountType: 'string'
}
}
OrganizationProfile-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor AzureDevOps-:
{
kind: 'AzureDevOps'
organizations: [
{
parallelism: int
projects: [
'string'
]
url: 'string'
}
]
permissionProfile: {
groups: [
'string'
]
kind: 'string'
users: [
'string'
]
}
}
Gebruik voor GitHub:
{
kind: 'GitHub'
organizations: [
{
repositories: [
'string'
]
url: 'string'
}
]
}
Eigenschapswaarden
AgentProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Ingesteld op Stateful voor het type Stateful. Ingesteld op Staatloos voor het type StatelessAgentProfile. | 'Stateful' Staatloos (vereist) |
resourcePredictions | Definieert poolbuffer/stand-by-agents. | enig |
resourcePredictionsProfile | Hiermee definieert u hoe de poolbuffer/stand-by-agents worden geleverd. | ResourcePredictionsProfile |
AutomaticResourcePredictionsProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Bepaalt hoe het standaardschema moet worden verstrekt. | 'Automatisch' (vereist) |
predictionPreference | Bepaalt de balans tussen kosten en prestaties. | 'Evenwichtig' 'BestPerformance' 'MoreCostEffective' 'MorePerformance' 'MostCostEffective' |
AzureDevOpsOrganizationProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | De eigenschap Discriminator voor OrganizationProfile. | 'AzureDevOps' (vereist) |
Organisaties | De lijst met Azure DevOps-organisaties waarin de pool moet aanwezig zijn. | Organisatie[] (vereist) |
permissionProfile | Het type machtiging dat bepaalt welke accounts beheerders zijn in de Azure DevOps-pool. | AzureDevOpsPermissionProfile |
AzureDevOpsPermissionProfile
Naam | Beschrijving | Waarde |
---|---|---|
groepen | E-mailadressen groeperen | tekenreeks[] |
soort | Bepaalt wie beheerdersmachtigingen heeft voor de Azure DevOps-pool. | 'CreatorOnly' 'Overnemen' 'SpecificAccounts' (vereist) |
Gebruikers | E-mailadressen van gebruikers | tekenreeks[] |
DataDisk
Naam | Beschrijving | Waarde |
---|---|---|
Caching | Het type caching dat moet worden ingeschakeld voor de gegevensschijven. De standaardwaarde voor opslaan in cache is readwrite. Zie voor meer informatie over de cacheopties: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. | 'Geen' 'ReadOnly' 'ReadWrite' |
diskSizeGiB | De initiële schijfgrootte in gigabytes. | Int |
driveLetter | De stationsletter voor de lege gegevensschijf. Als dit niet is opgegeven, is dit de eerste beschikbare letter. | snaar |
storageAccountType | Het type opslagaccount dat moet worden gebruikt voor de gegevensschijf. Als u dit weglaat, is de standaardwaarde 'standard_lrs'. | 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' |
DevOpsAzureSku
Naam | Beschrijving | Waarde |
---|---|---|
naam | De Azure SKU-naam van de machines in de pool. | tekenreeks (vereist) |
FabricProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Ingesteld op 'Vmss' voor het type VmssFabricProfile. | 'Vmss' (vereist) |
GitHubOrganization
Naam | Beschrijving | Waarde |
---|---|---|
Repositories | Optionele lijst met opslagplaatsen waarin de pool moet worden gemaakt. | tekenreeks[] |
URL | De URL van de GitHub-organisatie waarin de pool moet worden gemaakt. | tekenreeks (vereist) |
GitHubOrganizationProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | De eigenschap Discriminator voor OrganizationProfile. | 'GitHub' (vereist) |
Organisaties | De lijst met GitHub-organisaties/opslagplaatsen waarin de pool moet aanwezig zijn. | GitHubOrganization[] (vereist) |
ManagedServiceIdentity
Naam | Beschrijving | Waarde |
---|---|---|
type | Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). | 'Geen' 'SystemAssigned' 'SystemAssigned, UserAssigned' UserAssigned (vereist) |
userAssignedIdentities | De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. | UserAssignedId-entiteiten |
ManualResourcePredictionsProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Bepaalt hoe het standaardschema moet worden verstrekt. | 'Handmatig' (vereist) |
Microsoft.DevOpsInfrastructure/pools
Naam | Beschrijving | Waarde |
---|---|---|
identiteit | De beheerde service-identiteiten die zijn toegewezen aan deze resource. | ManagedServiceIdentity- |
plaats | De geografische locatie waar de resource zich bevindt | tekenreeks (vereist) |
naam | De resourcenaam | snaar Beperkingen: Patroon = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (vereist) |
Eigenschappen | De resourcespecifieke eigenschappen voor deze resource. | PoolProperties- |
Tags | Resourcetags | Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen |
NetworkProfile
Naam | Beschrijving | Waarde |
---|---|---|
subnetId | De subnet-id waarop alle machines die in de pool zijn gemaakt, moeten worden geplaatst. | tekenreeks (vereist) |
Organisatie
Naam | Beschrijving | Waarde |
---|---|---|
Parallellisme | Hoeveel machines maximaal in deze organisatie kunnen worden gemaakt uit de maximaleconcurrency van de pool. | Int |
Projecten | Optionele lijst met projecten waarin de pool moet worden gemaakt. | tekenreeks[] |
URL | De URL van de Azure DevOps-organisatie waarin de pool moet worden gemaakt. | tekenreeks (vereist) |
OrganizationProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Ingesteld op 'AzureDevOps' voor het type AzureDevOpsOrganizationProfile. Ingesteld op 'GitHub' voor het type GitHubOrganizationProfile. | 'AzureDevOps' 'GitHub' (vereist) |
OsProfile
Naam | Beschrijving | Waarde |
---|---|---|
logonType | Bepaalt hoe de service moet worden uitgevoerd. Dit wordt standaard ingesteld op Service. | 'Interactief' 'Service' |
secretsManagementSettings | De geheime beheerinstellingen van de machines in de pool. | SecretsManagementSettings |
PoolImage
Naam | Beschrijving | Waarde |
---|---|---|
Aliassen | Lijst met aliassen om naar de afbeelding te verwijzen. | tekenreeks[] |
buffer | Het percentage van de buffer dat aan deze afbeelding moet worden toegewezen. | snaar |
resourceId | De resource-id van de installatiekopieën. | snaar |
wellKnownImageName | De installatiekopieën die moeten worden gebruikt vanuit een bekende set afbeeldingen die beschikbaar worden gesteld aan klanten. | snaar |
PoolProperties
Naam | Beschrijving | Waarde |
---|---|---|
agentProfile | Hiermee definieert u hoe de machine wordt verwerkt zodra deze een taak heeft uitgevoerd. | AgentProfile (vereist) |
devCenterProjectResourceId | De resource-id van het DevCenter-project waartoe de pool behoort. | tekenreeks (vereist) |
fabricProfile | Definieert het type infrastructuur waarop de agent wordt uitgevoerd. | FabricProfile (vereist) |
maximumConcurrency | Hiermee definieert u hoeveel resources er op elk gewenst moment kunnen worden gemaakt. | Int Beperkingen: Minimumwaarde = 1 Maximumwaarde = 10000 (vereist) |
organizationProfile | Definieert de organisatie waarin de pool wordt gebruikt. | OrganizationProfile (vereist) |
provisioningState | De status van de huidige bewerking. | 'Geaccepteerd' 'Geannuleerd' 'Verwijderen' 'Mislukt' 'Inrichting' 'Geslaagd' 'Bijwerken' |
ResourcePredictionsProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Ingesteld op Automatisch voor type AutomaticResourcePredictionsProfile. Ingesteld op 'Handmatig' voor type ManualResourcePredictionsProfile. | 'Automatisch' 'Handmatig' (vereist) |
SecretsManagementSettings
Naam | Beschrijving | Waarde |
---|---|---|
certificateStoreLocation | Waar certificaten op de computer worden opgeslagen. | snaar |
keyExportable | Hiermee wordt gedefinieerd of de sleutel van de certificaten moet kunnen worden geëxporteerd. | bool (vereist) |
observedCertificates | De lijst met certificaten die op alle computers in de groep moeten worden geïnstalleerd. | tekenreeks[] (vereist) |
Stateful
Naam | Beschrijving | Waarde |
---|---|---|
gracePeriodTimeSpan | Hoe lang moet de machine worden bewaard nadat er een workload is uitgevoerd wanneer er geen zelfstandige agents zijn. Het maximum is één week. | snaar |
soort | De eigenschap Discriminator voor AgentProfile. | Stateful (vereist) |
maxAgentLifetime | Hoe lang stateful machines moeten worden bewaard. Het maximum is één week. | snaar |
StatelessAgentProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | De eigenschap Discriminator voor AgentProfile. | Staatloos (vereist) |
StorageProfile
Naam | Beschrijving | Waarde |
---|---|---|
dataDisks | Een lijst met lege gegevensschijven die moeten worden gekoppeld. | DataDisk[] |
osDiskStorageAccountType | De Azure SKU-naam van de machines in de pool. | 'Premium' 'Standaard' 'StandardSSD' |
TrackedResourceTags
Naam | Beschrijving | Waarde |
---|
UserAssignedIdentities
Naam | Beschrijving | Waarde |
---|
UserAssignedIdentity
Naam | Beschrijving | Waarde |
---|
VmssFabricProfile
Naam | Beschrijving | Waarde |
---|---|---|
beelden | De VM-installatiekopieën van de machines in de pool. | PoolImage[] (vereist) |
soort | De eigenschap Discriminator voor FabricProfile. | 'Vmss' (vereist) |
networkProfile | Het netwerkprofiel van de machines in de groep. | NetworkProfile |
osProfile | Het besturingssysteemprofiel van de machines in de pool. | OsProfile |
Sku | De Azure-SKU van de machines in de pool. | DevOpsAzureSku (vereist) |
storageProfile | Het opslagprofiel van de machines in de pool. | StorageProfile |
Resourcedefinitie van ARM-sjabloon
Het resourcetype pools kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen - Zie opdrachten voor de implementatie van resourcegroepen
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een Resource microsoft.DevOpsInfrastructure/pools wilt maken, voegt u de volgende JSON toe aan uw sjabloon.
{
"type": "Microsoft.DevOpsInfrastructure/pools",
"apiVersion": "2024-10-19",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"agentProfile": {
"resourcePredictions": {},
"resourcePredictionsProfile": {
"kind": "string"
// For remaining properties, see ResourcePredictionsProfile objects
},
"kind": "string"
// For remaining properties, see AgentProfile objects
},
"devCenterProjectResourceId": "string",
"fabricProfile": {
"kind": "string"
// For remaining properties, see FabricProfile objects
},
"maximumConcurrency": "int",
"organizationProfile": {
"kind": "string"
// For remaining properties, see OrganizationProfile objects
},
"provisioningState": "string"
},
"tags": {
"{customized property}": "string"
}
}
AgentProfile-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor Stateful:
{
"gracePeriodTimeSpan": "string",
"kind": "Stateful",
"maxAgentLifetime": "string"
}
Gebruik voor stateless:
{
"kind": "Stateless"
}
ResourcePredictionsProfile-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor Automatische:
{
"kind": "Automatic",
"predictionPreference": "string"
}
Voor Handmatigegebruikt u:
{
"kind": "Manual"
}
FabricProfile-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor Vmss:
{
"images": [
{
"aliases": [ "string" ],
"buffer": "string",
"resourceId": "string",
"wellKnownImageName": "string"
}
],
"kind": "Vmss",
"networkProfile": {
"subnetId": "string"
},
"osProfile": {
"logonType": "string",
"secretsManagementSettings": {
"certificateStoreLocation": "string",
"keyExportable": "bool",
"observedCertificates": [ "string" ]
}
},
"sku": {
"name": "string"
},
"storageProfile": {
"dataDisks": [
{
"caching": "string",
"diskSizeGiB": "int",
"driveLetter": "string",
"storageAccountType": "string"
}
],
"osDiskStorageAccountType": "string"
}
}
OrganizationProfile-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor AzureDevOps-:
{
"kind": "AzureDevOps",
"organizations": [
{
"parallelism": "int",
"projects": [ "string" ],
"url": "string"
}
],
"permissionProfile": {
"groups": [ "string" ],
"kind": "string",
"users": [ "string" ]
}
}
Gebruik voor GitHub:
{
"kind": "GitHub",
"organizations": [
{
"repositories": [ "string" ],
"url": "string"
}
]
}
Eigenschapswaarden
AgentProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Ingesteld op Stateful voor het type Stateful. Ingesteld op Staatloos voor het type StatelessAgentProfile. | 'Stateful' Staatloos (vereist) |
resourcePredictions | Definieert poolbuffer/stand-by-agents. | enig |
resourcePredictionsProfile | Hiermee definieert u hoe de poolbuffer/stand-by-agents worden geleverd. | ResourcePredictionsProfile |
AutomaticResourcePredictionsProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Bepaalt hoe het standaardschema moet worden verstrekt. | 'Automatisch' (vereist) |
predictionPreference | Bepaalt de balans tussen kosten en prestaties. | 'Evenwichtig' 'BestPerformance' 'MoreCostEffective' 'MorePerformance' 'MostCostEffective' |
AzureDevOpsOrganizationProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | De eigenschap Discriminator voor OrganizationProfile. | 'AzureDevOps' (vereist) |
Organisaties | De lijst met Azure DevOps-organisaties waarin de pool moet aanwezig zijn. | Organisatie[] (vereist) |
permissionProfile | Het type machtiging dat bepaalt welke accounts beheerders zijn in de Azure DevOps-pool. | AzureDevOpsPermissionProfile |
AzureDevOpsPermissionProfile
Naam | Beschrijving | Waarde |
---|---|---|
groepen | E-mailadressen groeperen | tekenreeks[] |
soort | Bepaalt wie beheerdersmachtigingen heeft voor de Azure DevOps-pool. | 'CreatorOnly' 'Overnemen' 'SpecificAccounts' (vereist) |
Gebruikers | E-mailadressen van gebruikers | tekenreeks[] |
DataDisk
Naam | Beschrijving | Waarde |
---|---|---|
Caching | Het type caching dat moet worden ingeschakeld voor de gegevensschijven. De standaardwaarde voor opslaan in cache is readwrite. Zie voor meer informatie over de cacheopties: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. | 'Geen' 'ReadOnly' 'ReadWrite' |
diskSizeGiB | De initiële schijfgrootte in gigabytes. | Int |
driveLetter | De stationsletter voor de lege gegevensschijf. Als dit niet is opgegeven, is dit de eerste beschikbare letter. | snaar |
storageAccountType | Het type opslagaccount dat moet worden gebruikt voor de gegevensschijf. Als u dit weglaat, is de standaardwaarde 'standard_lrs'. | 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' |
DevOpsAzureSku
Naam | Beschrijving | Waarde |
---|---|---|
naam | De Azure SKU-naam van de machines in de pool. | tekenreeks (vereist) |
FabricProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Ingesteld op 'Vmss' voor het type VmssFabricProfile. | 'Vmss' (vereist) |
GitHubOrganization
Naam | Beschrijving | Waarde |
---|---|---|
Repositories | Optionele lijst met opslagplaatsen waarin de pool moet worden gemaakt. | tekenreeks[] |
URL | De URL van de GitHub-organisatie waarin de pool moet worden gemaakt. | tekenreeks (vereist) |
GitHubOrganizationProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | De eigenschap Discriminator voor OrganizationProfile. | 'GitHub' (vereist) |
Organisaties | De lijst met GitHub-organisaties/opslagplaatsen waarin de pool moet aanwezig zijn. | GitHubOrganization[] (vereist) |
ManagedServiceIdentity
Naam | Beschrijving | Waarde |
---|---|---|
type | Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). | 'Geen' 'SystemAssigned' 'SystemAssigned, UserAssigned' UserAssigned (vereist) |
userAssignedIdentities | De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. | UserAssignedId-entiteiten |
ManualResourcePredictionsProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Bepaalt hoe het standaardschema moet worden verstrekt. | 'Handmatig' (vereist) |
Microsoft.DevOpsInfrastructure/pools
Naam | Beschrijving | Waarde |
---|---|---|
apiVersion | De API-versie | '2024-10-19' |
identiteit | De beheerde service-identiteiten die zijn toegewezen aan deze resource. | ManagedServiceIdentity- |
plaats | De geografische locatie waar de resource zich bevindt | tekenreeks (vereist) |
naam | De resourcenaam | snaar Beperkingen: Patroon = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (vereist) |
Eigenschappen | De resourcespecifieke eigenschappen voor deze resource. | PoolProperties- |
Tags | Resourcetags | Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen |
type | Het resourcetype | 'Microsoft.DevOpsInfrastructure/pools' |
NetworkProfile
Naam | Beschrijving | Waarde |
---|---|---|
subnetId | De subnet-id waarop alle machines die in de pool zijn gemaakt, moeten worden geplaatst. | tekenreeks (vereist) |
Organisatie
Naam | Beschrijving | Waarde |
---|---|---|
Parallellisme | Hoeveel machines maximaal in deze organisatie kunnen worden gemaakt uit de maximaleconcurrency van de pool. | Int |
Projecten | Optionele lijst met projecten waarin de pool moet worden gemaakt. | tekenreeks[] |
URL | De URL van de Azure DevOps-organisatie waarin de pool moet worden gemaakt. | tekenreeks (vereist) |
OrganizationProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Ingesteld op 'AzureDevOps' voor het type AzureDevOpsOrganizationProfile. Ingesteld op 'GitHub' voor het type GitHubOrganizationProfile. | 'AzureDevOps' 'GitHub' (vereist) |
OsProfile
Naam | Beschrijving | Waarde |
---|---|---|
logonType | Bepaalt hoe de service moet worden uitgevoerd. Dit wordt standaard ingesteld op Service. | 'Interactief' 'Service' |
secretsManagementSettings | De geheime beheerinstellingen van de machines in de pool. | SecretsManagementSettings |
PoolImage
Naam | Beschrijving | Waarde |
---|---|---|
Aliassen | Lijst met aliassen om naar de afbeelding te verwijzen. | tekenreeks[] |
buffer | Het percentage van de buffer dat aan deze afbeelding moet worden toegewezen. | snaar |
resourceId | De resource-id van de installatiekopieën. | snaar |
wellKnownImageName | De installatiekopieën die moeten worden gebruikt vanuit een bekende set afbeeldingen die beschikbaar worden gesteld aan klanten. | snaar |
PoolProperties
Naam | Beschrijving | Waarde |
---|---|---|
agentProfile | Hiermee definieert u hoe de machine wordt verwerkt zodra deze een taak heeft uitgevoerd. | AgentProfile (vereist) |
devCenterProjectResourceId | De resource-id van het DevCenter-project waartoe de pool behoort. | tekenreeks (vereist) |
fabricProfile | Definieert het type infrastructuur waarop de agent wordt uitgevoerd. | FabricProfile (vereist) |
maximumConcurrency | Hiermee definieert u hoeveel resources er op elk gewenst moment kunnen worden gemaakt. | Int Beperkingen: Minimumwaarde = 1 Maximumwaarde = 10000 (vereist) |
organizationProfile | Definieert de organisatie waarin de pool wordt gebruikt. | OrganizationProfile (vereist) |
provisioningState | De status van de huidige bewerking. | 'Geaccepteerd' 'Geannuleerd' 'Verwijderen' 'Mislukt' 'Inrichting' 'Geslaagd' 'Bijwerken' |
ResourcePredictionsProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Ingesteld op Automatisch voor type AutomaticResourcePredictionsProfile. Ingesteld op 'Handmatig' voor type ManualResourcePredictionsProfile. | 'Automatisch' 'Handmatig' (vereist) |
SecretsManagementSettings
Naam | Beschrijving | Waarde |
---|---|---|
certificateStoreLocation | Waar certificaten op de computer worden opgeslagen. | snaar |
keyExportable | Hiermee wordt gedefinieerd of de sleutel van de certificaten moet kunnen worden geëxporteerd. | bool (vereist) |
observedCertificates | De lijst met certificaten die op alle computers in de groep moeten worden geïnstalleerd. | tekenreeks[] (vereist) |
Stateful
Naam | Beschrijving | Waarde |
---|---|---|
gracePeriodTimeSpan | Hoe lang moet de machine worden bewaard nadat er een workload is uitgevoerd wanneer er geen zelfstandige agents zijn. Het maximum is één week. | snaar |
soort | De eigenschap Discriminator voor AgentProfile. | Stateful (vereist) |
maxAgentLifetime | Hoe lang stateful machines moeten worden bewaard. Het maximum is één week. | snaar |
StatelessAgentProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | De eigenschap Discriminator voor AgentProfile. | Staatloos (vereist) |
StorageProfile
Naam | Beschrijving | Waarde |
---|---|---|
dataDisks | Een lijst met lege gegevensschijven die moeten worden gekoppeld. | DataDisk[] |
osDiskStorageAccountType | De Azure SKU-naam van de machines in de pool. | 'Premium' 'Standaard' 'StandardSSD' |
TrackedResourceTags
Naam | Beschrijving | Waarde |
---|
UserAssignedIdentities
Naam | Beschrijving | Waarde |
---|
UserAssignedIdentity
Naam | Beschrijving | Waarde |
---|
VmssFabricProfile
Naam | Beschrijving | Waarde |
---|---|---|
beelden | De VM-installatiekopieën van de machines in de pool. | PoolImage[] (vereist) |
soort | De eigenschap Discriminator voor FabricProfile. | 'Vmss' (vereist) |
networkProfile | Het netwerkprofiel van de machines in de groep. | NetworkProfile |
osProfile | Het besturingssysteemprofiel van de machines in de pool. | OsProfile |
Sku | De Azure-SKU van de machines in de pool. | DevOpsAzureSku (vereist) |
storageProfile | Het opslagprofiel van de machines in de pool. | StorageProfile |
Resourcedefinitie van Terraform (AzAPI-provider)
Het resourcetype pools kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- resourcegroepen
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Resource-indeling
Als u een resource voor Microsoft.DevOpsInfrastructure/pools wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DevOpsInfrastructure/pools@2024-10-19"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
body = jsonencode({
properties = {
agentProfile = {
resourcePredictions = ?
resourcePredictionsProfile = {
kind = "string"
// For remaining properties, see ResourcePredictionsProfile objects
}
kind = "string"
// For remaining properties, see AgentProfile objects
}
devCenterProjectResourceId = "string"
fabricProfile = {
kind = "string"
// For remaining properties, see FabricProfile objects
}
maximumConcurrency = int
organizationProfile = {
kind = "string"
// For remaining properties, see OrganizationProfile objects
}
provisioningState = "string"
}
})
tags = {
{customized property} = "string"
}
}
AgentProfile-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor Stateful:
{
gracePeriodTimeSpan = "string"
kind = "Stateful"
maxAgentLifetime = "string"
}
Gebruik voor stateless:
{
kind = "Stateless"
}
ResourcePredictionsProfile-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor Automatische:
{
kind = "Automatic"
predictionPreference = "string"
}
Voor Handmatigegebruikt u:
{
kind = "Manual"
}
FabricProfile-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor Vmss:
{
images = [
{
aliases = [
"string"
]
buffer = "string"
resourceId = "string"
wellKnownImageName = "string"
}
]
kind = "Vmss"
networkProfile = {
subnetId = "string"
}
osProfile = {
logonType = "string"
secretsManagementSettings = {
certificateStoreLocation = "string"
keyExportable = bool
observedCertificates = [
"string"
]
}
}
sku = {
name = "string"
}
storageProfile = {
dataDisks = [
{
caching = "string"
diskSizeGiB = int
driveLetter = "string"
storageAccountType = "string"
}
]
osDiskStorageAccountType = "string"
}
}
OrganizationProfile-objecten
Stel de eigenschap type in om het type object op te geven.
Gebruik voor AzureDevOps-:
{
kind = "AzureDevOps"
organizations = [
{
parallelism = int
projects = [
"string"
]
url = "string"
}
]
permissionProfile = {
groups = [
"string"
]
kind = "string"
users = [
"string"
]
}
}
Gebruik voor GitHub:
{
kind = "GitHub"
organizations = [
{
repositories = [
"string"
]
url = "string"
}
]
}
Eigenschapswaarden
AgentProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Ingesteld op Stateful voor het type Stateful. Ingesteld op Staatloos voor het type StatelessAgentProfile. | 'Stateful' Staatloos (vereist) |
resourcePredictions | Definieert poolbuffer/stand-by-agents. | enig |
resourcePredictionsProfile | Hiermee definieert u hoe de poolbuffer/stand-by-agents worden geleverd. | ResourcePredictionsProfile |
AutomaticResourcePredictionsProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Bepaalt hoe het standaardschema moet worden verstrekt. | 'Automatisch' (vereist) |
predictionPreference | Bepaalt de balans tussen kosten en prestaties. | 'Evenwichtig' 'BestPerformance' 'MoreCostEffective' 'MorePerformance' 'MostCostEffective' |
AzureDevOpsOrganizationProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | De eigenschap Discriminator voor OrganizationProfile. | 'AzureDevOps' (vereist) |
Organisaties | De lijst met Azure DevOps-organisaties waarin de pool moet aanwezig zijn. | Organisatie[] (vereist) |
permissionProfile | Het type machtiging dat bepaalt welke accounts beheerders zijn in de Azure DevOps-pool. | AzureDevOpsPermissionProfile |
AzureDevOpsPermissionProfile
Naam | Beschrijving | Waarde |
---|---|---|
groepen | E-mailadressen groeperen | tekenreeks[] |
soort | Bepaalt wie beheerdersmachtigingen heeft voor de Azure DevOps-pool. | 'CreatorOnly' 'Overnemen' 'SpecificAccounts' (vereist) |
Gebruikers | E-mailadressen van gebruikers | tekenreeks[] |
DataDisk
Naam | Beschrijving | Waarde |
---|---|---|
Caching | Het type caching dat moet worden ingeschakeld voor de gegevensschijven. De standaardwaarde voor opslaan in cache is readwrite. Zie voor meer informatie over de cacheopties: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. | 'Geen' 'ReadOnly' 'ReadWrite' |
diskSizeGiB | De initiële schijfgrootte in gigabytes. | Int |
driveLetter | De stationsletter voor de lege gegevensschijf. Als dit niet is opgegeven, is dit de eerste beschikbare letter. | snaar |
storageAccountType | Het type opslagaccount dat moet worden gebruikt voor de gegevensschijf. Als u dit weglaat, is de standaardwaarde 'standard_lrs'. | 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' |
DevOpsAzureSku
Naam | Beschrijving | Waarde |
---|---|---|
naam | De Azure SKU-naam van de machines in de pool. | tekenreeks (vereist) |
FabricProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Ingesteld op 'Vmss' voor het type VmssFabricProfile. | 'Vmss' (vereist) |
GitHubOrganization
Naam | Beschrijving | Waarde |
---|---|---|
Repositories | Optionele lijst met opslagplaatsen waarin de pool moet worden gemaakt. | tekenreeks[] |
URL | De URL van de GitHub-organisatie waarin de pool moet worden gemaakt. | tekenreeks (vereist) |
GitHubOrganizationProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | De eigenschap Discriminator voor OrganizationProfile. | 'GitHub' (vereist) |
Organisaties | De lijst met GitHub-organisaties/opslagplaatsen waarin de pool moet aanwezig zijn. | GitHubOrganization[] (vereist) |
ManagedServiceIdentity
Naam | Beschrijving | Waarde |
---|---|---|
type | Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan). | 'Geen' 'SystemAssigned' 'SystemAssigned, UserAssigned' UserAssigned (vereist) |
userAssignedIdentities | De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen. | UserAssignedId-entiteiten |
ManualResourcePredictionsProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Bepaalt hoe het standaardschema moet worden verstrekt. | 'Handmatig' (vereist) |
Microsoft.DevOpsInfrastructure/pools
Naam | Beschrijving | Waarde |
---|---|---|
identiteit | De beheerde service-identiteiten die zijn toegewezen aan deze resource. | ManagedServiceIdentity- |
plaats | De geografische locatie waar de resource zich bevindt | tekenreeks (vereist) |
naam | De resourcenaam | snaar Beperkingen: Patroon = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (vereist) |
Eigenschappen | De resourcespecifieke eigenschappen voor deze resource. | PoolProperties- |
Tags | Resourcetags | Woordenlijst met tagnamen en -waarden. |
type | Het resourcetype | "Microsoft.DevOpsInfrastructure/pools@2024-10-19" |
NetworkProfile
Naam | Beschrijving | Waarde |
---|---|---|
subnetId | De subnet-id waarop alle machines die in de pool zijn gemaakt, moeten worden geplaatst. | tekenreeks (vereist) |
Organisatie
Naam | Beschrijving | Waarde |
---|---|---|
Parallellisme | Hoeveel machines maximaal in deze organisatie kunnen worden gemaakt uit de maximaleconcurrency van de pool. | Int |
Projecten | Optionele lijst met projecten waarin de pool moet worden gemaakt. | tekenreeks[] |
URL | De URL van de Azure DevOps-organisatie waarin de pool moet worden gemaakt. | tekenreeks (vereist) |
OrganizationProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Ingesteld op 'AzureDevOps' voor het type AzureDevOpsOrganizationProfile. Ingesteld op 'GitHub' voor het type GitHubOrganizationProfile. | 'AzureDevOps' 'GitHub' (vereist) |
OsProfile
Naam | Beschrijving | Waarde |
---|---|---|
logonType | Bepaalt hoe de service moet worden uitgevoerd. Dit wordt standaard ingesteld op Service. | 'Interactief' 'Service' |
secretsManagementSettings | De geheime beheerinstellingen van de machines in de pool. | SecretsManagementSettings |
PoolImage
Naam | Beschrijving | Waarde |
---|---|---|
Aliassen | Lijst met aliassen om naar de afbeelding te verwijzen. | tekenreeks[] |
buffer | Het percentage van de buffer dat aan deze afbeelding moet worden toegewezen. | snaar |
resourceId | De resource-id van de installatiekopieën. | snaar |
wellKnownImageName | De installatiekopieën die moeten worden gebruikt vanuit een bekende set afbeeldingen die beschikbaar worden gesteld aan klanten. | snaar |
PoolProperties
Naam | Beschrijving | Waarde |
---|---|---|
agentProfile | Hiermee definieert u hoe de machine wordt verwerkt zodra deze een taak heeft uitgevoerd. | AgentProfile (vereist) |
devCenterProjectResourceId | De resource-id van het DevCenter-project waartoe de pool behoort. | tekenreeks (vereist) |
fabricProfile | Definieert het type infrastructuur waarop de agent wordt uitgevoerd. | FabricProfile (vereist) |
maximumConcurrency | Hiermee definieert u hoeveel resources er op elk gewenst moment kunnen worden gemaakt. | Int Beperkingen: Minimumwaarde = 1 Maximumwaarde = 10000 (vereist) |
organizationProfile | Definieert de organisatie waarin de pool wordt gebruikt. | OrganizationProfile (vereist) |
provisioningState | De status van de huidige bewerking. | 'Geaccepteerd' 'Geannuleerd' 'Verwijderen' 'Mislukt' 'Inrichting' 'Geslaagd' 'Bijwerken' |
ResourcePredictionsProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | Ingesteld op Automatisch voor type AutomaticResourcePredictionsProfile. Ingesteld op 'Handmatig' voor type ManualResourcePredictionsProfile. | 'Automatisch' 'Handmatig' (vereist) |
SecretsManagementSettings
Naam | Beschrijving | Waarde |
---|---|---|
certificateStoreLocation | Waar certificaten op de computer worden opgeslagen. | snaar |
keyExportable | Hiermee wordt gedefinieerd of de sleutel van de certificaten moet kunnen worden geëxporteerd. | bool (vereist) |
observedCertificates | De lijst met certificaten die op alle computers in de groep moeten worden geïnstalleerd. | tekenreeks[] (vereist) |
Stateful
Naam | Beschrijving | Waarde |
---|---|---|
gracePeriodTimeSpan | Hoe lang moet de machine worden bewaard nadat er een workload is uitgevoerd wanneer er geen zelfstandige agents zijn. Het maximum is één week. | snaar |
soort | De eigenschap Discriminator voor AgentProfile. | Stateful (vereist) |
maxAgentLifetime | Hoe lang stateful machines moeten worden bewaard. Het maximum is één week. | snaar |
StatelessAgentProfile
Naam | Beschrijving | Waarde |
---|---|---|
soort | De eigenschap Discriminator voor AgentProfile. | Staatloos (vereist) |
StorageProfile
Naam | Beschrijving | Waarde |
---|---|---|
dataDisks | Een lijst met lege gegevensschijven die moeten worden gekoppeld. | DataDisk[] |
osDiskStorageAccountType | De Azure SKU-naam van de machines in de pool. | 'Premium' 'Standaard' 'StandardSSD' |
TrackedResourceTags
Naam | Beschrijving | Waarde |
---|
UserAssignedIdentities
Naam | Beschrijving | Waarde |
---|
UserAssignedIdentity
Naam | Beschrijving | Waarde |
---|
VmssFabricProfile
Naam | Beschrijving | Waarde |
---|---|---|
beelden | De VM-installatiekopieën van de machines in de pool. | PoolImage[] (vereist) |
soort | De eigenschap Discriminator voor FabricProfile. | 'Vmss' (vereist) |
networkProfile | Het netwerkprofiel van de machines in de groep. | NetworkProfile |
osProfile | Het besturingssysteemprofiel van de machines in de pool. | OsProfile |
Sku | De Azure-SKU van de machines in de pool. | DevOpsAzureSku (vereist) |
storageProfile | Het opslagprofiel van de machines in de pool. | StorageProfile |