Skapa och hantera anpassade platser på Azure Arc-aktiverade Kubernetes

2025-07-21

Funktionen för anpassade platser är ett sätt att konfigurera dina Azure Arc-aktiverade Kubernetes-kluster som målplatser för att distribuera instanser av Azure-erbjudanden. Exempel på Azure-erbjudanden som kan distribueras ovanpå anpassade platser är databaser, till exempel SQL Managed Instance som aktiveras av Azure Arc eller programinstanser, till exempel Container Apps, Logic Apps, Event Grid, Logic Apps och API Management.

En anpassad plats har en en-till-en-mappning till ett namnområde i Azure Arc-aktiverade Kubernetes-kluster. Azure-resursen för anpassad plats i kombination med rollbaserad åtkomstkontroll i Azure (Azure RBAC) kan användas för att ge detaljerade behörigheter till programutvecklare eller databasadministratörer, vilket gör det möjligt för dem att distribuera resurser som databaser eller programinstanser ovanpå Arc-aktiverade Kubernetes-kluster i en miljö med flera klientorganisationer.

I den här artikeln får du lära dig hur du aktiverar anpassade platser i ett Arc-aktiverat Kubernetes-kluster och hur du skapar en anpassad plats.

Förutsättningar

Installera eller uppgradera Azure CLI till den senaste versionen.
Installera de senaste versionerna av följande Azure CLI-tillägg:
- connectedk8s
- k8s-extension
- customlocation
```
az extension add --name connectedk8s
az extension add --name k8s-extension
az extension add --name customlocation
```
  Om du redan har installerat tilläggen connectedk8s, k8s-extensionoch customlocation uppdaterar du till den senaste versionen med hjälp av följande kommando:
```
az extension update --name connectedk8s
az extension update --name k8s-extension
az extension update --name customlocation
```
Verifiera slutförd providerregistrering för Microsoft.ExtendedLocation.
1. Ange följande kommandon:
```
az provider register --namespace Microsoft.ExtendedLocation
```
2. Övervaka registreringsprocessen. Registreringen kan ta upp till 10 minuter.
```
az provider show -n Microsoft.ExtendedLocation -o table
```
  När det har registrerats RegistrationState har tillståndet värdet Registered.
Kontrollera att du har ett befintligt Azure Arc-aktiverat Kubernetes-anslutet kluster och uppgradera dina agenter till den senaste versionen. Bekräfta att den dator där du ska köra kommandona som beskrivs i den här artikeln har en kubeconfig fil som pekar på det här klustret.

Aktivera anpassade platser i klustret

Viktigt!

Funktionen för anpassade platser är beroende av funktionen för klusteranslutning . Båda funktionerna måste vara aktiverade i klustret för att anpassade platser ska fungera.

OID (Custom Location Object ID) krävs för att aktivera anpassad plats. Om ditt användarkonto har de behörigheter som krävs hämtas OID automatiskt under funktionsaktivering. Om du inte har ett giltigt användarkonto används den manuellt skickade OID:en, men OID:en kan inte verifieras. Om OID är ogiltig kanske den anpassade platsen inte är korrekt aktiverad.

Funktionen anpassade platser måste vara aktiverad innan du skapar anpassade platser, eftersom aktiveringen ger de behörigheter som krävs för att skapa namnområdet för anpassade platser i Kubernetes-klustret.

Aktivera anpassade platser som Microsoft Entra-användare

Logga in på Azure CLI som en Microsoft Entra-användare och kör följande kommando:

az connectedk8s enable-features -n <clusterName> -g <resourceGroupName> --features cluster-connect custom-locations

Aktivera anpassade platser med tjänstens huvudnamn

Hämta den anpassade plats-OID:en manuellt genom att följa dessa steg.

Viktigt!

Kopiera och kör kommandot i steg 2 exakt som det visas. Ersätt inte värdet som skickades till parametern --id med ett annat värde.

Logga in på Azure CLI som Microsoft Entra-användare.
Kör följande kommando för att hämta den anpassade platsen oid (objekt-ID), där --id refererar till själva custom location service-appen och är fördefinierad och inställd på bc313c14-388c-4e7d-a58e-70017303ee3b:
```
az ad sp show --id bc313c14-388c-4e7d-a58e-70017303ee3b --query id -o tsv
```
Logga in på Azure CLI med tjänstens huvudnamn. Kör följande kommando för att aktivera funktionen anpassade platser i klustret med hjälp av oid värdet (objekt-ID) från föregående steg för parametern --custom-locations-oid :
```
az connectedk8s enable-features -n <cluster-name> -g <resource-group-name> --custom-locations-oid <cl-oid> --features cluster-connect custom-locations
```

Skapa anpassad plats

Distribuera klustertillägget för Azure-tjänsten för Azure-tjänstinstansen som du vill installera i klustret:
- Azure Arc-aktiverade datatjänster
  
  Kommentar
  
  Utgående proxy utan autentisering och utgående proxy med grundläggande autentisering stöds av Azure Arc-aktiverade klustertillägget för datatjänster. Utgående proxy som använder betrodda certifikat stöds för närvarande inte.
- Azure Container Apps i Azure Arc
- Event Grid på Kubernetes
Hämta Azure Resource Manager-identifieraren för det Azure Arc-aktiverade Kubernetes-klustret som i de senare stegen kallas connectedClusterId:
```
az connectedk8s show -n <clusterName> -g <resourceGroupName>  --query id -o tsv
```
Hämta Azure Resource Manager-identifieraren för klustertillägget som du distribuerade till Det Azure Arc-aktiverade Kubernetes-klustret, som i senare steg refereras till som extensionId:
```
az k8s-extension show --name <extensionInstanceName> --cluster-type connectedClusters -c <clusterName> -g <resourceGroupName>  --query id -o tsv
```

Skapa den anpassade platsen genom att referera till Det Azure Arc-aktiverade Kubernetes-klustret och tillägget:

az customlocation create -n <customLocationName> -g <resourceGroupName> --namespace <name of namespace> --host-resource-id <connectedClusterId> --cluster-extension-ids <extensionId>

Obligatoriska parametrar:

Parameternamn	beskrivning
`--name, --n`	Namnet på den anpassade platsen.
`--resource-group, --g`	Resursgrupp för den anpassade platsen.
`--namespace`	Namnområde i klustret som är bundet till den anpassade plats som skapas.
`--host-resource-id`	Azure Resource Manager-identifierare för Det Azure Arc-aktiverade Kubernetes-klustret (anslutet kluster).
`--cluster-extension-ids`	Azure Resource Manager-identifierare för en instans av klustertillägget som är installerad i det anslutna klustret. För flera tillägg anger du en utrymmesavgränsad lista över klustertilläggs-ID:t

Valfria parametrar:

Parameternamn	beskrivning
`--location, --l`	Platsen för den anpassade platsens Azure Resource Manager-resurs i Azure. Om det inte anges används platsen för det anslutna klustret.
`--tags`	Blankstegsavgränsad lista med taggar i formatet `key[=value]`. Använd "" för att rensa befintliga taggar.
`--kubeconfig`	Administratör `kubeconfig` för kluster.

Bekräfta att den anpassade platsen har aktiverats genom att köra följande kommando och kontrollera att ProvisioningState är Succeeded:

az customlocation show -n <customLocationName> -g <resourceGroupName>

Kontrollera användningen av en anpassad plats

Om du vill ta reda på om en anpassad plats aktivt används av andra Azure-resurser kan du lista de resurstyper som är aktiverade för den med hjälp av Azure CLI.

az customlocation list-enabled-resource-types -n <customLocationName> -g <resourceGroupName>

Det här kommandot returnerar en lista över Azure-resurstyper som har konfigurerats för att använda den angivna anpassade platsen. Om listan inte är tom anger den att den anpassade platsen för närvarande används av dessa resurstyper.

Exempel på utdata:

[
  {
    "resourceType": "Microsoft.App/containerApps"
  },
  {
    "resourceType": "Microsoft.Data/sqlManagedInstances"
  }
]

Visa information om en anpassad plats

Om du vill visa information om en anpassad plats använder du följande kommando:

az customlocation show -n <customLocationName> -g <resourceGroupName>

Visa en lista över anpassade platser

Om du vill visa en lista över alla anpassade platser i en resursgrupp använder du följande kommando:

az customlocation list -g <resourceGroupName>

Uppdatera en anpassad plats

update Använd kommandot för att lägga till nya värden för --tags eller associera nya --cluster-extension-ids till den anpassade platsen, samtidigt som du behåller befintliga värden för taggar och associerade klustertillägg.

az customlocation update -n <customLocationName> -g <resourceGroupName> --namespace <name of namespace> --host-resource-id <connectedClusterId> --cluster-extension-ids <extensionIds>

Korrigera en anpassad plats

patch Använd kommandot för att ersätta befintliga värden för --cluster-extension-ids eller --tags. Tidigare värden behålls inte.

az customlocation patch -n <customLocationName> -g <resourceGroupName> --namespace <name of namespace> --host-resource-id <connectedClusterId> --cluster-extension-ids <extensionIds>

Ta bort en anpassad plats

Om du vill ta bort en anpassad plats använder du följande kommando:

az customlocation delete -n <customLocationName> -g <resourceGroupName>

Felsökning

Du kan stöta på ett fel som innehåller: TypeError: get_login_credentials() got an unexpected keyword argument 'resource'. Azure CLI v2.70.0 inkluderade en icke-bakåtkompatibel ändring som utlöser det här felet. En korrigering finns i az customlocation v0.1.4 för kompatibilitet med Azure CLI v2.70.0 och senare.

Om du vill använda en lägre version av az customlocationmåste du också använda Azure CLI version 2.69.0 eller tidigare. Om du använde Installationsprogrammet för Azure CLI kan du avinstallera den aktuella versionen och installera Azure CLI v2.69.0 från Azure CLI installation page. Om du använde pip-installationsprogrammet kan du köra följande kommando för att nedgradera: pip install azure-cli==2.69.0. Vi rekommenderar dock vanligtvis att du använder den senaste versionen av az customlocation och Azure CLI.

Okänt proxyfel

Om det inte går att skapa en anpassad plats med felet Unknown proxy error occurredändrar du nätverksprincipen så att intern kommunikation mellan poddar tillåts i azure-arc namnområdet. Se till att även lägga till azure-arc namnområdet som en del av listan över undantag utan proxy för din konfigurerade princip.

Varning för tjänstens huvudnamn

Om du försöker aktivera anpassad plats när du är inloggad i Azure CLI med hjälp av ett huvudnamn för tjänsten kan du se följande varning:

Unable to fetch oid of 'custom-locations' app. Proceeding without enabling the feature. Insufficient privileges to complete the operation.

Den här varningen beror på att tjänstens huvudnamn saknar de behörigheter som krävs för att hämta oid (objekt-ID) för den anpassade plats som används av Azure Arc-tjänsten. Följ anvisningarna för att aktivera funktionen för anpassad plats med hjälp av tjänstens huvudnamn.

Resursprovidern har inte nödvändiga behörigheter

Om du försöker skapa den anpassade platsen innan funktionen för anpassad plats är aktiverad i Kubernetes-klustret kan du få följande felmeddelande:

Deployment failed. Correlation ID: ... "Microsoft.ExtendedLocation" resource provider does not have the required permissions to create a namespace on the cluster. Refer to https://aka.ms/ArcK8sCustomLocationsDocsEnableFeature to provide the required permissions to the resource provider.

Aktivera först funktionen för anpassad plats i klustret. När funktionen har aktiverats kan du följa stegen för att skapa den anpassade platsen.

Nästa steg

Anslut på ett säkert sätt till klustret med hjälp av funktionen för klusteranslutning .
Fortsätt med Azure Container Apps i Azure Arc för instruktioner från slutpunkt till slutpunkt om hur du installerar tillägg, skapar anpassade platser och skapar den anslutna Azure Container Apps-miljön.
Läs mer om tillgängliga Azure Arc-aktiverade Kubernetes-tillägg.

Feedback

Var den här sidan till hjälp?