Wprowadzenie do usługi Azure Kubernetes Application Network for AKS (wersja zapoznawcza)

Ważna

Funkcje usługi AKS w wersji zapoznawczej są dostępne na zasadzie samoobsługi i wymagają zapisania się. Wersje zapoznawcze są udostępniane w wersji "as is" i "jako dostępne" i są wykluczone z umów dotyczących poziomu usług i ograniczonej gwarancji. Wersje zapoznawcze usługi AKS są częściowo objęte pomocą techniczną dla klientów, świadczoną w miarę możliwości. W związku z tym te funkcje nie są przeznaczone do użytku produkcyjnego. Aby uzyskać więcej informacji, zobacz następujące artykuły pomocy technicznej:

Ten artykuł ułatwia rozpoczęcie pracy z usługą Azure Kubernetes Application Network for AKS. Zawiera instrukcje krok po kroku dotyczące tworzenia zasobu usługi Application Network i łączenia klastra usługi AKS z nim jako klastra członkowskiego.

Wymagania wstępne

Ustawianie zmiennych środowiskowych

  • Ustaw następujące zmienne środowiskowe dla zasobu i klastra usługi Azure Kubernetes Application Network. Możesz użyć istniejącego klastra lub utworzyć go w późniejszym kroku przed dodaniem go do usługi Azure Kubernetes Application Network.

    export SUBSCRIPTION=<subscription-id>
export LOCATION=<location>
export APPNET_RG=<resource-group-for-appnet-resource>
export APPNET_NAME=<appnet-name>
export APPNET_MEMBER_NAME=<appnet-member-name>
export AKS_RG=<aks-cluster-resource-group>
export CLUSTER_NAME=<cluster-name>

Zarejestruj funkcję do publicznej wersji zapoznawczej

  1. Zarejestruj funkcję usługi Azure Kubernetes Application Network przy użyciu az feature register polecenia .

    az feature register --namespace Microsoft.AppLink --name PublicPreview --subscription $SUBSCRIPTION

  2. Poczekaj na zarejestrowanie funkcji. Stan można sprawdzić przy użyciu az feature show polecenia .

    az feature show --namespace Microsoft.AppLink --name PublicPreview --subscription $SUBSCRIPTION

    Pole properties.state w danych wyjściowych wyświetli Registered po zarejestrowaniu.

  3. Po zarejestrowaniu funkcji odśwież rejestrację dostawcy zasobów Microsoft.AppLink przy użyciu az provider register polecenia .

    az provider register --namespace Microsoft.AppLink --subscription $SUBSCRIPTION

Instalowanie rozszerzenia interfejsu wiersza polecenia usługi AppNet

  • Zainstaluj rozszerzenie AppNet CLI przy użyciu polecenia az extension add.

    az extension add --name appnet-preview

Ustawianie aktywnej subskrypcji

  • Ustaw aktywną subskrypcję, którą chcesz użyć dla usługi Azure Kubernetes Application Network, przy użyciu polecenia az account set.

    az account set --subscription $SUBSCRIPTION

Utwórz klaster AKS

Uwaga / Notatka

Klastry członkowskie nie muszą znajdować się w oddzielnych grupach zasobów. Mogą znajdować się w tej samej grupie zasobów co zasób usługi Azure Kubernetes Application Network. Jednak wszystkie klastry członkowskie muszą być w tym samym dzierżawcy.

Jeśli nie masz istniejącego klastra usługi AKS do nawiązania połączenia z usługą Azure Kubernetes Application Network, musisz go utworzyć. Usługa Azure Kubernetes Application Network wymaga klastrów AKS spełniających następujące wymagania:

Jeśli masz istniejący klaster, który spełnia już te wymagania, możesz pominąć ten krok.

  1. Utwórz grupę zasobów dla klastra usługi AKS przy użyciu polecenia az group create.

    az group create --name $AKS_RG --location $LOCATION

  2. Utwórz klaster AKS z włączoną integracją Microsoft Entra zarządzaną przez AKS, wystawcą OIDC oraz zarządzanym dodatkiem interfejsu API bramy Kubernetes, używając polecenia az aks create z flagami --enable-oidc-issuer, --enable-aad i --enable-gateway-api. Nie włączaj dodatku siatki usługi Istio (--enable-azure-service-mesh) w tym klastrze.

    az aks create --name $CLUSTER_NAME --resource-group $AKS_RG --enable-oidc-issuer --enable-aad --enable-gateway-api

Tworzenie zasobu sieci aplikacji platformy Azure Kubernetes

  1. Utwórz grupę zasobów dla zasobu usługi Azure Kubernetes Application Network przy użyciu az group create polecenia .

    az group create --name $APPNET_RG --location $LOCATION

  2. Utwórz zasób usługi Azure Kubernetes Application Network przy użyciu az appnet create polecenia .

    Uwaga / Notatka

    Po utworzeniu zasobu sieci aplikacji nie można zmienić lokalizacji, subskrypcji ani grupy zasobów.

    az appnet create --resource-group $APPNET_RG --name $APPNET_NAME --location $LOCATION  --identity-type SystemAssigned

    Proces tworzenia może potrwać kilka minut. Pole properties.provisioningState danych wyjściowych pokazuje Succeeded dla pomyślnie utworzonej sieci Azure Kubernetes Application Network.

  3. Wyświetl zasób usługi Azure Kubernetes Application Network przy użyciu az appnet show polecenia .

    az appnet show --resource-group $APPNET_RG --name $APPNET_NAME

Dołącz do klastra AKS jako członek sieci aplikacji Kubernetes w usłudze Azure

Po dołączeniu klastra członkowskiego do usługi Azure Kubernetes Application Network można określić jeden z następujących trybów uaktualniania dla tego klastra: w pełni zarządzane lub samodzielne. Tryb uaktualniania określa, w jaki sposób do klastra członkowskiego są stosowane uaktualnienia wersji pomocniczej usługi Azure Kubernetes Application Network. Jeśli nie określisz trybu uaktualniania podczas dołączania członka, wartość domyślna to SelfManaged. Aby uzyskać więcej informacji na temat trybów uaktualniania, zobacz Konfigurowanie uaktualnień dla członków usługi Azure Kubernetes Application Network.

Uwaga / Notatka

Nie można zmienić nadrzędnej sieci aplikacji członka, lokalizacji, subskrypcji ani grupy zasobów po dołączeniu do niej. Aby zmienić którykolwiek z tych elementów, usuń członka i dołącz go ponownie z nowymi wartościami.

  • Dołącz do klastra AKS jako członek Azure Kubernetes Application Network, używając polecenia az appnet member join z parametrem ustawionym na wartość --upgrade-mode lub FullyManaged. W poniższym przykładzie pokazano, jak dołączyć klaster członkowski w SelfManaged trybie:

    az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode SelfManaged

Weryfikowanie łączności klastra członkowskiego

  • Po dołączeniu do klastra możesz zweryfikować łączność i wyświetlić szczegóły członków za pomocą polecenia az appnet member show.

    az appnet member show --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME

    Jeśli na przykład zarejestrowano w trybie w pełni zarządzanym w kanale wydania Stable, dane wyjściowe będą wyglądać następująco:

    {
  "id": "/subscriptions/$SUBSCRIPTION/resourceGroups/$APPNET_RG/providers/Microsoft.AppLink/appLinks/$APPNET_NAME/appLinkMembers/$APPNET_MEMBER_NAME",
  "location": "myLocation",
  "name": "myMemberName",
  "properties": {
    "clusterType": "AKS",
    "connectivityProfile": {
      "eastWestGateway": {
        "visibility": "Internal"
      }
    },
    "metadata": {
      "resourceId": "/subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME"
    },
    "observabilityProfile": {
      "metrics": {
        "metricsEndpoint": "https://myMember-mcp-fqdn.appnet.net"
      }
    },
    "provisioningState": "Succeeded",
    "upgradeProfile": {
      "mode": "FullyManaged",
      "fullyManagedUpgradeProfile": {
        "releaseChannel": "Stable"
      }
    }
  },
  "resourceGroup": "myAppNetRG",
  "type": "microsoft.applink/applinks/applinkmembers"
}

Lista członków sieci Azure Kubernetes Application Network

Wiele klastrów może dołączyć do usługi Azure Kubernetes Application Network.

  • Wyświetl listę wszystkich członków usługi Azure Kubernetes Application Network przy użyciu az appnet member list polecenia .

    az appnet member list --resource-group $APPNET_RG --appnet-name $APPNET_NAME --output table

Usuwanie zasobów usługi Azure Kubernetes Application Network

Usunięcie zasobu usługi Azure Kubernetes Application Network powoduje automatyczne usunięcie wszystkich jego członków, więc nie musisz najpierw ich usuwać. Usunięcie członka, zarówno indywidualnie, jak i w ramach tego mechanizmu kaskadowego, nie powoduje usunięcia odpowiadającego mu klastra AKS.

Usuwanie elementu członkowskiego usługi Azure Kubernetes Application Network

Uwaga / Notatka

Przed usunięciem członka należy usunąć obciążenia z płaszczyzny danych otoczenia przez usunięcie wcześniej zastosowanych etykiet Istio, takich jak istio.io/use-waypoint, istio.io/use-waypoint-namespace, i istio.io/dataplane-mode, z zasobów.

  1. Usuń członka z usługi Azure Kubernetes Application Network przy użyciu az appnet member remove polecenia .

    az appnet member remove --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME

  2. Sprawdź, czy użytkownik został usunięty przy użyciu polecenia az appnet member list.

    az appnet member list --resource-group $APPNET_RG --appnet-name $APPNET_NAME

Usuwanie zasobu sieci aplikacji platformy Azure Kubernetes

  • Usuń zasób usługi Azure Kubernetes Application Network przy użyciu az appnet delete polecenia .

    az appnet delete --resource-group $APPNET_RG --appnet-name $APPNET_NAME

Treści powiązane

Aby dowiedzieć się więcej o usłudze Azure Kubernetes Application Network, zobacz następujące artykuły:

  • Ostatnia aktualizacja o