Az Azure Kubernetes Application Network for AKS használatának első lépései (előzetes verzió)

Fontos

Az AKS előzetes verziójú funkciói önkiszolgáló, opt-in alapon érhetők el. Az előzetes verziókat "ahogy van" és "rendelkezésre állóként" biztosítjuk, és a szolgáltatási szerződésekből és a korlátozott jótállásból kizárjuk őket. Az AKS előzetes verzióihoz részleges támogatást nyújt az ügyfélszolgálat a tőle telhető legjobb módon. Ezért ezek a funkciók nem éles használatra vannak szánva. További információkért tekintse meg az alábbi támogatási cikkeket:

Ez a cikk segítséget nyújt az Azure Kubernetes Application Network for AKS használatának megkezdéséhez. Részletes útmutatást nyújt egy Application Network-erőforrás létrehozásához és egy AKS-fürt tagfürtként való csatlakoztatásához.

Előfeltételek

Környezeti változók beállítása

  • Állítsa be a következő környezeti változókat az Azure Kubernetes Application Network-erőforráshoz és -fürthöz. Használhat meglévő fürtöt, vagy létrehozhat egyet egy későbbi lépésben, mielőtt hozzáadja azt az Azure Kubernetes Application Network-hez.

    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>

A funkció regisztrálása nyilvános előzetes verzióra

  1. Regisztrálja az Azure Kubernetes Application Network szolgáltatását a az feature register paranccsal.

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

  2. Várjon, amíg a szolgáltatás regisztrálva lesz. Az állapotot a parancs használatával az feature show ellenőrizheti.

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

    A properties.state kimenet mezője akkor jelenik meg Registered , amikor a regisztráció befejeződött.

  3. A szolgáltatás regisztrálása után frissítse a Microsoft.AppLink erőforrás-szolgáltató regisztrációját a az provider register paranccsal.

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

Az AppNet CLI-bővítmény telepítése

  • Telepítse az AppNet CLI-bővítményt a az extension add paranccsal.

    az extension add --name appnet-preview

Aktív előfizetés beállítása

  • Állítsa be az aktív előfizetést arra, amelyet az Azure Kubernetes Application Network-hez szeretne használni a az account set paranccsal.

    az account set --subscription $SUBSCRIPTION

AKS-fürt létrehozása

Megjegyzés:

A tagfürtöknek nem kell külön erőforráscsoportokban lenniük. Ezek ugyanabban az erőforráscsoportban lehetnek, mint az Azure Kubernetes Application Network-erőforrás. Az összes tagfürtnek azonban ugyanabban a bérlői környezetben kell lennie.

Ha nincs meglévő AKS-fürtje az Azure Kubernetes Application Networkhez való csatlakozáshoz, létre kell hoznia egyet. Azure Kubernetes Application Networkhez olyan AKS-fürtök szükségesek, amelyek megfelelnek az alábbi követelményeknek:

Ha már rendelkezik olyan fürttel, amely már megfelel ezeknek a követelményeknek, kihagyhatja ezt a lépést.

  1. Hozzon létre egy erőforráscsoportot az AKS-fürthöz a az group create paranccsal.

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

  2. Hozzon létre egy AKS-fürtöt AKS által felügyelt Microsoft Entra-integrációval, OIDC-kibocsátóval és engedélyezett felügyelt Kubernetes Gateway API-bővítménnyel a az aks create paranccsal, a --enable-oidc-issuer, --enable-aad és --enable-gateway-api jelzők használatával. Ne engedélyezze az Istio service mesh bővítményt (--enable-azure-service-mesh) ezen a fürtön.

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

Azure Kubernetes Application Network-erőforrás létrehozása

  1. Hozzon létre egy erőforráscsoportot az Azure Kubernetes Application Network-erőforráshoz a az group create parancs használatával.

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

  2. Hozzon létre egy Azure Kubernetes Application Network-erőforrást a az appnet create paranccsal.

    Megjegyzés:

    A létrehozás után nem módosíthatja az Application Network-erőforrások helyét, előfizetését vagy erőforráscsoportját.

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

    A létrehozási folyamat eltarthat néhány percig. A properties.provisioningState kimenet mezője egy sikeresen létrehozott Azure Kubernetes Application Network esetében jelenik meg Succeeded .

  3. Az Azure Kubernetes Application Network-erőforrás megtekintése a az appnet show paranccsal.

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

Csatlakozzon egy AKS klaszterhez az Azure Kubernetes Application Network tagjaként

Ha csatlakozik egy tagfürthöz az Azure Kubernetes Application Network szolgáltatáshoz, a fürthöz a következő frissítési módok egyikét adhatja meg: teljes körűen felügyelt vagy önkiszolgáló. A frissítési mód határozza meg, hogy miként alkalmazzák az Azure Kubernetes Application Network kisebb verziófrissítéseit a tagfürtre. Ha a tagcsatlakozás során nem ad meg frissítési módot, az alapértelmezés szerint a SelfManaged. A frissítési módokról további információt az Azure Kubernetes Application Network-tagok frissítéseinek konfigurálása című témakörben talál.

Megjegyzés:

A tag szülőalkalmazás-hálózatát, helyét, előfizetését vagy erőforráscsoportját a csatlakozás után nem módosíthatja. Ezek bármelyikének módosításához távolítsa el a tagot, és csatlakozzon újra az új értékekkel.

  • Csatlakozzon egy AKS-fürthöz az Azure Kubernetes Application Network tagjaként a az appnet member join parancs használatával, amelynek --upgrade-mode paraméterét FullyManaged vagy SelfManaged beállítására állítsa be. Az alábbi példa bemutatja, hogyan csatlakozhat egy tagklaszterhez SelfManaged módban:

    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

A fürt csatlakozásának ellenőrzése

  • A klaszterhez való csatlakozás után ellenőrizheti a csatlakozást, és megtekintheti a tag részleteit a az appnet member show paranccsal.

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

    Ha például teljes mértékben felügyelt módban regisztrálva van a kiadási csatornával Stable , a kimenet a következőképpen nézne ki:

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

Azure Kubernetes Application Network-tagok listázása

Több fürt is csatlakozhat egy Azure Kubernetes-alkalmazáshálózathoz.

  • Az Azure Kubernetes Application Network összes tagjának listázása a az appnet member list paranccsal.

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

Azure Kubernetes Application Network-erőforrások törlése

Az Azure Kubernetes Application Network-erőforrás törlése automatikusan eltávolítja az összes tagot, így nem kell először eltávolítania a tagokat. Akár egyenként, akár ezzel a kaszkádművelettel távolít el egy tagot, a hozzá tartozó AKS-fürt nem törlődik.

Az Azure Kubernetes Application Network egyik tagjának eltávolítása

Megjegyzés:

Egy tag eltávolítása előtt el kell távolítania a munkaterheléseket a környezeti adatsíkról azáltal, hogy eltávolítja a korábban alkalmazott Istio-címkéket, például a istio.io/use-waypoint, istio.io/use-waypoint-namespace és istio.io/dataplane-mode címkéket az erőforrásokból.

  1. Távolítsa el a felhasználót az Azure Kubernetes Application Network hálózatból a az appnet member remove paranccsal.

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

  2. Ellenőrizze, hogy a tag el lett-e távolítva a az appnet member list parancs használatával.

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

Azure Kubernetes Application Network-erőforrás törlése

  • Törölje az Azure Kubernetes Application Network-erőforrást a az appnet delete paranccsal.

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

Kapcsolódó tartalom

Az Azure Kubernetes Application Networkről az alábbi cikkekben olvashat bővebben:

  • Utolsó frissítés időpontja: