Guia de início rápido: configurar o Spring Cloud Config Server para Azure Spring Apps
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
O Config Server é um serviço de configuração centralizado para sistemas distribuídos. Ele usa uma camada de repositório conectável que atualmente suporta armazenamento local, Git e Subversion. Neste início rápido, você configura o Config Server para obter dados de um repositório Git.
Pré-requisitos
- Conclusão do início rápido anterior desta série: Provisionar o serviço Azure Spring Apps.
- O Azure Spring Apps Config Server só é aplicável ao plano Básico ou Padrão.
Procedimentos do Config Server
Configure seu Config Server com o local do repositório Git para o projeto executando o seguinte comando. Substitua <service-instance-name> pelo nome do serviço criado anteriormente. O valor padrão para o nome da instância de serviço que você definiu no início rápido anterior não funciona com esse comando.
az spring config-server git set \
--name <service-instance-name> \
--uri https://github.com/Azure-Samples/azure-spring-apps-samples \
--search-paths steeltoe-sample/config
Este comando diz ao Config Server para localizar os dados de configuração na pasta steeltoe-sample/config do repositório de aplicativos de exemplo. Como o nome do aplicativo que obtém os dados de configuração é planet-weather-provider, o arquivo usado é planet-weather-provider.yml.
Pré-requisitos
- JDK 17
- Uma subscrição do Azure. Se você não tiver uma assinatura, crie uma conta gratuita antes de começar.
- Opcionalmente, a CLI do Azure versão 2.45.0 ou superior. Instale a extensão Azure Spring Apps com o seguinte comando:
az extension add --upgrade --name spring - Opcionalmente, o Kit de Ferramentas do Azure para IntelliJ.
Procedimentos do Config Server
O procedimento a seguir configura o Config Server usando o portal do Azure para implantar o exemplo PetClinic.
Vá para a página Visão geral do serviço e selecione Config Server.
Na seção Repositório padrão, defina URI como
https://github.com/azure-samples/spring-petclinic-microservices-config.Selecione Validar. A validação verifica o esquema e a acessibilidade do repositório git para garantir que ele esteja correto.
Quando a validação estiver concluída, selecione Aplicar para salvar as alterações.
A atualização da configuração pode levar alguns minutos. Você deve receber uma notificação quando a configuração for concluída.
Gorjeta
Para obter informações sobre como usar um repositório privado para o Config Server, consulte Configurar um Spring Cloud Config Server gerenciado no Azure Spring Apps.
Solução de problemas do Azure Spring Apps Config Server
O procedimento a seguir explica como solucionar problemas de configurações do Config Server.
No portal do Azure, vá para a página Visão geral do serviço e selecione Logs.
No painel Consultas, em Mostrar os logs do aplicativo que contêm os termos "erro" ou "exceção", selecione Executar.
O seguinte erro nos logs indica que o serviço Spring Apps não pode localizar propriedades do Config Server:
java.lang.illegalStateExceptionVá para a página Visão geral do serviço.
Selecione Diagnosticar e resolver problemas.
Em Disponibilidade e Desempenho, selecione Resolução de Problemas.
O portal do Azure exibe a página Disponibilidade e Desempenho, que fornece várias informações sobre o status de integridade do Config Server.
Clean up resources (Limpar recursos)
Se você planeja continuar trabalhando com guias de início rápido e tutoriais subsequentes, convém deixar esses recursos no lugar. Quando não precisar mais dele, exclua o grupo de recursos, que exclui os recursos do grupo de recursos. Para excluir o grupo de recursos, insira os seguintes comandos na CLI do Azure:
echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."