Migrera Spring Cloud Config Server från Azure Spring Apps till Azure Container Apps

Note

Planerna Basic, Standardoch Enterprise gick in i en pensionsperiod den 17 mars 2025. Mer information finns i meddelandet om azure Spring Apps-pensionering.

Den här artikeln gäller för:✅ Basic/Standard ✅ Enterprise

I den här artikeln beskrivs hur du migrerar Spring Cloud Config Server till Config Server for Spring i Azure Container Apps. Azure Container Apps hanterar Config Server for Spring, som har liknande funktioner som Spring Cloud Config Server i Azure Spring Apps.

Prerequisites

• En Azure Spring Apps-instans med Konfigurera server aktiverat.
• En Azure Container Apps-miljö för Config Server och en Azure Container Apps-instans.

Installera konfigurationsserver

Azure Portal

Följande steg visar hur du etablerar en konfigurationsserver för Spring i dina Azure Container Apps:

1. Gå till din Azure Container Apps-miljö i Azure-portalen.

2. I menyn väljer du Tjänster>tjänster.

3. Öppna listrutan Konfigurera och välj sedan Java-komponent.

4. I panelen Konfigurera Java-komponent anger du följande värden:

   Property	Value
   Java-komponenttyp	Välj Konfigurationsserver för Spring.
   Java-komponentnamn	Ange configserver.

5. I avsnittet Git-lagringsplatser väljer du Lägg till och migrerar sedan värdena från Programkonfigurationstjänsten till här, som du ser i följande tabell. Välj en lagringsplats som standardlagringsplats för Config Server for Spring.

   Property	Value
   Type	Välj STANDARD.
   URI	Ange värdet för URI för lagringsplatsen.
   Grennamn	Ange värdet för lagringsplatsens etikett .
   Sökvägar	Ange värdet för sökvägen till lagringsplatsen.
   Authentication	Välj lagringsplatsens autentiseringstyp och ange motsvarande information.

   Lämna resten av fälten med standardvärdena och välj sedan Lägg till.

6. Om du har flera lagringsplatser väljer du Lägg till för att migrera andra lagringsplatser. För Typ väljer du Övrigt och migrerar sedan andra egenskaper enligt föregående steg och följande tabell:

   Property	Value
   Type	Välj STANDARD.
   Pattern	Ange mönstervärdet för lagringsplatsen i {application}-formatet eller {application}/{profile}-formatet.

7. I avsnittet Bindning öppnar du listrutan för att välja vilka appar som ska bindas till konfigurationsservern för Spring.

8. Välj Nästa.

9. Om du vill konfigurera Config Server går du till fliken Granska , väljer Konfigurera och följer sedan anvisningarna i konfigurationsavsnittet.

När den väl har skapats kan du se att provisioning-tillståndet för en konfigurationsserver för Spring är slutfört.

Azure CLI

Använd följande kommando för att skapa och konfigurera komponenten 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>

Alla egenskaper anges med formatet --configuration <CONFIGURATION_KEY>=<CONFIGURATION_VALUE>. Information om hur du mappar befintliga konfigurationer till nyckel/värde-paren i konfigurationsservern finns i konfigurationsavsnittet.

Resurstilldelning

Resursallokeringen för containern för den hanterade konfigurationsservern i Azure Container Apps är fast i följande värden:

• CPU: 0,5 vCPU
• Minne: 1 gi

För att konfigurera antalet instanser av Config Server för Spring måste du uppdatera parametrarna --min-replicas och --max-replicas med samma värde. Den här konfigurationen säkerställer att instansantalet förblir fast. För närvarande stöder systemet inte konfigurationer för automatisk skalning för dynamisk skalning.

Konfigurera konfigurationsserver

Mappa standardlagringsplatsen för Git och ytterligare lagringsplatser som konfigurerats i Spring Cloud Config Server i Azure Spring Apps till standardlagringsplatsen och andra lagringsplatser i Config Server for Spring som distribueras i Azure Container Apps. I följande tabell visas mappningsrelationerna för egenskaper:

Egenskapsnamn i Azure Spring Apps	CONFIGURATION_KEY	CONFIGURATION_VALUE
uri	spring.cloud.config.server.git.uri spring.cloud.config.server.git.repos.{repoName}.uri	Fjärrlagringsplatsens uri.
search path	spring.cloud.config.server.git.search-paths spring.cloud.config.server.git.repos.{repoName}.search-paths	Sökvägar som ska användas i den lokala arbetskopian. Som standard söker endast roten.
label	spring.cloud.config.server.git.default-label spring.cloud.config.server.git.repos.{repoName}.default-label	Etiketten som används för Git.
name i ytterligare lagringsplatser	{repoName} i följande konfigurationer.
Patterns i ytterligare lagringsplatser	spring.cloud.config.server.git.repos.{repoName}.pattern
username	spring.cloud.config.server.git.username spring.cloud.config.server.git.repos.{repoName}.username	username Ange för autentisering med fjärrlagringsplatsen om autentiseringstypen är HTTP Basic.
password	spring.cloud.config.server.git.password spring.cloud.config.server.git.repos.{repoName}.password	password Ange för autentisering med fjärrlagringsplatsen om autentiseringstypen är HTTP Basic.
private key	spring.cloud.config.server.git.private-key spring.cloud.config.server.git.repos.{repoName}.private-key	Giltig privat SSH-nyckel om autentiseringstypen är SSH.
host key	spring.cloud.config.server.git.host-key spring.cloud.config.server.git.repos.{repoName}.host-key	Giltig SSH-värdnyckel om autentiseringstypen är SSH. Måste anges om host-key-algorithm det också är inställt.
host key algorithm	spring.cloud.config.server.git.host-key-algorithm spring.cloud.config.server.git.repos.{repoName}.host-key-algorithm	En av ssh-dss, ssh-rsa, ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384eller ecdsa-sha2-nistp521 om autentiseringstypen är SSH. Måste anges om värdnyckeln också har angetts.

Fler egenskaper för konfigurationsserver finns i avsnittet Konfigurationsalternativ i Ansluta till en hanterad konfigurationsserver för Spring i Azure Container Apps.

Distribuera programmet till Azure Container Apps

När du har testat programmet lokalt kan du distribuera den nya avbildningen till Azure Container Apps-programmet.

Azure Portal

Använd följande steg för att distribuera:

1. Gå till ditt Azure Container Apps-program i Azure-portalen.
2. På menyn väljer duProgramcontainrar>.
3. Välj Redigera och distribuera för att öppna sidan Skapa och distribuera ny revision .
4. I avsnittet Containeravbildning väljer du avbildningen och väljer sedan Redigera.
5. I avsnittet Redigera en container går du till fliken Egenskaper och väljer den nya avbildningen av programmet.
6. På fliken Miljövariabler för Namn anger du spring.application.name. För Källa väljer du sedan Manuell inmatning och anger namnet på konfigurationsfilen där programmet använder sig av konfigurationen.
7. Välj Spara för att distribuera den nya revisionen.

Azure CLI

Använd följande kommando för att uppdatera containerappen som använder konfigurationsdata:

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>

Parametern --bind <config-server-name> skapar länken mellan containerappen och konfigurationskomponenten. Du bör lägga till miljövariabeln genom att ange --set-env-vars spring.application.name=<config-file-name> i appcontainern så att appen kan använda konfigurationen från rätt konfigurationsfil.

Troubleshoot

Du kan visa loggar för den hanterade konfigurationsservern för Spring i Azure Container Apps med hjälp av Log Analytics. Följ stegen nedan:

1. Gå till din Azure Container Apps-miljö i Azure-portalen.

2. Välj menynÖvervakningsloggar>.

3. Om du vill visa loggar anger du en fråga i frågeredigeraren för ContainerAppSystemLogs_CL tabellen enligt följande exempel:

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

För mer information om att fråga loggar, se Observability of managed Java components in Azure Container Apps (Observerbarhet för hanterade Java-komponenter i Azure Container Apps).