Konfigurowanie ustawień puli

W tym artykule opisano sposób konfigurowania podstawowych ustawień wystąpienia zarządzanych pul DevOps.

Przegląd

Aby wyświetlić przegląd ustawień puli, przejdź do sekcji Przegląd.

W obszarze Przegląd można wykonywać następujące czynności:

• Wyświetl szczegóły grupy zasobów i subskrypcji oraz przenieś zasoby platformy Azure do nowej grupy zasobów lub subskrypcji.
• Wyświetl lokalizację puli. Aby wyświetlić obsługiwane lokalizacje, wykonaj procedurę opisaną w temacie Rejestrowanie dostawcy zasobów zarządzanych pul DevOps w ramach subskrypcji platformy Azure.
• Konfigurowanie tagów. Zarządzane pule DevOps przekazują do maszyny wirtualnej (VM) maksymalnie 20 etykiet, a pozostałe są ignorowane.
• Wyświetl informacje o konfiguracji puli, takie jak Nazwa, Organizacja usługi Azure DevOps, Stan agenta i Maksymalna liczba agentów.
• Wyświetlanie wstępnie zdefiniowanych wykresów metryk.

Ustawienia puli

Aby skonfigurować pulę, przejdź do Ustawienia>pula.

Aby skonfigurować pulę, użyj następujących ustawień:

• projekt Dev Center
• Organizacja usługi Azure DevOps
• Obrazy
• Maksymalna liczba agentów
• Rozmiar agenta
• Typ dysku systemu operacyjnego

Projekt Centrum deweloperskiego

Portal Azure

Wybierz wystąpienie projektu Centrum programistów dla swojej puli. (Jeśli go nie masz, możesz utworzyć instancję Dev Center oraz instancję projektu Dev Center podczas tworzenia puli).

Szablon ARM

Właściwość devCenterProjectResourceId określa wystąpienie projektu Centrum deweloperskiego.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "location": "eastus",
            "tags": {},
            "properties": {
                ...
                "devCenterProjectResourceId": "/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project"
            }
        }
    ]
}

Możesz pobrać wartość dla wystąpienia devCenterProjectResourceId w witrynie Azure Portal, korzystając z widoku JSON na stronie przeglądu wystąpienia projektu Centrum deweloperów. Można go również pobrać, używając Azure CLI do wykonania zapytania dotyczącego projektu w celu uzyskania jego właściwości id.

W poniższym przykładzie wartość devCenterProjectResourceId jest pobierana z wystąpienia projektu Centrum Deweloperów o nazwie fabrikam-dev-center-project w grupie zasobów fabrikam-managed-devops-pools.

 az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"

Interfejs wiersza polecenia platformy Azure

Parametr devcenter-project-id określa instancję projektu Centrum developerskiego podczas tworzenia lub aktualizowania puli.

az mdp pool create \
   --devcenter-project-id /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/resourceGroupName/providers/Microsoft.DevCenter/projects/devCenterProjectName
   # other parameters omitted for space

Można pobrać dla wystąpienia projektu Dev Center w Azure Portal, korzystając z Widoku JSON na stronie Przegląd dla wystąpienia projektu Dev Center. Można go również pobrać, używając Azure CLI do wykonania zapytania dotyczącego projektu w celu uzyskania jego właściwości id.

W poniższym przykładzie element devcenter-project-id jest pobierany z wystąpienia projektu Centrum deweloperskiego o nazwie fabrikam-dev-center-project w fabrikam-managed-devops-pools grupie zasobów.

 az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"

Biceps

Właściwość devCenterProjectResourceId określa wystąpienie projektu Centrum deweloperskiego.

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    devCenterProjectResourceId: '/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project'
  }
}

Można pobrać dla wystąpienia projektu Dev Center w Azure Portal, korzystając z Widoku JSON na stronie Przegląd dla wystąpienia projektu Dev Center. Można go również pobrać, używając Azure CLI do wykonania zapytania dotyczącego projektu w celu uzyskania jego właściwości id.

W poniższym przykładzie element devCenterProjectResourceId jest pobierany z wystąpienia projektu Centrum deweloperskiego o nazwie fabrikam-dev-center-project w fabrikam-managed-devops-pools grupie zasobów.

 az devcenter admin project show --name fabrikam-dev-center-project --resource-group fabrikam-managed-devops-pools --query "id"

Organizacja Azure DevOps

Portal Azure

Jeśli skonfigurowano pulę dla jednej organizacji usługi Azure DevOps, możesz określić organizację w ustawieniach puli.

Jeśli skonfigurowano pulę dla wielu organizacji, ustawienie organizacji usługi Azure DevOps nie jest obecne w ustawieniach puli. Aby skonfigurować pulę do użycia w wielu organizacjach, przejdź do Ustawienia>, i skonfiguruj Użyj puli w wielu organizacjach.

Szablon ARM

Można skonfigurować wartość organizacji usługi Azure DevOps, korzystając z listy organizations w sekcji organizationProfile.

W poniższym przykładzie pula jest skonfigurowana dla wszystkich projektów w ramach jednej organizacji, z przepustowością równoległą równą 4. Przykład przedstawiający sposób konfigurowania wielu organizacji można znaleźć w temacie Use pool in multiple organizations (Używanie puli w wielu organizacjach).

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "organizationProfile": {
                    "organizations": [
                        {
                            "url": "https://dev.azure.com/fabrikam-tailspin",
                            "projects": [],
                            "parallelism": 4
                        }
                    ]
                }
            }
        }
    ]
}

Interfejs wiersza polecenia platformy Azure

Wartość organizacji Azure DevOps można skonfigurować, korzystając z listy organizations w parametrze organization-profile.

W poniższym przykładzie pula jest skonfigurowana dla wszystkich projektów w ramach jednej organizacji, z przepustowością równoległą równą 4. Przykład przedstawiający sposób konfigurowania wielu organizacji można znaleźć w temacie Use pool in multiple organizations (Używanie puli w wielu organizacjach).

az mdp pool create \
   --organization-profile organization-profile.json
   # other parameters omitted for space

Poniższy przykład przedstawia listę organizations w pliku organization-profile.json.

{
  "AzureDevOps": {
    "organizations": [
      {
        "url": "https://dev.azure.com/fabrikam-tailspin",
        "projects": [],
        "parallelism": 4
      }
    ],
    "permissionProfile": {...}
  }
}

Biceps

Można skonfigurować wartość organizacji usługi Azure DevOps, korzystając z listy organizations w sekcji organizationProfile.

W poniższym przykładzie pula jest skonfigurowana dla wszystkich projektów w ramach jednej organizacji, z przepustowością równoległą równą 4.

Przykład przedstawiający sposób konfigurowania wielu organizacji można znaleźć w temacie Use pool in multiple organizations (Używanie puli w wielu organizacjach).

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    organizationProfile: {
      organizations: [
        {
          url: 'https://dev.azure.com/fabrikam-tailspin'
          projects: []
          parallelism: 4
        }
      ]
    }
  }
}

Domyślnie pula jest dostępna dla wszystkich projektów w określonych organizacjach. Aby ograniczyć pulę do określonych projektów, zobacz Ustawienia zabezpieczeń: Konfigurowanie dostępu organizacji.

Maksymalna liczba agentów

Określ maksymalną liczbę agentów, którzy mogą być udostępniani jednocześnie w puli. Jeśli na przykład określisz wartość Maksymalna liczba agentów wynosząca 2, możesz uruchomić maksymalnie dwóch agentów w tym samym czasie. Jeśli kolejkowane są więcej niż dwa zadania, tylko dwóch agentów uruchamia zadania, podczas gdy pozostałe zadania czekają.

Bieżący stan i liczba aprowizowanych agentów w puli można wyświetlić przy użyciu okienka Agenci . Wszyscy pozostali agenci w widoku Agenci (z wyjątkiem agentów ze stanem Zwrócony) działają na maszynie wirtualnej i są liczeni do Maksymalna liczba agentów.

Portal Azure

Wartość Maksymalna agentów można skonfigurować w ustawieniach puli dla istniejącej puli oraz na karcie Podstawowe podczas tworzenia puli.

Szablon ARM

Wartość Maksymalna liczba agentów można skonfigurować przy użyciu maximumConcurrency właściwości .

W poniższym przykładzie wartość Maksymalna liczba agentów to 4.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "maximumConcurrency": 4
            }
        }
    ]
}

Interfejs wiersza polecenia platformy Azure

Wartość Maksymalna agentów można skonfigurować przy użyciu parametru maximum-concurrency podczas tworzenia lub aktualizowania puli.

W poniższym przykładzie wartość Maksymalna liczba agentów to 4.

az mdp pool create \
   --maximum-concurrency 4
   # other parameters omitted for space

Biceps

Wartość Maksymalna liczba agentów można skonfigurować przy użyciu maximumConcurrency właściwości .

W poniższym przykładzie wartość Maksymalna liczba agentów to 4.

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    ...
    maximumConcurrency: 4
  }
}

Uwaga

Wartość Maksymalna liczba agentów umożliwia skonfigurowanie maksymalnej liczby agentów, które można aprowizować w tym samym czasie, ale liczba samodzielnie hostowanych zadań równoległych w organizacji określa liczbę zadań, które mogą być uruchamiane współbieżnie. Upewnij się, że masz wystarczająco dużo samodzielnie hostowanych zadań równoległych w swojej organizacji, aby umożliwić agentom uruchamianie zadań. Aby uzyskać więcej informacji, zobacz Cennik zadań równoległych usług Azure DevOps Services.

Rozmiar agenta

Ustawienie Rozmiar agenta określa rozmiar maszyny wirtualnej platformy Azure , który ma być używany do hostowania agentów zarządzanych pul DevOps.

Portal Azure

Aby wyświetlić i wybrać rozmiar maszyny wirtualnej platformy Azure dostępny w regionie świadczenia usługi Azure, wybierz pozycję Zmień rozmiar. Rozmiary agentów (jednostki SKU) z dostępnymi przydziałami zarządzanych pul DevOps są oznaczone jako Dostępne. Możesz zażądać większego limitu przydziału dla jednostek SKU oznaczonych jako Niedostępne. Po zatwierdzeniu żądania limitu przydziału dla jednostki SKU niedostępnej jest ona oznaczona jako Dostępna. Dowiedz się więcej o limitach przydziałów zarządzanych pul DevOps.

Szablon ARM

Możesz skonfigurować rozmiar agenta, używając właściwości sku w sekcji fabricProfile. W poniższym przykładzie Standard_D2ads_v5 określono rozmiar maszyny wirtualnej.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    }
                }
            }
        }
    ]
}

Interfejs wiersza polecenia platformy Azure

Rozmiar agenta można skonfigurować przy użyciu sku właściwości w fabricProfile sekcji podczas tworzenia lub aktualizowania puli. W poniższym przykładzie Standard_D2ads_v5 określono rozmiar maszyny wirtualnej.

az mdp pool create \
   --fabric-profile fabric-profile.json
   # other parameters omitted for space

Poniższy przykład przedstawia sekcję sku pliku fabric-profile.json.

{
  "vmss": {
    "sku": {
      "name": "Standard_D2ads_v5"
    },
    "images": [...],
    "osProfile": {...},
    "storageProfile": {...}
  }
}

Biceps

Rozmiar agenta można skonfigurować, korzystając z właściwości sku w sekcji fabricProfile. W poniższym przykładzie Standard_D2ads_v5 określono rozmiar maszyny wirtualnej.

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    fabricProfile: {
      ...
      sku: {
        name: 'Standard_D2ads_v5'
      }
    }
  }
}

Jeśli twoja subskrypcja nie ma pojemności do skonfigurowania puli przy użyciu określonej jednostki SKU maszyny wirtualnej platformy Azure i maksymalnej liczby agentów, zostanie wyświetlony komunikat o błędzie podobny do następującego:

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.

Nie wszystkie jednostki SKU są obsługiwane we wszystkich regionach świadczenia usługi Azure. Jeśli wystąpi błąd, taki jak SKU family <sku-family> is not available in location <region>, upewnij się, że rozmiar jednostki SKU jest obsługiwany w Twoim regionie. Aby uzyskać więcej informacji, zobacz Rozmiary maszyn wirtualnych w Azure i Produkty dostępne według regionów.

Typ dysku systemu operacyjnego

Zarządzane pule DevOps oferują następujące typy dysków dla dysku systemu operacyjnego:

• Standard
• SSD w warstwie Standardowa
• SSD w warstwie Premium

Domyślny typ dysku systemu operacyjnego to Standardowa. Jeśli przepustowość Twojego obciążenia przekracza poziom warstwy standardowej, możesz potencjalnie poprawić wydajność obciążenia, przechodząc na bardziej wydajny typ dysku. Aby uzyskać więcej informacji na temat typów dysków i wydajności, zobacz Typy dysków zarządzanych platformy Azure.

Portal Azure

Typ dysku systemu operacyjnego można skonfigurować w ustawieniach puli dla istniejącej puli. Typ dysku systemu operacyjnego można skonfigurować na karcie Podstawy podczas tworzenia puli.

Szablon ARM

Typ dysku systemu operacyjnego można skonfigurować przy użyciu osDiskStorageAccountType właściwości w storageProfile sekcji . Wybierz Standard, StandardSSD, lub Premium.

W poniższym przykładzie określono typ dysku systemu operacyjnego Standardowy:

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "name": "fabrikam-managed-pool",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "eastus",
            "properties": {
                ...
                "storageProfile": {
                    "osDiskStorageAccountType": "Standard"
                }
            }
        }
    ]
}

Interfejs wiersza polecenia platformy Azure

Typ dysku systemu operacyjnego można skonfigurować przy użyciu osDiskStorageAccountType właściwości w storageProfile sekcji w parametrze fabric-profile .

Wybierz Standard, StandardSSD, lub Premium. W poniższym przykładzie określono Standardowy typ dysku systemu operacyjnego.

az mdp pool create \
   --fabric-profile fabric-profile.json
   # other parameters omitted for space

Poniższy przykład przedstawia sekcję storageProfile pliku fabric-profile.json.

{
  "vmss": {
    "sku": {...},
    "images": [...],
    "osProfile": {...},
    "storageProfile": {
      "osDiskStorageAccountType": "Standard",
      "dataDisks": []
    }
  }
}

Biceps

Typ dysku systemu operacyjnego można skonfigurować przy użyciu osDiskStorageAccountType właściwości w storageProfile sekcji .

Wybierz Standard, StandardSSD, lub Premium. W poniższym przykładzie określono Standardowy typ dysku systemu operacyjnego.

resource managedDevOpsPools 'Microsoft.DevOpsInfrastructure/pools@2025-09-20' = {
  name: 'fabrikam-managed-pool'
  location: 'eastus'
  properties: {
    fabricProfile: {
      ...
      storageProfile: {
        osDiskStorageAccountType: 'Standard'
      }
    }
  }
}

Obrazy

Zarządzane pule DevOps udostępnia kilka opcji obrazu maszyny wirtualnej do uruchamiania potoków w puli. Pulę można utworzyć przy użyciu wybranych obrazów maszyn wirtualnych z Azure Marketplace, własnych obrazów niestandardowych w Azure Compute Gallery lub z tych samych obrazów systemu Windows i Linux, które są wykorzystywane przez agentów hostowanych przez Microsoft w usłudze Azure Pipelines.

Ważny

Zarządzane pule DevOps oferują teraz obrazy usługi Azure Pipelines w wersji 2. generacji, a oryginalne obrazy usługi Azure Pipelines 1. generacji nie otrzymują już aktualizacji.

Zarządzane Pule DevOps zalecają migrację pul, które używają oryginalnych wersji obrazów Azure Pipelines generacji 1, do wersji generacji 2. Aby uzyskać więcej informacji, zobacz Obrazy generacji 2 usługi Azure Pipelines.

Uwaga

Następujące obrazy są przestarzałe i zostały usunięte.

• Azure Pipelines — Windows Server 2019
• Ubuntu 20.04

Aby uzyskać więcej informacji, zobacz Harmonogram wycofywania obrazów zarządzanych pul DevOps.

Możesz skonfigurować pulę tak, aby korzystała z jednego obrazu lub wielu obrazów. Możesz również użyć aliasów, aby skonfigurować potoki do używania określonego obrazu. Aby uzyskać więcej informacji, zobacz Konfigurowanie obrazów zarządzanych pul DevOps.

Ważny

Jeśli masz wiele obrazów w puli i nie używasz wymagań w przepływach pracy do wyznaczenia obrazu, przepływy pracy są uruchamiane z użyciem pierwszego z listy w puli. Możesz zmienić kolejność obrazów w puli w następujący sposób:

• Użyj szablonów: zmień kolejność obrazów na images liście w fabricProfile sekcji .
• Użyj przeciągania: układaj obrazy na liście obrazów w portalu Azure.

Treści powiązane

• Konfigurowanie obrazów