Início Rápido: adicionar sinalizadores de recurso a um aplicativo Spring Boot

Neste início rápido, você criará um sinalizador de recursos no Configuração de Aplicativos do Azure e o usará para controlar dinamicamente os aplicativos Spring Boot para criar uma implementação de ponta a ponta do gerenciamento de recursos.

As bibliotecas de Gerenciamento de Funcionalidades do Spring Boot não têm dependência em nenhuma biblioteca do Azure. Elas se integram perfeitamente à Configuração de Aplicativos por meio de seu provedor de configuração do Spring Boot.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie um gratuitamente.
• Um repositório de Configuração de Aplicativos, conforme mostrado no tutorial para criar um repositório.
• Um SDK do Java Development Kit com suporte para a versão 17.
• Apache Maven, versão 3.0 ou posterior.

Adicionar um sinalizador de recursos

Adicione um sinalizador de recursos chamado Beta ao repositório da Configuração de Aplicativos e deixe o Rótulo e a Descrição com seus valores padrão. Para mais informações sobre como adicionar sinalizadores de recursos a um repositório usando o portal do Azure ou a CLI, acesse Criar um sinalizador de recurso. Neste estágio, a caixa de seleção Habilitar sinalizador de recurso deve ser desmarcada.

Criar um aplicativo de console

1. Crie um novo projeto do Spring Boot:

   1. Navegue até o Spring Initializr.

   2. Especifique as seguintes opções:

      • Gere um projeto Maven com Java.
      • Especifique uma versão do Spring Boot igual ou maior que 3.0.
      • Especifique os nomes de Grupo e Artefato do aplicativo. Este artigo usa com.example e demo.

   3. Após especificar as opções anteriores, selecione Gerar Projeto. Baixe e extraia o projeto para o computador local.

2. Localize pom.xml no diretório raiz do aplicativo e abra-o em um editor de texto.

3. Adicione o seguinte à lista de <dependencies>:

   <dependency>
       <groupId>com.azure.spring</groupId>
       <artifactId>spring-cloud-azure-appconfiguration-config</artifactId>
   </dependency>
   <dependency>
       <groupId>com.azure.spring</groupId>
       <artifactId>spring-cloud-azure-feature-management</artifactId>
   </dependency>
   

4. Adicione a seguinte seção <dependencyManagement> para gerenciar as versões da biblioteca de Azure do Spring Cloud:

   <dependencyManagement>
       <dependencies>
           <dependency>
               <groupId>com.azure.spring</groupId>
               <artifactId>spring-cloud-azure-dependencies</artifactId>
               <version>7.2.0</version>
               <type>pom</type>
               <scope>import</scope>
           </dependency>
       </dependencies>
   </dependencyManagement>
   

5. Navegue até o diretório resources do aplicativo e abra o arquivo application.properties ou application.yaml.

   Use a autenticação DefaultAzureCredential no repositório da Configuração de Aplicativos. Para que a autorização funcione, você precisa conceder a função Leitor de Dados de Configuração de Aplicativo à credencial que seu aplicativo usa. Para obter instruções, consulte Autenticação com credenciais de token. Certifique-se de permitir tempo suficiente para a permissão se propagar antes de executar seu aplicativo.

   • Propriedades
   • YAML

   spring.config.import=azureAppConfiguration
   spring.cloud.azure.appconfiguration.stores[0].endpoint= ${AZURE_APPCONFIG_ENDPOINT}
   spring.cloud.azure.appconfiguration.stores[0].feature-flags.enabled=true
   

6. Atualize o DemoApplication.java arquivo no diretório do pacote do aplicativo com o seguinte código:

   import org.springframework.boot.CommandLineRunner;
   import org.springframework.boot.SpringApplication;
   import org.springframework.boot.autoconfigure.SpringBootApplication;
   import org.springframework.context.annotation.Bean;
   
   import com.azure.spring.cloud.feature.management.FeatureManager;
   
   @SpringBootApplication
   public class DemoApplication {
   
       public static void main(String[] args) {
           SpringApplication.run(DemoApplication.class, args);
       }
   
       @Bean
       public CommandLineRunner runner(FeatureManager featureManager) {
           return args -> {
               System.out.println("Beta is enabled: " + featureManager.isEnabled("Beta"));
           };
       }
   }
   

7. Defina uma variável de ambiente chamada AZURE_APPCONFIG_ENDPOINT e defina-a como o ponto de extremidade do repositório de Configuração de Aplicativos. Na linha de comando, execute o seguinte comando e reinicie o prompt de comando para permitir que a alteração entre em vigor:

   • Prompt de comando do Windows
   • PowerShell
   • macOS
   • Linux

   setx AZURE_APPCONFIG_ENDPOINT "<endpoint-of-your-app-configuration-store>"
   

   Reinicie o prompt de comando para permitir que a alteração entre em vigor. Valide se ele está definido corretamente imprimindo o valor da variável de ambiente.

8. Crie e execute seu aplicativo Spring Boot com o Maven.

   mvn clean package
   mvn spring-boot:run
   

9. No portal da Configuração de Aplicativos, selecione Gerenciador de Recursos e altere o estado do sinalizador de recurso Beta para Ativado, usando a alternância na coluna Habilitado.

   Chave	Estado
   Beta	Por

10. Reinicie o aplicativo. O aplicativo imprimirá o seguinte:

    Beta is enabled: true
    

Limpar os recursos

Se não deseja continuar usando os recursos criados neste artigo, exclua o grupo de recursos que você criou aqui para evitar encargos.

1. Entre no portal do Azure e selecione Grupos de recursos.
2. Na caixa Filtrar por nome..., digite o nome do seu grupo de recursos.
3. Na lista de resultados, selecione o nome do grupo de recursos para conferir uma visão geral.
4. Selecione Excluir grupo de recursos.
5. Você receberá uma solicitação para confirmar a exclusão do grupo de recursos. Insira o nome do grupo de recursos para confirmar e selecione Excluir.

Após alguns instantes, o grupo de recursos e todos os recursos dele são excluídos.

Próximas etapas

Neste início rápido, você criou um novo repositório de Configuração de Aplicativos e o usou para gerenciar recursos em um aplicativo Spring Boot por meio das bibliotecas de Gerenciamento de Recursos.

• Saiba mais sobre o gerenciamento de recursos.
• Gerenciar sinalizadores de recursos.