Dela via


Tjänstens huvudnamn saknas eller är ogiltigt när ett AKS-kluster skapas

I den här artikeln beskrivs hur du felsöker ett tjänsthuvudnamn som inte hittas eller är ogiltigt när du försöker skapa ett AkS-kluster (Microsoft Azure Kubernetes Service).

Förutsättningar

Använd Azure CLI version 2.0.81 eller senare för att köra kommandona i den här artikeln.

Orsak

När du skapar ett AKS-kluster kräver AKS ett huvudnamn för tjänsten eller en hanterad identitet för att hantera resurser åt dig. Som standard använder AKS en systemtilldelad hanterad identitet. Om du föredrar att använda tjänstens huvudnamn i stället bör du vara medveten om att AKS inte automatiskt skapar ett åt dig. Du måste ange ett eget huvudnamn för tjänsten och referera till det när klustret skapas. Mer information finns i Använda tjänstens huvudnamn med Azure Kubernetes Service (AKS).

Även om tjänstens huvudnamn stöds för AKS-autentisering rekommenderar vi att du använder en systemtilldelad hanterad identitet. Den här identiteten kan förenkla autentiseringshanteringen och är standardalternativet för nya kluster.

När du skapar ett huvudnamn för tjänsten ska du dessutom se till att det sprids över alla regioner av Microsoft Entra-ID. Om den här spridningen tar för lång tid kan klustret misslyckas med valideringen eftersom AKS inte kan hitta tjänstens huvudnamn.

Lösning

Kontrollera att det finns ett giltigt, sökbart huvudnamn för tjänsten. Gör detta genom att använda någon av följande metoder:

  • När du skapar ett AKS-kluster bör du överväga att använda ett befintligt huvudnamn för tjänsten som redan har spridits mellan regioner. Även om det inte finns något direkt sätt att verifiera spridningsstatusen kan du verifiera funktionen med hjälp av ett tidigare distribuerat huvudnamn för tjänsten. Om du använder ett nytt huvudnamn kan du också tillåta 5–10 minuter innan du börjar skapa klustret.

  • Kontrollera att tjänstens huvudnamn är klart genom att köra az ad sp show --id <appId> kommandot och kontrollera utdata innan du fortsätter med skapandet av AKS-klustret.

  • Om du använder automationsskript lägger du till tidsfördröjningar mellan skapande av tjänstens huvudnamn och skapande av AKS-kluster. Vi rekommenderar en fördröjning på 5 till 10 minuter.

  • Om du använder Azure Portal återgår du till klusterinställningarna när du har försökt skapa klustret och försöker sedan verifiera sidan igen efter några minuter.

Kontakta oss för att få hjälp

Om du har frågor eller behöver hjälp skapar du en supportförfrågan eller frågar Azure community support. Du kan också skicka produktfeedback till Azure-feedbackcommunityn.