Compartir a través de


Grupos de Microsoft.DevOpsInfrastructure 2023-10-30-preview

Definición de recursos de Bicep

El tipo de recurso pools se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevOpsInfrastructure/pools, agregue el siguiente bicep a la plantilla.

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

Establezca la propiedad de tipo para especificar el tipo de objeto.

Para azureDevOps, use:

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

Objetos AgentProfile

Establezca la propiedad de tipo para especificar el tipo de objeto.

Para con estado , use:

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

Para sin estado , use:

{
  kind: 'Stateless'
}

FabricProfile (objetos)

Establezca la propiedad de tipo para especificar el 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 propiedad

AgentProfile

Nombre Descripción Valor
amable Establezca en "Stateful" para el tipo Stateful. Establezca en "Stateless" para el tipo StatelessAgentProfile. "Con estado"
'Sin estado' (obligatorio)
resourcePredictions Define el búfer del grupo. cualquier

AzureDevOpsOrganizationProfile

Nombre Descripción Valor
amable Propiedad Discriminador para OrganizationProfile. "AzureDevOps" (obligatorio)
Organizaciones La lista de organizaciones de Azure DevOps en las que debe estar presente el grupo. Organización[] (obligatorio)

DevOpsAzureSku

Nombre Descripción Valor
nombre Nombre de la SKU de Azure de las máquinas del grupo. string (obligatorio)
nivel Nivel de SKU de Azure de las máquinas del grupo. cuerda

FabricProfile

Nombre Descripción Valor
amable Establezca en "Vmss" para el tipo VmssFabricProfile. "Vmss" (obligatorio)

ManagedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatorio)
userAssignedIdentities Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

Nombre Descripción Valor
identidad Identidades de servicio administradas asignadas a este recurso. managedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^[a-z][a-z0-9]*$ (obligatorio)
Propiedades Propiedades específicas del recurso para este recurso. poolProperties de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

NetworkProfile

Nombre Descripción Valor
subnetId Identificador de subred en el que se van a colocar todas las máquinas creadas en el grupo. string (obligatorio)

Organización

Nombre Descripción Valor
paralelismo Número máximo de máquinas que se pueden crear en esta organización fuera de la máxima simultaneidad del grupo. Int
Proyectos Lista opcional de proyectos en los que se debe crear el grupo. string[]
URL Dirección URL de la organización de Azure DevOps en la que se debe crear el grupo. string (obligatorio)

OrganizationProfile

Nombre Descripción Valor
amable Establezca en "AzureDevOps" para el tipo AzureDevOpsOrganizationProfile. "AzureDevOps" (obligatorio)

OsProfile

Nombre Descripción Valor
secretsManagementSettings Configuración de administración de secretos de las máquinas del grupo. SecretsManagementSettings (obligatorio)

PoolImage

Nombre Descripción Valor
Alias Lista de alias por los que hacer referencia a la imagen. string[]
búfer Porcentaje del búfer que se va a asignar a esta imagen. cuerda
resourceId Identificador de recurso de la imagen. string (obligatorio)

PoolProperties

Nombre Descripción Valor
agentProfile Define cómo se controlará la máquina una vez que ejecutó un trabajo. AgentProfile de (obligatorio)
devCenterProjectResourceId Identificador de recurso del proyecto de DevCenter al que pertenece el grupo. string (obligatorio)
fabricProfile Define el tipo de tejido en el que se ejecutará el agente. FabricProfile (obligatorio)
maximumConcurrency Define el número de recursos que se pueden crear en un momento dado. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 10000 (obligatorio)
organizationProfile Define la organización en la que se usará el grupo. organizationProfile (obligatorio)
provisioningState Estado de la operación actual. 'Aceptado'
'Cancelado'
"Eliminar"
'Error'
"Aprovisionamiento"
"Correcto"
"Actualización"

SecretsManagementSettings

Nombre Descripción Valor
certificateStoreLocation Dónde almacenar certificados en la máquina. cuerda
keyExportable Define si la clave de los certificados debe ser exportable. bool (obligatorio)
observedCertificates Lista de certificados que se van a instalar en todas las máquinas del grupo. string[] (obligatorio)

Stateful

Nombre Descripción Valor
amable Propiedad Discriminador para AgentProfile. "Con estado" (obligatorio)
maxAgentLifetime Cuánto tiempo deben mantenerse las máquinas con estado. El máximo es una semana. string (obligatorio)

StatelessAgentProfile

Nombre Descripción Valor
amable Propiedad Discriminador para AgentProfile. 'Sin estado' (obligatorio)

TrackedResourceTags

Nombre Descripción Valor

UserAssignedIdentities

Nombre Descripción Valor

UserAssignedIdentity

Nombre Descripción Valor

VmssFabricProfile

Nombre Descripción Valor
Imágenes Imágenes de máquina virtual de las máquinas del grupo. PoolImage[] (obligatorio)
amable Propiedad Discriminador para FabricProfile. "Vmss" (obligatorio)
networkProfile Perfil de red de las máquinas del grupo. networkProfile de
osProfile Perfil del sistema operativo de las máquinas del grupo. OsProfile
Sku SKU de Azure de las máquinas del grupo. DevOpsAzureSku (obligatorio)

Definición de recursos de plantilla de ARM

El tipo de recurso pools se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevOpsInfrastructure/pools, agregue el siguiente JSON a la plantilla.

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

Establezca la propiedad de tipo para especificar el tipo de objeto.

Para azureDevOps, use:

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

Objetos AgentProfile

Establezca la propiedad de tipo para especificar el tipo de objeto.

Para con estado , use:

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

Para sin estado , use:

{
  "kind": "Stateless"
}

FabricProfile (objetos)

Establezca la propiedad de tipo para especificar el 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 propiedad

AgentProfile

Nombre Descripción Valor
amable Establezca en "Stateful" para el tipo Stateful. Establezca en "Stateless" para el tipo StatelessAgentProfile. "Con estado"
'Sin estado' (obligatorio)
resourcePredictions Define el búfer del grupo. cualquier

AzureDevOpsOrganizationProfile

Nombre Descripción Valor
amable Propiedad Discriminador para OrganizationProfile. "AzureDevOps" (obligatorio)
Organizaciones La lista de organizaciones de Azure DevOps en las que debe estar presente el grupo. Organización[] (obligatorio)

DevOpsAzureSku

Nombre Descripción Valor
nombre Nombre de la SKU de Azure de las máquinas del grupo. string (obligatorio)
nivel Nivel de SKU de Azure de las máquinas del grupo. cuerda

FabricProfile

Nombre Descripción Valor
amable Establezca en "Vmss" para el tipo VmssFabricProfile. "Vmss" (obligatorio)

ManagedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatorio)
userAssignedIdentities Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

Nombre Descripción Valor
apiVersion La versión de api '2023-10-30-preview'
identidad Identidades de servicio administradas asignadas a este recurso. managedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^[a-z][a-z0-9]*$ (obligatorio)
Propiedades Propiedades específicas del recurso para este recurso. poolProperties de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso "Microsoft.DevOpsInfrastructure/pools"

NetworkProfile

Nombre Descripción Valor
subnetId Identificador de subred en el que se van a colocar todas las máquinas creadas en el grupo. string (obligatorio)

Organización

Nombre Descripción Valor
paralelismo Número máximo de máquinas que se pueden crear en esta organización fuera de la máxima simultaneidad del grupo. Int
Proyectos Lista opcional de proyectos en los que se debe crear el grupo. string[]
URL Dirección URL de la organización de Azure DevOps en la que se debe crear el grupo. string (obligatorio)

OrganizationProfile

Nombre Descripción Valor
amable Establezca en "AzureDevOps" para el tipo AzureDevOpsOrganizationProfile. "AzureDevOps" (obligatorio)

OsProfile

Nombre Descripción Valor
secretsManagementSettings Configuración de administración de secretos de las máquinas del grupo. SecretsManagementSettings (obligatorio)

PoolImage

Nombre Descripción Valor
Alias Lista de alias por los que hacer referencia a la imagen. string[]
búfer Porcentaje del búfer que se va a asignar a esta imagen. cuerda
resourceId Identificador de recurso de la imagen. string (obligatorio)

PoolProperties

Nombre Descripción Valor
agentProfile Define cómo se controlará la máquina una vez que ejecutó un trabajo. AgentProfile de (obligatorio)
devCenterProjectResourceId Identificador de recurso del proyecto de DevCenter al que pertenece el grupo. string (obligatorio)
fabricProfile Define el tipo de tejido en el que se ejecutará el agente. FabricProfile (obligatorio)
maximumConcurrency Define el número de recursos que se pueden crear en un momento dado. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 10000 (obligatorio)
organizationProfile Define la organización en la que se usará el grupo. organizationProfile (obligatorio)
provisioningState Estado de la operación actual. 'Aceptado'
'Cancelado'
"Eliminar"
'Error'
"Aprovisionamiento"
"Correcto"
"Actualización"

SecretsManagementSettings

Nombre Descripción Valor
certificateStoreLocation Dónde almacenar certificados en la máquina. cuerda
keyExportable Define si la clave de los certificados debe ser exportable. bool (obligatorio)
observedCertificates Lista de certificados que se van a instalar en todas las máquinas del grupo. string[] (obligatorio)

Stateful

Nombre Descripción Valor
amable Propiedad Discriminador para AgentProfile. "Con estado" (obligatorio)
maxAgentLifetime Cuánto tiempo deben mantenerse las máquinas con estado. El máximo es una semana. string (obligatorio)

StatelessAgentProfile

Nombre Descripción Valor
amable Propiedad Discriminador para AgentProfile. 'Sin estado' (obligatorio)

TrackedResourceTags

Nombre Descripción Valor

UserAssignedIdentities

Nombre Descripción Valor

UserAssignedIdentity

Nombre Descripción Valor

VmssFabricProfile

Nombre Descripción Valor
Imágenes Imágenes de máquina virtual de las máquinas del grupo. PoolImage[] (obligatorio)
amable Propiedad Discriminador para FabricProfile. "Vmss" (obligatorio)
networkProfile Perfil de red de las máquinas del grupo. networkProfile de
osProfile Perfil del sistema operativo de las máquinas del grupo. OsProfile
Sku SKU de Azure de las máquinas del grupo. DevOpsAzureSku (obligatorio)

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso pools se puede implementar con operaciones destinadas a:

  • grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.DevOpsInfrastructure/pools, agregue el siguiente terraform a la plantilla.

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

Establezca la propiedad de tipo para especificar el tipo de objeto.

Para azureDevOps, use:

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

Objetos AgentProfile

Establezca la propiedad de tipo para especificar el tipo de objeto.

Para con estado , use:

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

Para sin estado , use:

{
  kind = "Stateless"
}

FabricProfile (objetos)

Establezca la propiedad de tipo para especificar el 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 propiedad

AgentProfile

Nombre Descripción Valor
amable Establezca en "Stateful" para el tipo Stateful. Establezca en "Stateless" para el tipo StatelessAgentProfile. "Con estado"
'Sin estado' (obligatorio)
resourcePredictions Define el búfer del grupo. cualquier

AzureDevOpsOrganizationProfile

Nombre Descripción Valor
amable Propiedad Discriminador para OrganizationProfile. "AzureDevOps" (obligatorio)
Organizaciones La lista de organizaciones de Azure DevOps en las que debe estar presente el grupo. Organización[] (obligatorio)

DevOpsAzureSku

Nombre Descripción Valor
nombre Nombre de la SKU de Azure de las máquinas del grupo. string (obligatorio)
nivel Nivel de SKU de Azure de las máquinas del grupo. cuerda

FabricProfile

Nombre Descripción Valor
amable Establezca en "Vmss" para el tipo VmssFabricProfile. "Vmss" (obligatorio)

ManagedServiceIdentity

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned). 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned' (obligatorio)
userAssignedIdentities Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes. UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

Nombre Descripción Valor
identidad Identidades de servicio administradas asignadas a este recurso. managedServiceIdentity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^[a-z][a-z0-9]*$ (obligatorio)
Propiedades Propiedades específicas del recurso para este recurso. poolProperties de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.DevOpsInfrastructure/pools@2023-10-30-preview"

NetworkProfile

Nombre Descripción Valor
subnetId Identificador de subred en el que se van a colocar todas las máquinas creadas en el grupo. string (obligatorio)

Organización

Nombre Descripción Valor
paralelismo Número máximo de máquinas que se pueden crear en esta organización fuera de la máxima simultaneidad del grupo. Int
Proyectos Lista opcional de proyectos en los que se debe crear el grupo. string[]
URL Dirección URL de la organización de Azure DevOps en la que se debe crear el grupo. string (obligatorio)

OrganizationProfile

Nombre Descripción Valor
amable Establezca en "AzureDevOps" para el tipo AzureDevOpsOrganizationProfile. "AzureDevOps" (obligatorio)

OsProfile

Nombre Descripción Valor
secretsManagementSettings Configuración de administración de secretos de las máquinas del grupo. SecretsManagementSettings (obligatorio)

PoolImage

Nombre Descripción Valor
Alias Lista de alias por los que hacer referencia a la imagen. string[]
búfer Porcentaje del búfer que se va a asignar a esta imagen. cuerda
resourceId Identificador de recurso de la imagen. string (obligatorio)

PoolProperties

Nombre Descripción Valor
agentProfile Define cómo se controlará la máquina una vez que ejecutó un trabajo. AgentProfile de (obligatorio)
devCenterProjectResourceId Identificador de recurso del proyecto de DevCenter al que pertenece el grupo. string (obligatorio)
fabricProfile Define el tipo de tejido en el que se ejecutará el agente. FabricProfile (obligatorio)
maximumConcurrency Define el número de recursos que se pueden crear en un momento dado. Int

Restricciones:
Valor mínimo = 1
Valor máximo = 10000 (obligatorio)
organizationProfile Define la organización en la que se usará el grupo. organizationProfile (obligatorio)
provisioningState Estado de la operación actual. 'Aceptado'
'Cancelado'
"Eliminar"
'Error'
"Aprovisionamiento"
"Correcto"
"Actualización"

SecretsManagementSettings

Nombre Descripción Valor
certificateStoreLocation Dónde almacenar certificados en la máquina. cuerda
keyExportable Define si la clave de los certificados debe ser exportable. bool (obligatorio)
observedCertificates Lista de certificados que se van a instalar en todas las máquinas del grupo. string[] (obligatorio)

Stateful

Nombre Descripción Valor
amable Propiedad Discriminador para AgentProfile. "Con estado" (obligatorio)
maxAgentLifetime Cuánto tiempo deben mantenerse las máquinas con estado. El máximo es una semana. string (obligatorio)

StatelessAgentProfile

Nombre Descripción Valor
amable Propiedad Discriminador para AgentProfile. 'Sin estado' (obligatorio)

TrackedResourceTags

Nombre Descripción Valor

UserAssignedIdentities

Nombre Descripción Valor

UserAssignedIdentity

Nombre Descripción Valor

VmssFabricProfile

Nombre Descripción Valor
Imágenes Imágenes de máquina virtual de las máquinas del grupo. PoolImage[] (obligatorio)
amable Propiedad Discriminador para FabricProfile. "Vmss" (obligatorio)
networkProfile Perfil de red de las máquinas del grupo. networkProfile de
osProfile Perfil del sistema operativo de las máquinas del grupo. OsProfile
Sku SKU de Azure de las máquinas del grupo. DevOpsAzureSku (obligatorio)