A Tanzuhoz készült alkalmazáskonfigurálási szolgáltatás használata

  • Cikk

Feljegyzés

Az Azure Spring Apps az Azure Spring Cloud szolgáltatás új neve. Bár a szolgáltatásnak új neve van, bizonyos helyeken a régi nevet fogja látni egy darabig, miközben az eszközök, például képernyőképek, videók és diagramok frissítésével dolgozunk.

Ez a cikk a következőre vonatkozik:❌ Basic/Standard ✔️ Enterprise

Ez a cikk bemutatja, hogyan használhatja az Application Configuration Service for VMware Tanzu szolgáltatást az Azure Spring Apps Enterprise-csomaggal.

A VMware Tanzu alkalmazáskonfigurációs szolgáltatása az egyik kereskedelmi VMware Tanzu-összetevő. Lehetővé teszi a Kubernetes natív ConfigMap erőforrásainak kezelését, amelyek egy vagy több Git-adattárban meghatározott tulajdonságokból vannak feltöltve.

Az Alkalmazáskonfigurációs szolgáltatással központi helyen kezelheti az alkalmazások külső tulajdonságait minden környezetben. Az Alapszintű és a Standard csomagokban található Spring Cloud Config Server közötti különbségek megismeréséhez tekintse meg az Azure Spring Apps Alapszintű vagy Standard csomagpéldány migrálásának vállalati csomagba történő migrálásáról szóló, az Alkalmazáskonfigurációs szolgáltatás használata külső konfigurációs szolgáltatáshoz című szakaszát.

Az Application Configuration Service két verzióban érhető el: Gen1 és Gen2. A Gen1-verzió elsősorban a meglévő ügyfeleket szolgálja ki visszamenőleges kompatibilitás céljából, és csak 2024. április 30-ig támogatott. Az új szolgáltatáspéldányoknak Gen2-t kell használniuk. A Gen2-verzió a Fluxot használja háttérrendszerként a Git-adattárakkal való kommunikációhoz, és jobb teljesítményt nyújt az 1. generációs verzióhoz képest.

Az alábbi táblázat az alösszetevő kapcsolatokat mutatja be:

Alkalmazáskonfigurációs szolgáltatás létrehozása Részösszetevők
Gen1 application-configuration-service
Gen2 application-configuration-service
flux-source-controller

Az alábbi táblázat néhány referenciaadatot mutat be. A Git-adattár mérete azonban kulcsfontosságú tényező, amely jelentős hatással van a teljesítményadatokra. Javasoljuk, hogy csak a szükséges konfigurációs fájlokat tárolja a Git-adattárban, hogy kicsi legyen.

Alkalmazáskonfigurációs szolgáltatás létrehozása 100 minta alatti frissítés időtartama A frissítés időtartama 250 minta alatt 500 minta alatti frissítés időtartama
Gen1 330 s 840 s 1500 s
Gen2 13 s 100 s 378 s

A Gen2 több biztonsági ellenőrzést is biztosít, amikor távoli Git-adattárhoz csatlakozik. A Gen2 biztonságos kapcsolatot igényel, ha HTTPS-t használ, és SSH-kapcsolat használatakor ellenőrzi a megfelelő gazdagépkulcsot és gazda algoritmust.

Az Azure Spring Apps Enterprise szolgáltatáspéldány létrehozásakor kiválaszthatja az Alkalmazáskonfigurációs szolgáltatás verzióját. Az alapértelmezett verzió a Gen1. A példány létrehozása után a Gen2-re is frissíthet, de a visszalépés nem támogatott. A frissítés nulla állásidővel rendelkezik, de továbbra is javasoljuk, hogy éles környezetbe való áttérés előtt tesztelje az átmeneti környezetben.

Előfeltételek

Alkalmazáskonfigurációs szolgáltatás beállításainak kezelése

Az Application Configuration Service támogatja az Azure DevOps, a GitHub, a GitLab és a Bitbucket szolgáltatást a konfigurációs fájlok tárolásához.

A szolgáltatásbeállítások kezeléséhez nyissa meg a Gépház szakaszt. Ebben a szakaszban a következő főbb szempontokat konfigurálhatja:

  • Generáció: A szolgáltatás generációjának frissítése.
  • Frissítési időköz: Állítsa be, hogy a szolgáltatás milyen gyakorisággal keressen frissítéseket a Git-adattárakból.
  • Adattárak: Új bejegyzések hozzáadása vagy meglévők módosítása. Ez a függvény lehetővé teszi annak szabályozását, hogy a szolgáltatásmonitorok mely adattárakat használják az adatok lekéréséhez.

Képernyőkép az Azure Portalról, amelyen az Alkalmazáskonfigurációs szolgáltatás lap látható, és a Gépház lap ki van emelve.

Ha az aktuális szolgáltatásgeneráció Gen1, a jobb teljesítmény érdekében frissíthet Gen2-re . További információ: Frissítés Gen1-ről Gen2-re .

A frissítési időköz megadja az adattárban lévő frissítések ellenőrzésének gyakoriságát (másodpercben). A minimális érték 0, ami letiltja az automatikus frissítést. Az optimális teljesítmény érdekében állítsa ezt az időközt legalább 60 másodperces értékre.

Az alábbi táblázat az egyes adattárbejegyzések tulajdonságait ismerteti:

Tulajdonság Kötelező? Leírás
Name Igen Egyedi név az egyes Git-adattárak címkézéséhez.
Patterns Igen A Git-adattárakban keresendő minták. Minden mintához használjon {application} vagy {application}/{profile} formátumot az {application}-{profile} .yml helyett. A mintákat vesszővel elválasztjuk. További információkért tekintse meg a cikk Minta szakaszát.
URI Igen Git URI (például https://github.com/Azure-Samples/piggymetrics-configgit@github.com:Azure-Samples/piggymetrics-config)
Label Igen A Git-adattárban keresni kívánt ág neve.
Search path Nem Nem kötelező keresési útvonalak vesszővel elválasztva a Git-adattár alkönyvtárainak kereséséhez.

Minta

A konfiguráció a Git háttérrendszereiből lesz lekért, a mintában definiált adatok alapján. A minta {application}/{profile} kombinációja az alábbi irányelvekben leírtak szerint.

  • {application} - Annak az alkalmazásnak a neve, amelynek a konfigurációját lekérte. Az érték application az alapértelmezett alkalmazás, és több alkalmazás között megosztott konfigurációs információkat tartalmaz. Bármely más érték egy adott alkalmazásra hivatkozik, és az alapértelmezett alkalmazás adott alkalmazásának és megosztott tulajdonságainak tulajdonságait is tartalmazza.
  • {profile} -Választható. Annak a profilnak a neve, amelynek a tulajdonságait lekérheti. Egy üres érték vagy érték defaultolyan tulajdonságokat tartalmaz, amelyek a profilok között vannak megosztva. A nem alapértelmezett értékek közé tartoznak a megadott profil tulajdonságai és az alapértelmezett profil tulajdonságai.

Hitelesítés

Az alábbi képernyőképen az Application Configuration Service által támogatott három típusú adattár-hitelesítés látható.

Képernyőkép az Azure Portalról, amelyen az Alkalmazáskonfigurációs szolgáltatás lap látható, és a Hitelesítés típusa menü ki van emelve.

Az alábbi lista a három hitelesítési típust ismerteti:

  • Nyilvános adattár.

    Nyilvános adattár használata esetén nincs szükség további hitelesítési konfigurációra. Válassza a Nyilvános lehetőséget a Hitelesítési űrlapon.

    Az alábbi táblázat a nyilvános Git-adattár beállításához használható konfigurálható tulajdonságot mutatja be:

    Tulajdonság Kötelező? Leírás
    CA certificate Nem Csak akkor szükséges, ha önaláírt tanúsítványt használ a Git-adattár URL-címéhez.

  • Privát adattár alapszintű hitelesítéssel.

    Az alábbi táblázat a privát Git-adattár alapszintű hitelesítéssel történő beállításához használható konfigurálható tulajdonságokat mutatja be:

    Tulajdonság Kötelező? Leírás
    username Igen Az adattár eléréséhez használt felhasználónév.
    password Igen Az adattár eléréséhez használt jelszó.
    CA certificate Nem Csak akkor szükséges, ha önaláírt tanúsítványt használ a Git-adattár URL-címéhez.

  • Privát adattár SSH-hitelesítéssel.

    Az alábbi táblázat a privát Git-adattár SSH-val való beállításához használható konfigurálható tulajdonságokat mutatja be:

    Tulajdonság Kötelező? Leírás
    Private key Igen A Git-felhasználót azonosító titkos kulcs. A jelszóval titkosított titkos kulcsok nem támogatottak.
    Host key Gen1-hez nem
    Igen a Gen2-hez    		 A Git-kiszolgáló gazdakulcsa. Ha a giten keresztül csatlakozik a kiszolgálóhoz a parancssorban, a gazdakulcs az .ssh/known_hosts fájlban található. Ne adja meg az algoritmus előtagját, mert az a következőben Host key algorithmvan megadva: .
    Host key algorithm Gen1-hez nem
    Igen a Gen2-hez    		 Az algoritmus a következőhöz hostKey: egyik ssh-dss, ssh-rsa, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384és ecdsa-sha2-nistp521. (A beszállításhoz Host keykötelező megadni).
    Strict host key checking Nem Nem kötelező érték, amely azt jelzi, hogy a háttérrendszert figyelmen kívül kell-e hagyni, ha hibát tapasztal a megadott Host key. Az érvényes értékek a következők: true és false. Az alapértelmezett érték true.

A cél URI-hoz való hozzáférés ellenőrzéséhez válassza az Ellenőrzés lehetőséget. Az ellenőrzés sikeres befejezése után válassza az Alkalmaz lehetőséget a konfigurációs beállítások frissítéséhez.

Frissítés Gen1-ről Gen2-re

Az Application Configuration Service Gen2 jobb teljesítményt nyújt a Gen1-hez képest, különösen akkor, ha nagy számú konfigurációs fájllal rendelkezik. Javasoljuk a Gen2 használatát, különösen azért, mert a Gen1 hamarosan megszűnik. A Gen1-ről Gen2-re való frissítés nulla állásidőt jelent, de továbbra is azt javasoljuk, hogy éles környezetbe való áttérés előtt tesztelje az átmeneti környezetben.

A Gen2 több konfigurációs tulajdonságot igényel, mint a Gen1 SSH-hitelesítés esetén. Frissítenie kell az alkalmazás konfigurációs tulajdonságait, hogy működjön a Gen2-vel. Az alábbi táblázat a Gen2 szükséges tulajdonságait mutatja be az SSH-hitelesítés használatakor:

Tulajdonság Leírás
Host key A Git-kiszolgáló gazdakulcsa. Ha a giten keresztül csatlakozik a kiszolgálóhoz a parancssorban, a gazdakulcs az .ssh/known_hosts fájlban található. Ne adja meg az algoritmus előtagját, mert az a következőben Host key algorithmvan megadva: .
Host key algorithm Az algoritmus a következőhöz hostKey: egyik ssh-dss, ssh-rsa, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384vagy ecdsa-sha2-nistp521.

Az alábbi lépésekkel frissíthet Gen1-ről Gen2-re:

  1. Az Azure Portalon lépjen az Azure Spring Apps-szolgáltatáspéldány Alkalmazáskonfigurációs szolgáltatás lapjára.

  2. Válassza ki a Gépház szakaszt, majd válassza a Gen2 lehetőséget a Generáció legördülő menüben.

    Képernyőkép az Azure Portalról, amelyen az Alkalmazáskonfigurációs szolgáltatás lap látható, és megjelenik a Gépház lap, és megnyílik a Generáció menü.

  3. Válassza az Ellenőrzés lehetőséget a cél URI-hoz való hozzáférés ellenőrzéséhez. Az ellenőrzés sikeres befejezése után válassza az Alkalmaz lehetőséget a konfigurációs beállítások frissítéséhez.

    Képernyőkép az Azure Portalról, amelyen az Alkalmazáskonfigurációs szolgáltatás lapja és a Gépház lap látható, kiemelve az Ellenőrzés gombot.

Polyglot-támogatás

Az Alkalmazáskonfigurációs szolgáltatás zökkenőmentesen működik a Spring Boot-alkalmazásokkal. A szolgáltatás által létrehozott tulajdonságokat a Spring Boot külső konfigurációként importálja, és a babba injektálja. Nem kell külön kódot írnia. Az értékeket felhasználhatja a széljegyzetek használatával, amelyeket a @Value Spring's Environment absztrakcióján keresztül érhet el, vagy strukturált objektumokhoz kötheti őket a @ConfigurationProperties széljegyzet használatával.

Az Alkalmazáskonfigurációs szolgáltatás olyan többplatformos alkalmazásokat is támogat, mint a dotNET, a Go, a Python stb. Ha olyan konfigurációs fájlokat szeretne elérni, amelyeket be szeretne tölteni a többplatformos alkalmazások üzembe helyezése során az alkalmazásokban, próbáljon meg hozzáférni egy olyan fájlelérési útvonalhoz, amelyet egy környezeti változón keresztül, például AZURE_SPRING_APPS_CONFIG_FILE_PATH. Az elérési út alatt elérheti az összes tervezett konfigurációs fájlt. A konfigurációs fájlok tulajdonságértékeinek eléréséhez használja az alkalmazás meglévő olvasási/írási fájltárait.

Frissítési stratégiák

Amikor módosítja és véglegesíti a konfigurációkat egy Git-adattárban, több lépésben is részt vesz, mielőtt ezek a módosítások megjelennek az alkalmazásokban. Ez a folyamat, bár automatizált, a következő különböző fázisokat és összetevőket foglalja magában, amelyek mindegyike saját időzítéssel és viselkedéssel rendelkezik:

  • Lekérdezés az Application Configuration Service-ben: Az Alkalmazáskonfigurációs szolgáltatás rendszeresen lekérdezi a háttérbeli Git-adattárakat a módosítások észleléséhez. Ez a lekérdezés a frissítési időköz által meghatározott gyakorisággal történik. Ha módosítást észlel, az Application Configuration Service frissíti a Kubernetes szolgáltatást ConfigMap.
  • ConfigMap kubelet-gyorsítótár frissítése és használata: Az Azure Spring Appsben ez ConfigMap adatkötetként van csatlakoztatva a megfelelő alkalmazáshoz. Ennek a folyamatnak azonban természetes késése van, mivel a kubelet a gyorsítótár frissítésének gyakorisága miatt felismeri a változásokat.ConfigMap
  • Az alkalmazás beolvassa a frissített konfigurációt: Az Azure Spring Apps-környezetben futó alkalmazás hozzáférhet a frissített konfigurációs értékekhez. A spring context meglévő babjai nem frissülnek automatikusan a frissített konfigurációk használatához.

Ezeket a szakaszokat a következő diagram foglalja össze:

Az Application Configuration Service frissítési folyamatának életciklusát bemutató ábra.

Az Alkalmazáskonfigurációs szolgáltatás lekérdezési frissítési időközét az igényeinek megfelelően módosíthatja. A frissített konfigurációk alkalmazáson belüli alkalmazásba való alkalmazásához újraindítási vagy frissítési művelet szükséges.

A Spring-alkalmazásokban a tulajdonságok a Spring Contextben babként vannak tárolva vagy hivatkozva. Új konfigurációk betöltéséhez fontolja meg a következő módszerek használatát:

  • Indítsa újra az alkalmazást. Az alkalmazás újraindítása mindig betölti az új konfigurációt.

  • Hívja meg a /actuator/refresh konfigurációs ügyfélen közzétett végpontot a Spring Actuatoron keresztül.

    A módszer használatához adja hozzá a következő függőséget a konfigurációs ügyfél pom.xml fájljához.

    <dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

    Az aktuátorvégpontot a következő konfiguráció hozzáadásával is engedélyezheti:

    management.endpoints.web.exposure.include=refresh, bus-refresh, beans, env

    Miután újra betölti a tulajdonságforrásokat a /actuator/refresh végpont meghívásával, a megjegyzést @RefreshScope tartalmazó babban lévő @Value attribútumok frissülnek.

    @Service
@Getter @Setter
@RefreshScope
public class MyService {
   @Value
   private Boolean activated;
}

    Az új konfiguráció frissítéséhez használja a curl-t az alkalmazásvégponttal, ahogyan az a következő példában látható:

    curl -X POST http://{app-endpoint}/actuator/refresh

  • A fájlmódosítás megtekintésére és a környezet igény szerinti frissítésére használható FileSystemWatcher . FileSystemWatcher egy olyan osztály, amely spring-boot-devtools bizonyos könyvtárakat figyel a fájlmódosításokhoz, vagy használhat egy másik hasonló függvényt. Az előző beállítás megköveteli, hogy a felhasználók aktívan kezdeményezik a frissítést, míg az utóbbi figyelheti a fájlmódosításokat, és automatikusan meghívhatja a frissítést a frissítések észlelésekor. A fájl elérési útját a Polyglot támogatási szakaszában említett környezeti változóval AZURE_SPRING_APPS_CONFIG_FILE_PATHlehet lekérni.

Alkalmazáskonfigurációs szolgáltatás beállításainak konfigurálása

Az Alkalmazáskonfigurációs szolgáltatás konfigurálásához kövesse az alábbi lépéseket:

  1. Válassza az Alkalmazáskonfigurációs szolgáltatás lehetőséget.

  2. Válassza az Áttekintés lehetőséget az Application Configuration Service-hez lefoglalt futó állapot és erőforrások megtekintéséhez.

    Képernyőkép az Azure Portalról, amelyen az Alkalmazáskonfigurációs szolgáltatás lap van kiemelve az Áttekintés lapon.

  3. Válassza a Gépház lehetőséget, és adjon hozzá egy új bejegyzést az Adattárak szakaszban a Git háttéradataival.

  4. Válassza az Ellenőrzés lehetőséget a cél URI-hoz való hozzáférés ellenőrzéséhez. Az ellenőrzés sikeres befejezése után válassza az Alkalmaz lehetőséget a konfigurációs beállítások frissítéséhez.

    Képernyőkép az Azure Portalról, amelyen az Alkalmazáskonfigurációs szolgáltatás lap látható, amelyen a Gépház lap és az Ellenőrzés gomb van kiemelve.

A TLS-tanúsítvány konfigurálása a Git-háttérrendszer eléréséhez a Gen2 önaláírt tanúsítványával

Ez a lépés nem kötelező. Ha önaláírt tanúsítványt használ a Git-háttérrendszerhez, konfigurálnia kell a TLS-tanúsítványt a Git háttérrendszer eléréséhez.

Először fel kell töltenie a tanúsítványt az Azure Spring Appsbe. További információkért tekintse meg a TLS/SSL-tanúsítványok használatának tanúsítványimportálásiszakaszát az alkalmazásban az Azure Spring Appsben.

A TLS-tanúsítvány konfigurálásához kövesse az alábbi lépéseket:

  1. Keresse meg a szolgáltatáserőforrást, majd válassza az Application Configuration Service lehetőséget.

  2. Válassza a Gépház lehetőséget, és adjon hozzá vagy frissítsen egy új bejegyzést az Adattárak szakaszban a Git háttérinformációival.

    Képernyőkép az Azure Portalról, amelyen az Alkalmazáskonfigurációs szolgáltatás lap látható, és megjelenik a Gépház lap.

Alkalmazáskonfigurációs szolgáltatás használata alkalmazásokkal

Ha Git háttérrendszerrel használja az Application Configuration Service-t, és a központi konfigurációkat használja, az alkalmazást az Application Configuration Service-hez kell kötnie.

Az Alkalmazáskonfigurációs szolgáltatás alkalmazásokkal való használatához kövesse az alábbi lépéseket:

  1. Nyissa meg az Alkalmazáskötés lapot.

  2. Válassza a Kötés alkalmazás lehetőséget , és válasszon egy alkalmazást a legördülő listából. Válassza az Alkalmaz elemet a kötéshez.

    Képernyőkép az Azure Portalról, amelyen az Alkalmazáskonfigurációs szolgáltatás lap látható, és az Alkalmazáskötés lap ki van emelve.

    Feljegyzés

    Amikor módosítja a kötés/kötés nélküli állapotot, újra kell indítania vagy újra kell üzembe helyeznie az alkalmazást a kötés érvénybe lépéséhez.

  3. A navigációs menüBen válassza az Alkalmazások lehetőséget az összes alkalmazás listájának megtekintéséhez.

  4. Válassza ki a célalkalmazást az name oszlop mintáinak konfigurálásához.

  5. A navigációs ablakban válassza a Konfiguráció, majd az Általános beállítások lehetőséget.

  6. A Konfigurációs fájlminták legördülő listában válasszon ki egy vagy több mintát a listából. További információ: Minta szakasz.

    Képernyőkép az Azure Portalról, amelyen az Alkalmazáskonfiguráció lap látható, amelyen az Általános beállítások lap és az API-Gateway beállításai vannak kiemelve.

  7. Válassza a Mentés lehetőséget.

Alkalmazás kötése az Alkalmazáskonfigurációs szolgáltatáshoz

Most már dönthet úgy, hogy új alkalmazás létrehozásakor az alkalmazást az Alkalmazáskonfigurációs szolgáltatáshoz köti.

Az alábbi lépésekkel hozzon létre egy új alkalmazást, és kösse az alkalmazáskonfigurációs szolgáltatáshoz:

  1. A navigációs ablakban válassza az Alkalmazások lehetőséget az összes alkalmazás megtekintéséhez.

  2. Új alkalmazás létrehozásához válassza az Alkalmazás létrehozása lehetőséget.

  3. Adja meg az új alkalmazás nevét.

  4. Válassza a Kötés lapot, majd válassza az Alkalmazáskonfigurációs szolgáltatás lehetőséget a legördülő menüből.

    Képernyőkép az Azure Portalról, amelyen az Alkalmazás létrehozása lap látható, és a Kötés legördülő lista ki van emelve.

  5. Válassza a Létrehozás lehetőséget az alkalmazás létrehozásának befejezéséhez és az Alkalmazáskonfigurációs szolgáltatáshoz való kötéséhez.

Alkalmazáskonfigurációs szolgáltatás engedélyezése/letiltása a szolgáltatás létrehozása után

A szolgáltatás létrehozása után engedélyezheti és letilthatja az Alkalmazáskonfigurációs szolgáltatást az Azure Portalon vagy az Azure CLI-vel. Az Alkalmazáskonfigurációs szolgáltatás letiltása előtt le kell tiltani az összes alkalmazás kötését.

Az Alkalmazáskonfigurációs szolgáltatás engedélyezéséhez vagy letiltásához kövesse az alábbi lépéseket:

  1. Keresse meg a szolgáltatáserőforrást, majd válassza az Application Configuration Service lehetőséget.
  2. Válassza a Kezelés lehetőséget.
  3. Válassza az Alkalmazáskonfigurációs szolgáltatás engedélyezése jelölőnégyzetet, vagy törölje a jelölését, majd válassza a Mentés lehetőséget.
  4. Most már megtekintheti az Alkalmazáskonfigurációs szolgáltatás állapotát az Alkalmazáskonfigurációs szolgáltatás lapon.

Konfigurációs fájl vizsgálata a ConfigMap-ban

Az alábbi szakasz bemutatja, hogyan vizsgálhatja meg az Application Configuration Service által a kapcsolódó Kubernetes ConfigMapfelsőbb rétegbeli Git-adattáraiból lekért konfigurációs fájl tartalmát. További információkért tekintse meg a cikk Frissítési stratégiák szakaszát.

Azure-szerepkör hozzárendelése

Először hozzá kell rendelnie az Azure-szerepkört Azure Spring Apps Application Configuration Service Config File Pattern Reader Role .

Azure-szerepkör hozzárendeléséhez kövesse az alábbi lépéseket:

  1. Nyissa meg az Azure Portalt , és nyissa meg az Azure Spring Apps szolgáltatáspéldányt.

  2. A navigációs ablakban válassza a Hozzáférés-vezérlés (IAM) lehetőséget.

  3. A Hozzáférés-vezérlés (IAM) lapon válassza a Hozzáadás, majd a Szerepkör-hozzárendelés hozzáadása lehetőséget.

    Képernyőkép az Azure Portalról, amelyen egy Azure Spring Apps-példány hozzáférés-vezérlési (IAM) lapja látható a szerepkör-hozzárendelés hozzáadása lehetőség kiemelésével.

  4. A Szerepkör-hozzárendelés hozzáadása lap Név listájában keresse meg és jelölje ki a célszerepkört, majd válassza a Tovább lehetőséget.

    Képernyőkép az Azure Portalról, amelyen egy Azure Spring Apps-példány szerepkör-hozzárendelési lapja látható az Azure Spring Apps alkalmazáskonfigurációs szolgáltatás konfigurációs szolgáltatásának konfigurációs fájlminta-olvasó szerepkörneve kiemelésével.

  5. Válassza a Tagok lehetőséget, majd keresse meg és válassza ki a felhasználónevét.

  6. Válassza az Áttekintés + hozzárendelés lehetőséget.

Konfigurációs fájl vizsgálata az Azure CLI-vel

A konfigurációs fájl tartalmát minta szerint az alábbi paranccsal tekintheti meg:

az spring application-configuration-service config show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --config-file-pattern <pattern>

Ez a parancs az alábbi példához hasonló JSON-kimenetet hoz létre:

{
  "configurationFiles": {
    "application.properties": [
      "example.property.application.name: example-service",
      "example.property.cloud: Azure"
    ]
  },
  "metadata": {
    "gitRevisions": "[{\"url\":\"{gitRepoUrl}\",\"revision\":\"{revisionInfo}\"}]"
  }
}

Feljegyzés

A metadata tulajdonságok nem gitRevisions érhetők el az Alkalmazáskonfigurációs szolgáltatás Gen1 verziójához.

Ezzel a paranccsal a --export-path {/path/to/target/folder} paraméterrel is exportálhatja a konfigurációs fájlt a megadott mappába. A relatív és az abszolút elérési utakat is támogatja. Ha nem adja meg az elérési utat, a parancs alapértelmezés szerint az aktuális könyvtár elérési útját használja.

Konfigurációs fájl vizsgálata az alkalmazásban

Miután az alkalmazást az Alkalmazáskonfigurációs szolgáltatáshoz kötötte, és beállította az alkalmazástelepítés mintáját a jelen cikk Alkalmazáskonfigurációs szolgáltatás használata alkalmazásokkal szakaszában leírtak szerint, a ConfigMap minta konfigurációs fájlját az alkalmazástárolóhoz kell csatlakoztatni. Az alábbi lépésekkel ellenőrizheti a konfigurációs fájlokat az alkalmazás üzembe helyezésének minden egyes példányában:

  1. Csatlakozás az egyik alkalmazáspéldányra. További információ: Csatlakozás egy alkalmazáspéldányra hibaelhárítás céljából.

  2. echo $AZURE_SPRING_APPS_CONFIG_FILE_PATH A parancs használatával keresse meg a konfigurációs fájlokat tartalmazó mappákat. A helyek listája vesszővel elválasztva jelenik meg az alábbi példában látható módon:

      $ echo $AZURE_SPRING_APPS_CONFIG_FILE_PATH
  /etc/azure-spring-cloud/configmap/acs-default-payment-default-e9d46,/etc/azure-spring-cloud/configmap/acs-default-catalog-default-616f4

  3. Ellenőrizze a konfigurációs fájl tartalmát olyan parancsokkal, mint a cat.

Feljegyzés

A Git-változat adatai nem érhetők el az alkalmazásban.

Naplók ellenőrzése

Az alábbi szakaszok bemutatják, hogyan tekintheti meg az alkalmazásnaplókat az Azure CLI vagy az Azure Portal használatával.

Valós idejű naplóstreamelés használata

A naplókat valós időben streamelheti az Azure CLI-vel. További információ: Stream Azure Spring Apps felügyelt összetevők naplói valós időben. Az alábbi példák azt mutatják be, hogyan használhatja az Azure CLI-parancsokat az új naplók folyamatos streamelésére és flux-source-controller alösszetevők számáraapplication-configuration-service.

A következő paranccsal streamelje a naplókat a következőhöz application-configuration-service:

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name application-configuration-service \
    --all-instances \
    --follow

A következő paranccsal streamelje a naplókat a következőhöz flux-source-controller:

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name flux-source-controller \
    --all-instances \
    --follow

A Log Analytics használata

Az alábbi szakaszok bemutatják, hogyan kapcsolhatja be és tekintheti meg a rendszernaplókat a Log Analytics használatával.

Diagnosztikai beállítások a Log Analyticshez

Az Application Configuration Service naplóinak lekérdezése előtt be kell kapcsolnia a rendszernaplókat, és el kell küldenie a naplókat a Log Analytics-példánynak. A rendszernaplók Azure Portalon való engedélyezéséhez kövesse az alábbi lépéseket:

  1. Nyissa meg az Azure Spring Apps-példányt.

  2. A navigációs panelen válassza a Diagnosztikai beállítások lehetőséget.

  3. Válassza a Diagnosztikai beállítás hozzáadása lehetőséget, vagy válassza a Szerkesztés beállítást egy meglévő beállításhoz.

  4. A Naplók szakaszban válassza ki a Rendszernaplók kategóriát.

  5. A Cél részletei szakaszban válassza a Küldés a Log Analytics-munkaterületre lehetőséget, majd válassza ki a munkaterületet.

  6. A beállítás frissítéséhez válassza a Mentés lehetőséget.

Naplók ellenőrzése a Log Analyticsben

Az Azure Portal naplóinak application-configuration-service ellenőrzéséhez és flux-source-controller használatához kövesse az alábbi lépéseket:

  1. Győződjön meg arról, hogy bekapcsolta a rendszernaplókat. További információt a Log Analytics diagnosztikai beállításai című szakaszban talál.

  2. Nyissa meg az Azure Spring Apps-példányt.

  3. A navigációs menüben válassza a Naplók, majd az Áttekintés lehetőséget.

  4. Használja az alábbi minta lekérdezéseket a lekérdezés szerkesztése panelen. Állítsa be az időtartományt, majd válassza a Futtatás lehetőséget a naplók kereséséhez.

    • A naplók megtekintéséhez application-configuration-servicehasználja a következő lekérdezést:

      AppPlatformSystemLogs
| where LogType in ("ApplicationConfigurationService")
| project TimeGenerated , ServiceName , LogType, Log , _ResourceId
| limit 100

      Képernyőkép az Azure Portalról, amely az application-configuration-service naplóinak lekérdezési eredményét jeleníti meg.

    • A naplók megtekintéséhez flux-source-controllerhasználja a következő lekérdezést:

      AppPlatformSystemLogs
| where LogType in ("Flux")
| project TimeGenerated , ServiceName , LogType, Log , _ResourceId
| limit 100

      Képernyőkép az Azure Portalról, amely a flux-source-controller naplóinak lekérdezési eredményét jeleníti meg.

Feljegyzés

Előfordulhat, hogy a naplók a Log Analyticsben való rendelkezésre állása előtt néhány perc késéssel járnak.

Ismert problémák elhárítása

Ha a legújabb módosítások nem jelennek meg az alkalmazásokban, ellenőrizze a következő elemeket a Frissítési stratégiák szakasz alapján:

  • Ellenőrizze, hogy a Git-adattár megfelelően van-e frissítve az alábbi elemek ellenőrzésével:
    • Győződjön meg arról, hogy a kívánt konfigurációs fájl módosításainak ága frissült.
    • Ellenőrizze, hogy az Alkalmazáskonfigurációs szolgáltatásban konfigurált minta megegyezik-e a frissített konfigurációs fájlokkal.
    • Ellenőrizze, hogy az alkalmazás az Alkalmazáskonfigurációs szolgáltatáshoz van-e kötve.
  • Ellenőrizze, hogy az ConfigMap alkalmazás által használt minta konfigurációs fájlját tartalmazza-e a cikk konfigurációs fájljának vizsgálata a jelen cikk ConfigMap szakaszában leírtak szerint. Ha nem frissül, emeljen fel egy jegyet.
  • Győződjön meg arról, hogy az ConfigMap alkalmazás fájlként van csatlakoztatva az alkalmazáshoz a jelen cikk alkalmazásszakaszában található Konfiguráció vizsgálata fájlban leírtak szerint. Ha a fájl nem frissül, várjon a Kubernetes frissítési időközére (1 perc), vagy kényszerítse ki a frissítést az alkalmazás újraindításával.

Az elemek ellenőrzése után az alkalmazásoknak képesnek kell lenniük olvasni a frissített konfigurációkat. Ha az alkalmazások még mindig nem frissülnek, adjon meg egy jegyet.

Kapcsolódó tartalom

Azure Spring Apps