Samouczek: wdrażanie węzłów wirtualnych na Azure Container Instances w klastrze Azure Kubernetes Service

W tym samouczku użyjesz portalu Azure do wdrożenia klastra Azure Kubernetes Service (AKS). Po wdrożeniu klastra AKS używasz wykresu Helm do wdrożenia węzłów wirtualnych w usłudze Azure Container Instances.

Prerequisites

W tym samouczku założono, że masz zainstalowane następujące narzędzia:

  • Azure CLI
  • kubectl (wersja 1.30 lub nowsza)
  • Helm
  • Git

Zaloguj się do Azure

Zaloguj się do witryny Azure Portal pod adresem https://portal.azure.com

Jeśli nie masz subskrypcji Azure, przed rozpoczęciem utwórz darmowe konto.

Tworzenie sieci wirtualnej dla klastra usługi AKS

Na stronie głównej witryny Azure Portal wybierz pozycję Utwórz zasób.

Screenshot pokazujący, jak rozpocząć tworzenie nowej sieci wirtualnej w portalu Azure.

Wybierz pozycję Sieć wirtualna>.

Screenshot przedstawiający sposób wybierania nowej sieci wirtualnej, którą chcesz utworzyć w portalu Azure.

Na stronie Podstawy wybierz subskrypcję i wprowadź następujące wartości:

  • Grupa zasobów: Utwórz nową>virtualnodesresourcegroup
  • Nazwa sieci wirtualnej: myvirtualnetwork
  • Region: East US

Zrzut ekranu przedstawiający sposób konfigurowania strony Podstawowe na potrzeby tworzenia sieci wirtualnej w portalu Azure.

Na stronie Adresy IP skonfiguruj następujące przestrzenie adresowe i podsieci:

  • 10.0.0.0/16: default podsieć o prefiksie /24
  • 10.1.0.0/16: aks podsieć o prefiksie /16
  • 10.2.0.0/16: cg podsieć o prefiksie /16

Screenshot przedstawiający sposób konfigurowania strony adresów IP na potrzeby tworzenia sieci wirtualnej w portalu Azure.

Pozostaw wartości domyślne wszystkich innych ustawień, a następnie wybierz pozycję Przejrzyj i utwórz.

Po zakończeniu walidacji zostanie wyświetlone podsumowanie ustawień sieci wirtualnej. Wybierz pozycję Utwórz , aby przesłać żądanie wdrożenia sieci wirtualnej.

Po rozpoczęciu wdrażania zostanie wyświetlone powiadomienie wskazujące, że wdrożenie jest w toku. Po wdrożeniu sieci wirtualnej zostanie wyświetlone inne powiadomienie.

Utwórz swój klaster AKS

Na stronie głównej witryny Azure Portal wybierz pozycję Utwórz zasób.

Screenshot pokazujący, jak rozpocząć tworzenie nowej sieci wirtualnej w portalu Azure.

Wybierz Kontenery>Azure Kubernetes Service (AKS).

Screenshot przedstawiający sposób wybierania nowego klastra usługi AKS, który chcesz utworzyć w portalu Azure.

Na stronie Podstawy wybierz tę samą subskrypcję używaną do tworzenia sieci wirtualnej i wprowadź następujące wartości:

  • Grupa zasobów: virtualnodesresourcegroup
  • Predefiniowana konfiguracja klastra: Dev/Test
  • Nazwa klastra Kubernetes: virtualnodescluster
  • Region: East US
  • Wersja platformy Kubernetes: dowolna wersja rozpoczynająca się od 1.30. — na przykład 1.30.9
  • Automatyczne uaktualnianie: Enabled with patch

Zrzut ekranu pokazujący, jak skonfigurować stronę „Podstawy” podczas tworzenia klastra AKS w portalu Azure.

Na stronie Pule węzłów wybierz dowolny rozmiar maszyny wirtualnej (SKU) z co najmniej 4 procesorami wirtualnymi i 16 GB pamięci RAM dla puli węzłów agentpool. Te węzły będą używane do hostowania infrastruktury węzłów wirtualnych. Nie wybieraj Enable virtual nodes - odnosi się to do poprzedniej oferty węzłów wirtualnych dla AKS.

Zrzut ekranu przedstawiający sposób konfigurowania strony „Pule węzłów” podczas tworzenia klastra AKS w portalu Azure.

Na stronie Sieć wprowadź następujące wartości:

  • Konfiguracja sieci: Azure CNI Node Subnet
  • Przynieś własną sieć wirtualną Azure: Enabled
  • Sieć wirtualna: myvirtualnetwork
  • Podsieć klastra: aks
  • Zakres adresów usługi Kubernetes: 10.4.0.0/16
  • Adres IP usługi DNS kubernetes: 10.4.0.10
  • Zasady sieciowe: Calico

Screenshot przedstawiający sposób konfigurowania strony Sieci dla tworzenia klastra usługi AKS w portalu Azure.

Pozostaw wartości domyślne wszystkich innych ustawień, a następnie wybierz pozycję Przejrzyj i utwórz.

Po zakończeniu sprawdzania poprawności zostanie wyświetlone podsumowanie ustawień klastra AKS. Wybierz pozycję Utwórz , aby przesłać żądanie wdrożenia klastra usługi AKS.

Po rozpoczęciu wdrażania zostanie wyświetlone powiadomienie wskazujące, że wdrożenie jest w toku. Po wdrożeniu klastra usługi AKS zostanie wyświetlone inne powiadomienie.

Przypisz uprawnienia do tożsamości zarządzanej klastra AKS

Podczas wdrażania klastra AKS usługa AKS tworzy grupę zasobów węzłów w tej samej subskrypcji do hostowania infrastruktury klastra. Domyślnie ta grupa zasobów ma nazwę taką jak MC_<resource group>_<AKS cluster>_<region>. Na potrzeby tego samouczka grupa zasobów węzła powinna mieć nazwę MC_virtualnodesresourcegroup_virtualnodescluster_eastus.

Jedną z zasobów utworzonych w grupie zasobów węzła jest tożsamość zarządzana o nazwie virtualnodescluster_agentpool. Przejdź do tej tożsamości zarządzanej i wybierz pozycję Przypisania ról platformy Azure. Następnie dodaj następujące dwa przypisania ról:

  • Zakres: Resource group
  • Subskrypcje: <your subscription name>
  • Grupa zasobów: MC_virtualnodesresourcegroup_virtualnodescluster_eastus
  • Rola: Contributor

To przypisanie roli umożliwia tworzenie grup kontenerów ACI w grupie zasobów węzła.

  • Zakres: Resource group
  • Subskrypcje: <your subscription name>
  • Grupa zasobów: virtualnodesresourcegroup
  • Rola: Contributor

To przypisanie roli umożliwia wdrażanie grup kontenerów ACI w sieci wirtualnej utworzonej w tej grupie zasobów.

Zrzut ekranu przedstawiający przypisania ról dodane do tożsamości zarządzanej usługi AKS.

Instalowanie wirtualnych węzłów w usłudze Azure Container Instances przy użyciu chartu Helm

Użyj interfejsu wiersza polecenia platformy Azure, aby pobrać konfigurację i poświadczenia dla utworzonego klastra AKS. To skonfiguruje narzędzie kubectl dla klastra AKS.

az login

az account set --subscription <your subscription ID>

az aks get-credentials --name virtualnodescluster --resource-group virtualnodesresourcegroup

Ponadto zarejestrujemy dostawcę zasobów ACI w ramach subskrypcji, aby można było wdrożyć grupy kontenerów.

az provider register -n Microsoft.ContainerInstance

Sklonuj repozytorium virtualnodesOnAzureContainerInstances GitHub. Chart Helm do instalowania węzłów wirtualnych w usłudze Azure Container Instances znajduje się w folderze Helm/virtualnode.

Zainstaluj chart Helm przy użyciu następującego polecenia:

helm install virtualnode <cloned repository location>\Helm\virtualnode

W ciągu minuty nowy węzeł wirtualny zostanie zarejestrowany w klastrze AKS i uzyska stan „Ready”. Stan węzłów klastra usługi AKS można sprawdzić za pomocą narzędzia kubectl.

kubectl get nodes

Zrzut ekranu przedstawiający wynik działania polecenia kubectl get nodes, na którym węzeł wirtualny ma stan Ready.

Wdróż swój pierwszy pod na węzeł wirtualny

Możesz wchodzić w interakcje z węzłami wirtualnymi, takimi jak wszystkie inne węzły kubernetes. Na przykład poniższy przykładowy plik YAML spowoduje wdrożenie zasobnika na węźle wirtualnym w klastrze AKS — zwróć uwagę na użycie selektorów węzłów i tolerancji, aby odpowiednio umieścić zasobnik. Kod YAML można wdrożyć przy użyciu narzędzia kubectl apply.

apiVersion: v1
kind: Pod
metadata:
  annotations:    
  name: demo-pod
spec:
  containers:
  - command:
    - /bin/bash
    - -c
    - 'counter=1; while true; do echo "Hello, World! Counter: $counter"; counter=$((counter+1)); sleep 1; done'
    image: mcr.microsoft.com/azure-cli
    name: hello-world-counter
    resources:
      limits:
        cpu: 2250m
        memory: 2256Mi
      requests:
        cpu: 100m
        memory: 128Mi
  nodeSelector:
    virtualization: virtualnode2
  tolerations:
  - effect: NoSchedule
    key: virtual-kubelet.io/provider
    operator: Exists

Po wdrożeniu zasobnika możesz wchodzić z nim w interakcję dokładnie tak samo jak ze „zwykłym” zasobnikiem Kubernetes.

Na przykład, aby wyświetlić stan poda i zdarzenia (przydatne przy wyszukiwaniu błędów!):

kubectl describe pods demo-pod

Aby wyświetlić dzienniki zasobnika:

kubectl logs demo-pod

Aby uzyskać powłokę dla zasobnika:

kubectl exec demo-pod -it -- /bin/bash

Następne kroki

W tym samouczku utworzono klaster AKS w portalu Azure, wdrożono węzły wirtualne w usłudze Azure Container Instances przy użyciu chartu Helm oraz wdrożono pod na węźle wirtualnym. Masz już podstawową wiedzę o tym, jak uruchamiać zasobniki Kubernetes na węźle wirtualnym, i możesz od razu korzystać na tych zasobnikach z większości funkcji i mechanizmów Kubernetes!

Jeśli chcesz korzystać z wyspecjalizowanych funkcji lub zachowań węzłów wirtualnych dla zasobników, zobacz Dostosowywanie zasobników.

Jeśli chcesz dostosować instalację węzła wirtualnego, zobacz Dostosowywanie węzła.

Jeśli planujesz wdrożyć obciążenia o dużej skali (tysiące zasobników na minutę) w węzłach wirtualnych, mamy najlepsze rozwiązania i zalecenia.