Migrace Spring Cloud Config Serveru z Azure Spring Apps do Azure Container Apps

Poznámka:

Plány Basic, Standard a Enterprise budou od poloviny března 2025 vyřazeny ze 3letého období vyřazení. Doporučujeme přejít na Azure Container Apps. Další informace najdete v oznámení o vyřazení Azure Spring Apps.

Od 30. září 2024 bude od 30. září 2024 zastaralý plán s úplným vypnutím po šesti měsících. Doporučujeme přejít na Azure Container Apps. Další informace najdete v tématu Migrace spotřeby Azure Spring Apps Úrovně Standard a vyhrazeného plánu do Azure Container Apps.

Tento článek se vztahuje na:✅ Basic/Standard ✅ Enterprise

Tento článek popisuje, jak migrovat Spring Cloud Config Server na Konfigurační server pro Spring v Azure Container Apps. Azure Container Apps spravuje konfigurační server pro Spring, který má podobné funkce jako Spring Cloud Config Server v Azure Spring Apps.

Požadavky

• Instance Azure Spring Apps s povolenou konfigurací serveru
• Prostředí Azure Container Apps pro konfigurační server a instanci Azure Container Apps.

Zřízení konfiguračního serveru

Azure Portal

Následující kroky ukazují, jak zřídit konfigurační server pro Spring ve službě Azure Container Apps:

1. Na webu Azure Portal přejděte do prostředí Azure Container Apps.

2. V nabídce vyberte Služby>.

3. Otevřete rozevírací seznam Konfigurovat a vyberte komponentu Java.

4. Na panelu Konfigurovat komponenty Java zadejte následující hodnoty:

   Vlastnost	Hodnota
   Typ komponenty Java	Vyberte Konfigurační server pro Spring.
   Název komponenty Java	Zadejte konfigurační server.

5. V části Úložiště Git vyberte Přidat a pak migrujte hodnoty ze služby Application Configuration Service, jak je znázorněno v následující tabulce. Jako výchozí úložiště konfiguračního serveru pro Spring zvolte jedno úložiště.

   Vlastnost	Hodnota
   Typ	Vyberte VÝCHOZÍ.
   Identifikátor URI	Zadejte hodnotu identifikátoru URI úložiště.
   Název větve	Zadejte hodnotu popisku úložiště.
   Cesty pro hledání	Zadejte hodnotu cesty hledání úložiště.
   Authentication	Vyberte typ ověřování úložiště a zadejte odpovídající informace.

   Ponechte zbývající pole s výchozími hodnotami a pak vyberte Přidat.

6. Pokud máte více úložišť, vyberte Přidat a migrujte další úložiště. V části Typ vyberte Jiné a potom migrujte další vlastnosti, jak je znázorněno v předchozím kroku a následující tabulka:

   Vlastnost	Hodnota
   Typ	Vyberte VÝCHOZÍ.
   Vzor	Zadejte hodnotu Vzory úložiště ve {application} formátu nebo {application}/{profile} ve formátu.

7. V části Vazba otevřete rozevírací seznam a vyberte aplikace, které se mají svázat s konfiguračním serverem pro Spring.

8. Vyberte Další.

9. Chcete-li nastavit konfigurační server, na kartě Revize vyberte Konfigurovat a poté postupujte podle pokynů v části Konfigurace.

Po úspěšném vytvoření uvidíte, že stav zřizování konfiguračního serveru pro spring je úspěšný.

Azure CLI

Pomocí následujícího příkazu vytvořte a nakonfigurujte komponentu Config Server for Spring Java:

az containerapp env java-component config-server-for-spring create \
    --resource-group <resource-group-name> \
    --name <config-server-name> \
    --environment <azure-container-app-environment-name> \
    --min-replicas 1 \
    --max-replicas 1 \
    --configuration spring.cloud.config.server.git.uri=<URI> spring.cloud.config.server.git.default-label=<label>

Všechny vlastnosti jsou nastaveny pomocí formátu --configuration <CONFIGURATION_KEY>=<CONFIGURATION_VALUE>. Pokud chcete namapovat existující konfigurace na páry klíč-hodnota konfiguračního serveru, přečtěte si část konfigurace.

Přidělení prostředků

Přidělení prostředků kontejneru pro spravovaný konfigurační server v Azure Container Apps je pevné na následující hodnoty:

• PROCESOR: 0,5 vCPU
• Paměť: 1 Gi

Pokud chcete nakonfigurovat počet instancí konfiguračního serveru pro Spring, musíte aktualizovat parametry --min-replicas a --max-replicas stejnou hodnotou. Tato konfigurace zajišťuje, že počet instancí zůstane opravený. V současné době systém nepodporuje konfigurace automatického škálování pro dynamické škálování.

Konfigurace konfiguračního serveru

Namapujte výchozí úložiště Git a další úložiště nakonfigurovaná na Spring Cloud Config Serveru v rámci Azure Spring Apps na výchozí a další úložiště v konfiguračním serveru pro Spring nasazené v Azure Container Apps. Následující tabulka ukazuje relace mapování vlastností:

Název vlastnosti v Azure Spring Apps	CONFIGURATION_KEY	CONFIGURATION_VALUE
uri	spring.cloud.config.server.git.uri spring.cloud.config.server.git.repos.{repoName}.uri	Vzdálené uri úložiště.
search path	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.
label	spring.cloud.config.server.git.default-label spring.cloud.config.server.git.repos.{repoName}.default-label	Popisek použitý pro Git.
name v dalších úložištích	{repoName} v následujících konfiguracích.
Patterns v dalších úložištích	spring.cloud.config.server.git.repos.{repoName}.pattern
username	spring.cloud.config.server.git.username spring.cloud.config.server.git.repos.{repoName}.username	username Zadejte pro ověřování pomocí vzdáleného úložiště, pokud je HTTP Basictyp ověřování .
password	spring.cloud.config.server.git.password spring.cloud.config.server.git.repos.{repoName}.password	password Zadejte pro ověřování pomocí vzdáleného úložiště, pokud je HTTP Basictyp ověřování .
private key	spring.cloud.config.server.git.private-key spring.cloud.config.server.git.repos.{repoName}.private-key	Platný privátní klíč SSH, pokud je SSHtyp ověřování .
host key	spring.cloud.config.server.git.host-key spring.cloud.config.server.git.repos.{repoName}.host-key	Platný klíč hostitele SSH, pokud je SSHtyp ověřování . Musí být nastavena i v případě, že host-key-algorithm je nastavena.
host key algorithm	spring.cloud.config.server.git.host-key-algorithm spring.cloud.config.server.git.repos.{repoName}.host-key-algorithm	Jeden z ssh-dss, , ssh-ed25519ssh-rsa, , ecdsa-sha2-nistp256, ecdsa-sha2-nistp384nebo ecdsa-sha2-nistp521 pokud je SSHtyp ověřování . Pokud je nastavený také klíč hostitele, musí být nastavená.

Další vlastnosti konfiguračního serveru najdete v části Možnosti konfigurace připojení ke spravovanému konfiguračnímu serveru pro Spring v Azure Container Apps.

Nasazení aplikace do Azure Container Apps

Po místním otestování aplikace můžete novou image nasadit do aplikace Azure Container Apps.

Azure Portal

K nasazení použijte následující postup:

1. Na webu Azure Portal přejděte k aplikaci Azure Container Apps.
2. V nabídce vyberte Kontejnery aplikací>.
3. Výběrem možnosti Upravit a nasadit otevřete stránku Vytvořit a nasadit novou revizi .
4. V části Image kontejneru vyberte image a pak vyberte Upravit.
5. V části Upravit kontejner vyberte na kartě Vlastnosti novou image aplikace.
6. Na kartě Proměnné prostředí zadejte spring.application.name. Potom v části Zdroj zvolte ruční položku a zadejte název konfiguračního souboru, ve kterém aplikace konfiguraci využívá.
7. Výběrem možnosti Uložit nasadíte novou revizi.

Azure CLI

Pomocí následujícího příkazu aktualizujte aplikaci kontejneru, která využívá konfigurační data:

az containerapp update \
    --resource-group <your-resource-group> \
    --name <container-app-name> \
    --image <new-container-image> \
    --bind <config-server-name> \
    --set-env-vars spring.application.name=<config-file-name>

Parametr --bind <config-server-name> vytvoří propojení mezi vaší aplikací kontejneru a komponentou konfigurace. Proměnnou prostředí byste měli přidat nastavením --set-env-vars spring.application.name=<config-file-name> do kontejneru aplikace, aby aplikace mohl konfiguraci využívat z správného konfiguračního souboru.

Odstraňování potíží

Protokoly pro spravovaný konfigurační server pro Spring v Azure Container Apps můžete zobrazit pomocí Log Analytics. Použijte následující postup:

1. Na webu Azure Portal přejděte do prostředí Azure Container Apps.

2. Vyberte nabídku Protokoly monitorování>.

3. Pokud chcete zobrazit protokoly, zadejte dotaz do editoru ContainerAppSystemLogs_CL dotazů pro tabulku, jak je znázorněno v následujícím příkladu:

   ContainerAppSystemLogs_CL
   | where ComponentType_s == "SpringCloudConfig"
   | project Time=TimeGenerated, ComponentName=ComponentName_s, Message=Log_s
   | take 100
   

Další informace o dotazováníprotokolůch