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

Ez a cikk bemutatja, hogyan hozhat létre felügyelt DevOps-készletet Bicep-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 létrehozása

Hozzon létre egy erőforráscsoportot, amely tartalmazza a felügyelt DevOps-készletet és más erőforrásokat. Cserélje le <resourceGroupName> az erőforráscsoporthoz használni kívánt nevet, és <location> azt az Azure-régiót, ahol létre szeretné hozni az erőforráscsoportot.
```
az group create --name <resourceGroupName> --location <location>
```

A sablon áttekintése és mentése

Hozzon létre egy helyi fájlnevet mdp-azure-deploy.bicep néven az alábbi tartalommal. Ez a fájl egy paraméteres Bicep-sablon, amely létrehoz egy erőforrást Microsoft.DevOpsInfrastructure/pools , beleértve a függőségi erőforrást Microsoft.DevCenter/devcenters és Microsoft.DevCenter/projects az erőforrást.

@minLength(3)
@maxLength(44)
param poolName string

@maxLength(26)
param devCenterName string

param devCenterProjectName string
param adoOrg string
param imageName string
param poolSize int
param location string = 'eastus'

resource devCenter 'Microsoft.DevCenter/devcenters@2025-02-01' = {
  name: devCenterName
  location: location
}

resource devCenterProject 'Microsoft.DevCenter/projects@2025-02-01' = {
  name: devCenterProjectName
  location: location
  properties: {
    devCenterId: devCenter.id
  }
}

resource pool 'microsoft.devopsinfrastructure/pools@2025-09-20' = {
  name: poolName
  location: location
  properties: {
    organizationProfile: {
      organizations: [
        {
          url: adoOrg
          parallelism: 1
        }
      ]
      permissionProfile: {
        kind: 'CreatorOnly'
      }
      kind: 'AzureDevOps'
    }
    devCenterProjectResourceId: devCenterProject.id
    maximumConcurrency: poolSize
    agentProfile: {
      kind: 'Stateless'
    }
    fabricProfile: {
      sku: {
        name: 'Standard_D2ads_v5'
      }
      images: [
        {
          wellKnownImageName: imageName
          buffer: '*'
        }
      ]
      kind: 'Vmss'
    }
  }
}

Hozzon létre egy másik helyi fájlt mdp-azure-deploy-parameters.bicepparam néven, é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.
`devCenterName`	Frissítsen `value` a Fejlesztői központ kívánt nevével.
`devCenterProjectName`	Frissítsen `value` a Dev Center-projekt kívánt nevével.
`adoOrg`	Frissítse `value` és cserélje le `your-organization` az Azure DevOps-szervezet nevét.
`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`.

using './mdp-azure-deploy.bicep'

param poolName = '<pool-name>'
param devCenterName = '<dev-center-name>'
param devCenterProjectName = '<dev-center-project-name>'
param adoOrg = 'https://dev.azure.com/fabrikam'
param location = 'eastus'
param imageName = 'windows-2022'
param poolSize = 1

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 mentette az mdp-azure-deploy.bicep és az mdp-azure-deploy-parameters.bicepparam fájlokat az előző lépésből. 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.bicep --parameters mdp-azure-deploy-parameters.bicepparam
```
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 a 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.

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.
Menjen a Pipelines>Agent-készletek részhez, é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 pillanatig, amíg az új készlet megjelenik az ügynökök listáján.

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}).
Menjen arra a projektre, amelyben futtatni szeretné a csővezetéket, és válassza a Csővezetékek 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 Starter csővezetékét.
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 neve fabrikam-managed-pool, ezért cserélje le a vmImage: ubuntu-latest-t name: fabrikam-managed-pools-re, é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 válassza a Mentés és futtatás lehetőséget másodszor is a megerősítéshez.
Ha ez az első futtatott folyamat ebben a erőforráskészletben, akkor előfordulhat, hogy a folyamat futtatása előtt engedélyeket kell adnia. 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.
Kövesse nyomon a pipeline futását az Azure DevOpsban, majd váltson át az Azure Portálra, és tekintse meg a futó ügynököt az Ügynökök nézetben.

Erőforrások tisztí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

Visszacsatolás

Hasznos volt ez az oldal?

Last updated on 2025-08-13