Oktatóanyag: Dinamikus konfiguráció használata az Azure Kubernetes Service-ben

Az Azure Kubernetes Service (AKS) használata esetén ez az oktatóanyag bemutatja, hogyan engedélyezheti a számítási feladatok dinamikus konfigurációját az AKS-ben a Azure-alkalmazás konfiguráció és annak Kubernetes-szolgáltatója használatával. Az oktatóanyag feltételezi, hogy végighalad a rövid útmutatón, és be van állítva egy alkalmazáskonfigurációs Kubernetes-szolgáltató, ezért mielőtt továbblép, győződjön meg arról, hogy elvégezte a Azure-alkalmazás-konfiguráció használata az Azure Kubernetes Service-ben rövid útmutatót.

Tipp.

A Kubernetesben üzemeltetett számítási feladatok beállításainak megtekintése Azure-alkalmazás konfiguráció eléréséhez.

Előfeltételek

Fejezze be a rövid útmutatót: Azure-alkalmazás-konfiguráció használata az Azure Kubernetes Service-ben.

Tipp.

Az Azure Cloud Shell egy ingyenes, interaktív rendszerhéj, amellyel futtathatja a cikkben szereplő parancssori utasításokat. Gyakran telepített Azure-eszközökkel rendelkezik, beleértve a .NET Core SDK-t is. Ha bejelentkezett az Azure-előfizetésbe, indítsa el az Azure Cloud Shellt a shell.azure.com. Az Azure Cloud Shellről a dokumentációnk elolvasásával tudhat meg többet.

Sentinel-kulcs hozzáadása

A sentinel kulcs az a kulcs, amelyet az összes többi kulcs módosítása után frissít. Az alkalmazás figyeli a sentinel kulcsot. Ha változás észlelhető, az alkalmazás frissíti az összes konfigurációs értéket. Ez a megközelítés segít biztosítani az alkalmazásban a konfiguráció konzisztenciáját, és csökkenti az Alkalmazáskonfigurációs áruházba érkező kérelmek teljes számát, szemben a módosítások összes kulcsának figyelésével.

Adja hozzá a következő kulcsértéket az Alkalmazáskonfigurációs áruházhoz. Ha többet szeretne tudni arról, hogyan adhat hozzá kulcsértékeket egy áruházhoz az Azure Portal vagy a parancssori felület használatával, lépjen a Kulcs-érték létrehozása elemre.

Kulcs	Érték
Gépház:Sentinel	0

Adatok újrabetöltése az alkalmazáskonfigurációból

1. Nyissa meg az üzembe helyezési könyvtárban található appConfigurationProvider.yaml fájlt. Ezután adja hozzá a refresh tulajdonság alatti szakaszt configuration . Lehetővé teszi a konfiguráció frissítését a sentinel kulcs figyelésével.

   apiVersion: azconfig.io/v1
   kind: AzureAppConfigurationProvider
   metadata:
     name: appconfigurationprovider-sample
   spec:
     endpoint: <your-app-configuration-store-endpoint>
     target:
       configMapName: configmap-created-by-appconfig-provider
       configMapData: 
         type: json
         key: mysettings.json
     auth:
       workloadIdentity:
         managedIdentityClientId: <your-managed-identity-client-id>
     configuration:
       refresh:
         enabled: true
         monitoring:
           keyValues:
           - key: Settings:Sentinel
   

   Tipp.

   Alapértelmezés szerint a Kubernetes-szolgáltató 30 másodpercenként lekérdezi a figyelési kulcsértékeket a változásészleléshez. Ezt a viselkedést azonban módosíthatja a interval tulajdonság refreshbeállításával. Ha csökkenteni szeretné az Alkalmazáskonfigurációs áruházba érkező kérések számát, azt magasabb értékre módosíthatja.

2. Nyissa meg a deployment.yaml fájlt az Üzembehelyezési könyvtárban, és adja hozzá a következő tartalmat a spec.containers szakaszhoz. Az alkalmazás betölti a konfigurációt egy kötetre csatlakoztatott fájlból, amit az alkalmazáskonfigurációs Kubernetes-szolgáltató hoz létre. A környezeti változó beállításával az alkalmazás lekérdezéssel figyelheti a csatlakoztatott fájlok változásait.

   env:
   - name: DOTNET_USE_POLLING_FILE_WATCHER
     value: "true"
   

3. Futtassa a következő parancsot a módosítás üzembe helyezéséhez. Cserélje le a névteret, ha a meglévő AKS-alkalmazást használja.

   kubectl apply -f ./Deployment -n appconfig-demo
   

4. Nyisson meg egy böngészőablakot, és keresse meg az előző lépésben beszerzett IP-címet. A weblap a következőképpen néz ki:

   

5. Frissítse a következő kulcsértékeket az Alkalmazáskonfigurációs áruházban, biztosítva, hogy a sentinel kulcs utolsó frissítése legyen.

   Kulcs	Érték
   Gépház:Üzenet	Hello from Azure-alkalmazás Configuration - most élő frissítésekkel!
   Gépház:Sentinel	2

6. A böngésző néhány alkalommal történő frissítése után a frissített tartalom a ConfigMap 30 másodpercen belüli frissítése után jelenik meg.

   

Konfigurációtérkép és titkos kód újrabetöltése

Az alkalmazáskonfiguráció kubernetes-szolgáltatója létrehoz egy konfigurációt Térképek vagy titkos kulcsokat, amelyek környezeti változókként vagy kötetre csatlakoztatott fájlokként használhatók. Ez az oktatóanyag bemutatja, hogyan tölthető be a konfiguráció egy JSON-fájlból a .NET JSON-konfigurációszolgáltatóval, amely automatikusan újra betölti a konfigurációt, amikor változást észlel a csatlakoztatott fájlban. Ennek eredményeképpen az alkalmazás automatikusan megkapja a frissített konfigurációt, amikor az alkalmazáskonfigurációs Kubernetes-szolgáltató frissíti a ConfigMap-et.

Ha az alkalmazás a konfiguráció környezeti változóitól függ, előfordulhat, hogy újraindításra van szükség a frissített értékek felvételéhez. A Kubernetesben az alkalmazás újraindítása a megfelelő podokon vagy tárolókon futó frissítések használatával vezénylhető. A konfigurációfrissítések automatizálásához használhat olyan külső eszközöket, mint a stakater/reloader, amelyek automatikusan aktiválhatják a Config Térképek vagy a Titkos kódok módosításait.

Következő lépések

A Azure-alkalmazás Konfigurációs Kubernetes-szolgáltatóról további információt Azure-alkalmazás Konfigurációs Kubernetes-szolgáltató hivatkozásában talál.