Partilhar via

Migrar o Spring Cloud Config Server do Azure Spring Apps para o Azure Container Apps

  • Artigo

Nota

Os planos Basic, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de aposentadoria de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.

O plano de consumo padrão e dedicado será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para obter mais informações, consulte Migrar consumo padrão e plano dedicado do Azure Spring Apps para Aplicativos de Contêiner do Azure.

Este artigo aplica-se a:✅ Basic/Standard ✅ Enterprise

Este artigo descreve como migrar o Spring Cloud Config Server para o Config Server for Spring em Aplicativos de Contêiner do Azure. O Azure Container Apps gerencia o Config Server for Spring, que tem funções semelhantes ao Spring Cloud Config Server no Azure Spring Apps.

Pré-requisitos

  • Uma instância do Azure Spring Apps com Configurar Servidor habilitado.
  • Um Ambiente de Aplicativos de Contêiner do Azure para o Servidor de Configuração e uma instância de Aplicativos de Contêiner do Azure.

Provisionar o Config Server

As etapas a seguir mostram como provisionar um Config Server for Spring em seus Aplicativos de Contêiner do Azure:

  1. Navegue até o ambiente dos Aplicativos de Contêiner do Azure no portal do Azure.

  2. No menu, selecione >Serviços de Serviços.

  3. Abra a lista suspensa Configurar e selecione Componente Java.

  4. No painel Configurar componente Java, insira os seguintes valores:

    Property valor
    Tipo de componente Java Selecione Config Server for Spring.
    Nome do componente Java Digite configserver.

  5. Na seção Repositórios Git, selecione Adicionar e migre os valores do Serviço de Configuração de Aplicativo para aqui, conforme mostrado na tabela a seguir. Escolha um repositório como o repositório padrão do Config Server for Spring.

    Property valor
    Tipo Selecione DEFAULT.
    URI Insira o valor do URI do repositório.
    Nome do ramo Insira o valor do rótulo do repositório.
    Caminhos de pesquisa Insira o valor do caminho de pesquisa do repositório.
    Autenticação Selecione o tipo de autenticação do repositório e insira as informações correspondentes.

    Deixe o restante dos campos com os valores padrão e selecione Adicionar.

  6. Se você tiver vários repositórios, selecione Adicionar para migrar outros repositórios. Em Tipo, selecione Outro e migre outras propriedades, conforme mostrado na etapa anterior e na tabela a seguir:

    Property valor
    Tipo Selecione DEFAULT.
    Padrão Insira o valor Patterns para o repositório no {application} formato ou {application}/{profile} .

  7. Na seção Vinculação, abra a lista suspensa para selecionar os aplicativos a serem vinculados ao Config Server for Spring.

  8. Selecione Seguinte.

  9. Para configurar o Config Server, na guia Revisão , selecione Configurar e siga as instruções na seção de configuração.

Após a criação bem-sucedida, você pode ver que o estado de provisionamento do Config Server for Spring foi bem-sucedido.

Alocação de recursos

A alocação de recursos de contêiner para o Servidor de Configuração gerenciado nos Aplicativos de Contêiner do Azure é fixada com os seguintes valores:

  • CPU: 0.5 vCPU
  • Memória: 1 Gi

Para configurar a contagem de instâncias do Config Server for Spring, você precisa atualizar os parâmetros --min-replicas e --max-replicas com o mesmo valor. Essa configuração garante que a contagem de instâncias permaneça fixa. Atualmente, o sistema não suporta configurações de dimensionamento automático para dimensionamento dinâmico.

Configurar o Config Server

Mapeie o repositório Git padrão e repositórios adicionais configurados no Spring Cloud Config Server dentro do Azure Spring Apps para o padrão e outros repositórios no Config Server for Spring implantados no Azure Container Apps. A tabela a seguir mostra as relações de mapeamento para propriedades:

Nome da propriedade no Azure Spring Apps CONFIGURATION_KEY CONFIGURATION_VALUE
uri spring.cloud.config.server.git.uri
spring.cloud.config.server.git.repos.{repoName}.uri		 O uri do repositório remoto.
search path spring.cloud.config.server.git.search-paths
spring.cloud.config.server.git.repos.{repoName}.search-paths		 Pesquisar caminhos para usar na cópia de trabalho local. Por padrão, pesquisa apenas a raiz.
label spring.cloud.config.server.git.default-label
spring.cloud.config.server.git.repos.{repoName}.default-label		 O rótulo usado para o Git.
name em repositórios adicionais {repoName} nas configurações a seguir.
Patterns em repositórios adicionais spring.cloud.config.server.git.repos.{repoName}.pattern
username spring.cloud.config.server.git.username
spring.cloud.config.server.git.repos.{repoName}.username		 Insira o username para autenticação com repositório remoto se o tipo de autenticação for HTTP Basic.
password spring.cloud.config.server.git.password
spring.cloud.config.server.git.repos.{repoName}.password		 Insira o password para autenticação com repositório remoto se o tipo de autenticação for HTTP Basic.
private key spring.cloud.config.server.git.private-key
spring.cloud.config.server.git.repos.{repoName}.private-key		 Chave privada SSH válida se o tipo de autenticação for SSH.
host key spring.cloud.config.server.git.host-key
spring.cloud.config.server.git.repos.{repoName}.host-key		 Chave de host SSH válida se o tipo de autenticação for SSH. Deve ser definido se host-key-algorithm também estiver definido.
host key algorithm spring.cloud.config.server.git.host-key-algorithm
spring.cloud.config.server.git.repos.{repoName}.host-key-algorithm		 Um de , ssh-rsa, ssh-ed25519, ecdsa-sha2-nistp256, , ecdsa-sha2-nistp384ou ecdsa-sha2-nistp521 se o tipo de ssh-dssautenticação for SSH. Deve ser definido se a chave do host também estiver definida.

Para obter mais propriedades do Config Server, consulte a seção Opções de configuração de Conectar-se a um Config Server gerenciado para Spring em Aplicativos de Contêiner do Azure.

Implantar o aplicativo em Aplicativos de Contêiner do Azure

Depois de testar o aplicativo localmente, você pode implantar a nova imagem no aplicativo Aplicativos de Contêiner do Azure.

Use as seguintes etapas para implantar:

  1. Navegue até seu aplicativo de Aplicativos de Contêiner do Azure no portal do Azure.
  2. No menu, selecione Contêineres de aplicativos>.
  3. Selecione Editar e implantar para abrir a página Criar e implantar nova revisão .
  4. Na seção Imagem de contêiner, selecione a imagem e, em seguida, selecione Editar.
  5. Na seção Editar um contêiner, na guia Propriedades, escolha a nova imagem do aplicativo.
  6. Na guia Variáveis de ambiente, para Nome, especifique spring.application.name. Em seguida, para Source, escolha Entrada manual e especifique o nome do arquivo de configuração onde o aplicativo consome a configuração.
  7. Selecione Salvar para implantar a nova revisão.

Resolver problemas

Você pode exibir logs para o Config Server gerenciado para Spring em Aplicativos de Contêiner do Azure usando o Log Analytics. Utilize os passos seguintes:

  1. Navegue até o ambiente dos Aplicativos de Contêiner do Azure no portal do Azure.

  2. Selecione o menu Logs de monitoramento>.

  3. Para exibir logs, insira uma consulta no editor de consultas da ContainerAppSystemLogs_CL tabela, conforme mostrado no exemplo a seguir:

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

Para obter mais informações sobre como consultar logs, consulte Observabilidade de componentes Java gerenciados em Aplicativos de Contêiner do Azure.