Compartir vía

Inicio rápido: Creación de un grupo de DevOps administrado mediante una plantilla de Resource Manager

  • Artículo

En este artículo se muestra cómo crear un grupo de DevOps administrado mediante una plantilla de ARM y ejecutar una canalización en el nuevo grupo.

Requisitos previos

Antes de completar los pasos de este artículo, debe haber configurado la suscripción de Azure y la organización de Azure DevOps para su uso con grupos de DevOps administrados, como se describe en el artículo Requisitos previos . Estos pasos solo deben completarse una vez por suscripción de Azure y la organización de Azure DevOps.

Inicio de sesión en la CLI de Azure

Abra un símbolo del sistema (en Windows, use el símbolo del sistema de Windows o PowerShell) y ejecute los comandos siguientes.

  1. Inicie sesión en la CLI de Azure.

    az login

  2. Si tiene más de una suscripción de Azure, establezca la suscripción predeterminada de Azure.

    az account set --subscription "My subscription name"

    Para obtener una lista de las suscripciones, puede ejecutar el siguiente comando.

    az account list -o table

    Si tiene varios inquilinos o quiere ver más información sobre cómo trabajar con una suscripción de Azure mediante la CLI de Azure, consulte Administración de suscripciones de Azure con la CLI de Azure.

Creación de un grupo de recursos, Centro de desarrollo y Centro de desarrollo Project

  1. Siga los pasos de Creación de un centro de desarrollo en Creación y configuración de un centro de desarrollo para entornos de implementación de Azure mediante la CLI de Azure.

    Solo tiene que seguir los pasos descritos en la sección Crear un centro de desarrollo. Anote el nombre del grupo de recursos y Centro de desarrollo nombre.

  2. Siga los pasos Crear un proyecto en Creación y configuración de un proyecto mediante la CLI de Azure.

    Anote el id elemento del proyecto creado (no el devCenterId).

Revisar y guardar la plantilla

  1. Cree un nombre de archivo local mdp-azure-deploy.json con el siguiente contenido. Este archivo es una plantilla de ARM parametrizada que crea un microsoft.devopsinfrastructure/pools recurso.

    {
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "poolName": {
            "type": "string"
        },
        "adoOrg": {
            "type": "string"
        },
        "devCenterResourceId": {
            "type": "string"
        },
        "imageName": {
            "type": "string"
        },
        "poolSize": {
            "type": "int"
        },
        "location": {
            "type": "string",
            "defaultValue": "eastus"
        }
    },
    "variables": {},
    "resources": [
        {
            "name": "[parameters('poolName')]",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2024-10-19",
            "location": "[parameters('location')]",
            "tags": {},
            "properties": {
                "organizationProfile": {
                    "organizations": [
                        {
                            "url": "[parameters('adoOrg')]",
                            "parallelism": 1
                        }
                    ],
                    "permissionProfile": {
                        "kind": "CreatorOnly"
                    },
                    "kind": "AzureDevOps"
                },
                "devCenterProjectResourceId": "[parameters('devCenterResourceId')]",
                "maximumConcurrency": "[parameters('poolSize')]",
                "agentProfile": {
                    "kind": "Stateless"
                },
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    },
                    "images": [
                        {
                            "wellKnownImageName": "[parameters('imageName')]",
                            "buffer": "*"
                        }
                    ],
                    "kind": "Vmss"
                }
            }
        }
    ]
}

  2. Cree otro archivo local denominado mdp-azure-deploy-parameters.json y guárdelo en la misma carpeta que el primer archivo. Actualice las siguientes propiedades para que coincidan con los detalles del entorno.

    Parámetro Valor
    poolName Actualice value con el nombre deseado del grupo. El nombre debe constar de caracteres alfanuméricos, ., -o _y tener entre 3 y 44 caracteres de longitud. El nombre debe ser único globalmente en Azure.
    adoOrg Actualice value y reemplace por your-organization el nombre de la organización de Azure DevOps.
    devCenterResourceId Actualice value con el id objeto del anterior paso Crear un grupo de recursos, Centro de desarrollo y Centro de desarrollo Proyecto.
    imageName Este ejemplo está configurado para usar una imagen de Azure Pipelines y usa la imagen de Windows Server 2022. Si quiere cambiarlo, elija entre los alias predefinidos de la imagen de Azure Pipelines. Los grupos de DevOps administrados también admiten imágenes de Azure Compute Gallery y imágenes de Marketplace seleccionadas. Para obtener información sobre cómo configurar un recurso de grupos de DevOps administrados para estos tipos de imágenes, consulte Configuración de imágenes de grupos de DevOps administrados.
    poolSize Actualice value con el número máximo de agentes que desea poder ejecutar trabajos simultáneos. En este ejemplo, poolSize es 1.
    location Región de Azure para el grupo. En este ejemplo, la región es eastus. 
    {
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "poolName": {
            "value": "my-first-managed-pool"
        },
        "adoOrg": {
            "value": "https://dev.azure.com/your-organization"
        },
        "devCenterResourceId": {
            "value": "/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project"
        },
        "imageName": {
            "value": "windows-2022"
        },
        "poolSize": {
            "value": 1
        },
        "location": {
            "value": "eastus"
        }
    }
}

Creación del grupo de DevOps administrado

Abra un símbolo del sistema (en Windows, use el símbolo del sistema de Windows o PowerShell) y ejecute los comandos siguientes. Puede omitir los dos primeros comandos si la sesión de la CLI de Azure del primer procedimiento todavía está activa.

  1. Inicie sesión en la CLI de Azure.

    az login

  2. Si tiene más de una suscripción de Azure, establezca la suscripción predeterminada de Azure.

    az account set --subscription "My subscription name"

    Para obtener una lista de las suscripciones, puede ejecutar el siguiente comando.

    az account list -o table

    Si tiene varios inquilinos o quiere ver más información sobre cómo trabajar con una suscripción de Azure mediante la CLI de Azure, consulte Administración de suscripciones de Azure con la CLI de Azure.

  3. Vaya a la carpeta cuando guardó los dos archivos JSON del paso anterior. En este ejemplo, los archivos se guardan en C:\examples.

    cd c:\examples

  4. Cree el grupo de DevOps administrado. Reemplace por <resourceGroupName> el grupo de recursos creado en el primer paso.

    az deployment group create --resource-group <resourceGroupName> --template-file mdp-azure-deploy.json --parameters mdp-azure-deploy-parameters.json

    Si la suscripción no tiene la capacidad de configurar el grupo con la SKU de máquina virtual de Azure deseada y el número máximo de agentes, la creación del grupo produce un error similar al siguiente mensaje. Cores needed to complete this request is 8, which exceeds the current limit of 0 for SKU family standardDDSv4Family in region eastus. Please choose a different region if possible, or request additional quota at https://portal.azure.com/#view/Microsoft_Azure_Support/NewSupportRequestV3Blade/issueType/quota/subscriptionId/subscription_id_placeholder/topicId/3eadc5d3-b59a-3658-d8c6-9c729ba35b97. Para resolver el problema, consulta Revisar las cuotas de grupos de DevOps administrados.

Visualización del grupo creado en Azure Portal

  1. Inicie sesión en Azure Portal.

  2. Busque Grupos de DevOps administrados y selecciónelo en las opciones disponibles.

  3. Elija el nuevo grupo de DevOps administrado en la lista.

  4. Elija Vista JSON para ver el formato JSON del recurso Grupos de DevOps administrados.

    Captura de pantalla del botón Vista JSON en información general del grupo.

Visualización del grupo de agentes en Azure DevOps

  1. Vaya al portal de Azure DevOps e inicie sesión en la organización de Azure DevOps (https://dev.azure.com/{your-organization}).

  2. Vaya a Configuración de la organización de Azure DevOps>.

    Captura de pantalla del botón Configuración de la organización.

  3. Vaya a Grupos de agentes de canalizaciones> y compruebe que aparece el nuevo grupo. Si acaba de crear el grupo de DevOps administrado, puede tardar unos instantes en aparecer en la lista de agentes.

    Captura de pantalla de la lista Grupos de agentes.

Ejecución de una canalización en el nuevo grupo

En este paso, crearemos una canalización sencilla en el repositorio predeterminado de un proyecto de Azure DevOps y lo ejecutaremos en el nuevo grupo de DevOps administrado.

  1. Vaya al portal de Azure DevOps e inicie sesión en la organización de Azure DevOps (https://dev.azure.com/{your-organization}).

  2. Vaya al proyecto donde desea ejecutar la canalización y elija Canalizaciones.

    Captura de pantalla de la lista Proyectos.

  3. Elija Nueva canalización (o Crear canalización si esta es la primera canalización).

    Captura de pantalla del botón nueva canalización.

  4. Elija Git de Azure Repos.

    Captura de pantalla de los tipos de repositorio.

  5. Elija el repositorio que tiene el mismo nombre que el proyecto. En este ejemplo, el proyecto se denomina FabrikamFiber, por lo que se elige el repositorio con el mismo nombre.

    Captura de pantalla del repositorio fabrikamFiber.

  6. Elija Canalización de inicio.

    Captura de pantalla de la lista de plantillas de canalización.

  7. De forma predeterminada, la plantilla de inicio usa un agente de Linux hospedado por Microsoft. Edite la plantilla de canalización y cambie la pool sección para que haga referencia al grupo que creó en los pasos anteriores.

    # Change these two lines as shown in the following example.
 pool:
  vmImage: ubuntu-latest

    En este ejemplo, los grupos de DevOps administrados se denominan fabrikam-managed-pool, por lo que reemplazan por vmImage: ubuntu-latest name: fabrikam-managed-poolsy especifican el nombre del grupo de DevOps administrado.

    # Replace fabrikam-managed-pools with the name
# of your Managed DevOps Pool.
pool:
  name: fabrikam-managed-pool

  8. Elija Guardar y ejecutar y elija Guardar y ejecutar una segunda vez para confirmar.

    Captura de pantalla del botón Guardar y ejecutar.

  9. Si se trata de la primera ejecución de canalización en este grupo, es posible que se le pida que conceda permisos antes de que se ejecute la canalización.

  10. Vea la ejecución de la canalización en Azure DevOps y puede cambiar a Azure Portal y ver el agente en ejecución en la vista Agentes.

Limpieza de recursos

Cuando haya completado el inicio rápido, elimine los recursos creados si no desea seguir utilizándolos.

Para eliminar el grupo de DevOps administrado, Centro de desarrollo y Centro de desarrollo Project, puede eliminarlos eliminando el grupo de recursos que los contiene.

Consulte también