A Tanzuhoz készült alkalmazáskonfigurálási szolgáltatás használata
Feljegyzés
Az Alapszintű, a Standard és a Nagyvállalati csomag 2025. március közepétől megszűnik, 3 éves nyugdíjazási időszakkal. Javasoljuk, hogy váltson az Azure Container Appsre. További információkért lásd az Azure Spring Apps kivonási bejelentését.
A standard felhasználás és a dedikált csomag 2024. szeptember 30-tól megszűnik, hat hónap után pedig teljes leállítással. Javasoljuk, hogy váltson az Azure Container Appsre. További információ: Azure Spring Apps Standard-használat migrálása és dedikált csomag az Azure Container Appsbe.
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
- Már kiépített Azure Spring Apps Enterprise-csomagpéldány, amelyen engedélyezve van az Application Configuration Service. További információ : Rövid útmutató: Alkalmazások létrehozása és üzembe helyezése az Azure Spring Appsben a Nagyvállalati csomag használatával.
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 Beállítások 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.
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-config git@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} -Szabadon választható. Annak a profilnak a neve, amelynek a tulajdonságait lekérheti. Egy üres érték vagy érték
default
olyan 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ó.
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-hezA 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 algorithm
van megadva: .Host key algorithm
Gen1-hez nem
Igen a Gen2-hezAz algoritmus a következőhöz hostKey
: egyikssh-dss
,ssh-rsa
,ecdsa-sha2-nistp256
,ecdsa-sha2-nistp384
ésecdsa-sha2-nistp521
. (A beszállításhozHost key
kö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
ésfalse
. Az alapértelmezett értéktrue
.
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 algorithm van megadva: . |
Host key algorithm |
Az algoritmus a következőhöz hostKey : egyik ssh-dss , ssh-rsa , ecdsa-sha2-nistp256 , ecdsa-sha2-nistp384 vagy ecdsa-sha2-nistp521 . |
Az alábbi lépésekkel frissíthet Gen1-ről Gen2-re:
Az Azure Portalon lépjen az Azure Spring Apps-szolgáltatáspéldány Alkalmazáskonfigurációs szolgáltatás lapjára.
Válassza a Beállítások szakaszt, majd a Generáció legördülő menü Gen2 elemét.
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.
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 ezConfigMap
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 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, amelyspring-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óvalAZURE_SPRING_APPS_CONFIG_FILE_PATH
lehet 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:
Válassza az Alkalmazáskonfigurációs szolgáltatás lehetőséget.
Válassza az Áttekintés lehetőséget az Application Configuration Service-hez lefoglalt futó állapot és erőforrások megtekintéséhez.
Válassza a Beállítások lehetőséget , és adjon hozzá egy új bejegyzést az Adattárak szakaszban a Git háttérinformációival.
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.
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ási szakaszá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:
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:
Nyissa meg az Alkalmazáskötés lapot.
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.
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.
A navigációs menüBen válassza az Alkalmazások lehetőséget az összes alkalmazás listájának megtekintéséhez.
Válassza ki a célalkalmazást az
name
oszlop mintáinak konfigurálásához.A navigációs ablakban válassza a Konfiguráció, majd az Általános beállítások lehetőséget.
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.
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:
A navigációs ablakban válassza az Alkalmazások lehetőséget az összes alkalmazás megtekintéséhez.
Új alkalmazás létrehozásához válassza az Alkalmazás létrehozása lehetőséget.
Adja meg az új alkalmazás nevét.
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.
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:
- Keresse meg a szolgáltatáserőforrást, majd válassza az Application Configuration Service lehetőséget.
- Válassza a Kezelés lehetőséget.
- 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.
- 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 ConfigMap
felső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:
Nyissa meg az Azure Portalt , és nyissa meg az Azure Spring Apps szolgáltatáspéldányt.
A navigációs ablakban válassza a Hozzáférés-vezérlés (IAM) lehetőséget.
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.
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.
Válassza a Tagok lehetőséget, majd keresse meg és válassza ki a felhasználónevét.
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:
Csatlakozzon az egyik alkalmazáspéldányhoz. További információ: Csatlakozás alkalmazáspéldányhoz hibaelhárításhoz.
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
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:
Nyissa meg az Azure Spring Apps-példányt.
A navigációs panelen válassza a Diagnosztikai beállítások lehetőséget.
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.
A Naplók szakaszban válassza ki a Rendszernaplók kategóriát.
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.
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:
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.
Nyissa meg az Azure Spring Apps-példányt.
A navigációs menüben válassza a Naplók, majd az Áttekintés lehetőséget.
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-service
használja a következő lekérdezést:AppPlatformSystemLogs | where LogType in ("ApplicationConfigurationService") | project TimeGenerated , ServiceName , LogType, Log , _ResourceId | limit 100
A naplók megtekintéséhez
flux-source-controller
használja a következő lekérdezést:AppPlatformSystemLogs | where LogType in ("Flux") | project TimeGenerated , ServiceName , LogType, Log , _ResourceId | limit 100
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.
A konfigurációs fájlok Git-változatainak vizsgálata
A minta konfigurációs fájljának Git-változatát az Application Configuration Service naplóiban találja. Az alábbi példanapló azt jelzi, hogy a minta konfigurációs fájlja payment/default
az main
adattár ágából https://github.com/Azure-Samples/acme-fitness-store-config
származikexample-commit-id
. A naplók lekérdezését a Naplók ellenőrzése szakaszban ismerheti meg.
Applied ConfigMap ({config-map-name}) for content (payment/default) from Git repositories https://github.com/Azure-Samples/acme-fitness-store-config@main@sha1:{example-commit-id}
A Git-változatot az Azure CLI használatával is megtalálhatja. További információ: Konfigurációs fájl vizsgálata az Azure CLI-vel szakasz.
Feljegyzés
A Git-változat nem érhető el az Application Configuration Service Gen1 verziójához.
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.
- Győződjön meg arról, hogy az Alkalmazáskonfigurációs szolgáltatás a megfelelő Git-változatokat használja a konfigurációs fájlok vizsgálatával foglalkozó szakaszban leírtak szerint.
- 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.