Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Distribution och hantering av Kubernetes-program kräver vanligtvis att YAML-manifest skrivs, kubectl-kommandon körs och att du växlar mellan flera verktyg. AKS Desktop tar bort den här komplexiteten med guidade arbetsflöden som gör att utvecklare och DevOps-tekniker kan distribuera, övervaka, felsöka och rensa program utan djup Kubernetes-expertis.
Den här guiden vägleder dig genom att distribuera ett TypeScript-program med hjälp av AKS Desktop, från att skapa ett kluster genom att utforska programloggar, mått, skalning och inbyggda felsökningsverktyg.
Förutsättningar
- Ett Azure-abonnemang. Om du inte har en Azure-prenumeration kan du skapa ett kostnadsfritt Azure-konto.
- Azure CLI version 2.64.0 eller senare måste installeras. Kontrollera din version med hjälp av
az --versionkommandot . Information om hur du installerar eller uppgraderar finns i Installera Azure CLI. - Azure CLI-tillägget
aks-preview. Installera den med kommandotaz extension add --name aks-preview. - AKS Desktop installerad. AKS Desktop stöder följande operativsystem (OS): Windows, Linux och Mac.
- Om du använder ett befintligt kluster måste klustret vara Microsoft Entra-ID autentiserat. För att säkerställa att klustret är Microsoft Entra-ID autentiserat använder du ett AKS-automatiskt kluster. Du behöver även rbac-klusteradministratörsrollen för Azure Kubernetes Service eller motsvarande behörigheter för målklustret.
Skapa Azure-resurser
Om du inte har något befintligt AKS-kluster och Azure Container Registry (ACR) kan du skapa dem med hjälp av Azure CLI. De här avsnitten visar hur du skapar en ny resursgrupp, AKS-kluster och ACR. Om du redan har dessa resurser kan du gå vidare till Registrera klustret med AKS Desktop.
Ange miljövariabler
För att förenkla kommandona anger du följande miljövariabler i terminalen. Se till att ange myLocation till din Azure-region. Exemplet här används RAND för att skapa unika resursnamn. Du kan ersätta dessa med dina egna värden om du vill.
RAND=$RANDOM
export RAND
echo "Random resource identifier will be: ${RAND}"
myResourceGroup=bbash$RAND
myLocation=westus3
myClusterName=clu-$RAND
registryName=bbashreg$RAND
Skapa en resursgrupp
Skapa en Azure resursgrupp med kommandot az group create.
az group create --name $myResourceGroup --location $myLocation
Skapa ett Azure-containerregister
Skapa ett Azure-containerregister med kommandot az acr create .
az acr create --resource-group $myResourceGroup --name $registryName --sku Basic
Skapa ett AKS-kluster med ACR-integrering
Skapa ett AKS-kluster med ACR-integrering med hjälp av az aks create kommandot . Parametern --attach-acr ger AKS-klustret behörighet att hämta avbildningar från ACR. Exempelkommandot anger också --sku till automatic. Vi rekommenderar att du använder AKS-automatiska kluster för bästa möjliga upplevelse med AKS Desktop, men du kan också använda ett Standard-kluster.
az aks create --resource-group $myResourceGroup --name $myClusterName --sku automatic --attach-acr $registryName
Bevilja klusteradministratörsbehörigheter
Hämta klusterresurs-ID
az aks show:t med kommandot och ange det till en miljövariabel.AKS_ID=$(az aks show --resource-group $myResourceGroup --name $myClusterName --query id --output tsv)Ge dig själv administratörsbehörighet till klustret med kommandot
az role assignment createmed azure Kubernetes Service RBAC-klusteradministratörsrollen. Ersätt<your-entra-id>med ditt Microsoft Entra ID-objekt-ID.az role assignment create --role "Azure Kubernetes Service RBAC Cluster Admin" \ --assignee <your-entra-id> \ --scope $AKS_ID
Skapa en containeravbildning för testning
Det här exemplet skapar en avbildning från Contoso Air-exempelprogrammet, men du kan använda valfri containeravbildning för att testa distributionen av ett program med AKS Desktop. Om du vill använda en annan avbildning måste du ersätta avbildningsinformationen i distributionsstegen.
Skapa en ny katalog, navigera till den och klona Contoso Air-exempelprogrammet. Navigera sedan till webbprogramkatalogen. Om du använder en annan program- eller katalogstruktur justerar du dessa kommandon i enlighet med detta.
mkdir myapp cd myapp git clone https://github.com/Azure-Samples/contoso-air cd contoso-air/src/webBygg och push containeravbildningen till ditt containerregister med
az acr build-kommando. Om du använder en annan avbildning måste du uppdatera avbildningens namn och sökväg i enlighet med detta.az acr build --resource-group $myResourceGroup --registry $registryName --image contosoair:v1 .
Registrera klustret med AKS Desktop
Kontrollera att du är inloggad på AKS Desktop med samma konto som har åtkomst till AKS-klustret. När du har loggat in väljer du Lägg till från Azure-prenumeration.
Ange namnet på din Azure-prenumeration om du har fler än en. (Du kan också välja pilen för att öppna listrutan och sedan välja din Azure-prenumeration.)
Välj klustret och välj sedan Registrera kluster
Skapa ett hanterat projekt i AKS Desktop
I AKS-skrivbordet går du till fliken Projekt och väljer Skapa ett nytt hanterat projekt.
Konfigurera följande projektinställningar:
-
Grunderna:
- Projektnamn: Till exempel
my-dev-frontend - Prenumeration:
<your-subscription-name> - Kluster:
<your-cluster-name>
- Projektnamn: Till exempel
Note
När du ställer in Azure-prenumerationen och AKS-klustret söker AKS Desktop efter stöd för kluster- och prenumerationsfunktioner som krävs för AKS-skrivbordsmiljön.
Nätverksprinciper: Du kan lämna standardinställningarna för den här snabbstarten eller uppdatera dem efter behov.
- Om du vill exponera programmet offentligt ändrar du Ingress till
Allow all traffic.
- Om du vill exponera programmet offentligt ändrar du Ingress till
Beräkningskvot: Låt testprogrammet vara standard.
Åtkomst: Lägg till någon eller ta bort posten genom att ta bort radposten.
-
Grunderna:
På Granska kontrollerar du inställningarna för ditt projekt och väljer sedan Skapa projekt.
Distribuera ett program
Ange ett programnamn och välj sedan Skapa program.
Välj en källa för ditt program. I det här exemplet väljer du Containeravbildning>Nästa.
Konfigurera följande programinställningar. Du kan acceptera standardinställningarna eller uppdatera dem efter behov.
Containeravbildningsnamn:
- Lägg till containeravbildningens namn. I det här exemplet använder vi
myacr.azurecr.io/contosoair:v1.
Important
Du kan inte använda taggen
latest. Ange en explicit tagg, till exempelv1.- Lägg till containeravbildningens namn. I det här exemplet använder vi
Nätverk:
- Målport: För exempelcontainern anger du till
3000. - Aktivera offentlig åtkomst: Ange om du vill komma åt programmet från en offentlig URL.
- Målport: För exempelcontainern anger du till
HPA (Horizontal Pod Autoscaler):
- Aktivera HPA: Ställ in för att aktivera automatisk skalning av programmet baserat på resursanvändning.
Välj Distribuera för att distribuera programmet. Det kan ta några minuter för programmet att slutföra distributionen. Du kan visa distributionsstatusen på sidan Projektöversikt. Vänta tills alla resurser visar ett felfritt tillstånd innan du utforskar programmet.
Utforska programmet
På sidan Projektöversikt kan du utforska ditt program med hjälp av följande flikar:
- Resurser: Visa alla Kubernetes-resurser för programmet.
- Karta: Visualisera hur alla Kubernetes-resurser interagerar med och är beroende av varandra.
- Loggar: Visa poddloggar.
- Metrik: Visa kärnapplikationens resursförbrukning.
- Skalning: Visa skalningshändelser och gör uppdateringar.
- Insikter: Felsöka DNS-fel, nätverkstrafik och resursanvändning (förhandsversion). Mer information finns i Felsöka ett program i AKS Desktop med hjälp av Insights.
- Ta bort: Ta bort projektet.
- AI-assistent: Använd naturligt språk för att diagnostisera och lösa problem i klustret (förhandsversion). Mer information finns i Använda AI-felsökningsassistenten i AKS Desktop.
Rensa resurser
När du är klar med snabbstarten kan du rensa de resurser som du har skapat för att undvika onödiga kostnader.
Om du vill ta bort projektet väljer du Ta bort. Om du också vill ta bort den underliggande Azure-hanterade namnområdesresursen väljer du Ta även bort namnrymderna.
Relaterat innehåll
Mer information om AKS Desktop finns i följande resurser: