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.
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(...)
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
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 |
cadeia de caracteres
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. Ver Tags em modelos |
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) |
escalão |
A camada de SKU do Azure das máquinas no pool. |
cadeia (de caracteres) |
FabricProfile
Designação |
Descrição |
Valor |
tipo |
Defina como 'Vmss' para o tipo VmssFabricProfile. |
'Vmss' (obrigatório) |
Identidade de Serviço Gerido (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) |
identidades atribuídas pelo utilizador |
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 |
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
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[] |
colocar em memória intermédia |
A porcentagem do buffer a ser alocado para esta imagem. |
cadeia (de caracteres) |
identificadorDeRecurso |
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. |
cadeia (de caracteres) |
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) |
Designação |
Descrição |
Valor |
UserAssignedIdentities
Designação |
Descrição |
Valor |
IdentidadeAtribuídaPeloUtilizador
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. |
Perfil de rede |
osPerfil |
O perfil do SO das máquinas no pool. |
OsProfile |
SKU |
A SKU do Azure das máquinas no pool. |
DevOpsAzureSku (obrigatório) |
Exemplos de uso
Módulos verificados do Azure
Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.
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.
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
Microsoft.DevOpsInfrastructure/pools
Designação |
Descrição |
Valor |
Versão da API |
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 |
cadeia de caracteres
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. Ver Tags em modelos |
tipo |
O tipo de recurso |
'Microsoft.DevOpsInfrastructure/pools' |
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) |
escalão |
A camada de SKU do Azure das máquinas no pool. |
cadeia (de caracteres) |
FabricProfile
Designação |
Descrição |
Valor |
tipo |
Defina como 'Vmss' para o tipo VmssFabricProfile. |
'Vmss' (obrigatório) |
Identidade de Serviço Gerido (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) |
identidades atribuídas pelo utilizador |
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 |
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
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[] |
colocar em memória intermédia |
A porcentagem do buffer a ser alocado para esta imagem. |
cadeia (de caracteres) |
identificadorDeRecurso |
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. |
cadeia (de caracteres) |
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) |
Designação |
Descrição |
Valor |
UserAssignedIdentities
Designação |
Descrição |
Valor |
IdentidadeAtribuídaPeloUtilizador
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. |
Perfil de rede |
osPerfil |
O perfil do SO das máquinas no pool. |
OsProfile |
SKU |
A SKU do Azure das máquinas no pool. |
DevOpsAzureSku (obrigatório) |
Exemplos de uso
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.
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"
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"
}
}
}
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
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 |
cadeia de caracteres
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 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) |
escalão |
A camada de SKU do Azure das máquinas no pool. |
cadeia (de caracteres) |
FabricProfile
Designação |
Descrição |
Valor |
tipo |
Defina como 'Vmss' para o tipo VmssFabricProfile. |
'Vmss' (obrigatório) |
Identidade de Serviço Gerido (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) |
identidades atribuídas pelo utilizador |
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 |
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
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[] |
colocar em memória intermédia |
A porcentagem do buffer a ser alocado para esta imagem. |
cadeia (de caracteres) |
identificadorDeRecurso |
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. |
cadeia (de caracteres) |
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) |
Designação |
Descrição |
Valor |
UserAssignedIdentities
Designação |
Descrição |
Valor |
IdentidadeAtribuídaPeloUtilizador
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. |
Perfil de rede |
osPerfil |
O perfil do SO das máquinas no pool. |
OsProfile |
SKU |
A SKU do Azure das máquinas no pool. |
DevOpsAzureSku (obrigatório) |
Exemplos de uso
Módulos verificados do Azure
Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.
Módulo |
Descrição |
DevOps Pools |
Módulo de recursos AVM para pools de DevOps |