Udostępnij przez


Microsoft.DevOpsInfrastructure pule 2023-10-30-preview

Definicja zasobu Bicep

Typ zasobu pul można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevOpsInfrastructure/pools, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.DevOpsInfrastructure/pools@2023-10-30-preview' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    agentProfile: {
      resourcePredictions: any(...)
      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'
  }
}

Obiekty AgentProfile

Ustaw właściwość kind , aby określić typ obiektu.

W przypadku funkcji Stateful użyj:

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

W przypadku bezstanowych użyj:

{
  kind: 'Stateless'
}

Obiekty FabricProfile

Ustaw właściwość kind , aby określić typ obiektu.

W przypadku usługi VMSS użyj:

{
  images: [
    {
      aliases: [
        'string'
      ]
      buffer: 'string'
      resourceId: 'string'
    }
  ]
  kind: 'Vmss'
  networkProfile: {
    subnetId: 'string'
  }
  osProfile: {
    secretsManagementSettings: {
      certificateStoreLocation: 'string'
      keyExportable: bool
      observedCertificates: [
        'string'
      ]
    }
  }
  sku: {
    name: 'string'
    tier: 'string'
  }
}

Obiekty OrganizationProfile

Ustaw właściwość kind , aby określić typ obiektu.

W przypadku usługi AzureDevOps użyj:

{
  kind: 'AzureDevOps'
  organizations: [
    {
      parallelism: int
      projects: [
        'string'
      ]
      url: 'string'
    }
  ]
}

Wartości właściwości

Microsoft.DevOpsInfrastructure/pools

Name Description Value
tożsamość Tożsamości usługi zarządzanej przypisane do tego zasobu. ManagedServiceIdentity
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
name Nazwa zasobu string

Constraints:
Wzorzec = ^[a-z][a-z0-9]*$ (wymagane)
properties Właściwości specyficzne dla zasobu dla tego zasobu. PoolProperties
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

AgentProfile

Name Description Value
kind Ustaw wartość "Stateful" dla typu Stateful. Ustaw wartość "Stateless" dla typu StatelessAgentProfile. 'Stateful'
"Bezstanowy" (wymagane)
resourcePredictions Definiuje bufor puli. any

AzureDevOpsOrganizationProfile

Name Description Value
kind Właściwość dyskryminująca dla elementu OrganizationProfile. "AzureDevOps" (wymagane)
organizations Lista organizacji usługi Azure DevOps, w których powinna znajdować się pula. Organizacja[] (wymagane)

DevOpsAzureSku

Name Description Value
name Nazwa jednostki SKU platformy Azure maszyn w puli. ciąg (wymagany)
warstwa Warstwa jednostki SKU platformy Azure maszyn w puli. ciąg

FabricProfile

Name Description Value
kind Ustaw wartość "Vmss" dla typu VmssFabricProfile. "Vmss" (wymagane)

ManagedServiceIdentity

Name Description Value
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). 'None'
'SystemAssigned'
"SystemAssigned, UserAssigned"
"UserAssigned" (wymagane)
userAssignedIdentities Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

NetworkProfile

Name Description Value
subnetId Identyfikator podsieci, w której mają być umieszczone wszystkie maszyny utworzone w puli. ciąg (wymagany)

Organization

Name Description Value
parallelism Ile maszyn można utworzyć maksymalnie w tej organizacji z maksymalnej liczby komputerów w puli. int
projects Opcjonalna lista projektów, w których należy utworzyć pulę. string[]
url Adres URL organizacji usługi Azure DevOps, w którym należy utworzyć pulę. ciąg (wymagany)

OrganizationProfile

Name Description Value
kind Ustaw wartość "AzureDevOps" dla typu AzureDevOpsOrganizationProfile. "AzureDevOps" (wymagane)

OsProfile

Name Description Value
secretsManagementSettings Ustawienia zarządzania wpisami tajnymi maszyn w puli. SecretsManagementSettings (wymagane)

PoolImage

Name Description Value
aliases Lista aliasów do odwołowania się do obrazu. string[]
bufor Procent buforu, który ma zostać przydzielony do tego obrazu. ciąg
resourceId Identyfikator zasobu obrazu. ciąg (wymagany)

PoolProperties

Name Description Value
agentProfile Definiuje sposób obsługi maszyny po wykonaniu zadania. AgentProfile (wymagane)
devCenterProjectResourceId Identyfikator zasobu projektu DevCenter, do którego należy pula. ciąg (wymagany)
fabricProfile Definiuje typ sieci szkieletowej, na których będzie uruchamiany agent. FabricProfile (wymagane)
maximumConcurrency Określa, ile zasobów można utworzyć w danym momencie. int

Constraints:
Minimalna wartość = 1
Wartość maksymalna = 10000 (wymagane)
organizationProfile Definiuje organizację, w której będzie używana pula. OrganizationProfile (wymagane)
provisioningState Stan bieżącej operacji. 'Accepted'
'Canceled'
'Deleting'
'Failed'
'Provisioning'
'Succeeded'
'Updating'

SecretsManagementSettings

Name Description Value
certificateStoreLocation Gdzie przechowywać certyfikaty na maszynie. ciąg
keyExportable Określa, czy klucz certyfikatów powinien być eksportowalny. bool (wymagane)
observedCertificates Lista certyfikatów do zainstalowania na wszystkich maszynach w puli. string[] (wymagane)

Stateful

Name Description Value
kind Właściwość dyskryminująca dla agentaProfile. "Stanowy" (wymagane)
maxAgentLifetime Jak długo powinny być przechowywane stanowe maszyny. Maksymalna wartość to tydzień. ciąg (wymagany)

StatelessAgentProfile

Name Description Value
kind Właściwość dyskryminująca dla agentaProfile. "Bezstanowy" (wymagane)

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

VmssFabricProfile

Name Description Value
images Obrazy maszyn wirtualnych maszyn w puli. PoolImage[] (wymagane)
kind Dyskryminująca właściwość fabricProfile. "Vmss" (wymagane)
networkProfile Profil sieciowy maszyn w puli. NetworkProfile
osProfile Profil systemu operacyjnego maszyn w puli. OsProfile
sku Jednostka SKU platformy Azure maszyn w puli. DevOpsAzureSku (wymagane)

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Module Description
puli infrastruktury DevOps Moduł zasobów AVM dla puli infrastruktury DevOps

Definicja zasobu szablonu usługi ARM

Typ zasobu pul można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevOpsInfrastructure/pools, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.DevOpsInfrastructure/pools",
  "apiVersion": "2023-10-30-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "agentProfile": {
      "resourcePredictions": {},
      "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"
  }
}

Obiekty AgentProfile

Ustaw właściwość kind , aby określić typ obiektu.

W przypadku funkcji Stateful użyj:

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

W przypadku bezstanowych użyj:

{
  "kind": "Stateless"
}

Obiekty FabricProfile

Ustaw właściwość kind , aby określić typ obiektu.

W przypadku usługi VMSS użyj:

{
  "images": [
    {
      "aliases": [ "string" ],
      "buffer": "string",
      "resourceId": "string"
    }
  ],
  "kind": "Vmss",
  "networkProfile": {
    "subnetId": "string"
  },
  "osProfile": {
    "secretsManagementSettings": {
      "certificateStoreLocation": "string",
      "keyExportable": "bool",
      "observedCertificates": [ "string" ]
    }
  },
  "sku": {
    "name": "string",
    "tier": "string"
  }
}

Obiekty OrganizationProfile

Ustaw właściwość kind , aby określić typ obiektu.

W przypadku usługi AzureDevOps użyj:

{
  "kind": "AzureDevOps",
  "organizations": [
    {
      "parallelism": "int",
      "projects": [ "string" ],
      "url": "string"
    }
  ]
}

Wartości właściwości

Microsoft.DevOpsInfrastructure/pools

Name Description Value
apiVersion Wersja interfejsu API '2023-10-30-preview'
tożsamość Tożsamości usługi zarządzanej przypisane do tego zasobu. ManagedServiceIdentity
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
name Nazwa zasobu string

Constraints:
Wzorzec = ^[a-z][a-z0-9]*$ (wymagane)
properties Właściwości specyficzne dla zasobu dla tego zasobu. PoolProperties
tags Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu 'Microsoft.DevOpsInfrastructure/pools'

AgentProfile

Name Description Value
kind Ustaw wartość "Stateful" dla typu Stateful. Ustaw wartość "Stateless" dla typu StatelessAgentProfile. 'Stateful'
"Bezstanowy" (wymagane)
resourcePredictions Definiuje bufor puli. any

AzureDevOpsOrganizationProfile

Name Description Value
kind Właściwość dyskryminująca dla elementu OrganizationProfile. "AzureDevOps" (wymagane)
organizations Lista organizacji usługi Azure DevOps, w których powinna znajdować się pula. Organizacja[] (wymagane)

DevOpsAzureSku

Name Description Value
name Nazwa jednostki SKU platformy Azure maszyn w puli. ciąg (wymagany)
warstwa Warstwa jednostki SKU platformy Azure maszyn w puli. ciąg

FabricProfile

Name Description Value
kind Ustaw wartość "Vmss" dla typu VmssFabricProfile. "Vmss" (wymagane)

ManagedServiceIdentity

Name Description Value
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). 'None'
'SystemAssigned'
"SystemAssigned, UserAssigned"
"UserAssigned" (wymagane)
userAssignedIdentities Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

NetworkProfile

Name Description Value
subnetId Identyfikator podsieci, w której mają być umieszczone wszystkie maszyny utworzone w puli. ciąg (wymagany)

Organization

Name Description Value
parallelism Ile maszyn można utworzyć maksymalnie w tej organizacji z maksymalnej liczby komputerów w puli. int
projects Opcjonalna lista projektów, w których należy utworzyć pulę. string[]
url Adres URL organizacji usługi Azure DevOps, w którym należy utworzyć pulę. ciąg (wymagany)

OrganizationProfile

Name Description Value
kind Ustaw wartość "AzureDevOps" dla typu AzureDevOpsOrganizationProfile. "AzureDevOps" (wymagane)

OsProfile

Name Description Value
secretsManagementSettings Ustawienia zarządzania wpisami tajnymi maszyn w puli. SecretsManagementSettings (wymagane)

PoolImage

Name Description Value
aliases Lista aliasów do odwołowania się do obrazu. string[]
bufor Procent buforu, który ma zostać przydzielony do tego obrazu. ciąg
resourceId Identyfikator zasobu obrazu. ciąg (wymagany)

PoolProperties

Name Description Value
agentProfile Definiuje sposób obsługi maszyny po wykonaniu zadania. AgentProfile (wymagane)
devCenterProjectResourceId Identyfikator zasobu projektu DevCenter, do którego należy pula. ciąg (wymagany)
fabricProfile Definiuje typ sieci szkieletowej, na których będzie uruchamiany agent. FabricProfile (wymagane)
maximumConcurrency Określa, ile zasobów można utworzyć w danym momencie. int

Constraints:
Minimalna wartość = 1
Wartość maksymalna = 10000 (wymagane)
organizationProfile Definiuje organizację, w której będzie używana pula. OrganizationProfile (wymagane)
provisioningState Stan bieżącej operacji. 'Accepted'
'Canceled'
'Deleting'
'Failed'
'Provisioning'
'Succeeded'
'Updating'

SecretsManagementSettings

Name Description Value
certificateStoreLocation Gdzie przechowywać certyfikaty na maszynie. ciąg
keyExportable Określa, czy klucz certyfikatów powinien być eksportowalny. bool (wymagane)
observedCertificates Lista certyfikatów do zainstalowania na wszystkich maszynach w puli. string[] (wymagane)

Stateful

Name Description Value
kind Właściwość dyskryminująca dla agentaProfile. "Stanowy" (wymagane)
maxAgentLifetime Jak długo powinny być przechowywane stanowe maszyny. Maksymalna wartość to tydzień. ciąg (wymagany)

StatelessAgentProfile

Name Description Value
kind Właściwość dyskryminująca dla agentaProfile. "Bezstanowy" (wymagane)

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

VmssFabricProfile

Name Description Value
images Obrazy maszyn wirtualnych maszyn w puli. PoolImage[] (wymagane)
kind Dyskryminująca właściwość fabricProfile. "Vmss" (wymagane)
networkProfile Profil sieciowy maszyn w puli. NetworkProfile
osProfile Profil systemu operacyjnego maszyn w puli. OsProfile
sku Jednostka SKU platformy Azure maszyn w puli. DevOpsAzureSku (wymagane)

Przykłady użycia

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu pul można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DevOpsInfrastructure/pools, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevOpsInfrastructure/pools@2023-10-30-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      agentProfile = {
        resourcePredictions = ?
        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"
    }
  }
}

Obiekty AgentProfile

Ustaw właściwość kind , aby określić typ obiektu.

W przypadku funkcji Stateful użyj:

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

W przypadku bezstanowych użyj:

{
  kind = "Stateless"
}

Obiekty FabricProfile

Ustaw właściwość kind , aby określić typ obiektu.

W przypadku usługi VMSS użyj:

{
  images = [
    {
      aliases = [
        "string"
      ]
      buffer = "string"
      resourceId = "string"
    }
  ]
  kind = "Vmss"
  networkProfile = {
    subnetId = "string"
  }
  osProfile = {
    secretsManagementSettings = {
      certificateStoreLocation = "string"
      keyExportable = bool
      observedCertificates = [
        "string"
      ]
    }
  }
  sku = {
    name = "string"
    tier = "string"
  }
}

Obiekty OrganizationProfile

Ustaw właściwość kind , aby określić typ obiektu.

W przypadku usługi AzureDevOps użyj:

{
  kind = "AzureDevOps"
  organizations = [
    {
      parallelism = int
      projects = [
        "string"
      ]
      url = "string"
    }
  ]
}

Wartości właściwości

Microsoft.DevOpsInfrastructure/pools

Name Description Value
tożsamość Tożsamości usługi zarządzanej przypisane do tego zasobu. ManagedServiceIdentity
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
name Nazwa zasobu string

Constraints:
Wzorzec = ^[a-z][a-z0-9]*$ (wymagane)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
properties Właściwości specyficzne dla zasobu dla tego zasobu. PoolProperties
tags Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.DevOpsInfrastructure/pools@2023-10-30-preview"

AgentProfile

Name Description Value
kind Ustaw wartość "Stateful" dla typu Stateful. Ustaw wartość "Stateless" dla typu StatelessAgentProfile. 'Stateful'
"Bezstanowy" (wymagane)
resourcePredictions Definiuje bufor puli. any

AzureDevOpsOrganizationProfile

Name Description Value
kind Właściwość dyskryminująca dla elementu OrganizationProfile. "AzureDevOps" (wymagane)
organizations Lista organizacji usługi Azure DevOps, w których powinna znajdować się pula. Organizacja[] (wymagane)

DevOpsAzureSku

Name Description Value
name Nazwa jednostki SKU platformy Azure maszyn w puli. ciąg (wymagany)
warstwa Warstwa jednostki SKU platformy Azure maszyn w puli. ciąg

FabricProfile

Name Description Value
kind Ustaw wartość "Vmss" dla typu VmssFabricProfile. "Vmss" (wymagane)

ManagedServiceIdentity

Name Description Value
typ Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). 'None'
'SystemAssigned'
"SystemAssigned, UserAssigned"
"UserAssigned" (wymagane)
userAssignedIdentities Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. UserAssignedIdentities

NetworkProfile

Name Description Value
subnetId Identyfikator podsieci, w której mają być umieszczone wszystkie maszyny utworzone w puli. ciąg (wymagany)

Organization

Name Description Value
parallelism Ile maszyn można utworzyć maksymalnie w tej organizacji z maksymalnej liczby komputerów w puli. int
projects Opcjonalna lista projektów, w których należy utworzyć pulę. string[]
url Adres URL organizacji usługi Azure DevOps, w którym należy utworzyć pulę. ciąg (wymagany)

OrganizationProfile

Name Description Value
kind Ustaw wartość "AzureDevOps" dla typu AzureDevOpsOrganizationProfile. "AzureDevOps" (wymagane)

OsProfile

Name Description Value
secretsManagementSettings Ustawienia zarządzania wpisami tajnymi maszyn w puli. SecretsManagementSettings (wymagane)

PoolImage

Name Description Value
aliases Lista aliasów do odwołowania się do obrazu. string[]
bufor Procent buforu, który ma zostać przydzielony do tego obrazu. ciąg
resourceId Identyfikator zasobu obrazu. ciąg (wymagany)

PoolProperties

Name Description Value
agentProfile Definiuje sposób obsługi maszyny po wykonaniu zadania. AgentProfile (wymagane)
devCenterProjectResourceId Identyfikator zasobu projektu DevCenter, do którego należy pula. ciąg (wymagany)
fabricProfile Definiuje typ sieci szkieletowej, na których będzie uruchamiany agent. FabricProfile (wymagane)
maximumConcurrency Określa, ile zasobów można utworzyć w danym momencie. int

Constraints:
Minimalna wartość = 1
Wartość maksymalna = 10000 (wymagane)
organizationProfile Definiuje organizację, w której będzie używana pula. OrganizationProfile (wymagane)
provisioningState Stan bieżącej operacji. 'Accepted'
'Canceled'
'Deleting'
'Failed'
'Provisioning'
'Succeeded'
'Updating'

SecretsManagementSettings

Name Description Value
certificateStoreLocation Gdzie przechowywać certyfikaty na maszynie. ciąg
keyExportable Określa, czy klucz certyfikatów powinien być eksportowalny. bool (wymagane)
observedCertificates Lista certyfikatów do zainstalowania na wszystkich maszynach w puli. string[] (wymagane)

Stateful

Name Description Value
kind Właściwość dyskryminująca dla agentaProfile. "Stanowy" (wymagane)
maxAgentLifetime Jak długo powinny być przechowywane stanowe maszyny. Maksymalna wartość to tydzień. ciąg (wymagany)

StatelessAgentProfile

Name Description Value
kind Właściwość dyskryminująca dla agentaProfile. "Bezstanowy" (wymagane)

TrackedResourceTags

Name Description Value

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

VmssFabricProfile

Name Description Value
images Obrazy maszyn wirtualnych maszyn w puli. PoolImage[] (wymagane)
kind Dyskryminująca właściwość fabricProfile. "Vmss" (wymagane)
networkProfile Profil sieciowy maszyn w puli. NetworkProfile
osProfile Profil systemu operacyjnego maszyn w puli. OsProfile
sku Jednostka SKU platformy Azure maszyn w puli. DevOpsAzureSku (wymagane)

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Module Description
Pule DevOps Moduł zasobów AVM dla pul DevOps