Configurer les paramètres du pool

Cet article explique comment configurer les paramètres de base de votre pool DevOps managé.

Accédez à Vue d’ensemble pour afficher une vue d’ensemble des paramètres du pool, déplacer des ressources Azure vers un nouveau groupe de ressources ou un nouvel abonnement, ou configurer des balises. Les pools DevOps managés passent jusqu’à 20 balises à la machine virtuelle, et le reste est ignoré.

Pour configurer votre pool, accédez au pool de paramètres>.

Utilisez les paramètres suivants pour configurer votre pool DevOps managé.

• projet Centre de développement
• Organisation Azure DevOps
• Images
• Nombre maximal d’agents
• Taille de l’agent
• Type de disque du système d’exploitation

projet Centre de développement

Azure portal

Choisissez le projet Centre de développement pour votre pool DevOps managé. Lors de la création du pool, vous pouvez créer un projet Centre de développement et Centre de développement si vous n’en avez pas.

Modèle ARM

Le projet du centre de développement est spécifié par la devCenterProjectResourceId propriété.

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

Vous pouvez récupérer le devCenterProjectResourceId projet de votre Centre de développement dans le Portail Azure à l’aide de l’affichage JSON à partir de la page vue d’ensemble de votre projet Centre de développement, ou vous pouvez le récupérer à l’aide d’Azure CLI pour interroger le projet pour sa id propriété. Dans l’exemple suivant, il devCenterProjectResourceId est récupéré à partir d’un projet Centre de développement nommé fabrikam-dev-center-project dans le fabrikam-managed-devops-pools groupe de ressources.

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

Azure CLI

Le projet du centre de développement est spécifié par le paramètre lors de la création ou de la devcenter-project-id mise à jour d’un pool.

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

Vous pouvez récupérer le devcenter-project-id projet de centre de développement dans l’Portail Azure à l’aide de la vue JSON à partir de la page vue d’ensemble de votre projet du centre de développement, ou vous pouvez le récupérer à l’aide d’Azure CLI pour interroger le projet pour sa id propriété. Dans l’exemple suivant, le fichier devcenter-project-id est récupéré à partir d’un projet du centre de développement nommé fabrikam-dev-center-project dans le fabrikam-managed-devops-pools groupe de ressources.

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

Organisation Azure DevOps

Azure portal

Si votre pool DevOps managé est configuré pour une seule organisation Azure DevOps, vous pouvez spécifier l’organisation dans les paramètres du pool.

Si votre pool est configuré pour plusieurs organisations, le paramètre d’organisation Azure DevOps n’est pas présent dans les paramètres du pool. Pour configurer votre pool à utiliser dans plusieurs organisations, accédez à Sécurité des paramètres>et configurez Utiliser un pool dans plusieurs organisations.

Modèle ARM

L’organisation Azure DevOps est configurée à l’aide de la organizations liste dans la organizationProfile section. Dans l’exemple suivant, un pool DevOps managé est configuré pour tous les projets d’une seule organisation, avec un parallélisme de 4. Pour obtenir un exemple de configuration de plusieurs organisations, consultez Utiliser un pool dans plusieurs organisations.

{
    "$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": "2024-10-19",
            "location": "eastus",
            "properties": {
                ...
                "organizationProfile": {
                    "organizations": [
                        {
                            "url": "https://dev.azure.com/fabrikam-tailspin",
                            "projects": [],
                            "parallelism": 4
                        }
                    ]
                }
            }
        }
    ]
}

Azure CLI

L’organisation Azure DevOps est configurée à l’aide de la organizations liste dans le organization-profile paramètre. Dans l’exemple suivant, un pool DevOps managé est configuré pour tous les projets d’une seule organisation, avec un parallélisme de 4. Pour obtenir un exemple de configuration de plusieurs organisations, consultez Utiliser un pool dans plusieurs organisations.

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

L’exemple suivant montre la organizations liste dans le fichier organization-profile.json .

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

Par défaut, votre pool DevOps géré est disponible pour tous les projets de vos organisations spécifiées. Pour limiter votre pool à des projets spécifiques, consultez Paramètres de sécurité : configurer l’accès de l’organisation.

Nombre maximal d’agents

Spécifiez le nombre maximal d’agents disponibles pour une utilisation dans votre pool. Par exemple, si vous spécifiez une valeur maximale d’agents de 2, vous pouvez exécuter un maximum de deux agents en même temps. Si plus de deux travaux sont mis en file d’attente, seuls deux agents à la fois exécutent des travaux pendant que les autres travaux attendent.

Azure portal

Le nombre maximal d’agents est configuré dans les paramètres du pool pour un pool existant, et sous l’onglet Informations de base lors de la création d’un pool.

Modèle ARM

Le nombre maximal d’agents est configuré à l’aide de la maximumConcurrency propriété. Dans l’exemple suivant, les agents maximum sont définis sur 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": "2024-10-19",
            "location": "eastus",
            "properties": {
                ...
                "maximumConcurrency": 4
            }
        }
    ]
}

Azure CLI

Le nombre maximal d’agents est configuré à l’aide du paramètre lors de la création ou de la maximum-concurrency mise à jour d’un pool. Dans l’exemple suivant, les agents maximum sont définis sur 4.

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

Remarque

Les agents maximum configurent le nombre maximal d’agents pouvant être provisionnés en même temps, mais le nombre de travaux parallèles auto-hébergés de votre organisation spécifie le nombre de travaux pouvant s’exécuter simultanément. Vérifiez que vous disposez de suffisamment de travaux parallèles auto-hébergés dans votre organisation pour permettre à vos agents d’exécuter des travaux. Pour plus d’informations, consultez la tarification des travaux parallèles Azure DevOps Services.

Taille de l’agent

La taille de l’agent spécifie la taille de machine virtuelle Azure à utiliser pour héberger vos agents de pools DevOps managés.

Azure portal

Choisissez Modifier la taille pour afficher et sélectionner une taille de machine virtuelle Azure disponible dans votre région Azure. Les tailles d’agent (SKU) avec des quotas de pools DevOps managés disponibles sont marquées comme disponibles. Vous pouvez demander davantage de quotas pour les références SKU non disponibles . Une fois qu’une demande de quota pour une référence SKU non disponible est approuvée, elle est alors répertoriée comme Disponible. En savoir plus sur les quotas de pools DevOps managés.

Modèle ARM

La taille de l’agent est configurée à l’aide de la sku propriété dans la fabricProfile section. Dans l’exemple suivant, une taille de machine virtuelle Standard_D2ads_v5 est spécifiée.

{
    "$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": "2024-10-19",
            "location": "eastus",
            "properties": {
                ...
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    }
                }
            }
        }
    ]
}

Azure CLI

La taille de l’agent est configurée à l’aide de la sku propriété dans la section lors de la création ou de la fabricProfile mise à jour d’un pool. Dans l’exemple suivant, une taille de machine virtuelle Standard_D2ads_v5 est spécifiée.

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

L’exemple suivant montre la sku section du fichier fabric-profile.json .

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

Si votre abonnement n’a pas la capacité de configurer votre pool avec la référence SKU de machine virtuelle Azure souhaitée et le nombre maximal d’agents, vous recevrez une erreur similaire au message suivant. 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. Pour résoudre le problème, consultez Passer en revue les quotas de pools DevOps gérés.

Toutes les SKU ne sont pas prises en charge dans toutes les régions Azure. Si vous recevez une erreur similaire à SKU family <sku-family> is not available in location <region>, vérifiez que votre taille de référence SKU est prise en charge pour votre région. Pour plus d’informations, consultez Tailles des machines virtuelles dans Azure et Produits disponibles par région.

Type de disque du système d’exploitation

Les pools DevOps managés fournissent les types de disques suivants pour le disque du système d’exploitation.

• Standard
• SSD Standard
• SSD Premium

Le type de disque de système d’exploitation par défaut est Standard. Si le débit de votre charge de travail dépasse le niveau standard, vous pouvez potentiellement bénéficier d’une amélioration des performances de votre charge de travail en effectuant une mise à niveau vers un type de disque plus performant. Pour plus d’informations sur les types de disques et les performances, consultez Types de disques managés Azure.

Azure portal

Le type de disque du système d’exploitation est configuré dans les paramètres du pool pour un pool existant, et sous l’onglet Informations de base lors de la création d’un pool.

Modèle ARM

Le type de disque du système d’exploitation est configuré à l’aide de la osDiskStorageAccountType propriété de la storageProfile section. Dans l’exemple suivant, un type de disque de système d’exploitation standard est spécifié. Choisissez Standard, StandardSSD ou Premium.

{
    "$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": "2024-10-19",
            "location": "eastus",
            "properties": {
                ...
                "storageProfile": {
                    "osDiskStorageAccountType": "Standard"
                }
            }
        }
    ]
}

Azure CLI

Dans l’exemple suivant, un type de disque de système d’exploitation standard est spécifié. Choisissez Standard, StandardSSD ou Premium.

Le type de disque du système d’exploitation est configuré à l’aide de la osDiskStorageAccountType propriété de la storageProfile section du fabric-profile paramètre. Dans l’exemple suivant, un type de disque de système d’exploitation standard est spécifié. Choisissez Standard, StandardSSD ou Premium.

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

L’exemple suivant montre la storageProfile section du fichier fabric-profile.json .

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

Images

Les pools DevOps managés vous offrent plusieurs options pour les images de machine virtuelle pour l’exécution de pipelines dans votre pool. Vous pouvez créer votre pool à l’aide d’images de machine virtuelle sélectionnées Place de marché Azure, utiliser vos propres images personnalisées dans une galerie de calcul Azure ou utiliser les mêmes images Windows et Linux utilisées par les agents hébergés par Microsoft Azure Pipelines.

Vous pouvez configurer votre pool pour utiliser une seule image ou plusieurs images, et utiliser des alias pour configurer vos pipelines afin d’utiliser une image spécifique. Pour plus d’informations, consultez Configurer des images de pools DevOps managés.

Voir aussi

• Configurer des images