Rychlý start: Nasazení clusteru Kubernetes pomocí šablony Azure Resource Manageru

Platí pro: Azure Local, verze 23H2

V tomto rychlém startu se dozvíte, jak nasadit cluster Kubernetes v AKS Arc pomocí šablony Azure Resource Manageru (ARM). Azure Arc rozšiřuje možnosti správy Azure na clustery Kubernetes kdekoli a poskytuje jednotný přístup ke správě různých prostředí.

Než začnete

Tento článek předpokládá základní znalosti konceptů Kubernetes.

Pokud chcete nasadit šablonu ARM, potřebujete oprávnění k zápisu k prostředkům, které nasazujete, a oprávnění ke všem operacím na prostředcích typu Microsoft.Resources/deployments. Například k nasazení virtuálního počítače potřebujete oprávnění Microsoft.Compute/virtualMachines/write a Microsoft.Resources/deployments/* . Seznam rolí a oprávnění najdete v tématu Předdefinované role Azure.

Požadavky

• Účet Azure s aktivním předplatným.
• Místní cluster Azure verze 23H2.
• Nejnovější verze Azure CLI.

Krok 1: Příprava účtu Azure

1. Přihlášení k Azure: Otevřete terminál nebo příkazový řádek a přihlaste se ke svému účtu Azure pomocí Azure CLI:

   az login
   

2. Nastavení předplatného: nahraďte <your-subscription-id> ID předplatného:

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

Krok 2: Vytvoření páru klíčů SSH pomocí Azure CLI

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

nebo vytvořte pár klíčů SSH pomocí ssh-keygen:

ssh-keygen -t rsa -b 4096

Pokud chcete šablonu nasadit, musíte zadat veřejný klíč z páru SSH. Pokud chcete načíst veřejný klíč, použijte az sshkey show příkaz:

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

Ve výchozím nastavení se soubory klíčů SSH vytvoří v adresáři ~/.ssh . Spuštěním az sshkey create příkazu nebo ssh-keygen příkazu přepište všechny existující páry klíčů SSH se stejným názvem.

Další informace o vytváření klíčů SSH najdete v tématu Vytvoření a správa klíčů SSH pro ověřování v Azure.

Krok 3: Kontrola šablony

Stáhněte si šablonu a soubory parametrů z úložiště AKSArc do místního počítače. Zkontrolujte všechny výchozí hodnoty a ujistěte se, že jsou správné.

Krok 4: Nasazení šablony

Cluster Kubernetes nasadíte spuštěním následujícího příkazu:

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

Vytvoření clusteru bude trvat několik minut. Než přejdete k dalšímu kroku, počkejte, než se cluster úspěšně nasadí.

Krok 5: Ověření nasazení

Po dokončení nasazení pomocí následujícího příkazu ověřte, že je cluster Kubernetes spuštěný a spuštěný:

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

Krok 6: Připojení ke clusteru

1. Pokud se chcete připojit ke clusteru, spusťte az connectedk8s proxy příkaz. Příkaz stáhne a spustí binární soubor proxy serveru na klientském počítači a načte soubor kubeconfig přidružený ke clusteru:

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

   Nebo použijte klienta příkazového řádku Kubernetes kubectl. Pokud používáte Azure Cloud Shell, kubectl je už nainstalovaný. Pokud chcete nainstalovat a spustit kubectl místně, spusťte az aksarc install-cli příkaz.

   Pomocí příkazu nakonfigurujte kubectl pro připojení ke clusteru az aksarc get-credentials Kubernetes. Tento příkaz stáhne přihlašovací údaje a nakonfiguruje rozhraní příkazového řádku Kubernetes tak, aby je používalo:

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

2. Pomocí příkazu ověřte připojení ke clusteru kubectl get . Tento příkaz vrátí seznam uzlů clusteru:

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

   Následující příklad výstupu ukazuje tři uzly vytvořené v předchozích krocích. Ujistěte se, že je stav uzlu připravený:

   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
   

Krok 7: Nasazení fondu uzlů pomocí šablony Azure Resource Manageru (volitelné)

Podobně jako v kroku 3, stáhněte si šablonu a parametry fondu uzlů z AKSArc repozitáře a zkontrolujte výchozí hodnoty.

Nasazení šablony a ověření výsledků pomocí Azure CLI (volitelné)

Zkontrolujte a použijte šablonu. Dokončení tohoto procesu trvá několik minut. Pomocí Azure CLI můžete ověřit, že se fond uzlů úspěšně vytvořil:

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>"

Prostředky šablon

connectedClusters

Název	Popis	Hodnota
type	Typ zdroje.	Microsoft.Kubernetes/ConnectedClusters
apiVersion	Verze rozhraní API prostředku.	2024-01-01
name	Název prostředku.	Řetězec (povinné) Limit znaků: 1-63 Platné znaky: Alfanumerické znaky, podtržítka a pomlčky. Začněte a končit alfanumerickými znaky.
location	Geografické umístění, ve kterém se nachází prostředek.	Řetězec (povinný argument).
tags	Značky prostředků	Slovník názvů a hodnot značek Viz značky v šablonách.
extendedLocation	Rozšířené umístění virtuálního počítače.	ExtendedLocation
identity	Identita připojeného clusteru, pokud je nakonfigurovaná.
properties	Vlastnosti připojeného clusteru

ProvisionedClusterInstances

Název	Popis	Hodnota
type	Typ prostředku	microsoft.hybridcontainerservice/provisionedclusterinstances
apiVersion	Verze rozhraní API prostředku	2024-01-01
name	Název prostředku	Řetězec (povinný argument). Toto nastavení neměňte z výchozího nastavení.
properties	Vlastnosti připojeného clusteru
extendedLocation	Rozšířené umístění clusteru.	ExtendedLocation

ExtendedLocation

Název	Popis	Hodnota
name	ID rozšířeného umístění.	string
type	Typ rozšířeného umístění.	CustomLocation

Další kroky

Přehled služby AKS Arc