Rövid útmutató: Felügyelt DevOps-készlet létrehozása ARM-sablonnal

Ez a cikk bemutatja, hogyan hozhat létre felügyelt DevOps-készletet ARM-sablonnal, és hogyan futtathat egy folyamatot az új készletben.

Előfeltételek

A cikk lépéseinek végrehajtása előtt konfigurálta az Azure-előfizetését és az Azure DevOps-szervezetet a felügyelt DevOps-készletekhez való használatra, az Előfeltételek cikkben leírtak szerint. Ezeket a lépéseket azure-előfizetésenként és Azure DevOps-szervezetenként csak egyszer kell elvégezni.

Nyisson meg egy parancssort (Windows rendszeren, használja a Windows parancssorát vagy a PowerShellt), és futtassa a következő parancsokat.

Jelentkezzen be az Azure CLI-be.
```
az login
```
Ha több Azure-előfizetéssel rendelkezik, állítsa be az alapértelmezett Azure-előfizetést.
```
az account set --subscription "My subscription name"
```
Az előfizetések listájának lekéréséhez futtassa a következő parancsot.
```
az account list -o table
```
Ha több bérlővel rendelkezik, vagy további információt szeretne látni az Azure-előfizetés Azure CLI-vel való használatáról, tekintse meg az Azure-előfizetések Azure CLI-vel való kezelését ismertető témakört.

Erőforráscsoport, Fejlesztői központ és Fejlesztői központ projekt létrehozása

Kövesse az Azure Deployment Environments fejlesztői központjának létrehozásával és konfigurálásával kapcsolatos lépéseket az Azure CLI használatával.

Csak a Fejlesztői központ létrehozása szakasz lépéseit kell követnie. Jegyezze fel az erőforráscsoport nevét és Fejlesztői központ nevét.
Kövesse a projekt létrehozásának lépéseit a Projekt létrehozása és konfigurálása az Azure CLI használatával.

Jegyezze fel a id-t a létrehozott projektből (nem a devCenterId-t).

A sablon áttekintése és mentése

Hozzon létre egy helyi fájlnevet mdp-azure-deploy.json a következő tartalommal. Ez a fájl egy paraméteres ARM-sablon, amely létrehoz egy erőforrást microsoft.devopsinfrastructure/pools .

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

Hozzon létre egy másik mdp-azure-deploy-parameters.json nevű helyi fájlt, és mentse az első fájllal megegyező mappába. Frissítse a következő tulajdonságokat a környezet részleteinek megfelelően.

Paraméter	Érték
`poolName`	Frissítse a `value`-t a medence kívánt nevére. A névnek alfanumerikus karakterekből kell állnia, `.-`és `_`3 és 44 karakter közötti hosszúságúnak kell lennie. A névnek globálisan egyedinek kell lennie az Azure-ban.
`adoOrg`	Frissítse `value` és cserélje le `your-organization` az Azure DevOps-szervezet nevét.
`devCenterResourceId`	Frissítsen `value` az `id` előző Erőforráscsoport létrehozása, Fejlesztői központ és Fejlesztői központ Projekt lépésével.
`imageName`	Ez a példa egy Azure Pipelines-rendszerkép használatára van konfigurálva, és a Windows Server 2022 rendszerképet használja. Ha módosítani szeretné, válasszon az Azure Pipelines-rendszerkép előre definiált aliasai közül. A felügyelt DevOps-készletek az Azure Compute Gallery rendszerképeit és a kiválasztott piactéri rendszerképeket is támogatják. A felügyelt DevOps-készletek erőforrásának konfigurálásával kapcsolatos információkért tekintse meg a Felügyelt DevOps-készletek rendszerképeinek konfigurálását ismertető témakört.
`poolSize`	Frissítsen `value` az egyidejű feladatok futtatásához használni kívánt ügynökök maximális számával. Ebben a példában a következő: `poolSize1`.
`location`	A készlet Azure-régiója. Ebben a példában a régió az `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"
        }
    }
}

A felügyelt DevOps-készlet létrehozása

Nyisson meg egy parancssort (Windows rendszeren, használja a Windows parancssorát vagy a PowerShellt), és futtassa a következő parancsokat. Kihagyhatja az első két parancsot, ha az Azure CLI-munkamenet az első eljárásból még aktív.

Jelentkezzen be az Azure CLI-be.
```
az login
```
Ha több Azure-előfizetéssel rendelkezik, állítsa be az alapértelmezett Azure-előfizetést.
```
az account set --subscription "My subscription name"
```
Az előfizetések listájának lekéréséhez futtassa a következő parancsot.
```
az account list -o table
```
Ha több bérlővel rendelkezik, vagy további információt szeretne látni az Azure-előfizetés Azure CLI-vel való használatáról, tekintse meg az Azure-előfizetések Azure CLI-vel való kezelését ismertető témakört.
Nyissa meg a mappát, amikor az előző lépésből mentette a két JSON-fájlt. Ebben a példában a fájlokat a következő helyre menti: C:\examples.
```
cd c:\examples
```
Hozza létre a felügyelt DevOps-készletet. Cserélje le <resourceGroupName> az első lépésben létrehozott erőforráscsoportra.
```
az deployment group create --resource-group <resourceGroupName> --template-file mdp-azure-deploy.json --parameters mdp-azure-deploy-parameters.json
```
Ha az előfizetés nem rendelkezik kapacitással a készlet konfigurálásához a kívánt Azure-beli virtuálisgép-termékváltozattal és az ügynökök maximális számával, a készlet létrehozása az alábbi üzenethez hasonló hibával meghiúsul. 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. A probléma megoldásához lásd: A felügyelt DevOps-készletek kvótáinak áttekintése.

A létrehozott készlet megtekintése az Azure Portalon

Jelentkezzen be az Azure Portalra.
Keressen felügyelt DevOps-készleteket, és válassza ki az elérhető lehetőségek közül.
Válassza ki az új felügyelt DevOps-készletet a listából.
Válassza a JSON nézetet a felügyelt DevOps-készletek erőforrás JSON-formátumának megtekintéséhez.

Az ügynökkészlet megtekintése az Azure DevOpsban

Nyissa meg az Azure DevOps portált, és jelentkezzen be az Azure DevOps-szervezetbe (https://dev.azure.com/{your-organization}).
Nyissa meg az Azure DevOps>Organization beállításait.
Nyissa meg a Pipelines>Agent-készleteket, és ellenőrizze, hogy az új készlet szerepel-e a listában. Ha most hozta létre a felügyelt DevOps-készletet, eltarthat néhány percig, amíg az új készlet megjelenik az ügynökök listájában.

Folyamatlánc futtatása az új poolban

Ebben a lépésben létrehozunk egy egyszerű folyamatot egy Azure DevOps-projekt alapértelmezett adattárában, és futtatjuk az új felügyelt DevOps-készletben.

Nyissa meg az Azure DevOps portált, és jelentkezzen be az Azure DevOps-szervezetbe (https://dev.azure.com/{your-organization}).
Nyissa meg azt a projektet, ahol futtatni szeretné a pipeline-t, és válassza a Pipeline-ek lehetőséget.
Válassza az Új folyamat (vagy a Folyamat létrehozása, ha ez az első folyamat).
Válassza az Azure Repos Git lehetőséget.
Válassza ki azt az adattárat, amelynek neve megegyezik a projekt nevével. Ebben a példában a projekt neve FabrikamFiber, ezért az azonos nevű adattárat választjuk ki.
Válassza a kezdő folyamatot.
Alapértelmezés szerint a kezdősablon egy Microsoft által üzemeltetett Linux-ügynököt használ. Szerkessze a folyamatsablont, és módosítsa a pool szakaszt úgy, hogy az az előző lépésekben létrehozott készletre hivatkozzon.
```
# Change these two lines as shown in the following example.
 pool:
  vmImage: ubuntu-latest
```
Ebben a példában a felügyelt DevOps-készlet a fabrikam-managed-pool nevet kapta, ezért cserélje le a vmImage: ubuntu-latest-t a name: fabrikam-managed-pools-ra, és adja meg a felügyelt DevOps-készlet nevét.
```
# Replace fabrikam-managed-pools with the name
# of your Managed DevOps Pool.
pool:
  name: fabrikam-managed-pool
```
Válassza a Mentés és futtatás lehetőséget, majd erősítse meg a Mentés és futtatás választásával.
Ha ez az első folyamatvonal futtatása ebben a készletben, előfordulhat, hogy a futtatás előtt engedélyeket szükséges megadnia. További információ : A folyamatnak engedélyre van szüksége egy erőforrás eléréséhez, mielőtt a futtatás folytatódna.
Figyelje az Azure DevOpsban a folyamat futását, majd váltson át az Azure Portálra, ahol az Ügynökök nézetben megtekintheti a futó ügynököt.

Az erőforrások felszabadítása

Ha befejezte a rövid útmutatót, törölje a létrehozott erőforrásokat, ha nem szeretné továbbra is használni őket.

A felügyelt DevOps-készlet, Fejlesztői központ és Fejlesztői központ Project törléséhez törölje azokat a bennük található erőforráscsoport törlésével.

Lásd még

Felügyelt DevOps-készletek ARM-sablonreferenciája

Visszacsatolás

Hasznos volt ez az oldal?

Last updated on 2025-07-29