Konfigurera säkerhetsinställningar för hanterade DevOps-pooler

Som standard konfigureras Hanterade DevOps-pooler för användning med en enda Azure DevOps-organisation som du anger när du skapar poolen. När din pool har konfigurerats för en enskild organisation visas och konfigureras organisationsnamnet i Poolinställningar

Som standard är Lägg till pool i alla projekt inställt på Ja, och åtkomst till den hanterade DevOps-poolen beviljas till alla projekt i organisationen. Välj Nej om du vill ange en lista över projekt för att begränsa vilka projekt i din organisation som kan använda poolen.

Organisationer konfigureras i organizationProfile egenskapen för resursen Hanterade DevOps-pooler.

{
    "$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-04-04-preview",
            "location": "eastus",
            "properties": {
            ...
            "organizationProfile": {
                "organizations": [
                    {
                        "url": "https://dev.azure.com/fabrikam-tailspin",
                        "projects": [],
                        "parallelism": 4
                    }
                ],
                "permissionProfile": {
                    "kind": "CreatorOnly"
                },
                "kind": "AzureDevOps"
            }
        }
    ]
}

Avsnittet organizationProfile har följande egenskaper.

Organisationer konfigureras i parametern organization-profile när du skapar eller uppdaterar en pool.

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

I följande exempel visas ett organization-profile objekt som har konfigurerats för alla projekt i fabrikam-tailspin organisationen med parallelism inställt på 1.

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

Avsnittet organizationProfile har följande egenskaper.

Aktivera Använd pool i flera organisationer för att använda din pool med flera Azure DevOps-organisationer. För varje organisation anger du de projekt som tillåts använda poolen eller lämnar tomma för att tillåta alla projekt. Konfigurera parallelliteten för varje organisation genom att ange vilka delar av samtidigheten som anges av Maximalt antal agenter för poolen för att allokera till varje organisation. Summan av parallelliteten för alla organisationer måste vara lika med poolens maximala samtidighet. Om maximalt antal agenter till exempel är inställt på fem måste summan av parallelliteten för de angivna organisationerna vara fem. Om Maximalt antal agenter är inställt på en kan du bara använda poolen med en organisation.

I följande exempel är poolen konfigurerad för att vara tillgänglig för fabrikamResearch - och FabrikamTest-projekten i fabrikam-tailspin-organisationen och för alla projekt i den fabrikamblå organisationen.

Om du får ett fel som The sum of parallelism for all organizations must equal the max concurrency.kontrollerar du att maximalt antal agenter för poolen matchar summan av kolumnen Parallellitet .

Lägg till ytterligare organisationer i organisationslistan för att konfigurera poolen för användning med flera organisationer. I följande exempel har två organisationer konfigurerats. Den första organisationen är konfigurerad för att använda Hanterade DevOps-pooler för alla projekt, och den andra organisationen är begränsad till två projekt. I det här exemplet är inställningen för maximala agenter för poolen fyra och varje organisation kan använda två av dessa fyra agenter.

"organizationProfile": {
    "organizations": [
        {
            "url": "https://dev.azure.com/fabrikam-tailspin",
            "projects": [],
            "parallelism": 2
        },
        {
            "url": "https://dev.azure.com/fabrikam-prime",
            "projects": [ "fabrikam-dev", "fabrikam-test" ],
            "parallelism": 2
        }
    ],
    "permissionProfile": {
        "kind": "CreatorOnly"
    },
    "kind": "AzureDevOps"
}

Organisationer konfigureras i parametern organization-profile när du skapar eller uppdaterar en pool.

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

Lägg till ytterligare organisationer i organisationslistan för att konfigurera poolen för användning med flera organisationer. I följande exempel har två organisationer konfigurerats. Den första organisationen är konfigurerad för att använda Hanterade DevOps-pooler för alla projekt, och den andra organisationen är begränsad till två projekt. I det här exemplet är inställningen för maximala agenter för poolen fyra och varje organisation kan använda två av dessa fyra agenter.

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

Interaktivt läge konfigureras i osProfile avsnittet i fabricProfile egenskapen. Ange logonType till Interactive för att aktivera interaktivt läge eller Service för att inaktivera interaktivt läge.

{
    "$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-04-04-preview",
            "location": "eastus",
            "properties": {
            ...
            "fabricProfile": {
                "sku": {...},
                "images": [...],
                "osProfile": {
                    "secretsManagementSettings": {...},
                    "logonType": "Interactive"
                },
                "storageProfile": {...},
                "kind": "Vmss"
            }
        }
    ]
}

Interaktivt läge konfigureras med egenskapen logonType i osProfile avsnittet i parametern fabric-profile när du skapar eller uppdaterar en pool.

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

I följande exempel visas avsnittet osProfile i filen fabric-profile.json med Interactive läget aktiverat.

{
  "vmss": {
    "sku": {...},
    "images": [...],
    "osProfile": {
      "secretsManagementSettings": {...},
      "logonType": "Interactive"
    },
    "storageProfile": {...}
  }
}

• Endast skapare – Användaren som skapade den hanterade DevOps-poolen läggs till som administratör för Azure DevOps-agentpoolen och Arv är inställt på Av i säkerhetsinställningarna för agentpoolen. Skapare är bara standardinställningen.
• Ärv behörigheter från projektet – Användaren som skapade den hanterade DevOps-poolen läggs till som administratör för Azure DevOps-agentpoolen och Arv är inställt på På i säkerhetsinställningarna för agentpoolen.
• Specifika konton – Ange vilka konton som ska läggas till som administratörer för den skapade agentpoolen i Azure DevOps. Som standard läggs skaparen av Managed DevOps-poolen till i listan.

Behörigheter för pooladministration konfigureras i egenskapen för permissionsProfile avsnittet för resursen organizationProfile Hanterade DevOps-pooler.

{
"organizationProfile": {
    "organizations": [...],
    "permissionProfile": {
        "kind": "CreatorOnly"
    },
    "kind": "AzureDevOps"
}

Egenskapen permissionProfile kan endast anges när poolen skapas. Tillåtna värden är Inherit, CreatorOnlyoch SpecificAccounts.

• CreatorOnly– Användaren som skapade den hanterade DevOps-poolen läggs till som administratör för Azure DevOps-agentpoolen och Arv är inställt på Av i säkerhetsinställningarna för agentpoolen. Skapare är bara standardinställningen.

• Inherit– Användaren som skapade den hanterade DevOps-poolen läggs till som administratör för Azure DevOps-agentpoolen och Arv är inställt på På i säkerhetsinställningarna för agentpoolen.

• SpecificAccounts – Ange de konton som ska läggas till som administratörer för den skapade agentpoolen i Azure DevOps. Som standard läggs skaparen av Managed DevOps-poolen till i listan. Ange en enda e-postadress eller en lista med e-postadresser för users egenskapen. Annars utelämnar du users.

  {
  "organizationProfile": {
       "organizations": [...],
       "permissionProfile": {
           "kind": "SpecificAccounts",
           "users" : ["User1@fabrikam.com", "User2@fabrikam.com" ]
       },
       "kind": "AzureDevOps"
    }
  

Behörigheter för pooladministration konfigureras i parametern organization-profile när du skaparen pool.

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

{
  "AzureDevOps":
  {
    "organizations":  [...],
    "permissionProfile": {
        "kind": "CreatorOnly"
    }
  }
}

Egenskapen permissionProfile kan endast anges när poolen skapas. Tillåtna värden är Inherit, CreatorOnlyoch SpecificAccounts.

• CreatorOnly– Användaren som skapade den hanterade DevOps-poolen läggs till som administratör för Azure DevOps-agentpoolen och Arv är inställt på Av i säkerhetsinställningarna för agentpoolen. Skapare är bara standardinställningen.

• Inherit– Användaren som skapade den hanterade DevOps-poolen läggs till som administratör för Azure DevOps-agentpoolen och Arv är inställt på På i säkerhetsinställningarna för agentpoolen.

• SpecificAccounts – Ange de konton som ska läggas till som administratörer för den skapade agentpoolen i Azure DevOps. Som standard läggs skaparen av Managed DevOps-poolen till i listan. Ange en enda e-postadress eller en lista med e-postadresser för users egenskapen. Annars utelämnar du users.

    {
        "AzureDevOps" : {
            "organizationProfile": {
            "organizations": [...],
            "permissionProfile": {
            "kind": "SpecificAccounts",
            "users" : ["User1@fabrikam.com", "User2@fabrikam.com" ]
            }
        }
    }