快速入門：使用ARM範本建立受控DevOps集區

發行項
11/14/2024

本文說明如何使用 ARM 範本建立受控 DevOps 集區，並在新的集區中執行管線。

必要條件

在完成本文中的步驟之前，請預先按照必要條件一文的說明，設定您的 Azure 訂用帳戶和 Azure DevOps 組織，以供受控 DevOps 集區使用。每個 Azure 訂用帳戶和 Azure DevOps 組織只需要完成一次這些步驟。

開啟命令提示字元（在 Windows 上，使用 Windows 命令提示字元或 PowerShell），然後執行下列命令。

登入 Azure CLI。
```
az login
```
如果您有多個 Azure 訂用帳戶，請設定您的預設 Azure 訂用帳戶。
```
az account set --subscription "My subscription name"
```
若要取得訂用帳戶的清單，您可以執行下列命令。
```
az account list -o table
```
如果您有多個租使用者，或想要查看使用 Azure CLI 使用 Azure 訂用帳戶的詳細資訊，請參閱如何使用 Azure CLI 管理 Azure 訂用帳戶。

建立資源群組、開發人員中心和開發人員中心專案

遵循使用 Azure CLI 建立和設定 Azure 部署環境的開發人員中心中的建立開發人員中心步驟。

您只需要遵循建立開發人員中心一節中的步驟。記下資源組名和開發人員中心名稱。
請遵循使用 Azure CLI 建立和設定專案中的建立專案步驟。

記下 id 已建立專案的（而非 devCenterId）。

檢閱並儲存範本

使用下列內容建立本機檔名 mdp-azure-deploy.json 。此檔案是可建立 microsoft.devopsinfrastructure/pools 資源的參數化 ARM 範本。

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

建立另一個名為 mdp-azure-deploy-parameters.json 的本機檔案，並將它儲存在與第一個檔案相同的資料夾中。更新下列屬性，以符合環境的詳細數據。

參數	值
`poolName`	使用您集區所需的名稱進行更新 `value` 。名稱必須包含英數位元、 `.`、 `-`或 `_`，長度介於 3 到 44 個字元之間。名稱在 Azure 中必須是全域唯一的。
`adoOrg`	將更新 `value` 並取代 `your-organization` 為您的 Azure DevOps 組織名稱。
`devCenterResourceId`	使用上一個建立資源群組、開發人員中心和開發人員中心 Project`id`
`imageName`	此範例已設定為使用 Azure Pipelines 映射，並使用 Windows Server 2022 映像。如果您想要變更它，請選擇 Azure Pipelines 映像預先定義的別名。受控DevOps集區也支援 Azure 計算資源庫映像和選取的市集映像。如需為這些映像類型設定受控DevOps集區資源的詳細資訊，請參閱設定受控DevOps集區映像。
`poolSize`	使用您要執行並行作業的代理程式數目上限進行更新 `value` 。在這裡範例中， `poolSize` 是 `1`。
`location`	集區的 Azure 區域。在這裡範例中，區域為 `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"
        }
    }
}

建立受控DevOps集區

開啟命令提示字元（在 Windows 上，使用 Windows 命令提示字元或 PowerShell），然後執行下列命令。如果來自第一個程式的 Azure CLI 工作階段仍在使用中，您可以略過前兩個命令。

登入 Azure CLI。
```
az login
```
如果您有多個 Azure 訂用帳戶，請設定您的預設 Azure 訂用帳戶。
```
az account set --subscription "My subscription name"
```
若要取得訂用帳戶的清單，您可以執行下列命令。
```
az account list -o table
```
如果您有多個租使用者，或想要查看使用 Azure CLI 使用 Azure 訂用帳戶的詳細資訊，請參閱如何使用 Azure CLI 管理 Azure 訂用帳戶。
當您從上一個步驟儲存兩個 JSON 檔案時，請移至資料夾。在這裡範例中，檔案會儲存至 C:\examples。
```
cd c:\examples
```
建立受控DevOps集區。將取代 <resourceGroupName> 為在第一個步驟中建立的資源群組。
```
az deployment group create --resource-group <resourceGroupName> --template-file mdp-azure-deploy.json --parameters mdp-azure-deploy-parameters.json
```
如果您的訂用帳戶沒有容量可設定具有所需 Azure VM SKU 和最大代理程式計數的集區，集區建立會失敗，並出現類似下列訊息的錯誤。 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. 若要解決此問題，請參閱檢閱受控 DevOps 集區配額。

在 Azure 入口網站中檢視已建立的集區

登入 Azure 入口網站。
搜尋 受控 DevOps 集區 ，並從可用的選項中選取它。
從清單中選擇新的受控DevOps集區。
選擇 [JSON 檢視 ] 以查看受控 DevOps 集區資源的 JSON 格式。

在 Azure DevOps 中檢視代理程式集區

移至 Azure DevOps 入口網站，然後登入您的 Azure DevOps 組織（https://dev.azure.com/{your-organization}）。
移至 Azure DevOps>組織設定。
移至 [管線>代理程式集區]，並確認您的新集區已列出。如果您剛建立受控DevOps集區，新集區可能需要一些時間才會出現在代理程式清單中。

在新集區中執行管線

在此步驟中，我們將在 Azure DevOps 專案的預設存放庫中建立簡單的管線，並在新的受控 DevOps 集區中執行。

移至 Azure DevOps 入口網站，然後登入您的 Azure DevOps 組織（https://dev.azure.com/{your-organization}）。
移至您要執行管線的項目，然後選擇 [管線]。
選擇 [新增管線] （如果這是您的第一個管線，請選擇 [建立管線]。
選擇 [Azure Repos Git]。
選擇與專案同名的存放庫。在此範例中，專案名為 FabrikamFiber，因此我們選擇具有相同名稱的存放庫。
選擇 [入門管線]。
根據預設，入門範本會使用裝載Microsoft Linux 代理程式。編輯管線範本並變更 pool 區段，使其參考您在先前步驟中建立的集區。
```
# Change these two lines as shown in the following example.
 pool:
  vmImage: ubuntu-latest
```
在此範例中，Managed DevOps 集區的名稱為 fabrikam-managed-pool，因此請將取代 vmImage: ubuntu-latest 為 name: fabrikam-managed-pools，並指定受控 DevOps 集區的名稱。
```
# Replace fabrikam-managed-pools with the name
# of your Managed DevOps Pool.
pool:
  name: fabrikam-managed-pool
```
選擇 [ 儲存並執行]，然後選擇 [ 儲存並執行 第二次] 以確認。
如果這是此集區中的第一個管線執行，系統可能會要求您在管線執行之前授與許可權。
觀看 Azure DevOps 中的管線執行，您可以切換至 Azure 入口網站，並在 [代理程式] 檢視中查看執行中的代理程式。