Partilhar via


Pools Microsoft.DevOpsInfrastructure 2023-10-30-preview

Definição de recursos do bíceps

O tipo de recurso de pools pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DevOpsInfrastructure/pools, adicione o seguinte Bicep ao seu modelo.

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

Objetos OrganizationProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para AzureDevOps, use:

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

Objetos AgentProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Stateful, use:

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

Para apátrida, use:

{
  kind: 'Stateless'
}

Objetos FabricProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Vmss, use:

{
  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'
  }
}

Valores de propriedade

Perfil do agente

Designação Descrição Valor
tipo Defina como 'Stateful' para o tipo Stateful. Defina como 'Stateless' para o tipo StatelessAgentProfile. 'Apátrida'
«Apátrida» (obrigatório)
resourcePredictions Define o buffer do pool. qualquer

AzureDevOpsOrganizationProfile

Designação Descrição Valor
tipo Propriedade Discriminator para OrganizationProfile. 'AzureDevOps' (obrigatório)
Organizações A lista de organizações de DevOps do Azure nas quais o pool deve estar presente. Organização[] (obrigatório)

DevOpsAzureSku

Designação Descrição Valor
Designação O nome da SKU do Azure das máquinas no pool. string (obrigatório)
nível A camada de SKU do Azure das máquinas no pool. string

FabricProfile

Designação Descrição Valor
tipo Defina como 'Vmss' para o tipo VmssFabricProfile. 'Vmss' (obrigatório)

ManagedServiceIdentity

Designação Descrição Valor
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

Designação Descrição Valor
identidade As identidades de serviço gerenciado atribuídas a este recurso. ManagedServiceIdentity
Localização A geolocalização onde o recurso vive string (obrigatório)
Designação O nome do recurso string

Restrições:
Padrão = ^[a-z][a-z0-9]*$ (obrigatório)
propriedades As propriedades específicas do recurso para este recurso. PoolProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

Perfil de rede

Designação Descrição Valor
subnetId O id da sub-rede no qual colocar todas as máquinas criadas no pool. string (obrigatório)

Organização

Designação Descrição Valor
paralelismo Quantas máquinas podem ser criadas no máximo nesta organização fora da simultaneidade máxima do pool. Int
Projetos Lista opcional de projetos nos quais o pool deve ser criado. string[]
URL A URL da organização do Azure DevOps na qual o pool deve ser criado. string (obrigatório)

Perfil da Organização

Designação Descrição Valor
tipo Defina como 'AzureDevOps' para o tipo AzureDevOpsOrganizationProfile. 'AzureDevOps' (obrigatório)

OsProfile

Designação Descrição Valor
secretsManagementSettings As configurações secretas de gerenciamento das máquinas no pool. SecretsManagementSettings (obrigatório)

PoolImage

Designação Descrição Valor
pseudónimos Lista de aliases para referenciar a imagem por. string[]
buffer A porcentagem do buffer a ser alocado para esta imagem. string
resourceId O id de recurso da imagem. string (obrigatório)

PoolProperties

Designação Descrição Valor
agentProfile Define como a máquina será manipulada depois de executar um trabalho. AgentProfile (obrigatório)
devCenterProjectResourceId A id de recurso do Projeto DevCenter ao qual o pool pertence. string (obrigatório)
fabricProfile Define o tipo de malha em que o agente será executado. FabricProfile (obrigatório)
maximumConcurrency Define quantos recursos podem ser criados a qualquer momento. Int

Restrições:
Valor mínimo = 1
Valor máximo = 10000 (obrigatório)
organizaçãoPerfil Define a organização na qual o pool será usado. OrganizationProfile (obrigatório)
provisionamentoEstado O status da operação atual. 'Aceito'
'Cancelado'
'Eliminação'
'Falhou'
'Provisionamento'
'Conseguiu'
'Atualização'

SecretsManagementSettings

Designação Descrição Valor
certificateStoreLocalização Onde armazenar certificados na máquina. string
chaveExportável Define se a chave dos certificados deve ser exportável. bool (obrigatório)
observedCertificados A lista de certificados a serem instalados em todas as máquinas do pool. string[] (obrigatório)

Com estado

Designação Descrição Valor
tipo Propriedade Discriminator para AgentProfile. «Com estado» (obrigatório)
maxAgentLifetime Por quanto tempo as máquinas stateful devem ser mantidas por perto. O máximo é de uma semana. string (obrigatório)

StatelessAgentProfile

Designação Descrição Valor
tipo Propriedade Discriminator para AgentProfile. «Apátrida» (obrigatório)

TrackedResourceTags

Designação Descrição Valor

UserAssignedIdentities

Designação Descrição Valor

UserAssignedIdentity

Designação Descrição Valor

VmssFabricProfile

Designação Descrição Valor
imagens As imagens VM das máquinas no pool. PoolImage[] (obrigatório)
tipo Propriedade Discriminator para FabricProfile. 'Vmss' (obrigatório)
networkProfile O perfil de rede das máquinas no pool. NetworkProfile
osPerfil O perfil do SO das máquinas no pool. OsProfile
SKU A SKU do Azure das máquinas no pool. DevOpsAzureSku (obrigatório)

Definição de recurso de modelo ARM

O tipo de recurso de pools pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DevOpsInfrastructure/pools, adicione o seguinte JSON ao seu modelo.

{
  "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"
  }
}

Objetos OrganizationProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para AzureDevOps, use:

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

Objetos AgentProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Stateful, use:

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

Para apátrida, use:

{
  "kind": "Stateless"
}

Objetos FabricProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Vmss, use:

{
  "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"
  }
}

Valores de propriedade

Perfil do agente

Designação Descrição Valor
tipo Defina como 'Stateful' para o tipo Stateful. Defina como 'Stateless' para o tipo StatelessAgentProfile. 'Apátrida'
«Apátrida» (obrigatório)
resourcePredictions Define o buffer do pool. qualquer

AzureDevOpsOrganizationProfile

Designação Descrição Valor
tipo Propriedade Discriminator para OrganizationProfile. 'AzureDevOps' (obrigatório)
Organizações A lista de organizações de DevOps do Azure nas quais o pool deve estar presente. Organização[] (obrigatório)

DevOpsAzureSku

Designação Descrição Valor
Designação O nome da SKU do Azure das máquinas no pool. string (obrigatório)
nível A camada de SKU do Azure das máquinas no pool. string

FabricProfile

Designação Descrição Valor
tipo Defina como 'Vmss' para o tipo VmssFabricProfile. 'Vmss' (obrigatório)

ManagedServiceIdentity

Designação Descrição Valor
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

Designação Descrição Valor
apiVersion A versão api '2023-10-30-pré-visualização'
identidade As identidades de serviço gerenciado atribuídas a este recurso. ManagedServiceIdentity
Localização A geolocalização onde o recurso vive string (obrigatório)
Designação O nome do recurso string

Restrições:
Padrão = ^[a-z][a-z0-9]*$ (obrigatório)
propriedades As propriedades específicas do recurso para este recurso. PoolProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.DevOpsInfrastructure/pools'

Perfil de rede

Designação Descrição Valor
subnetId O id da sub-rede no qual colocar todas as máquinas criadas no pool. string (obrigatório)

Organização

Designação Descrição Valor
paralelismo Quantas máquinas podem ser criadas no máximo nesta organização fora da simultaneidade máxima do pool. Int
Projetos Lista opcional de projetos nos quais o pool deve ser criado. string[]
URL A URL da organização do Azure DevOps na qual o pool deve ser criado. string (obrigatório)

Perfil da Organização

Designação Descrição Valor
tipo Defina como 'AzureDevOps' para o tipo AzureDevOpsOrganizationProfile. 'AzureDevOps' (obrigatório)

OsProfile

Designação Descrição Valor
secretsManagementSettings As configurações secretas de gerenciamento das máquinas no pool. SecretsManagementSettings (obrigatório)

PoolImage

Designação Descrição Valor
pseudónimos Lista de aliases para referenciar a imagem por. string[]
buffer A porcentagem do buffer a ser alocado para esta imagem. string
resourceId O id de recurso da imagem. string (obrigatório)

PoolProperties

Designação Descrição Valor
agentProfile Define como a máquina será manipulada depois de executar um trabalho. AgentProfile (obrigatório)
devCenterProjectResourceId A id de recurso do Projeto DevCenter ao qual o pool pertence. string (obrigatório)
fabricProfile Define o tipo de malha em que o agente será executado. FabricProfile (obrigatório)
maximumConcurrency Define quantos recursos podem ser criados a qualquer momento. Int

Restrições:
Valor mínimo = 1
Valor máximo = 10000 (obrigatório)
organizaçãoPerfil Define a organização na qual o pool será usado. OrganizationProfile (obrigatório)
provisionamentoEstado O status da operação atual. 'Aceito'
'Cancelado'
'Eliminação'
'Falhou'
'Provisionamento'
'Conseguiu'
'Atualização'

SecretsManagementSettings

Designação Descrição Valor
certificateStoreLocalização Onde armazenar certificados na máquina. string
chaveExportável Define se a chave dos certificados deve ser exportável. bool (obrigatório)
observedCertificados A lista de certificados a serem instalados em todas as máquinas do pool. string[] (obrigatório)

Com estado

Designação Descrição Valor
tipo Propriedade Discriminator para AgentProfile. «Com estado» (obrigatório)
maxAgentLifetime Por quanto tempo as máquinas stateful devem ser mantidas por perto. O máximo é de uma semana. string (obrigatório)

StatelessAgentProfile

Designação Descrição Valor
tipo Propriedade Discriminator para AgentProfile. «Apátrida» (obrigatório)

TrackedResourceTags

Designação Descrição Valor

UserAssignedIdentities

Designação Descrição Valor

UserAssignedIdentity

Designação Descrição Valor

VmssFabricProfile

Designação Descrição Valor
imagens As imagens VM das máquinas no pool. PoolImage[] (obrigatório)
tipo Propriedade Discriminator para FabricProfile. 'Vmss' (obrigatório)
networkProfile O perfil de rede das máquinas no pool. NetworkProfile
osPerfil O perfil do SO das máquinas no pool. OsProfile
SKU A SKU do Azure das máquinas no pool. DevOpsAzureSku (obrigatório)

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso de pools pode ser implantado com operações que visam:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DevOpsInfrastructure/pools, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevOpsInfrastructure/pools@2023-10-30-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    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"
    }
  })
}

Objetos OrganizationProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para AzureDevOps, use:

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

Objetos AgentProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Stateful, use:

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

Para apátrida, use:

{
  kind = "Stateless"
}

Objetos FabricProfile

Defina a propriedade kind para especificar o tipo de objeto.

Para Vmss, use:

{
  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"
  }
}

Valores de propriedade

Perfil do agente

Designação Descrição Valor
tipo Defina como 'Stateful' para o tipo Stateful. Defina como 'Stateless' para o tipo StatelessAgentProfile. 'Apátrida'
«Apátrida» (obrigatório)
resourcePredictions Define o buffer do pool. qualquer

AzureDevOpsOrganizationProfile

Designação Descrição Valor
tipo Propriedade Discriminator para OrganizationProfile. 'AzureDevOps' (obrigatório)
Organizações A lista de organizações de DevOps do Azure nas quais o pool deve estar presente. Organização[] (obrigatório)

DevOpsAzureSku

Designação Descrição Valor
Designação O nome da SKU do Azure das máquinas no pool. string (obrigatório)
nível A camada de SKU do Azure das máquinas no pool. string

FabricProfile

Designação Descrição Valor
tipo Defina como 'Vmss' para o tipo VmssFabricProfile. 'Vmss' (obrigatório)

ManagedServiceIdentity

Designação Descrição Valor
tipo Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). 'Nenhuma'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obrigatório)
userAssignedIdentities O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações. UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

Designação Descrição Valor
identidade As identidades de serviço gerenciado atribuídas a este recurso. ManagedServiceIdentity
Localização A geolocalização onde o recurso vive string (obrigatório)
Designação O nome do recurso string

Restrições:
Padrão = ^[a-z][a-z0-9]*$ (obrigatório)
propriedades As propriedades específicas do recurso para este recurso. PoolProperties
Etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.DevOpsInfrastructure/pools@2023-10-30-preview"

Perfil de rede

Designação Descrição Valor
subnetId O id da sub-rede no qual colocar todas as máquinas criadas no pool. string (obrigatório)

Organização

Designação Descrição Valor
paralelismo Quantas máquinas podem ser criadas no máximo nesta organização fora da simultaneidade máxima do pool. Int
Projetos Lista opcional de projetos nos quais o pool deve ser criado. string[]
URL A URL da organização do Azure DevOps na qual o pool deve ser criado. string (obrigatório)

Perfil da Organização

Designação Descrição Valor
tipo Defina como 'AzureDevOps' para o tipo AzureDevOpsOrganizationProfile. 'AzureDevOps' (obrigatório)

OsProfile

Designação Descrição Valor
secretsManagementSettings As configurações secretas de gerenciamento das máquinas no pool. SecretsManagementSettings (obrigatório)

PoolImage

Designação Descrição Valor
pseudónimos Lista de aliases para referenciar a imagem por. string[]
buffer A porcentagem do buffer a ser alocado para esta imagem. string
resourceId O id de recurso da imagem. string (obrigatório)

PoolProperties

Designação Descrição Valor
agentProfile Define como a máquina será manipulada depois de executar um trabalho. AgentProfile (obrigatório)
devCenterProjectResourceId A id de recurso do Projeto DevCenter ao qual o pool pertence. string (obrigatório)
fabricProfile Define o tipo de malha em que o agente será executado. FabricProfile (obrigatório)
maximumConcurrency Define quantos recursos podem ser criados a qualquer momento. Int

Restrições:
Valor mínimo = 1
Valor máximo = 10000 (obrigatório)
organizaçãoPerfil Define a organização na qual o pool será usado. OrganizationProfile (obrigatório)
provisionamentoEstado O status da operação atual. 'Aceito'
'Cancelado'
'Eliminação'
'Falhou'
'Provisionamento'
'Conseguiu'
'Atualização'

SecretsManagementSettings

Designação Descrição Valor
certificateStoreLocalização Onde armazenar certificados na máquina. string
chaveExportável Define se a chave dos certificados deve ser exportável. bool (obrigatório)
observedCertificados A lista de certificados a serem instalados em todas as máquinas do pool. string[] (obrigatório)

Com estado

Designação Descrição Valor
tipo Propriedade Discriminator para AgentProfile. «Com estado» (obrigatório)
maxAgentLifetime Por quanto tempo as máquinas stateful devem ser mantidas por perto. O máximo é de uma semana. string (obrigatório)

StatelessAgentProfile

Designação Descrição Valor
tipo Propriedade Discriminator para AgentProfile. «Apátrida» (obrigatório)

TrackedResourceTags

Designação Descrição Valor

UserAssignedIdentities

Designação Descrição Valor

UserAssignedIdentity

Designação Descrição Valor

VmssFabricProfile

Designação Descrição Valor
imagens As imagens VM das máquinas no pool. PoolImage[] (obrigatório)
tipo Propriedade Discriminator para FabricProfile. 'Vmss' (obrigatório)
networkProfile O perfil de rede das máquinas no pool. NetworkProfile
osPerfil O perfil do SO das máquinas no pool. OsProfile
SKU A SKU do Azure das máquinas no pool. DevOpsAzureSku (obrigatório)