Quickstart: Toepassingen implementeren en beheren met AKS-bureaublad

Voor het implementeren en beheren van Kubernetes-toepassingen is doorgaans het schrijven van YAML-manifesten vereist, het uitvoeren van kubectl-opdrachten en het schakelen tussen meerdere hulpprogramma's. AKS-bureaublad verwijdert deze complexiteit met begeleide werkstromen waarmee ontwikkelaars en DevOps-technici toepassingen kunnen implementeren, bewaken, oplossen en opschonen zonder diepgaande Kubernetes-expertise.

Deze handleiding helpt u bij het implementeren van een TypeScript-toepassing met behulp van AKS-bureaublad, van het maken van een cluster door toepassingslogboeken, metrische gegevens, schalen en ingebouwde hulpprogramma's voor probleemoplossing te verkennen.

Prerequisites

  • Een Azure-abonnement. Als u geen Azure-abonnement hebt, kunt u een gratis Azure-account maken.
  • Azure CLI versie 2.64.0 of hoger moet zijn geïnstalleerd. Controleer uw versie met behulp van de az --version opdracht. Voor het installeren of upgraden, zie Azure CLI installeren.
  • De aks-preview Azure CLI-extensie. Installeer deze met behulp van de az extension add --name aks-preview opdracht.
  • AKS-bureaublad geïnstalleerd. AKS-bureaublad ondersteunt de volgende besturingssystemen (OS): Windows, Linux en Mac.
  • Als u een bestaand cluster gebruikt, moet het cluster worden geverifieerd met Microsoft Entra ID. Gebruik een automatisch AKS-cluster om ervoor te zorgen dat uw cluster is geverifieerd met Microsoft Entra ID. U hebt ook de Azure Kubernetes Service RBAC Cluster Admin-rol of gelijkwaardige machtigingen voor het doelcluster nodig.

Azure-resources maken

Als u geen bestaand AKS-cluster en Azure Container Registry (ACR) hebt, kunt u deze maken met behulp van de Azure CLI. Deze secties laten zien hoe u een nieuwe resourcegroep, AKS-cluster en ACR maakt. Als u deze resources al hebt, kunt u doorgaan naar Uw cluster registreren via AKS-bureaublad.

Omgevingsvariabelen instellen

Als u de opdrachten wilt vereenvoudigen, stelt u de volgende omgevingsvariabelen in uw terminal in. Zorg ervoor dat u myLocation instelt op uw Azure-regio. In het voorbeeld hier wordt RAND gebruikt om unieke resourcenamen te maken. U kunt deze vervangen door uw eigen waarden als u wilt.

RAND=$RANDOM
export RAND
echo "Random resource identifier will be: ${RAND}"
myResourceGroup=bbash$RAND
myLocation=westus3
myClusterName=clu-$RAND
registryName=bbashreg$RAND

Een brongroep maken

Maak een Azure-resourcegroep met behulp van de az group create opdracht.

az group create --name $myResourceGroup --location $myLocation

Een Azure-containerregister maken

Maak een Azure-containerregister met behulp van de az acr create opdracht.

az acr create --resource-group $myResourceGroup --name $registryName --sku Basic

Een AKS-cluster maken met ACR-integratie

Maak een AKS-cluster met ACR-integratie met behulp van de az aks create opdracht. De --attach-acr-parameter verleent het AKS-cluster toestemming om afbeeldingen uit de ACR te halen. Stelt deze voorbeeldopdracht ook --sku in op automatic. We raden u aan om automatische AKS-clusters te gebruiken voor de beste ervaring met AKS Desktop, maar u kunt ook een Standard-cluster gebruiken.

az aks create --resource-group $myResourceGroup --name $myClusterName --sku automatic --attach-acr $registryName

Clusterbeheerdersmachtigingen verlenen

  1. Haal de clusterresource-id op met behulp van de az aks show opdracht en stel deze in op een omgevingsvariabele.

    AKS_ID=$(az aks show --resource-group $myResourceGroup --name $myClusterName --query id --output tsv)

  2. Gebruik de az role assignment create-opdracht om uzelf beheerdersrechten toe te kennen aan het cluster met de rol van Azure Kubernetes Service RBAC Cluster Admin. Zorg ervoor dat u <your-entra-id> vervangt door de object-id van uw Microsoft Entra ID.

    az role assignment create --role "Azure Kubernetes Service RBAC Cluster Admin" \
   --assignee <your-entra-id> \
   --scope $AKS_ID

Een containerimage maken voor testdoeleinden

In dit voorbeeld wordt een image gemaakt van de Contoso Air-voorbeeldtoepassing, maar u kunt elke containerimage gebruiken om een toepassing te testen met AKS-bureaublad. Als u een andere afbeelding wilt gebruiken, moet u ervoor zorgen dat u de details van de afbeelding in de implementatiestappen vervangt.

  1. Maak een nieuwe map, navigeer ernaartoe en kloon de Contoso Air-voorbeeldtoepassing. Navigeer vervolgens naar de map van de webtoepassing. Als u een andere toepassing of mapstructuur gebruikt, past u deze opdrachten dienovereenkomstig aan.

    mkdir myapp
cd myapp
git clone https://github.com/Azure-Samples/contoso-air
cd contoso-air/src/web

  2. Maak en push de containerimage naar uw containerregister door het gebruik van de az acr build-opdracht. Als u een andere afbeelding gebruikt, moet u de naam en het pad van de afbeelding dienovereenkomstig bijwerken.

    az acr build --resource-group $myResourceGroup --registry $registryName --image contosoair:v1 .

Registreer uw cluster bij AKS Desktop

  1. Zorg ervoor dat u bent aangemeld bij het bureaublad van AKS met hetzelfde account dat toegang heeft tot het AKS-cluster. Nadat u zich hebt aangemeld, selecteert u Toevoegen uit Een Azure-abonnement.

  2. Voer de naam van uw Azure-abonnement in als u meer dan één abonnement hebt. (U kunt ook de pijl selecteren om de vervolgkeuzelijst te openen en vervolgens uw Azure-abonnement selecteren.)

  3. Selecteer uw cluster en selecteer Cluster registreren

    Een video waarin wordt gedemonstreerd hoe u een cluster toevoegt aan de AKS-bureaublad-app.

Een beheerd project maken in de AKS-omgeving

  1. Ga in het AKS-bureaublad naar het tabblad Projecten en selecteer Een nieuw beheerd project maken.

  2. Configureer de volgende Project-instellingen:

    • Basisbeginselen:
      • Projectnaam: bijvoorbeeld my-dev-frontend
      • Abonnement: <your-subscription-name>
      • Cluster: <your-cluster-name>

    Opmerking

    Wanneer u het Azure-abonnement en het AKS-cluster instelt, controleert AKS desktop op ondersteuning voor cluster- en abonnementsfuncties die vereist zijn voor de AKS-bureaubladervaring.

    • Netwerkbeleid: u kunt de standaardinstellingen voor deze quickstart laten staan of deze indien nodig bijwerken.

      • Als u de toepassing openbaar wilt maken, wijzigt u Ingress in Allow all traffic.

    • Rekenquotum: laat de standaardwaarde staan voor de testtoepassing.

    • Access: Voeg iemand toe of verwijder de vermelding door het regelitem te verwijderen.

  3. Controleer onder Controleren de instellingen voor uw Project en selecteer Vervolgens Project maken.

    Schermopname van het maken van een nieuw project op het AKS-bureaublad.

Een app implementeren

  1. Geef een toepassingsnaam op en selecteer Vervolgens Toepassing maken.

    Schermopname van het maken van een nieuwe toepassing in AKS Desktop.

  2. Selecteer een bron voor uw toepassing. Voor dit voorbeeld selecteert u containerimage>Volgende.

    Schermopname van het selecteren van een bron voor een nieuwe toepassing in het AKS-bureaublad.

  3. Configureer de volgende toepassingsinstellingen. U kunt de standaardinstellingen accepteren of ze indien nodig bijwerken.

    • Containerimagenaam:

      • Voeg de naam van de containerimage toe. In dit voorbeeld gebruiken we myacr.azurecr.io/contosoair:v1.

      Important

      U kunt de latest tag niet gebruiken. Geef een expliciete tag op, zoals v1.

    • Netwerken:

      • Doelpoort: Voor de voorbeeldcontainer, ingesteld op 3000.
      • Openbare toegang inschakelen: stel in of u toegang wilt krijgen tot de toepassing vanuit een openbare URL.

    • HPA (horizontale automatische schaalaanpassing van pods):

      • HPA inschakelen: instellen om automatisch schalen van de toepassing in te schakelen op basis van resourcegebruik.

  4. Selecteer Implementeren om de toepassing te implementeren. Het kan enkele minuten duren voordat de toepassing is geïmplementeerd. U kunt de implementatiestatus bekijken op de overzichtspagina van Project. Wacht tot alle resources in een goede staat verkeren voordat u de toepassing verkent.

    Schermopname van een projectoverzichtsscherm in AKS Desktop.

De toepassing verkennen

Op de overzichtspagina van Project kunt u uw toepassing verkennen met behulp van de volgende tabbladen:

  • Resources: Bekijk alle Kubernetes-resources voor de toepassing.
  • Kaart: Visualiseer hoe alle Kubernetes-resources met elkaar communiceren en afhankelijk zijn van elkaar.
  • Logboeken: Pod-logboeken weergeven.
  • Metrische gegevens: Het resourceverbruik van de kerntoepassing weergeven.
  • Schalen: Bekijk de schaal van gebeurtenissen en breng updates aan.
  • Inzichten: Problemen met DNS-fouten, netwerkverkeer en resourcegebruik (preview) oplossen. Zie Problemen met een toepassing in het AKS-bureaublad oplossen met behulp van Insights voor meer informatie.
  • Verwijderen: Verwijder het project.
  • AI-assistent: gebruik natuurlijke taal om problemen in uw cluster vast te stellen en op te lossen (preview). Zie De AI-assistent voor probleemoplossing gebruiken in AKS Desktop voor meer informatie.

De hulpbronnen opschonen

Wanneer u klaar bent met de quickstart, kunt u de resources die u hebt gemaakt opschonen om onnodige kosten te voorkomen.

Als u het project wilt verwijderen, selecteert u Verwijderen. Als u ook de onderliggende beheerde Naamruimteresource van Azure wilt verwijderen, selecteert u Ook de naamruimten verwijderen.

Verwante inhoud

Voor meer informatie over het AKS-bureaublad, zie de volgende bronnen:

  • Last updated on