Sdílet prostřednictvím

Rychlý start: Vytvoření spravovaného fondu DevOps pomocí šablony ARM

V tomto článku se dozvíte, jak pomocí šablony ARM vytvořit spravovanou skupinu DevOps Pool a spustit pipeline v tomto novém fondu.

Požadavky

Před dokončením kroků v tomto článku nakonfigurujte předplatné Azure a organizaci Azure DevOps pro použití se spravovanými fondy DevOps, jak je popsáno v článku Požadavky. Tyto kroky je potřeba provést jenom jednou pro každé předplatné Azure a organizaci Azure DevOps.

Přihlášení k Azure CLI

Otevřete příkazový řádek (ve Windows, použijte Příkazový řádek windows nebo PowerShell) a spusťte následující příkazy.

  1. Přihlaste se k Azure CLI.

    az login

  2. Pokud máte více než jedno předplatné Azure, nastavte výchozí předplatné Azure.

    az account set --subscription "My subscription name"

    Pokud chcete získat seznam předplatných, můžete spustit následující příkaz.

    az account list -o table

    Pokud máte více tenantů nebo chcete zobrazit další informace o práci s předplatným Azure pomocí Azure CLI, přečtěte si téma Správa předplatných Azure pomocí Azure CLI.

Vytvoření skupiny prostředků, Dev Centra a projektu Dev Center

  1. Postupujte podle kroků vytvoření vývojového centra v tématu Vytvoření a konfigurace vývojového centra pro prostředí nasazení Azure pomocí Azure CLI.

    Stačí postupovat jenom podle kroků v části Vytvoření centra pro vývoj. Poznamenejte si název skupiny prostředků a název Dev Center.

  2. Postupujte podle kroků vytvoření projektu v části Vytvoření a konfigurace projektu pomocí Azure CLI.

    Zapište si údaj id vytvořeného projektu (nikoliv devCenterId).

Kontrola a uložení šablony

  1. Vytvořte název místního souboru mdp-azure-deploy.json s následujícím obsahem. Tento soubor je parametrizovaná šablona ARM, která vytvoří microsoft.devopsinfrastructure/pools prostředek.

    {
    "$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": "2025-09-20",
            "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. Vytvořte další místní soubor s názvem mdp-azure-deploy-parameters.json a uložte ho do stejné složky jako první soubor. Aktualizujte následující vlastnosti tak, aby odpovídaly podrobnostem vašeho prostředí.

    Parametr Hodnota
    poolName Aktualizujte value na požadovaný název vašeho fondu. Název se musí skládat z alfanumerických znaků, ., -nebo a _musí mít délku 3 až 44 znaků. Název musí být globálně jedinečný v Azure.
    adoOrg Aktualizujte value a nahraďte your-organization názvem vaší organizace Azure DevOps.
    devCenterResourceId Aktualizujte value s id z předchozího kroku Vytvoření skupiny prostředků, Dev Center a projektu Dev Center.
    imageName Tento příklad je nakonfigurovaný tak, aby používal Azure Pipelines image, a používá Windows Server 2022 image. Pokud ho chcete změnit, vyberte si z předdefinovaných aliasů pro image Azure Pipelines. Spravované fondy DevOps také podporují image galerie výpočetních prostředků Azure a vybrané image z marketplace. Informace o konfiguraci zdroje spravovaných fondů DevOps pro tyto image naleznete v části Konfigurace imagí spravovaných fondů DevOps.
    poolSize Aktualizujte value na maximální počet agentů, které chcete mít možnost pro souběžné spouštění úloh. V tomto příkladu je poolSize1.
    location Oblast Azure pro fond. V tomto příkladu je oblast 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"
        }
    }
}

Vytvoření spravovaného fondu DevOps

Otevřete příkazový řádek (ve Windows, použijte Příkazový řádek windows nebo PowerShell) a spusťte následující příkazy. První dva příkazy můžete přeskočit, pokud vaše relace Azure CLI z první procedury je stále aktivní.

  1. Přihlaste se k Azure CLI.

    az login

  2. Pokud máte více než jedno předplatné Azure, nastavte výchozí předplatné Azure.

    az account set --subscription "My subscription name"

    Pokud chcete získat seznam předplatných, můžete spustit následující příkaz.

    az account list -o table

    Pokud máte více tenantů nebo chcete zobrazit další informace o práci s předplatným Azure pomocí Azure CLI, přečtěte si téma Správa předplatných Azure pomocí Azure CLI.

  3. Přejděte do složky, když jste uložili dva soubory JSON z předchozího kroku. V tomto příkladu jsou soubory uloženy do C:\examples.

    cd c:\examples

  4. Vytvořte spravovaný fond DevOps. Nahraďte <resourceGroupName> skupinou prostředků vytvořenou v prvním kroku.

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

    Pokud vaše předplatné nemá kapacitu ke konfiguraci fondu s požadovaným SKU virtuálního počítače Azure a maximálním počtem agentů, vytvoření fondu selže s chybou podobnou následující zprávě. 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. Pokud chcete tento problém vyřešit, přečtěte si téma Kontrola kvót spravovaných fondů DevOps.

Zobrazení vytvořeného fondu na webu Azure Portal

  1. Přihlaste se k portálu Azure.

  2. Vyhledejte spravované fondy DevOps a vyberte je z dostupných možností.

  3. V seznamu vyberte nový spravovaný fond DevOps.

  4. Zvolte Zobrazení JSON a zobrazte formát JSON vaší zdroje spravovaných DevOps fondů.

    Snímek obrazovky s tlačítkem Zobrazení JSON v přehledu fondu

Zobrazení fondu agentů v Azure DevOps

  1. Přejděte na portál Azure DevOps a přihlaste se k organizaci Azure DevOps.https://dev.azure.com/{your-organization}

  2. Přejděte do Azure DevOps>Nastavení organizace.

    Snímek obrazovky s tlačítkem Nastavení organizace

  3. Přejděte do Pipelines>Agent pools a ověřte, že je váš nový fond uvedený. Pokud jste právě vytvořili spravovaný fond DevOps, může chvíli trvat, než se nový fond zobrazí v seznamu agentů.

    Snímek obrazovky seznamu poolů agentů

Spusťte potrubí v novém fondu

V tomto kroku vytvoříme jednoduchý kanál ve výchozím úložišti projektu Azure DevOps a spustíme ho ve vašem novém spravovaném fondu DevOps.

  1. Přejděte na portál Azure DevOps a přihlaste se k organizaci Azure DevOps.https://dev.azure.com/{your-organization}

  2. Přejděte do projektu, ve kterém chcete kanál spustit, a zvolte Kanály.

    Snímek obrazovky se seznamem Projektů

  3. Zvolte Nový kanál (nebo vytvořte kanál, pokud se jedná o první kanál).

    Snímek obrazovky s tlačítkem nového kanálu

  4. Zvolte Azure Repos Git.

    Snímek obrazovky s typy úložišť

  5. Zvolte úložiště, které má stejný název jako váš projekt. V tomto příkladu má projekt název FabrikamFiber, proto zvolíme úložiště se stejným názvem.

    Snímek obrazovky s úložištěm FabrikamFiber

  6. Zvolte počáteční kanál.

    Snímek obrazovky se seznamem šablon kanálů

  7. Ve výchozím nastavení úvodní šablona používá agenta Microsoftu hostovaného v Linuxu. Upravte šablonu kanálu a změňte pool oddíl tak, aby odkazoval na fond, který jste vytvořili v předchozích krocích.

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

    V tomto příkladu se spravovaný fond DevOps nazývá fabrikam-managed-pool, takže nahraďte vmImage: ubuntu-latest za name: fabrikam-managed-pools a zadejte název vašeho spravovaného fondu DevOps.

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

  8. Zvolte Uložit a spustit a zvolte Uložit a spusťte podruhé, abyste to potvrdili.

    Snímek obrazovky s tlačítkem Uložit a spustit

  9. Pokud se jedná o první spuštění potrubí v tomto fondu, můžete být požádáni o udělení oprávnění před tím, než se potrubí spustí. Další informace najdete v tématu Toto potrubí potřebuje oprávnění k přístupu k prostředku, aby tento proces mohl pokračovat.

  10. Sledujte spuštění pipeline v Azure DevOps, a můžete přepnout na Azure Portal a zobrazit spuštěného agenta v zobrazení Agentů.

Vyčištění prostředků

Po dokončení rychlého startu odstraňte vytvořené prostředky, pokud je nechcete dál používat.

Pokud chcete odstranit spravovaný fond DevOps, Dev Center a projekt Dev Center, můžete je odstranit odstraněním skupiny prostředků, která je obsahuje.

Viz také

  • Last updated on