Snabbstart: Distribuera och hantera program med HJÄLP av AKS Desktop

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 --version kommandot . Information om hur du installerar eller uppgraderar finns i Installera Azure CLI.
  • Azure CLI-tillägget aks-preview . Installera den med kommandot az 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

  1. 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)
    
  2. Ge dig själv administratörsbehörighet till klustret med kommandot az role assignment create med 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.

  1. 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/web
    
  2. Bygg 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

  1. 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.

  2. 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.)

  3. Välj klustret och välj sedan Registrera kluster

    En video som visar hur du lägger till ett kluster i AKS-skrivbordsappen.

Skapa ett hanterat projekt i AKS Desktop

  1. I AKS-skrivbordet går du till fliken Projekt och väljer Skapa ett nytt hanterat projekt.

  2. Konfigurera följande projektinställningar:

    • Grunderna:
      • Projektnamn: Till exempel my-dev-frontend
      • Prenumeration: <your-subscription-name>
      • Kluster: <your-cluster-name>

    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.
    • Beräkningskvot: Låt testprogrammet vara standard.

    • Åtkomst: Lägg till någon eller ta bort posten genom att ta bort radposten.

  3. Granska kontrollerar du inställningarna för ditt projekt och väljer sedan Skapa projekt.

    Skärmbild av hur du skapar ett nytt projekt i AKS Desktop.

Distribuera ett program

  1. Ange ett programnamn och välj sedan Skapa program.

    Skärmbild av hur du skapar ett nytt program i AKS Desktop.

  2. Välj en källa för ditt program. I det här exemplet väljer du Containeravbildning>Nästa.

    Skärmbild av att välja en källa för ett nytt program i AKS Desktop.

  3. 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 exempel v1.

    • 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.
    • HPA (Horizontal Pod Autoscaler):

      • Aktivera HPA: Ställ in för att aktivera automatisk skalning av programmet baserat på resursanvändning.
  4. 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.

    Skärmbild av en projektöversiktsskärm i AKS Desktop.

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.

Mer information om AKS Desktop finns i följande resurser: