Compartilhar via

Migrar o Spring Cloud Config Server do Aplicativos Spring do Azure para Aplicativos de Contêiner do Azure

  • Artigo

Observação

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

O plano consumo e dedicado Standard 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 mais informações, confira Migrar o plano dedicado e consumo Standard dos Aplicativos Spring do Azure para os Aplicativos de Contêiner do Azure.

Este artigo se aplica a:✅ Básico/Standard ✅ Enterprise

Este artigo descreve como migrar o Spring Cloud Config Server para o Config Server para Spring nos Aplicativos de Contêiner do Azure. Os Aplicativos de Contêiner do Azure gerenciam o Config Server para Spring, que tem funções semelhantes às do Spring Cloud Config Server nos Aplicativos Spring do Azure.

Pré-requisitos

  • Uma instância dos Aplicativos Spring do Azure com o Configure Server habilitado.
  • Um ambiente de Aplicativos de Contêiner do Azure para o Config Server e uma instância dos Aplicativos de Contêiner do Azure.

Provisionar o Config Server

As etapas a seguir mostram como provisionar um Config Server para 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>Serviços.

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

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

    Propriedade Valor
    Tipo de componente Java Selecione Config Server para Spring.
    Nome do componente Java Insira o configserver.

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

    Propriedade Valor
    Tipo Selecione PADRÃO.
    URI Insira o valor do URI do repositório.
    Nome do branch 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. Como Tipo, selecione Outros e migre outras propriedades, conforme mostrado na etapa anterior e na tabela a seguir:

    Propriedade Valor
    Tipo Selecione PADRÃO.
    Padrão Insira o valor de Padrões para o repositório no formato {application} ou no formato{application}/{profile}.

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

  8. Selecione Avançar.

  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 ser bem-sucedida, você pode ver que o Estado de Provisionamento do Config Server para Spring foi Bem-sucedido.

Alocação de recurso

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

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

Para configurar a contagem de instâncias do Config Server para 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 dá suporte a 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 nos Aplicativos Spring do Azure para o padrão e outros repositórios no Config Server para Spring implantados nos Aplicativos de Contêiner do Azure. A tabela a seguir mostra as relações de mapeamento para as propriedades:

Nome da propriedade nos Aplicativos Spring do Azure 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		 Caminhos de pesquisa a serem usados 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 Git.
name nos repositórios adicionais {repoName} nas configurações a seguir.
Patterns nos 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 o 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 o 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		 Uma das opções ssh-dss, ssh-rsa, ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384 ou ecdsa-sha2-nistp521 se o tipo de autenticação for SSH. Deve ser definido se a chave de 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 Servidor de Configuração Gerenciado para Spring nos Aplicativos de Contêiner do Azure.

Implantar o aplicativo nos Aplicativos de Contêiner do Azure

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

Use as seguintes etapas para implantar o aplicativo:

  1. Navegue até seu aplicativo de Aplicativos de Contêiner do Azure no portal do Azure.
  2. No menu, selecione Aplicativo>Contêineres.
  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, 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, em Nome, especifique spring.application.name. Em seguida, como a Origem, escolha Entrada manual e especifique o nome do arquivo de configuração em que o aplicativo consome a configuração.
  7. Selecione Salvar para implantar a nova revisão.

Solucionar problemas

Você pode exibir logs do Servidor de Configuração Gerenciado para Spring nos Aplicativos de Contêiner do Azure usando o Log Analytics. Use as seguintes etapas:

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

  2. Selecione o menu Monitoramento>Logs.

  3. Para exibir logs, insira uma consulta no editor de consultas da tabela ContainerAppSystemLogs_CL, 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 nos Aplicativos de Contêiner do Azure.