Configurar um ambiente de preparo no Azure Spring Apps

Este artigo aplica-se a: ✔️ Java ❌ C#

Este artigo aplica-se a:❌ Basic ✔️ Standard ✔️ Enterprise

Este artigo explica como configurar uma implantação de preparo usando o padrão de implantação azul-verde no Azure Spring Apps. A implantação azul-verde é um padrão de entrega contínua do Azure DevOps que depende de manter uma versão existente (azul) ativa enquanto uma nova (verde) é implantada. Este artigo mostra como colocar essa implantação de preparo em produção sem alterar a implantação de produção.

Pré-requisitos

• Uma instância existente do Azure Spring Apps no plano Standard.
• CLI do Azure.

Este artigo usa um aplicativo criado a partir do Spring Initializr. Se você quiser usar um aplicativo diferente para este exemplo, faça uma alteração em uma parte voltada para o público do aplicativo para diferenciar sua implantação de preparo da implantação de produção.

Para configurar a implantação azul-verde no Azure Spring Apps, siga as instruções nas próximas seções.

Instalar a extensão da CLI do Azure

Instale a extensão do Azure Spring Apps para a CLI do Azure usando o seguinte comando:

az extension add --name spring

Preparar o aplicativo e as implantações

Para criar o aplicativo, execute estas etapas:

1. Gere o código para o aplicativo de exemplo usando o Spring Initializr com essa configuração.

2. Faça o download do código.

3. Adicione o seguinte arquivo de origem HelloController.java à pasta *\src\main\java\com\example\hellospring*:

   package com.example.hellospring;
   import org.springframework.web.bind.annotation.RestController;
   import org.springframework.web.bind.annotation.RequestMapping;
   
   @RestController
   
   public class HelloController {
   
   @RequestMapping("/")
   
     public String index() {
         return "Greetings from Azure Spring Apps!";
     }
   
   }
   

4. Crie o arquivo .jar :

   mvn clean package -DskipTests
   

5. Crie o aplicativo em sua instância do Azure Spring Apps:

   • Plano Standard
   • Plano empresarial

   az spring app create \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name demo \
       --runtime-version Java_17 \
       --assign-endpoint
   

6. Implante o aplicativo no Azure Spring Apps:

   az spring app deploy \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name demo \
       --artifact-path target\hellospring-0.0.1-SNAPSHOT.jar
   

7. Modifique o código para sua implantação de preparo:

   package com.example.hellospring;
   import org.springframework.web.bind.annotation.RestController;
   import org.springframework.web.bind.annotation.RequestMapping;
   
   @RestController
   
   public class HelloController {
   
   @RequestMapping("/")
   
     public String index() {
         return "Greetings from Azure Spring Apps! THIS IS THE GREEN DEPLOYMENT";
     }
   
   }
   

8. Reconstrua o arquivo .jar :

   mvn clean package -DskipTests
   

9. Crie a implantação verde:

   • Plano Standard
   • Plano empresarial

   az spring app deployment create \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --app demo \
       --name green \
       --runtime-version Java_17 \
       --artifact-path target\hellospring-0.0.1-SNAPSHOT.jar
   

Exibir aplicativos e implantações

Use as etapas a seguir para exibir aplicativos implantados.

1. Vá para sua instância do Azure Spring Apps no portal do Azure.

2. No painel de navegação, abra o painel Aplicativos para exibir aplicativos para sua instância de serviço.

   

3. Selecione um aplicativo para ver os detalhes.

   

4. Abra Implantações para ver todas as implantações do aplicativo. A grade mostra as implantações de produção e de preparação.

   

5. Selecione a URL para abrir o aplicativo implantado no momento.

   

6. Selecione Produção na coluna Estado para ver o aplicativo padrão.

   

7. Selecione Preparo na coluna Estado para ver o aplicativo de preparo.

   

Se você visitar sua demonstração de aplicativo voltada para o público neste momento, deverá ver a página antiga sem a nova alteração.

Definir a implantação verde como o ambiente de produção

1. Depois de verificar a alteração no ambiente de preparação, você pode enviá-la para a produção. Na página Implantações de aplicativos>, selecione o aplicativo atualmente em produção.

2. Selecione as reticências após Status de registro da implantação verde e, em seguida, selecione Definir como produção.

   

3. Confirme se o URL da aplicação apresenta as suas alterações.

   

Modificar a implantação de preparo

Se não estiver satisfeito com a alteração, você pode modificar o código do aplicativo, criar um novo pacote de .jar e carregá-lo em sua implantação verde usando a CLI do Azure:

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name demo \
    --deployment green \
    --artifact-path demo.jar

Excluir a implantação de preparo

Para excluir sua implantação de preparo do portal do Azure, vá para a página de sua implantação de preparo e selecione o botão Excluir .

Como alternativa, exclua sua implantação de preparo da CLI do Azure executando o seguinte comando:

az spring app deployment delete \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <staging-deployment-name> \
    --app demo

Próximos passos

• CI/CD para Aplicativos Azure Spring