Delen via

Quickstart: Een Kubernetes-cluster implementeren met behulp van een Azure Resource Manager-sjabloon

  • Artikel

Van toepassing op: Azure Local, versie 23H2

In deze quickstart ziet u hoe u een Kubernetes-cluster in AKS Arc implementeert met behulp van een ARM-sjabloon (Azure Resource Manager). Azure Arc breidt azure-beheermogelijkheden uit naar Kubernetes-clusters overal en biedt een uniforme benadering voor het beheren van verschillende omgevingen.

Voordat u begint

In dit artikel wordt ervan uitgegaan dat u basiskennis hebt van Kubernetes-concepten.

Als u een ARM-sjabloon wilt implementeren, hebt u schrijftoegang nodig voor de resources die u implementeert en hebt u toegang tot alle bewerkingen op het Microsoft.Resources/deployments resourcetype. Als u bijvoorbeeld een virtuele machine wilt implementeren, hebt u machtigingen voor Microsoft.Compute/virtualMachines/write en Microsoft.Resources/deployments/* nodig. Zie Ingebouwde Azure-rollen voor een lijst met rollen en machtigingen.

Vereisten

  • Een Azure-account met een actief abonnement.
  • Een Lokaal Azure-cluster, versie 23H2.
  • De nieuwste Versie van Azure CLI.

Stap 1: Uw Azure-account voorbereiden

  1. Meld u aan bij Azure: open uw terminal of opdrachtprompt en meld u aan bij uw Azure-account met behulp van de Azure CLI:

    az login

  2. Stel uw abonnement in: vervang dit door <your-subscription-id> uw abonnements-id:

    az account set --subscription "<your-subscription-id>"

Stap 2: Een SSH-sleutelpaar maken met behulp van Azure CLI

az sshkey create --name "mySSHKey" --resource-group "myResourceGroup"

of maak een SSH-sleutelpaar met behulp van ssh-keygen:

ssh-keygen -t rsa -b 4096

Als u de sjabloon wilt implementeren, moet u de openbare sleutel van het SSH-paar opgeven. Gebruik de az sshkey show opdracht om de openbare sleutel op te halen:

az sshkey show --name "mySSHKey" --resource-group "myResourceGroup" --query "publicKey"

Standaard worden de SSH-sleutelbestanden gemaakt in de map ~/.ssh . Voer de az sshkey create of ssh-keygen opdracht uit om een bestaand SSH-sleutelpaar met dezelfde naam te overschrijven.

Zie SSH-sleutels maken en beheren voor verificatie in Azure voor meer informatie over het maken van SSH-sleutels.

Stap 3: De sjabloon controleren

Download de sjabloon- en parameterbestanden uit de AKSArc-opslagplaats naar uw lokale computer. Controleer alle standaardwaarden en controleer of ze juist zijn.

Stap 4: De sjabloon implementeren

Voer de volgende opdracht uit om het Kubernetes-cluster te implementeren:

az deployment group create \
--name "<deployment-name>" \
--resource-group "<resource-group-name>" \
--template-file "azuredeploy.json" \
--parameters "azuredeploy.parameters.json"

Het duurt een paar minuten om het cluster te maken. Wacht totdat het cluster met succes is geïmplementeerd voordat u met de volgende stap verdergaat.

Stap 5: De implementatie controleren

Zodra de implementatie is voltooid, gebruikt u de volgende opdracht om te controleren of uw Kubernetes-cluster actief is:

az aksarc show --resource-group "<resource-group-name>" --name "<cluster-name>" --output table

Stap 6: Verbinding maken met het cluster

  1. Voer de az connectedk8s proxy opdracht uit om verbinding te maken met het cluster. Met de opdracht wordt een binair proxybestand gedownload en uitgevoerd op de clientcomputer en wordt een kubeconfig-bestand opgehaald dat is gekoppeld aan het cluster:

    az connectedk8s proxy --name <cluster name> -g <resource group>

    Of gebruik de Kubernetes-opdrachtregelclient kubectl. Als u Azure Cloud Shell gebruikt, is kubectl al geïnstalleerd. Voer de opdracht uit om kubectlaz aksarc install-cli.

    Configureer kubectl om verbinding te maken met uw Kubernetes-cluster met behulp van de az aksarc get-credentials opdracht. Met deze opdracht downloadt u referenties en configureert u de Kubernetes CLI om deze te gebruiken:

    az aksarc get-credentials --resource-group "<resource-group-name>" --name "<cluster-name>"

  2. Controleer de verbinding met uw cluster met behulp van de kubectl get opdracht. Met deze opdracht wordt een lijst met de clusterknooppunten geretourneerd:

    kubectl get nodes -A --kubeconfig .\<path to kubecofig>

    In de volgende voorbeelduitvoer ziet u de drie knooppunten die in de vorige stappen zijn gemaakt. Zorg ervoor dat de status van het knooppunt gereed is:

    NAME                                STATUS   ROLES   AGE   VERSION
aks-agentpool-27442051-vmss000000   Ready    agent   10m   v1.27.7
aks-agentpool-27442051-vmss000001   Ready    agent   10m   v1.27.7
aks-agentpool-27442051-vmss000002   Ready    agent   11m   v1.27.7

Stap 7: Knooppuntgroep implementeren met behulp van een Azure Resource Manager-sjabloon (optioneel)

Vergelijkbaar met stap 3, download de knooppuntgroepsjabloon en parameters van de AKSArc-repository en bekijk de standaardwaarden.

De sjabloon implementeren en resultaten valideren met behulp van Azure CLI (optioneel)

Controleer en pas de sjabloon toe. Dit proces duurt enkele minuten. U kunt de Azure CLI gebruiken om te controleren of de knooppuntgroep is gemaakt:

az deployment group create \
--name "<deployment-name>" \
--resource-group "<resource-group-name>" \
--template-file "azuredeploy.json" \
--parameters "azuredeploy.parameters.json"

az aksarc nodepool show --cluster-name "<cluster-name>" --resource-group "<resource-group-name>" --name "<nodepool-name>"

Sjabloonresources

connectedClusters

Name Beschrijving Waarde
type Het type van de resource. Microsoft.Kubernetes/ConnectedClusters
apiVersion De versie van de resource-API. 2024-01-01
name De resourcenaam. Tekenreeks (vereist)
Tekenlimiet: 1-63
Geldige tekens: Alfanumerieke tekens, onderstrepingstekens en afbreekstreepjes.
Begin en eindig met alfanumeriek.
location De geografische locatie waarin de resource zich bevindt. Tekenreeks (vereist).
tags Resourcetags. Woordenlijst met tagnamen en -waarden. Zie Tags in sjablonen.
extendedLocation De uitgebreide locatie van de virtuele machine. ExtendedLocation
identity De identiteit van het verbonden cluster, indien geconfigureerd.
properties Eigenschappen van een verbonden cluster.

ProvisionedClusterInstances

Name Beschrijving Waarde
type Het resourcetype microsoft.hybridcontainerservice/provisionedclusterinstances
apiVersion De resource-API-versie 2024-01-01
name De resourcenaam Tekenreeks (vereist). Wijzig dit niet van standaardinstelling.
properties Eigenschappen van een verbonden cluster.
extendedLocation De uitgebreide locatie van het cluster. ExtendedLocation

ExtendedLocation

Name Beschrijving Waarde
name De id van de uitgebreide locatie. tekenreeks
type Het type van de uitgebreide locatie. CustomLocation

Volgende stappen

Overzicht van AKS Arc