Szybki start: tworzenie zarządzanej puli DevOps przy użyciu szablonu usługi ARM

Artykuł
11/13/2024

W tym artykule pokazano, jak utworzyć zarządzaną pulę DevOps przy użyciu szablonu usługi ARM i uruchomić potok w nowej puli.

Wymagania wstępne

Przed wykonaniem kroków opisanych w tym artykule musisz skonfigurować subskrypcję platformy Azure i organizację usługi Azure DevOps do użycia z zarządzanymi pulami DevOps zgodnie z opisem w artykule Wymagania wstępne . Te kroki należy wykonać tylko raz na subskrypcję platformy Azure i organizację usługi Azure DevOps.

Otwórz wiersz polecenia (w systemie Windows, użyj wiersza polecenia systemu Windows lub programu PowerShell) i uruchom następujące polecenia.

Zaloguj się do interfejsu wiersza polecenia platformy Azure.
```
az login
```
Jeśli masz więcej niż jedną subskrypcję platformy Azure, ustaw domyślną subskrypcję platformy Azure.
```
az account set --subscription "My subscription name"
```
Aby uzyskać listę subskrypcji, możesz uruchomić następujące polecenie.
```
az account list -o table
```
Jeśli masz wiele dzierżaw lub chcesz wyświetlić więcej informacji na temat pracy z subskrypcją platformy Azure przy użyciu interfejsu wiersza polecenia platformy Azure, zobacz Jak zarządzać subskrypcjami platformy Azure za pomocą interfejsu wiersza polecenia platformy Azure.

Tworzenie grupy zasobów, Centrum deweloperów i projektu Centrum deweloperów

Wykonaj kroki tworzenia centrum deweloperskiego w temacie Tworzenie i konfigurowanie centrum deweloperskiego dla środowisk wdrażania platformy Azure przy użyciu interfejsu wiersza polecenia platformy Azure.

Wystarczy wykonać kroki opisane w sekcji Tworzenie centrum deweloperskiego. Zanotuj nazwę grupy zasobów i nazwę Centrum deweloperów.
Wykonaj kroki tworzenia projektu w temacie Tworzenie i konfigurowanie projektu przy użyciu interfejsu wiersza polecenia platformy Azure.

Zanotuj id utworzony projekt (a nie devCenterId).

Przeglądanie i zapisywanie szablonu

Utwórz lokalną nazwę pliku mdp-azure-deploy.json z następującą zawartością. Ten plik jest sparametryzowanym szablonem usługi ARM, który tworzy microsoft.devopsinfrastructure/pools zasób.

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

Utwórz inny plik lokalny o nazwie mdp-azure-deploy-parameters.json i zapisz go w tym samym folderze co pierwszy plik. Zaktualizuj następujące właściwości, aby dopasować je do szczegółów środowiska.

Parametr	Wartość
`poolName`	Zaktualizuj `value` element przy użyciu żądanej nazwy puli. Nazwa musi zawierać znaki alfanumeryczne, `.`, `-`lub `_`, i mieć długość od 3 do 44 znaków. Nazwa musi być globalnie unikatowa na platformie Azure.
`adoOrg`	Zaktualizuj `value` i zastąp `your-organization` ciąg nazwą organizacji usługi Azure DevOps.
`devCenterResourceId`	Zaktualizuj `value` element za `id` pomocą polecenia z poprzedniego kroku Tworzenie grupy zasobów, Centrum deweloperów i Centrum deweloperów project.
`imageName`	W tym przykładzie skonfigurowano użycie obrazu usługi Azure Pipelines i użyto obrazu systemu Windows Server 2022. Jeśli chcesz ją zmienić, wybierz z wstępnie zdefiniowanych aliasów obrazu usługi Azure Pipelines. Zarządzane pule DevOps obsługują również obrazy z galerii obliczeń platformy Azure i wybrane obrazy z witryny Marketplace. Aby uzyskać informacje na temat konfigurowania zasobu zarządzanych pul DevOps dla tych typów obrazów, zobacz Konfigurowanie obrazów zarządzanych pul DevOps.
`poolSize`	Zaktualizuj `value` przy użyciu maksymalnej liczby agentów, które mają być w stanie uruchamiać współbieżne zadania. W tym przykładzie wartość `poolSize` to `1`.
`location`	Region platformy Azure dla puli. W tym przykładzie region to `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"
        }
    }
}

Tworzenie zarządzanej puli DevOps

Otwórz wiersz polecenia (w systemie Windows, użyj wiersza polecenia systemu Windows lub programu PowerShell) i uruchom następujące polecenia. Pierwsze dwa polecenia można pominąć, jeśli sesja interfejsu wiersza polecenia platformy Azure z pierwszej procedury jest nadal aktywna.

Zaloguj się do interfejsu wiersza polecenia platformy Azure.
```
az login
```
Jeśli masz więcej niż jedną subskrypcję platformy Azure, ustaw domyślną subskrypcję platformy Azure.
```
az account set --subscription "My subscription name"
```
Aby uzyskać listę subskrypcji, możesz uruchomić następujące polecenie.
```
az account list -o table
```
Jeśli masz wiele dzierżaw lub chcesz wyświetlić więcej informacji na temat pracy z subskrypcją platformy Azure przy użyciu interfejsu wiersza polecenia platformy Azure, zobacz Jak zarządzać subskrypcjami platformy Azure za pomocą interfejsu wiersza polecenia platformy Azure.
Przejdź do folderu po zapisaniu dwóch plików JSON z poprzedniego kroku. W tym przykładzie pliki są zapisywane w pliku C:\examples.
```
cd c:\examples
```
Utwórz zarządzaną pulę DevOps. Zastąp element <resourceGroupName> grupą zasobów utworzoną w pierwszym kroku.
```
az deployment group create --resource-group <resourceGroupName> --template-file mdp-azure-deploy.json --parameters mdp-azure-deploy-parameters.json
```
Jeśli twoja subskrypcja nie ma pojemności do skonfigurowania puli przy użyciu żądanej jednostki SKU maszyny wirtualnej platformy Azure i maksymalnej liczby agentów, tworzenie puli kończy się niepowodzeniem z powodu błędu podobnego do poniższego komunikatu. 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. Aby rozwiązać ten problem, zobacz Przeglądanie limitów przydziałów zarządzanych pul DevOps.

Wyświetlanie utworzonej puli w witrynie Azure Portal

Zaloguj się w witrynie Azure Portal.
Wyszukaj pozycję Zarządzane pule DevOps i wybierz je z dostępnych opcji.
Z listy wybierz nową zarządzaną pulę DevOps.
Wybierz pozycję Widok JSON, aby wyświetlić format JSON zasobu zarządzanych pul DevOps.

Wyświetlanie puli agentów w usłudze Azure DevOps

Przejdź do portalu usługi Azure DevOps i zaloguj się do organizacji usługi Azure DevOps (https://dev.azure.com/{your-organization}).
Przejdź do pozycji Ustawienia organizacji usługi Azure DevOps>.
Przejdź do pul agentów potoków>i sprawdź, czy nowa pula jest wyświetlana. Jeśli właśnie utworzono zarządzaną pulę DevOps, wyświetlenie nowej puli na liście agentów może potrwać kilka chwil.

Uruchamianie potoku w nowej puli

W tym kroku utworzymy prosty potok w domyślnym repozytorium projektu usługi Azure DevOps i uruchomimy go w nowej zarządzanej puli DevOps.

Przejdź do portalu usługi Azure DevOps i zaloguj się do organizacji usługi Azure DevOps (https://dev.azure.com/{your-organization}).
Przejdź do projektu, w którym chcesz uruchomić potok, a następnie wybierz pozycję Potoki.
Wybierz pozycję Nowy potok (lub Utwórz potok, jeśli jest to pierwszy potok).
Wybierz pozycję Azure Repos Git.
Wybierz repozytorium, które ma taką samą nazwę jak projekt. W tym przykładzie projekt nosi nazwę FabrikamFiber, dlatego wybieramy repozytorium o tej samej nazwie.
Wybierz pozycję Potok startowy.
Domyślnie szablon startowy używa agenta systemu Linux hostowanego przez firmę Microsoft. Edytuj szablon potoku i zmień sekcję pool , tak aby odwoływała się do puli utworzonej w poprzednich krokach.
```
# Change these two lines as shown in the following example.
 pool:
  vmImage: ubuntu-latest
```
W tym przykładzie pula zarządzanej metodyki DevOps ma nazwę fabrikam-managed-pool, więc zastąp vmImage: ubuntu-latest ciąg ciągiem name: fabrikam-managed-poolsi określ nazwę zarządzanej puli DevOps.
```
# Replace fabrikam-managed-pools with the name
# of your Managed DevOps Pool.
pool:
  name: fabrikam-managed-pool
```
Wybierz pozycję Zapisz i uruchom, a następnie wybierz pozycję Zapisz i uruchom ponownie, aby potwierdzić.
Jeśli jest to pierwsze uruchomienie potoku w tej puli, może zostać wyświetlony monit o udzielenie uprawnień przed uruchomieniem potoku.
Obejrzyj przebieg potoku w usłudze Azure DevOps i możesz przełączyć się do witryny Azure Portal i wyświetlić uruchomionego agenta w widoku Agenci.