Configurar um Servidor de Configuração do Spring Cloud

  • 7 minutos

Neste módulo, você configurará um Spring Cloud Config Server que é totalmente gerenciado e suportado pelo Azure Spring Apps, para ser usado pelos microsserviços do Spring Boot.

Este Spring Cloud Config Server obtém seus dados de configuração de um repositório Git, onde os arquivos de configuração do Spring Boot são armazenados. O armazenamento de ficheiros de configuração através deste mecanismo tem as seguintes vantagens:

  • Os parâmetros confidenciais do seu aplicativo (como a senha do banco de dados) não serão verificados no código do aplicativo.
  • O repositório Git que armazena sua configuração pode ser protegido, para que apenas uma equipe de operações tenha acesso a ele.
  • À medida que os ficheiros de configuração são armazenados no Git, pode etiquetá-los ou revertê-los. Isto facilita a gestão do seu ambiente de produção.
  • Fornece um local centralizado para armazenar todos os seus dados de configuração, para todos os seus microsserviços.

Criar um repositório Git para armazenar a configuração da aplicação

Na sua conta do GitHub, crie um novo repositório privado onde as configurações Spring Boot serão armazenadas.

No novo repositório privado do GitHub, adicione um novo arquivo application.yml, que armazena dados de configuração para todos os nossos microsserviços.

Normalmente, cada aplicação Spring Boot inclui um desses ficheiros nos binários da aplicação para conter as definições da aplicação. Um Servidor de Configuração do Spring Cloud permite que tais configurações sejam armazenadas fora da sua aplicação, o que fornece os seguintes benefícios:

  • Permite armazenar parâmetros confidenciais (como a palavra-passe da sua base de dados) fora da sua aplicação.
  • A sua configuração é armazenada num repositório Git, o que permite que os respetivos dados sejam etiquetados ou revertidos.
  • Utiliza um repositório Git específico, que pode ser protegido em separado.
  • Fornece um local centralizado para armazenar todos os seus dados de configuração, para todos os seus microsserviços.

No momento, nosso application.yml apenas armazenará uma mensagem para verificar se a configuração foi bem-sucedida:

application:
    message: Configured by Azure Spring Apps

Consolide e emita o novo ficheiro:

git add application.yml
git commit -m 'Add new Spring Boot configuration file'
git push

Criar um token pessoal do GitHub

Os Azure Spring Apps podem acessar repositórios Git que são públicos, protegidos por SSH ou protegidos usando autenticação básica HTTP. Usaremos essa última opção, pois é mais fácil criar e gerenciar com o GitHub.

Siga o guia do GitHub para criar um token pessoal e guarde o seu token. Quando solicitado a selecionar escopos, marque toda a seção "repo" e nada mais.

Captura de tela que mostra as configurações do token de acesso pessoal do GitHub.

Após o token ser gerado, mantenha esse separador aberto até ao final desta secção.

Configurar o Azure Spring Apps para acessar o repositório Git

  1. Vá para o portal do Azure e procure Azure Spring Apps.

  2. Vá para a página de visão geral do seu servidor Azure Spring Apps e selecione Config Server no menu.

  3. Configure o repositório criado anteriormente:

    1. Adicione o URL do repositório, por exemplo https://github.com/<YOUR_USERNAME>/azure-spring-cloud-config ou git@github.com:<YOUR_USERNAME>/azure-spring-cloud-config.git.

      Gorjeta

      Certifique-se de incluir a .git terminação na URL ou use o URI qualificado.

    2. Adicione o seu ramo em Label. Assumirá a predefinição main no GitHub, mas os repositórios mais antigos ou fornecedores do Git alternativos poderão ainda utilizar master.

    3. Selecione Autenticação e selecione HTTP Básico.

    4. O nome de utilizador é o seu nome de início de sessão do GitHub.

    5. A palavra-passe é o token pessoal que criámos na secção anterior.

    Captura de tela das configurações do servidor de configuração do Spring Cloud.

  4. Selecione Validar e aguarde até que a operação seja bem-sucedida.

  5. Selecione Aplicar e aguarde até que a operação seja bem-sucedida.

Rever

Criamos um repositório de configuração privado. Também habilitamos o Azure Spring Apps para criar um servidor de configuração com os arquivos de configuração desse repositório.

Verifique o seu conhecimento

1.

No Azure Spring Apps, quais mecanismos de segurança o Spring Cloud Config Server suporta?

2.

Usar o Spring Cloud Config é uma ótima solução porque: