Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Konfigurační server for Spring poskytuje centralizované umístění pro zpřístupnění konfiguračních dat více aplikacím. V tomto článku se dozvíte, jak připojit aplikaci hostované v Azure Container Apps k instanci Java Config Serveru pro Spring.
Komponenta Konfigurační server pro Spring Java používá úložiště GitHub jako zdroj pro nastavení konfigurace. Hodnoty konfigurace jsou pro vaši aplikaci kontejneru zpřístupněny prostřednictvím vazby mezi komponentou a vaší aplikací kontejneru. Když se hodnoty změní na konfiguračním serveru, automaticky přetékají do vaší aplikace, a to vše bez nutnosti opětovného kompilace nebo opětovného nasazení aplikace.
V tomto kurzu se naučíte:
- Vytvoření komponenty Config Server for Spring Java
- Vytvoření vazby konfiguračního serveru pro Spring k aplikaci kontejneru
- Sledujte hodnoty konfigurace před a po připojení konfiguračního serveru k aplikaci.
- Šifrování a dešifrování hodnot konfigurace pomocí symetrického klíče
Důležité
V tomto kurzu se používají služby, které můžou ovlivnit fakturu za Azure. Pokud se rozhodnete postupovat podle podrobných pokynů, nezapomeňte odstranit prostředky doporučené v tomto článku, abyste se vyhnuli neočekávané fakturaci.
Požadavky
- Účet Azure s aktivním předplatným. Pokud ho ještě nemáte, můžete si ho zdarma vytvořit.
- Rozhraní příkazového řádku Azure.
Důležité informace
Při spuštění na konfiguračním serveru pro Spring v Azure Container Apps mějte na paměti následující podrobnosti:
| Položka | Vysvětlení |
|---|---|
| Scope | Konfigurační server pro Spring běží ve stejném prostředí jako připojená aplikace kontejneru. |
| Škálování | Aby se zachoval jediný zdroj pravdy, konfigurační server pro Spring se škáluje. Vlastnosti minReplicas škálování a maxReplicas obě jsou nastaveny na 1. |
| Materiály | Přidělení prostředků kontejneru pro konfigurační server pro Spring je pevné, počet jader procesoru je 0,5 a velikost paměti je 1Gi. |
| Ceny | Konfigurační server pro fakturaci Spring spadá do cen založených na spotřebě. Prostředky spotřebované spravovanými komponentami Java se účtují podle sazby aktivní/nečinné. K zastavení fakturace můžete odstranit komponenty, které se už nepoužívají. |
| Binding | Aplikace kontejneru se připojí ke konfiguračnímu serveru pro Spring prostřednictvím vazby. Vazba vloží konfigurace do proměnných prostředí kontejneru aplikace. Po vytvoření vazby může aplikace kontejneru číst konfigurační hodnoty z proměnných prostředí. |
Nastavení
Než začnete pracovat s konfiguračním serverem for Spring, musíte nejprve vytvořit požadované prostředky.
Spuštěním následujících příkazů vytvořte skupinu prostředků a prostředí Container Apps.
Vytvořte proměnné pro podporu konfigurace aplikace. Tyto hodnoty jsou k dispozici pro účely této lekce.
export LOCATION=eastus export RESOURCE_GROUP=my-services-resource-group export ENVIRONMENT=my-environment export JAVA_COMPONENT_NAME=configserver export APP_NAME=my-config-client export IMAGE="mcr.microsoft.com/javacomponents/samples/sample-service-config-client:latest" export URI="https://github.com/Azure-Samples/azure-spring-cloud-config-java-aca.git"Proměnná Popis LOCATIONUmístění oblasti Azure, kam vytvoříte aplikaci kontejneru a komponentu Java. ENVIRONMENTNázev prostředí Azure Container Apps pro vaši ukázkovou aplikaci. RESOURCE_GROUPNázev skupiny prostředků Azure pro ukázkovou aplikaci JAVA_COMPONENT_NAMENázev komponenty Java vytvořené pro vaši aplikaci kontejneru. V tomto případě vytvoříte komponentu Config Server for Spring Java. IMAGEImage kontejneru použitá v aplikaci kontejneru. URIIdentifikátor URI můžete nahradit adresou URL úložiště Git, pokud je privátní, přidat související konfigurace ověřování, jako spring.cloud.config.server.git.usernamespring.cloud.config.server.git.passwordje a .Přihlaste se k Azure pomocí Azure CLI.
az loginVytvořte skupinu prostředků.
az group create --name $RESOURCE_GROUP --location $LOCATIONVytvořte prostředí kontejnerových aplikací.
az containerapp env create \ --name $ENVIRONMENT \ --resource-group $RESOURCE_GROUP \ --location $LOCATION
Toto prostředí slouží k hostování komponenty Config Server for Spring Java i aplikace kontejneru.
Vytvoření komponenty Config Server for Spring Java
Teď, když máte prostředí Container Apps, můžete vytvořit aplikaci kontejneru a svázat ji s komponentou Config Server for Spring Java. Když vytvoříte vazbu aplikace kontejneru, hodnoty konfigurace se automaticky synchronizují z komponenty konfiguračního serveru do vaší aplikace.
Vytvořte komponentu Config Server for Spring Java.
az containerapp env java-component config-server-for-spring create \ --environment $ENVIRONMENT \ --resource-group $RESOURCE_GROUP \ --name $JAVA_COMPONENT_NAME \ --min-replicas 1 \ --max-replicas 1 \ --configuration spring.cloud.config.server.git.uri=$URIAktualizujte komponentu Konfigurační server pro Spring Java.
az containerapp env java-component config-server-for-spring update \ --environment $ENVIRONMENT \ --resource-group $RESOURCE_GROUP \ --name $JAVA_COMPONENT_NAME \ --min-replicas 2 \ --max-replicas 2 \ --configuration spring.cloud.config.server.git.uri=$URI spring.cloud.config.server.git.refresh-rate=60Tady říkáte komponentě, kde najít úložiště, které obsahuje informace o konfiguraci prostřednictvím
urivlastnosti. Tatorefresh-ratevlastnost říká Container Apps, jak často se mají kontrolovat změny v úložišti Git.
Vytvoření vazby aplikace kontejneru k komponentě Config Server for Spring Java
Vytvořte aplikaci kontejneru, která využívá konfigurační data.
az containerapp create \ --name $APP_NAME \ --resource-group $RESOURCE_GROUP \ --environment $ENVIRONMENT \ --image $IMAGE \ --min-replicas 1 \ --max-replicas 1 \ --ingress external \ --target-port 8080 \ --query properties.configuration.ingress.fqdnTento příkaz vrátí adresu URL vaší aplikace kontejneru, která využívá konfigurační data. Zkopírujte adresu URL do textového editoru, abyste ji mohli použít v nadcházejícím kroku.
Pokud aplikaci navštívíte v prohlížeči, je vrácená
connectTimeouthodnota výchozí hodnotou0.Vytvořte vazbu na konfigurační server pro Spring.
Teď, když se vytvoří aplikace kontejneru a konfigurační server, svážete je společně s příkazem
updatek vaší aplikaci kontejneru.az containerapp update \ --name $APP_NAME \ --resource-group $RESOURCE_GROUP \ --bind $JAVA_COMPONENT_NAMEParametr
--bind $JAVA_COMPONENT_NAMEvytvoří propojení mezi vaší aplikací kontejneru a komponentou konfigurace.
Jakmile jsou aplikace kontejneru a komponenta konfiguračního serveru svázané, změny konfigurace se automaticky synchronizují s aplikací kontejneru.
Když znovu navštívíte adresu URL aplikace, hodnota connectTimeout je nyní 10000. Tato hodnota pochází z úložiště Git nastaveného v $URI proměnné původně nastavené jako zdroj konfigurační komponenty. Konkrétně se tato hodnota načítá z connectionTimeout vlastnosti v application.yml souboru úložiště.
Požadavek vazby vloží nastavení konfigurace do aplikace jako proměnné prostředí. Tyto hodnoty jsou nyní k dispozici pro kód aplikace, který se má použít při načítání nastavení konfigurace z konfiguračního serveru.
V tomto případě jsou pro aplikaci k dispozici následující proměnné prostředí:
SPRING_CLOUD_CONFIG_URI=http://[JAVA_COMPONENT_INTERNAL_FQDN]:80
SPRING_CLOUD_CONFIG_COMPONENT_URI=http://[JAVA_COMPONENT_INTERNAL_FQDN]:80
SPRING_CONFIG_IMPORT=optional:configserver:$SPRING_CLOUD_CONFIG_URI
Pokud chcete přizpůsobit vlastní SPRING_CONFIG_IMPORT, můžete odkazovat na proměnnou SPRING_CLOUD_CONFIG_COMPONENT_URI prostředí , například můžete přepsat argumenty příkazového řádku, například Java -Dspring.config.import=optional:configserver:${SPRING_CLOUD_CONFIG_COMPONENT_URI}?fail-fast=true.
Můžete také odebrat vazbu z aplikace.
(Volitelné) Zrušení vazby aplikace kontejneru z komponenty Config Server for Spring Java
Pokud chcete odebrat vazbu z aplikace kontejneru, použijte tuto --unbind možnost.
az containerapp update \
--name $APP_NAME \
--unbind $JAVA_COMPONENT_NAME \
--resource-group $RESOURCE_GROUP
Když znovu navštívíte adresu URL aplikace, hodnota connectTimeout se změní zpět na 0adresu URL aplikace.
Vyčištění prostředků
Prostředky vytvořené v tomto kurzu mají vliv na fakturu za Azure. Pokud tyto služby nebudete používat dlouhodobě, spuštěním následujícího příkazu odeberte vše vytvořené v tomto kurzu.
az group delete --resource-group $RESOURCE_GROUP
Možnosti konfigurace
Příkaz az containerapp update používá --configuration parametr k řízení konfigurace konfiguračního serveru pro Spring. Můžete použít více parametrů najednou, pokud jsou oddělené mezerou. Další informace naleznete v tématu Spring Cloud Config Server.
Následující tabulka popisuje různé dostupné hodnoty konfigurace back-endu Gitu:
| Název | Popis |
|---|---|
spring.cloud.config.server.git.uri spring.cloud.config.server.git.repos.{repoName}.uri |
Identifikátor URI vzdáleného úložiště |
spring.cloud.config.server.git.username spring.cloud.config.server.git.repos.{repoName}.username |
Uživatelské jméno pro ověřování pomocí vzdáleného úložiště |
spring.cloud.config.server.git.password spring.cloud.config.server.git.repos.{repoName}.password |
Heslo pro ověřování pomocí vzdáleného úložiště |
spring.cloud.config.server.git.search-paths spring.cloud.config.server.git.repos.{repoName}.search-paths |
Cesty hledání, které se mají použít v místní pracovní kopii. Ve výchozím nastavení prohledá pouze kořen. |
spring.cloud.config.server.git.force-pull spring.cloud.config.server.git.repos.{repoName}.force-pull |
Příznak označující, že úložiště by mělo vynutit přijetí změn. Pokud truezahodíte všechny místní změny a převezmete ho ze vzdáleného úložiště. |
spring.cloud.config.server.git.default-label spring.cloud.config.server.git.repos.{repoName}.default-label |
Výchozí popisek použitý pro Git je hlavní. Pokud nenastavíte spring.cloud.config.server.git.default-label a větev s názvem main neexistuje, konfigurační server se ve výchozím nastavení pokusí rezervovat větev s názvem master. Pokud chcete zakázat chování náhradní větve, můžete nastavit na spring.cloud.config.server.git.tryMasterBranchhodnotu false . |
spring.cloud.config.server.git.try-master-branch spring.cloud.config.server.git.repos.{repoName}.try-master-branch |
Konfigurační server se ve výchozím nastavení pokusí rezervovat větev s názvem master. |
spring.cloud.config.server.git.skip-ssl-validation spring.cloud.config.server.git.repos.{repoName}.skip-ssl-validation |
Ověření konfiguračního serveru certifikátu TLS/SSL serveru Git můžete zakázat nastavením git.skipSslValidation vlastnosti na truehodnotu . |
spring.cloud.config.server.git.clone-on-start spring.cloud.config.server.git.repos.{repoName}.clone-on-start |
Příznak označující, že úložiště by se mělo naklonovat při spuštění, ne na vyžádání. Obecně vede k pomalejšímu spuštění, ale rychlejšímu prvnímu dotazu. |
spring.cloud.config.server.git.timeout spring.cloud.config.server.git.repos.{repoName}.timeout |
Časový limit v sekundách pro získání připojení HTTP nebo SSH, pokud je k dispozici. Výchozí hodnota je 5 sekund. |
spring.cloud.config.server.git.refresh-rate spring.cloud.config.server.git.repos.{repoName}.refresh-rate |
Jak často konfigurační server načítá aktualizovaná konfigurační data z back-endu Gitu. |
spring.cloud.config.server.git.private-key spring.cloud.config.server.git.repos.{repoName}.private-key |
Platný privátní klíč SSH. Musí být nastaveno, pokud ignore-local-ssh-settings je true a identifikátor URI Gitu je ve formátu SSH. |
spring.cloud.config.server.git.host-key spring.cloud.config.server.git.repos.{repoName}.host-key |
Platný klíč hostitele SSH. Musí být nastavena i v případě, že host-key-algorithm je nastavena. |
spring.cloud.config.server.git.host-key-algorithm spring.cloud.config.server.git.repos.{repoName}.host-key-algorithm |
Jeden z ssh-dss, , ssh-rsassh-ed25519, ecdsa-sha2-nistp256, , ecdsa-sha2-nistp384nebo ecdsa-sha2-nistp521. Musí být nastavena i v případě, že host-key je nastavena. |
spring.cloud.config.server.git.strict-host-key-checking spring.cloud.config.server.git.repos.{repoName}.strict-host-key-checking |
true nebo false. Pokud false, ignorovat chyby s klíčem hostitele. |
spring.cloud.config.server.git.repos.{repoName} |
Identifikátor URI vzdáleného úložiště |
spring.cloud.config.server.git.repos.{repoName}.pattern |
Formát vzoru je čárkami oddělený seznam {application}/{profile} názvů se zástupnými cardy. Pokud {application}/{profile} neodpovídá žádnému ze vzorů, použije výchozí identifikátor URI definovaný v rámci. |
Následující seznam popisuje běžné konfigurace:
Protokolování souvisejících konfigurací:
logging.level.*logging.group.*- Všechny ostatní konfigurace v
logging.*oboru názvů by měly být zakázané – například zápis souborů protokolu pomocílogging.fileby měl být zakázán.
spring.cloud.config.server.overrides- Dodatečná mapa zdroje vlastností, která se má odeslat všem klientům bezpodmínečně.
spring.cloud.config.override-none- Prioritu všech přepsání v klientovi můžete změnit tak, aby vypadala podobně jako výchozí hodnoty, takže aplikace do proměnných prostředí nebo vlastností systému zadají vlastní hodnoty, a to nastavením
spring.cloud.config.override-none=truepříznaku – výchozí hodnota je false – ve vzdáleném úložišti.
- Prioritu všech přepsání v klientovi můžete změnit tak, aby vypadala podobně jako výchozí hodnoty, takže aplikace do proměnných prostředí nebo vlastností systému zadají vlastní hodnoty, a to nastavením
spring.cloud.config.allow-override- Pokud povolíte konfiguraci při prvním spuštění, můžete klientským aplikacím povolit přepsání konfigurace z konfiguračního serveru umístěním dvou vlastností do konfigurace aplikací pocházejících z konfiguračního serveru.
spring.cloud.config.server.health.*- Indikátor stavu můžete nakonfigurovat tak, aby kontrolovali více aplikací spolu s vlastními profily a vlastními popisky.
spring.cloud.config.server.accept-empty- Můžete nastavit
spring.cloud.config.server.accept-empty,falseaby server vrátil stav HTTP404, pokud aplikace nebyla nalezena. Ve výchozím nastavení je tento příznak nastaven natrue.
- Můžete nastavit
Šifrování a dešifrování (symetrické):
encrypt.key- Pohodlné použití symetrického klíče, protože se jedná o jednu hodnotu vlastnosti ke konfiguraci.
spring.cloud.config.server.encrypt.enabled- Nastavte tuto vlastnost tak, aby
falsese dešifrování na straně serveru zakázalo.
- Nastavte tuto vlastnost tak, aby
Aktualizovat
Služby, které využívají vlastnosti, musí vědět o změně, než k ní dojde. Výchozí metoda oznámení pro konfigurační server pro Spring zahrnuje ruční aktivaci události aktualizace, například aktualizaci voláním https://<YOUR_CONFIG_CLIENT_HOST_NAME>/actuator/refresh, což nemusí být možné, pokud existuje mnoho instancí aplikace.
Místo toho můžete hodnoty z konfiguračního serveru automaticky aktualizovat tak, že necháte klienta konfigurace dotazovat změny na základě interní aktualizace. Pomocí následujících kroků můžete automaticky aktualizovat hodnoty z konfiguračního serveru:
Zaregistrujte naplánovanou úlohu pro aktualizaci kontextu v daném intervalu, jak je znázorněno v následujícím příkladu:
@Configuration @AutoConfigureAfter({RefreshAutoConfiguration.class, RefreshEndpointAutoConfiguration.class}) @EnableScheduling public class ConfigClientAutoRefreshConfiguration implements SchedulingConfigurer { @Value("${spring.cloud.config.refresh-interval:60}") private long refreshInterval; @Value("${spring.cloud.config.auto-refresh:false}") private boolean autoRefresh; private final RefreshEndpoint refreshEndpoint; public ConfigClientAutoRefreshConfiguration(RefreshEndpoint refreshEndpoint) { this.refreshEndpoint = refreshEndpoint; } @Override public void configureTasks(ScheduledTaskRegistrar scheduledTaskRegistrar) { if (autoRefresh) { // set minimal refresh interval to 5 seconds refreshInterval = Math.max(refreshInterval, 5); scheduledTaskRegistrar.addFixedRateTask(refreshEndpoint::refresh, Duration.ofSeconds(refreshInterval)); } } }Povolte
autorefresha nastavte odpovídající interval aktualizace v souboru application.yml . V následujícím příkladu se klient dotazuje na změnu konfigurace každých 60 sekund, což je minimální hodnota, kterou můžete nastavit pro interval aktualizace.Ve výchozím nastavení
autorefreshje nastavenáfalsehodnota arefresh-intervalje nastavená na 60 sekund.spring: cloud: config: auto-refresh: true refresh-interval: 60 management: endpoints: web: exposure: include: - refreshPřidejte
@RefreshScopekód. V následujícím příkladu se proměnnáconnectTimeoutautomaticky aktualizuje každých 60 sekund:@RestController @RefreshScope public class HelloController { @Value("${timeout:4000}") private String connectTimeout; }
Šifrování a dešifrování pomocí symetrického klíče
Dešifrování na straně serveru
Ve výchozím nastavení je povolené šifrování na straně serveru. Pomocí následujících kroků povolte dešifrování ve vaší aplikaci:
Přidejte zašifrovanou vlastnost do souboru .properties v úložišti Git.
Soubor by měl vypadat jako na následujícím příkladu:
message={cipher}f43e3df3862ab196a4b367624a7d9b581e1c543610da353fbdd2477d60fb282fAktualizujte komponentu Konfigurační server pro Spring Java tak, aby používala úložiště Git, které má zašifrovanou vlastnost, a nastavte šifrovací klíč.
Před spuštěním následujícího příkazu nahraďte zástupné symboly ohraničené
<>hodnotami.az containerapp env java-component config-server-for-spring update \ --environment <ENVIRONMENT_NAME> \ --resource-group <RESOURCE_GROUP> \ --name <JAVA_COMPONENT_NAME> \ --configuration spring.cloud.config.server.git.uri=<URI> encrypt.key=randomKey
Dešifrování na straně klienta
Dešifrování vlastností na straně klienta můžete použít pomocí následujících kroků:
Přidejte zašifrovanou vlastnost do souboru .properties v úložišti Git.
Aktualizujte komponentu Konfigurační server pro Spring Java tak, aby používala úložiště Git, které má zašifrovanou vlastnost, a zakažte dešifrování na straně serveru.
Před spuštěním následujícího příkazu nahraďte zástupné symboly ohraničené
<>hodnotami.az containerapp env java-component config-server-for-spring update \ --environment <ENVIRONMENT_NAME> \ --resource-group <RESOURCE_GROUP> \ --name <JAVA_COMPONENT_NAME> \ --configuration spring.cloud.config.server.git.uri=<URI> spring.cloud.config.server.encrypt.enabled=falseV klientské aplikaci přidejte dešifrovací klíč
ENCRYPT_KEY=randomKeyjako proměnnou prostředí.Případně pokud zahrnete
spring-cloud-starter-bootstrapdo objektuclasspath, nebo nastavítespring.cloud.bootstrap.enabled=truejako systémovou vlastnost, nastavteencrypt.keyvbootstrap.properties.Před spuštěním následujícího příkazu nahraďte zástupné symboly ohraničené
<>hodnotami.az containerapp update \ --name <APP_NAME> \ --resource-group <RESOURCE_GROUP> \ --set-env-vars "ENCRYPT_KEY=randomKey"encrypt: key: somerandomkey