Migrace služby Konfigurace aplikace na spravovaný spring cloudový konfigurační server

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 ze služby Application Configuration Service (ACS) na Spring Cloud Config Server při použití plánu Azure Spring Apps Enterprise s aplikacemi Java.

Spring Cloud Config Server poskytuje centralizovanou konfigurační službu, kterou můžou aplikace použít k načtení vlastností konfigurace z externích zdrojů, jako jsou úložiště Git.

Zřízení spring cloudového konfiguračního serveru

Pokud máte instanci plánu Azure Spring Apps Enterprise s povolenou službou Application Configuration Service, prvním krokem při migraci ze služby ACS na Spring Cloud Config Server je zřízení konfiguračního serveru ve vašem prostředí Azure Spring Apps. Můžete ho zřídit pomocí webu Azure Portal nebo Azure CLI.

Azure Portal

Pomocí následujících kroků zřiďte Spring Cloud Config Server:

• Na webu Azure Portal přejděte do podnikové instance Azure Spring Apps.
• V nabídce vyberte Spring Cloud Config Server.
• Pokud chcete zjistit, jestli je povolený Spring Cloud Config Server, vyberte Spravovat. Pokud není, povolte ho a pak vyberte Použít k uložení.
• Po úspěšné aktualizaci se na kartě Přehled zobrazí stav zřizování konfiguračního serveru Úspěšně.

Azure CLI

1. Pomocí následujících příkazů se přihlaste k Azure CLI a zvolte předplatné služby Azure Spring Apps:

   az login
   az account list --output table
   az account set --subscription <subscription-ID>
   

2. Pomocí následujícího příkazu zřiďte Spring Cloud Config Server:

   az spring config-server create \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-service-instance-name>
   

Konfigurace spring cloudového konfiguračního serveru

Jakmile zřídíte Spring Cloud Config Server, dalším krokem je jeho konfigurace pro vaši aplikaci, aby se zajistila bezproblémová migrace.

Azure Portal

Pomocí následujících kroků nakonfigurujte Spring Cloud Config Server na webu Azure Portal:

1. V instanci Azure Spring Apps přejděte na Spring Cloud Config Server.

2. Na kartě Nastavení namapujte konfigurace všech úložišť služby ACS na Spring Cloud Config Server.

   Pokud máte v ACS jenom jedno úložiště, namapujte ho na výchozí úložiště pro Spring Cloud Config Server bez názvu a vzorů. Pokud máte ve službě ACS více úložišť, zvolte jedno úložiště jako výchozí úložiště pro Spring Cloud Config Server a jako další úložiště použijte další úložiště. Migrujte vlastnosti, včetně uri, , namelabelsearch patha authentication z ACS na Spring Cloud Config Server.

   

3. Po mapování konfigurací vyberte Ověřit a ověřte konfiguraci.

4. Po úspěšném ověření vyberte Použít a dokončete konfiguraci Spring Cloud Config Serveru.

5. Pokud chcete změny použít, na kartě Vazby aplikace vyberte Vytvořit vazbu aplikace a pak vyberte všechny aplikace, které budou používat Spring Cloud Config Server.

Azure CLI

1. Pomocí následujícího příkazu nastavte vlastnost Git serveru Spring Cloud Config Server. Hodnoty vlastností jsou odkazy ze služby ACS.

   az spring config-server git set \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-service-instance-name> \
       --uri <uri-of-git-repository> \
       --label <label-of-git-repository>
   

   Pokud pro úložiště Git používáte základní ověřování nebo ověřování SSH, použijte parametry --password a private-key.

2. Pokud máte ve službě ACS více než jedno úložiště, můžete přidat další úložiště Git na Spring Cloud Config Server pomocí příkazu:

   az spring config-server git repo add \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-service-instance-name> \
       --repo-name <repo-name> \
       --uri <uri-of-git-repository> \
       --label <label-of-git-repository>
   

3. Vytvořte vazbu aplikací tak, aby používaly Spring Cloud Config Server pomocí následujícího příkazu:

   az spring config-server bind \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-service-instance-name> \
       --app <app-name>
   

Pokud chcete migrovat vlastnost pattern služby ACS, je důležité zajistit, aby název aplikace Azure Spring Apps odpovídal názvu konfiguračního souboru v úložišti Git.

• Pokud název aplikace Azure Spring Apps odpovídá názvu souboru konfiguračního souboru, Spring Cloud Config Server automaticky použije konfigurační soubor s odpovídajícím názvem aplikace, aniž by vyžadoval další konfiguraci.
• Pokud se názvy neshoduje, musíte vytvořit novou aplikaci s názvem jako názvem konfiguračního souboru.

Další konfigurace najdete v dokumentu Spring Cloud Config Server.

Aktualizace konfigurace aplikace

Vzhledem k rozdílům v implementačních mechanismech mezi službami ACS a konfiguračním serverem se některé změny konfigurace aplikací vyžadují, aby se přizpůsobily způsobu načítání konfigurací.

Jakmile zřídíte a nakonfigurujete Spring Cloud Config Server, musíte konfiguraci upravit pomocí následujících kroků:

1. Aktualizujte závislosti Spring Boot přidáním následujících požadovaných závislostí Spring Cloud Config do souboru pom.xml pro soubor Maven nebo build.gradle pro Gradle.

   Maven

   <dependency>
       <groupId>org.springframework.cloud</groupId>
       <artifactId>spring-cloud-starter-config</artifactId>
   </dependency>
   

   Gradle

   dependencies {
       implementation 'org.springframework.cloud:spring-cloud-starter-config'
   }
   

2. Nakonfigurujte profil.

   V ACS zadáte profil jako vzory v nasazení Azure Spring Apps, zatímco na Spring Cloud Config Serveru nakonfigurujete profil ve zdrojovém kódu aplikace.

   Ujistěte se, že vaše aplikace používá správné profily – devproda tak dále , aby server Spring Cloud Config Server mohl obsluhovat konfigurace specifické pro prostředí.

   Aktualizujte soubor bootstrap.yml nebo application.yml v aplikaci se správnými vlastnostmi konfigurace tak, aby odkazovat na Spring Cloud Config Server, jak je znázorněno v následujícím příkladu:

   spring:
     cloud:
       config:
         profile: dev
   

   Ujistěte se, že název aplikace Azure Spring Apps odpovídá názvu konfiguračního souboru v úložišti Git. Vyhněte se také konfiguraci spring.application.name v kódu vaší aplikace.

Opětovné nasazení aplikace

Jakmile aplikaci otestujete místně, můžete ji znovu nasadit v Azure Spring Apps, aby používala Spring Cloud Config Server pomocí následujícího příkazu Azure CLI:

az spring app deploy \
    --name <app-name> \
    --artifact-path <path-to-your-app> \
    --config-file-patterns '""'

Parametr --config-file-patterns '""' vyčistí odkaz služby Application Configuration Service z vaší aplikace. Aplikace využívá konfiguraci prostřednictvím spring cloudového konfiguračního serveru místo služby Konfigurace aplikace.

Zakázání služby konfigurace aplikace

Po dokončení migrace na Spring Cloud Config Server můžete zrušit vazbu těchto aplikací do služby Konfigurace aplikace a zakázat službu ACS.

Azure Portal

1. V instanci Azure Spring Apps přejděte do služby Application Configuration Service.
2. Otevřete kartu Vazby aplikace a pak vyberte každou vázanou aplikaci, která se má zrušit.
3. Jakmile budou všechny aplikace nevázané, vyberte Spravovat a zakažte službu Konfigurace aplikací.

Azure CLI

1. Pokud chcete zrušit vazbu aplikací ze služby ACS, použijte následující příkaz:

   az spring application-configuration-service unbind \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-service-instance-name> \
       --app <application-name>
   

2. Jakmile jsou všechny aplikace nevázané, pomocí následujícího příkazu zakažte službu ACS:

   az spring application-configuration-service delete \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-service-instance-name>
   

Pečlivě podle těchto kroků můžete zajistit bezproblémovou migraci a využívat výhody Spring Cloud Config Serveru v rámci Azure Spring Apps.

Známé omezení

Migrace služby ACS na Spring Cloud Config Server platí jenom pro aplikace v Javě, protože služba ACS spravuje konfiguraci pomocí nativního ConfigMapKubernetes . Tato metoda umožňuje dynamické aktualizace konfigurace v prostředích Kubernetes, takže je všestranná pro různé aplikace s více programovacími jazyky. Spring Cloud Config Server je primárně určený pro aplikace v Javě pomocí funkcí Spring Frameworku, takže podporuje pouze správu konfigurace pro Javu.