Microsoft.DevOpsInfrastructure Pools
Bicep-Ressourcendefinition
Der Ressourcentyp "Pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.DevOpsInfrastructure/pools-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep hinzu.
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-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für stateful:
{
gracePeriodTimeSpan: 'string'
kind: 'Stateful'
maxAgentLifetime: 'string'
}
Verwenden Sie für stateless:
{
kind: 'Stateless'
}
ResourcePredictionsProfile-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für automatischen:
{
kind: 'Automatic'
predictionPreference: 'string'
}
Verwenden Sie für manuellen:
{
kind: 'Manual'
}
FabricProfile-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für 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-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für AzureDevOps-:
{
kind: 'AzureDevOps'
organizations: [
{
parallelism: int
projects: [
'string'
]
url: 'string'
}
]
permissionProfile: {
groups: [
'string'
]
kind: 'string'
users: [
'string'
]
}
}
Verwenden Sie für GitHub-:
{
kind: 'GitHub'
organizations: [
{
repositories: [
'string'
]
url: 'string'
}
]
}
Eigenschaftswerte
AgentProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Legen Sie für den Typ Statefulauf "Stateful" fest. Wird für den Typ StatelessAgentProfile-auf "Stateless" festgelegt. | "Stateful" "Stateless" (erforderlich) |
resourcePredictions | Definiert Poolpuffer/Stand-by-Agents. | jegliche |
resourcePredictionsProfile | Definiert, wie der Poolpuffer/stand-by-Agents bereitgestellt wird. | ResourcePredictionsProfile- |
AutomaticResourcePredictionsProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Bestimmt, wie das stand-by-Schema bereitgestellt werden soll. | "Automatisch" (erforderlich) |
predictionPreference | Bestimmt das Gleichgewicht zwischen Kosten und Leistung. | "Ausgewogen" 'BestPerformance' "MoreCostEffective" 'MorePerformance' "MostCostEffective" |
AzureDevOpsOrganizationProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Diskriminator-Eigenschaft für OrganizationProfile. | "AzureDevOps" (erforderlich) |
Organisationen | Die Liste der Azure DevOps-Organisationen, in der der Pool vorhanden sein sollte. | Organisation[] (erforderlich) |
permissionProfile | Der Berechtigungstyp, der bestimmt, welche Konten Administratoren im Azure DevOps-Pool sind. | AzureDevOpsPermissionProfile- |
AzureDevOpsPermissionProfile
Name | Beschreibung | Wert |
---|---|---|
Gruppen | Gruppen-E-Mail-Adressen | string[] |
Art | Bestimmt, wer über Administratorberechtigungen für den Azure DevOps-Pool verfügt. | "CreatorOnly" 'Erben' "SpecificAccounts" (erforderlich) |
Benutzer | E-Mail-Adressen des Benutzers | string[] |
DataDisk
Name | Beschreibung | Wert |
---|---|---|
Caching | Der Typ der Zwischenspeicherung, die für die Datenträger aktiviert werden soll. Der Standardwert für die Zwischenspeicherung ist "readwrite". Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. | 'None' 'ReadOnly' 'ReadWrite' |
diskSizeGiB | Die anfängliche Datenträgergröße in Gigabyte. | Int |
driveLetter | Der Laufwerkbuchstaben für den leeren Datenträger. Wenn nicht angegeben, ist es der erste verfügbare Buchstabe. | Schnur |
storageAccountType | Der Speicherkontotyp, der für den Datenträger verwendet werden soll. Wenn nicht angegeben, lautet der Standardwert "standard_lrs". | "Premium_LRS" "Premium_ZRS" "StandardSSD_LRS" "StandardSSD_ZRS" "Standard_LRS" |
DevOpsAzureSku
Name | Beschreibung | Wert |
---|---|---|
Name | Der Azure-SKU-Name der Computer im Pool. | Zeichenfolge (erforderlich) |
FabricProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Legen Sie für den Typ VmssFabricProfileauf "Vmss" fest. | "Vmss" (erforderlich) |
GitHubOrganization
Name | Beschreibung | Wert |
---|---|---|
repositorien | Optionale Liste der Repositorys, in denen der Pool erstellt werden soll. | string[] |
URL | Die GitHub-Organisations-URL, in der der Pool erstellt werden soll. | Zeichenfolge (erforderlich) |
GitHubOrganizationProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Diskriminator-Eigenschaft für OrganizationProfile. | 'GitHub' (erforderlich) |
Organisationen | Die Liste der GitHub-Organisationen/Repositorys, in der der Pool vorhanden sein sollte. | GitHubOrganization-[] (erforderlich) |
ManagedServiceIdentity
Name | Beschreibung | Wert |
---|---|---|
Art | Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). | 'None' 'SystemAssigned' "SystemAssigned,UserAssigned" "UserAssigned" (erforderlich) |
userAssignedIdentities | Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. | UserAssignedIdentities- |
ManualResourcePredictionsProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Bestimmt, wie das stand-by-Schema bereitgestellt werden soll. | "Manuell" (erforderlich) |
Microsoft.DevOpsInfrastructure/pools
Name | Beschreibung | Wert |
---|---|---|
Identität | Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. | ManagedServiceIdentity- |
Ort | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
Name | Der Ressourcenname | Schnur Zwänge: Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (erforderlich) |
Eigenschaften | Die ressourcenspezifischen Eigenschaften für diese Ressource. | PoolProperties- |
Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
NetworkProfile
Name | Beschreibung | Wert |
---|---|---|
subnetz-ID | Die Subnetz-ID, auf der alle Computer im Pool erstellt werden sollen. | Zeichenfolge (erforderlich) |
Organisation
Name | Beschreibung | Wert |
---|---|---|
Parallelismus | Anzahl der Computer, die maximal in dieser Organisation erstellt werden können, aus der maximalen Anzahl der Pools. | Int |
Projekte | Optionale Liste der Projekte, in denen der Pool erstellt werden soll. | string[] |
URL | Die Azure DevOps-Organisations-URL, in der der Pool erstellt werden soll. | Zeichenfolge (erforderlich) |
OrganizationProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Legen Sie für den Typ AzureDevOpsOrganizationProfileauf "AzureDevOpsOrganizationProfile" fest. Set to 'GitHub' for type GitHubOrganizationProfile. | "AzureDevOps" 'GitHub' (erforderlich) |
OsProfile
Name | Beschreibung | Wert |
---|---|---|
logonType | Bestimmt, wie der Dienst ausgeführt werden soll. Standardmäßig wird dies auf "Dienst" festgelegt. | "Interaktiv" 'Service' |
secretsManagementSettings | Die Einstellungen für die geheime Verwaltung der Computer im Pool. | SecretsManagementSettings |
PoolImage
Name | Beschreibung | Wert |
---|---|---|
decknamen | Liste der Aliase, nach der auf das Bild verwiesen werden soll. | string[] |
Puffer | Der Prozentsatz des Puffers, der diesem Bild zugeordnet werden soll. | Schnur |
resourceId | Die Ressourcen-ID des Bilds. | Schnur |
wellKnownImageName | Das Bild, das von einer bekannten Gruppe von Bildern verwendet werden soll, die Kunden zur Verfügung gestellt werden. | Schnur |
PoolProperties
Name | Beschreibung | Wert |
---|---|---|
agentProfile | Definiert, wie der Computer verarbeitet wird, nachdem er einen Auftrag ausgeführt hat. | AgentProfile- (erforderlich) |
devCenterProjectResourceId | Die Ressourcen-ID des DevCenter-Projekts, zu dem der Pool gehört. | Zeichenfolge (erforderlich) |
fabricProfile | Definiert den Typ der Fabric, auf der der Agent ausgeführt wird. | FabricProfile- (erforderlich) |
maximumConcurrency | Definiert, wie viele Ressourcen zu einem bestimmten Zeitpunkt erstellt werden können. | Int Zwänge: Min.-Wert = 1 Maximalwert = 10000 (erforderlich) |
organizationProfile | Definiert die Organisation, in der der Pool verwendet wird. | OrganizationProfile- (erforderlich) |
provisioningState | Der Status des aktuellen Vorgangs. | "Akzeptiert" 'Abgebrochen' "Löschen" 'Fehler' 'Bereitstellung' "Erfolgreich" "Aktualisieren" |
ResourcePredictionsProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Legen Sie für den Typ AutomaticResourcePredictionsProfileauf "Automatisch" fest. Set to 'Manual' for type ManualResourcePredictionsProfile. | "Automatisch" "Manuell" (erforderlich) |
SecretsManagementSettings
Name | Beschreibung | Wert |
---|---|---|
certificateStoreLocation | Speicherort für Zertifikate auf dem Computer. | Schnur |
keyExportable | Definiert, ob der Schlüssel der Zertifikate exportierbar sein soll. | bool (erforderlich) |
observedCertificates | Die Liste der Zertifikate, die auf allen Computern im Pool installiert werden sollen. | string[] (erforderlich) |
Zustandsorientiert
Name | Beschreibung | Wert |
---|---|---|
gracePeriodTimeSpan | Wie lange sollte der Computer beibehalten werden, nachdem er eine Workload ausgeführt hat, wenn keine eigenständigen Agents vorhanden sind. Das Maximum beträgt eine Woche. | Schnur |
Art | Diskriminator-Eigenschaft für AgentProfile. | "Stateful" (erforderlich) |
maxAgentLifetime | Wie lange zustandsbehaftete Computer beibehalten werden sollen. Das Maximum beträgt eine Woche. | Schnur |
StatelessAgentProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Diskriminator-Eigenschaft für AgentProfile. | "Stateless" (erforderlich) |
StorageProfile
Name | Beschreibung | Wert |
---|---|---|
dataDisks | Eine Liste leerer Datenträger, die angefügt werden sollen. | DataDisk-[] |
osDiskStorageAccountType | Der Azure-SKU-Name der Computer im Pool. | "Premium" "Standard" "StandardSSD" |
TrackedResourceTags
Name | Beschreibung | Wert |
---|
UserAssignedIdentities
Name | Beschreibung | Wert |
---|
UserAssignedIdentity
Name | Beschreibung | Wert |
---|
VmssFabricProfile
Name | Beschreibung | Wert |
---|---|---|
Bilder | Die VM-Images der Computer im Pool. | PoolImage-[] (erforderlich) |
Art | Diskriminator-Eigenschaft für FabricProfile. | "Vmss" (erforderlich) |
networkProfile | Das Netzwerkprofil der Computer im Pool. | NetworkProfile- |
osProfile | Das Betriebssystemprofil der Computer im Pool. | OsProfile- |
Sku | Die Azure-SKU der Computer im Pool. | DevOpsAzureSku- (erforderlich) |
storageProfile | Das Speicherprofil der Computer im Pool. | StorageProfile- |
ARM-Vorlagenressourcendefinition
Der Ressourcentyp "Pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.DevOpsInfrastructure/pools-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.
{
"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-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für stateful:
{
"gracePeriodTimeSpan": "string",
"kind": "Stateful",
"maxAgentLifetime": "string"
}
Verwenden Sie für stateless:
{
"kind": "Stateless"
}
ResourcePredictionsProfile-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für automatischen:
{
"kind": "Automatic",
"predictionPreference": "string"
}
Verwenden Sie für manuellen:
{
"kind": "Manual"
}
FabricProfile-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für 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-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für AzureDevOps-:
{
"kind": "AzureDevOps",
"organizations": [
{
"parallelism": "int",
"projects": [ "string" ],
"url": "string"
}
],
"permissionProfile": {
"groups": [ "string" ],
"kind": "string",
"users": [ "string" ]
}
}
Verwenden Sie für GitHub-:
{
"kind": "GitHub",
"organizations": [
{
"repositories": [ "string" ],
"url": "string"
}
]
}
Eigenschaftswerte
AgentProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Legen Sie für den Typ Statefulauf "Stateful" fest. Wird für den Typ StatelessAgentProfile-auf "Stateless" festgelegt. | "Stateful" "Stateless" (erforderlich) |
resourcePredictions | Definiert Poolpuffer/Stand-by-Agents. | jegliche |
resourcePredictionsProfile | Definiert, wie der Poolpuffer/stand-by-Agents bereitgestellt wird. | ResourcePredictionsProfile- |
AutomaticResourcePredictionsProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Bestimmt, wie das stand-by-Schema bereitgestellt werden soll. | "Automatisch" (erforderlich) |
predictionPreference | Bestimmt das Gleichgewicht zwischen Kosten und Leistung. | "Ausgewogen" 'BestPerformance' "MoreCostEffective" 'MorePerformance' "MostCostEffective" |
AzureDevOpsOrganizationProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Diskriminator-Eigenschaft für OrganizationProfile. | "AzureDevOps" (erforderlich) |
Organisationen | Die Liste der Azure DevOps-Organisationen, in der der Pool vorhanden sein sollte. | Organisation[] (erforderlich) |
permissionProfile | Der Berechtigungstyp, der bestimmt, welche Konten Administratoren im Azure DevOps-Pool sind. | AzureDevOpsPermissionProfile- |
AzureDevOpsPermissionProfile
Name | Beschreibung | Wert |
---|---|---|
Gruppen | Gruppen-E-Mail-Adressen | string[] |
Art | Bestimmt, wer über Administratorberechtigungen für den Azure DevOps-Pool verfügt. | "CreatorOnly" 'Erben' "SpecificAccounts" (erforderlich) |
Benutzer | E-Mail-Adressen des Benutzers | string[] |
DataDisk
Name | Beschreibung | Wert |
---|---|---|
Caching | Der Typ der Zwischenspeicherung, die für die Datenträger aktiviert werden soll. Der Standardwert für die Zwischenspeicherung ist "readwrite". Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. | 'None' 'ReadOnly' 'ReadWrite' |
diskSizeGiB | Die anfängliche Datenträgergröße in Gigabyte. | Int |
driveLetter | Der Laufwerkbuchstaben für den leeren Datenträger. Wenn nicht angegeben, ist es der erste verfügbare Buchstabe. | Schnur |
storageAccountType | Der Speicherkontotyp, der für den Datenträger verwendet werden soll. Wenn nicht angegeben, lautet der Standardwert "standard_lrs". | "Premium_LRS" "Premium_ZRS" "StandardSSD_LRS" "StandardSSD_ZRS" "Standard_LRS" |
DevOpsAzureSku
Name | Beschreibung | Wert |
---|---|---|
Name | Der Azure-SKU-Name der Computer im Pool. | Zeichenfolge (erforderlich) |
FabricProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Legen Sie für den Typ VmssFabricProfileauf "Vmss" fest. | "Vmss" (erforderlich) |
GitHubOrganization
Name | Beschreibung | Wert |
---|---|---|
repositorien | Optionale Liste der Repositorys, in denen der Pool erstellt werden soll. | string[] |
URL | Die GitHub-Organisations-URL, in der der Pool erstellt werden soll. | Zeichenfolge (erforderlich) |
GitHubOrganizationProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Diskriminator-Eigenschaft für OrganizationProfile. | 'GitHub' (erforderlich) |
Organisationen | Die Liste der GitHub-Organisationen/Repositorys, in der der Pool vorhanden sein sollte. | GitHubOrganization-[] (erforderlich) |
ManagedServiceIdentity
Name | Beschreibung | Wert |
---|---|---|
Art | Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). | 'None' 'SystemAssigned' "SystemAssigned,UserAssigned" "UserAssigned" (erforderlich) |
userAssignedIdentities | Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. | UserAssignedIdentities- |
ManualResourcePredictionsProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Bestimmt, wie das stand-by-Schema bereitgestellt werden soll. | "Manuell" (erforderlich) |
Microsoft.DevOpsInfrastructure/pools
Name | Beschreibung | Wert |
---|---|---|
apiVersion | Die API-Version | '2024-10-19' |
Identität | Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. | ManagedServiceIdentity- |
Ort | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
Name | Der Ressourcenname | Schnur Zwänge: Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (erforderlich) |
Eigenschaften | Die ressourcenspezifischen Eigenschaften für diese Ressource. | PoolProperties- |
Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
Art | Der Ressourcentyp | "Microsoft.DevOpsInfrastructure/pools" |
NetworkProfile
Name | Beschreibung | Wert |
---|---|---|
subnetz-ID | Die Subnetz-ID, auf der alle Computer im Pool erstellt werden sollen. | Zeichenfolge (erforderlich) |
Organisation
Name | Beschreibung | Wert |
---|---|---|
Parallelismus | Anzahl der Computer, die maximal in dieser Organisation erstellt werden können, aus der maximalen Anzahl der Pools. | Int |
Projekte | Optionale Liste der Projekte, in denen der Pool erstellt werden soll. | string[] |
URL | Die Azure DevOps-Organisations-URL, in der der Pool erstellt werden soll. | Zeichenfolge (erforderlich) |
OrganizationProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Legen Sie für den Typ AzureDevOpsOrganizationProfileauf "AzureDevOpsOrganizationProfile" fest. Set to 'GitHub' for type GitHubOrganizationProfile. | "AzureDevOps" 'GitHub' (erforderlich) |
OsProfile
Name | Beschreibung | Wert |
---|---|---|
logonType | Bestimmt, wie der Dienst ausgeführt werden soll. Standardmäßig wird dies auf "Dienst" festgelegt. | "Interaktiv" 'Service' |
secretsManagementSettings | Die Einstellungen für die geheime Verwaltung der Computer im Pool. | SecretsManagementSettings |
PoolImage
Name | Beschreibung | Wert |
---|---|---|
decknamen | Liste der Aliase, nach der auf das Bild verwiesen werden soll. | string[] |
Puffer | Der Prozentsatz des Puffers, der diesem Bild zugeordnet werden soll. | Schnur |
resourceId | Die Ressourcen-ID des Bilds. | Schnur |
wellKnownImageName | Das Bild, das von einer bekannten Gruppe von Bildern verwendet werden soll, die Kunden zur Verfügung gestellt werden. | Schnur |
PoolProperties
Name | Beschreibung | Wert |
---|---|---|
agentProfile | Definiert, wie der Computer verarbeitet wird, nachdem er einen Auftrag ausgeführt hat. | AgentProfile- (erforderlich) |
devCenterProjectResourceId | Die Ressourcen-ID des DevCenter-Projekts, zu dem der Pool gehört. | Zeichenfolge (erforderlich) |
fabricProfile | Definiert den Typ der Fabric, auf der der Agent ausgeführt wird. | FabricProfile- (erforderlich) |
maximumConcurrency | Definiert, wie viele Ressourcen zu einem bestimmten Zeitpunkt erstellt werden können. | Int Zwänge: Min.-Wert = 1 Maximalwert = 10000 (erforderlich) |
organizationProfile | Definiert die Organisation, in der der Pool verwendet wird. | OrganizationProfile- (erforderlich) |
provisioningState | Der Status des aktuellen Vorgangs. | "Akzeptiert" 'Abgebrochen' "Löschen" 'Fehler' 'Bereitstellung' "Erfolgreich" "Aktualisieren" |
ResourcePredictionsProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Legen Sie für den Typ AutomaticResourcePredictionsProfileauf "Automatisch" fest. Set to 'Manual' for type ManualResourcePredictionsProfile. | "Automatisch" "Manuell" (erforderlich) |
SecretsManagementSettings
Name | Beschreibung | Wert |
---|---|---|
certificateStoreLocation | Speicherort für Zertifikate auf dem Computer. | Schnur |
keyExportable | Definiert, ob der Schlüssel der Zertifikate exportierbar sein soll. | bool (erforderlich) |
observedCertificates | Die Liste der Zertifikate, die auf allen Computern im Pool installiert werden sollen. | string[] (erforderlich) |
Zustandsorientiert
Name | Beschreibung | Wert |
---|---|---|
gracePeriodTimeSpan | Wie lange sollte der Computer beibehalten werden, nachdem er eine Workload ausgeführt hat, wenn keine eigenständigen Agents vorhanden sind. Das Maximum beträgt eine Woche. | Schnur |
Art | Diskriminator-Eigenschaft für AgentProfile. | "Stateful" (erforderlich) |
maxAgentLifetime | Wie lange zustandsbehaftete Computer beibehalten werden sollen. Das Maximum beträgt eine Woche. | Schnur |
StatelessAgentProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Diskriminator-Eigenschaft für AgentProfile. | "Stateless" (erforderlich) |
StorageProfile
Name | Beschreibung | Wert |
---|---|---|
dataDisks | Eine Liste leerer Datenträger, die angefügt werden sollen. | DataDisk-[] |
osDiskStorageAccountType | Der Azure-SKU-Name der Computer im Pool. | "Premium" "Standard" "StandardSSD" |
TrackedResourceTags
Name | Beschreibung | Wert |
---|
UserAssignedIdentities
Name | Beschreibung | Wert |
---|
UserAssignedIdentity
Name | Beschreibung | Wert |
---|
VmssFabricProfile
Name | Beschreibung | Wert |
---|---|---|
Bilder | Die VM-Images der Computer im Pool. | PoolImage-[] (erforderlich) |
Art | Diskriminator-Eigenschaft für FabricProfile. | "Vmss" (erforderlich) |
networkProfile | Das Netzwerkprofil der Computer im Pool. | NetworkProfile- |
osProfile | Das Betriebssystemprofil der Computer im Pool. | OsProfile- |
Sku | Die Azure-SKU der Computer im Pool. | DevOpsAzureSku- (erforderlich) |
storageProfile | Das Speicherprofil der Computer im Pool. | StorageProfile- |
Terraform -Ressourcendefinition (AzAPI-Anbieter)
Der Ressourcentyp "Pools" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.DevOpsInfrastructure/pools-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.
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-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für stateful:
{
gracePeriodTimeSpan = "string"
kind = "Stateful"
maxAgentLifetime = "string"
}
Verwenden Sie für stateless:
{
kind = "Stateless"
}
ResourcePredictionsProfile-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für automatischen:
{
kind = "Automatic"
predictionPreference = "string"
}
Verwenden Sie für manuellen:
{
kind = "Manual"
}
FabricProfile-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für 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-Objekte
Legen Sie die Art Eigenschaft fest, um den Objekttyp anzugeben.
Verwenden Sie für AzureDevOps-:
{
kind = "AzureDevOps"
organizations = [
{
parallelism = int
projects = [
"string"
]
url = "string"
}
]
permissionProfile = {
groups = [
"string"
]
kind = "string"
users = [
"string"
]
}
}
Verwenden Sie für GitHub-:
{
kind = "GitHub"
organizations = [
{
repositories = [
"string"
]
url = "string"
}
]
}
Eigenschaftswerte
AgentProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Legen Sie für den Typ Statefulauf "Stateful" fest. Wird für den Typ StatelessAgentProfile-auf "Stateless" festgelegt. | "Stateful" "Stateless" (erforderlich) |
resourcePredictions | Definiert Poolpuffer/Stand-by-Agents. | jegliche |
resourcePredictionsProfile | Definiert, wie der Poolpuffer/stand-by-Agents bereitgestellt wird. | ResourcePredictionsProfile- |
AutomaticResourcePredictionsProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Bestimmt, wie das stand-by-Schema bereitgestellt werden soll. | "Automatisch" (erforderlich) |
predictionPreference | Bestimmt das Gleichgewicht zwischen Kosten und Leistung. | "Ausgewogen" 'BestPerformance' "MoreCostEffective" 'MorePerformance' "MostCostEffective" |
AzureDevOpsOrganizationProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Diskriminator-Eigenschaft für OrganizationProfile. | "AzureDevOps" (erforderlich) |
Organisationen | Die Liste der Azure DevOps-Organisationen, in der der Pool vorhanden sein sollte. | Organisation[] (erforderlich) |
permissionProfile | Der Berechtigungstyp, der bestimmt, welche Konten Administratoren im Azure DevOps-Pool sind. | AzureDevOpsPermissionProfile- |
AzureDevOpsPermissionProfile
Name | Beschreibung | Wert |
---|---|---|
Gruppen | Gruppen-E-Mail-Adressen | string[] |
Art | Bestimmt, wer über Administratorberechtigungen für den Azure DevOps-Pool verfügt. | "CreatorOnly" 'Erben' "SpecificAccounts" (erforderlich) |
Benutzer | E-Mail-Adressen des Benutzers | string[] |
DataDisk
Name | Beschreibung | Wert |
---|---|---|
Caching | Der Typ der Zwischenspeicherung, die für die Datenträger aktiviert werden soll. Der Standardwert für die Zwischenspeicherung ist "readwrite". Informationen zu den Zwischenspeicherungsoptionen finden Sie unter: https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/. | 'None' 'ReadOnly' 'ReadWrite' |
diskSizeGiB | Die anfängliche Datenträgergröße in Gigabyte. | Int |
driveLetter | Der Laufwerkbuchstaben für den leeren Datenträger. Wenn nicht angegeben, ist es der erste verfügbare Buchstabe. | Schnur |
storageAccountType | Der Speicherkontotyp, der für den Datenträger verwendet werden soll. Wenn nicht angegeben, lautet der Standardwert "standard_lrs". | "Premium_LRS" "Premium_ZRS" "StandardSSD_LRS" "StandardSSD_ZRS" "Standard_LRS" |
DevOpsAzureSku
Name | Beschreibung | Wert |
---|---|---|
Name | Der Azure-SKU-Name der Computer im Pool. | Zeichenfolge (erforderlich) |
FabricProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Legen Sie für den Typ VmssFabricProfileauf "Vmss" fest. | "Vmss" (erforderlich) |
GitHubOrganization
Name | Beschreibung | Wert |
---|---|---|
repositorien | Optionale Liste der Repositorys, in denen der Pool erstellt werden soll. | string[] |
URL | Die GitHub-Organisations-URL, in der der Pool erstellt werden soll. | Zeichenfolge (erforderlich) |
GitHubOrganizationProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Diskriminator-Eigenschaft für OrganizationProfile. | 'GitHub' (erforderlich) |
Organisationen | Die Liste der GitHub-Organisationen/Repositorys, in der der Pool vorhanden sein sollte. | GitHubOrganization-[] (erforderlich) |
ManagedServiceIdentity
Name | Beschreibung | Wert |
---|---|---|
Art | Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). | 'None' 'SystemAssigned' "SystemAssigned,UserAssigned" "UserAssigned" (erforderlich) |
userAssignedIdentities | Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. | UserAssignedIdentities- |
ManualResourcePredictionsProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Bestimmt, wie das stand-by-Schema bereitgestellt werden soll. | "Manuell" (erforderlich) |
Microsoft.DevOpsInfrastructure/pools
Name | Beschreibung | Wert |
---|---|---|
Identität | Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. | ManagedServiceIdentity- |
Ort | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
Name | Der Ressourcenname | Schnur Zwänge: Pattern = ^[a-zA-Z0-9][a-zA-Z0-9-.]*$ (erforderlich) |
Eigenschaften | Die ressourcenspezifischen Eigenschaften für diese Ressource. | PoolProperties- |
Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. |
Art | Der Ressourcentyp | "Microsoft.DevOpsInfrastructure/pools@2024-10-19" |
NetworkProfile
Name | Beschreibung | Wert |
---|---|---|
subnetz-ID | Die Subnetz-ID, auf der alle Computer im Pool erstellt werden sollen. | Zeichenfolge (erforderlich) |
Organisation
Name | Beschreibung | Wert |
---|---|---|
Parallelismus | Anzahl der Computer, die maximal in dieser Organisation erstellt werden können, aus der maximalen Anzahl der Pools. | Int |
Projekte | Optionale Liste der Projekte, in denen der Pool erstellt werden soll. | string[] |
URL | Die Azure DevOps-Organisations-URL, in der der Pool erstellt werden soll. | Zeichenfolge (erforderlich) |
OrganizationProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Legen Sie für den Typ AzureDevOpsOrganizationProfileauf "AzureDevOpsOrganizationProfile" fest. Set to 'GitHub' for type GitHubOrganizationProfile. | "AzureDevOps" 'GitHub' (erforderlich) |
OsProfile
Name | Beschreibung | Wert |
---|---|---|
logonType | Bestimmt, wie der Dienst ausgeführt werden soll. Standardmäßig wird dies auf "Dienst" festgelegt. | "Interaktiv" 'Service' |
secretsManagementSettings | Die Einstellungen für die geheime Verwaltung der Computer im Pool. | SecretsManagementSettings |
PoolImage
Name | Beschreibung | Wert |
---|---|---|
decknamen | Liste der Aliase, nach der auf das Bild verwiesen werden soll. | string[] |
Puffer | Der Prozentsatz des Puffers, der diesem Bild zugeordnet werden soll. | Schnur |
resourceId | Die Ressourcen-ID des Bilds. | Schnur |
wellKnownImageName | Das Bild, das von einer bekannten Gruppe von Bildern verwendet werden soll, die Kunden zur Verfügung gestellt werden. | Schnur |
PoolProperties
Name | Beschreibung | Wert |
---|---|---|
agentProfile | Definiert, wie der Computer verarbeitet wird, nachdem er einen Auftrag ausgeführt hat. | AgentProfile- (erforderlich) |
devCenterProjectResourceId | Die Ressourcen-ID des DevCenter-Projekts, zu dem der Pool gehört. | Zeichenfolge (erforderlich) |
fabricProfile | Definiert den Typ der Fabric, auf der der Agent ausgeführt wird. | FabricProfile- (erforderlich) |
maximumConcurrency | Definiert, wie viele Ressourcen zu einem bestimmten Zeitpunkt erstellt werden können. | Int Zwänge: Min.-Wert = 1 Maximalwert = 10000 (erforderlich) |
organizationProfile | Definiert die Organisation, in der der Pool verwendet wird. | OrganizationProfile- (erforderlich) |
provisioningState | Der Status des aktuellen Vorgangs. | "Akzeptiert" 'Abgebrochen' "Löschen" 'Fehler' 'Bereitstellung' "Erfolgreich" "Aktualisieren" |
ResourcePredictionsProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Legen Sie für den Typ AutomaticResourcePredictionsProfileauf "Automatisch" fest. Set to 'Manual' for type ManualResourcePredictionsProfile. | "Automatisch" "Manuell" (erforderlich) |
SecretsManagementSettings
Name | Beschreibung | Wert |
---|---|---|
certificateStoreLocation | Speicherort für Zertifikate auf dem Computer. | Schnur |
keyExportable | Definiert, ob der Schlüssel der Zertifikate exportierbar sein soll. | bool (erforderlich) |
observedCertificates | Die Liste der Zertifikate, die auf allen Computern im Pool installiert werden sollen. | string[] (erforderlich) |
Zustandsorientiert
Name | Beschreibung | Wert |
---|---|---|
gracePeriodTimeSpan | Wie lange sollte der Computer beibehalten werden, nachdem er eine Workload ausgeführt hat, wenn keine eigenständigen Agents vorhanden sind. Das Maximum beträgt eine Woche. | Schnur |
Art | Diskriminator-Eigenschaft für AgentProfile. | "Stateful" (erforderlich) |
maxAgentLifetime | Wie lange zustandsbehaftete Computer beibehalten werden sollen. Das Maximum beträgt eine Woche. | Schnur |
StatelessAgentProfile
Name | Beschreibung | Wert |
---|---|---|
Art | Diskriminator-Eigenschaft für AgentProfile. | "Stateless" (erforderlich) |
StorageProfile
Name | Beschreibung | Wert |
---|---|---|
dataDisks | Eine Liste leerer Datenträger, die angefügt werden sollen. | DataDisk-[] |
osDiskStorageAccountType | Der Azure-SKU-Name der Computer im Pool. | "Premium" "Standard" "StandardSSD" |
TrackedResourceTags
Name | Beschreibung | Wert |
---|
UserAssignedIdentities
Name | Beschreibung | Wert |
---|
UserAssignedIdentity
Name | Beschreibung | Wert |
---|
VmssFabricProfile
Name | Beschreibung | Wert |
---|---|---|
Bilder | Die VM-Images der Computer im Pool. | PoolImage-[] (erforderlich) |
Art | Diskriminator-Eigenschaft für FabricProfile. | "Vmss" (erforderlich) |
networkProfile | Das Netzwerkprofil der Computer im Pool. | NetworkProfile- |
osProfile | Das Betriebssystemprofil der Computer im Pool. | OsProfile- |
Sku | Die Azure-SKU der Computer im Pool. | DevOpsAzureSku- (erforderlich) |
storageProfile | Das Speicherprofil der Computer im Pool. | StorageProfile- |