Guia de início rápido: configurar o Spring Cloud Config Server para Azure Spring Apps
Nota
Azure Spring Apps é o novo nome para o serviço Azure Spring Cloud. Embora o serviço tenha um novo nome, você verá o nome antigo em alguns lugares por um tempo enquanto trabalhamos para atualizar ativos, como capturas de tela, vídeos e diagramas.
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 <o nome da instância do serviço 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 -n <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 é , o arquivo usado é planet-weather-providerplanet-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 ..."