Tutorial: Implantar aplicativos no Azure Spring Apps usando Jenkins e a CLI do Azure

O Azure Spring Apps é um desenvolvimento de microsserviços totalmente gerenciado com descoberta de serviço interno e gerenciamento de configuração. O serviço facilita a implantação de aplicativos de microsserviço baseados no Spring Boot no Azure. Este tutorial demonstra como você pode usar a CLI do Azure no Jenkins para automatizar a integração contínua e a entrega (CI/CD) para o Azure Spring Apps.

Neste tutorial, você concluirá estas tarefas:

Pré-requisitos

• Assinatura do Azure: se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

• Jenkins: Instale o Jenkins em uma VM Linux
• Conta do GitHub: Se você não tiver uma conta do GitHub, crie uma conta gratuita antes de começar.

Provisionar uma instância de serviço e executar um aplicativo Java Spring

Usamos o Piggy Metrics como o aplicativo de serviço Microsoft de exemplo e seguimos as mesmas etapas em Guia de início rápido: iniciar um aplicativo Java Spring usando a CLI do Azure para provisionar a instância de serviço e configurar os aplicativos. Se você já passou pelo mesmo processo, pule para a próxima seção. Caso contrário, incluídos a seguir estão os comandos da CLI do Azure. Consulte Guia de início rápido: inicie um aplicativo Java Spring usando a CLI do Azure para obter mais informações.

Sua máquina local precisa atender ao mesmo pré-requisito que o servidor de compilação Jenkins. Verifique se o seguinte está instalado para criar e implantar os aplicativos de microsserviço:

• Git
• JDK 8
• Maven 3.0 ou superior
• CLI do Azure instalada, versão 2.0.67 ou superior

1. Instale a extensão Azure Spring Apps:

   az extension add --name spring
   

2. Crie um grupo de recursos para conter seu serviço Azure Spring Apps:

   az group create --location eastus --name <resource group name>
   

3. Provisione uma instância do Azure Spring Apps:

   az spring create -n <service name> -g <resource group name>
   

4. Fork o repositório Piggy Metrics para sua própria conta do GitHub. Em sua máquina local, clone seu repositório em um diretório chamado source-code:

   mkdir source-code
   git clone https://github.com/<your GitHub id>/piggymetrics
   

5. Configure o servidor de configuração. Certifique-se de substituir <seu ID> do GitHub pelo valor correto.

   az spring config-server git set -n <your-service-name> --uri https://github.com/<your GitHub id>/piggymetrics --label config
   

6. Compile o projeto:

   cd piggymetrics
   mvn clean package -D skipTests
   

7. Crie os três microsserviços: gateway, auth-service e account-service:

   az spring app create --n gateway -s <service name> -g <resource group name>
   az spring app create --n auth-service -s <service name> -g <resource group name>
   az spring app create --n account-service -s <service name> -g <resource group name>
   

8. Implante os aplicativos:

   az spring app deploy -n gateway -s <service name> -g <resource group name> --jar-path ./gateway/target/gateway.jar
   az spring app deploy -n account-service -s <service name> -g <resource group name> --jar-path ./account-service/target/account-service.jar
   az spring app deploy -n auth-service -s <service name> -g <resource group name> --jar-path ./auth-service/target/auth-service.jar
   

9. Atribua um ponto de extremidade público ao gateway:

   az spring app update -n gateway -s <service name> -g <resource group name> --is-public true
   

10. Consulte o aplicativo de gateway para obter a url para que você possa verificar se o aplicativo está em execução.

    az spring app show --name gateway | grep url
    

11. Navegue até a URL fornecida pelo comando anterior para executar o aplicativo PiggyMetrics.

Preparar o servidor Jenkins

Nesta seção, você prepara o servidor Jenkins para executar uma compilação, o que é bom para testes. No entanto, devido à implicação de segurança, você deve usar um agente de VM do Azure ou um agente de Contêiner do Azure para girar um agente no Azure para executar suas compilações.

Instalar plug-ins

1. Inicie sessão no seu servidor Jenkins.

2. Selecione Gerenciar Jenkins.

3. Selecione Gerenciar plugins.

4. Na guia Disponível , selecione os seguintes plug-ins:

   • Integração com GitHub
   • Credencial do Azure

   Se esses plug-ins não aparecerem na lista, verifique a guia Instalado para ver se eles já estão instalados.

5. Para instalar os plug-ins, selecione Baixar agora e instalar após a reinicialização.

6. Reinicie o servidor Jenkins para concluir a instalação.

Adicionar a sua credencial do Principal de Serviço do Azure ao armazenamento de credenciais do Jenkins

1. Você precisa de uma Entidade de Serviço do Azure para implantar no Azure. Para obter mais informações, consulte a seção Criar entidade de serviço no tutorial Implantar no Serviço de Aplicativo do Azure. A saída de az ad sp create-for-rbac é algo mais ou menos assim:

   {
       "appId": "xxxxxx-xxx-xxxx-xxx-xxxxxxxxxxxx",
       "displayName": "xxxxxxxjenkinssp",
       "name": "http://xxxxxxxjenkinssp",
       "password": "xxxxxx-xxx-xxxx-xxx-xxxxxxxxxxxx",
       "tenant": "xxxxxx--xxx-xxxx-xxx-xxxxxxxxxxxx"
   }
   

2. No painel do Jenkins, selecione Credenciais>Sistema. Em seguida, selecione Credenciais globais(sem restrições).

3. Selecione Adicionar credenciais.

4. Selecione Entidade de Serviço do Microsoft Azure como tipo.

5. Valores de fornecimento para os seguintes campos:

   • ID da assinatura: ID da assinatura do Azure
   • ID do cliente: ID da aplicação do principal de serviço
   • Segredo do cliente: Senha do principal de serviço
   • ID do inquilino: ID do locatário da conta da Microsoft
   • Ambiente do Azure: selecione o valor apropriado para o seu ambiente. Por exemplo, use o Azure para Azure Global
   • ID: Defina como azure_service_principal. Usamos esse ID em uma etapa posterior deste artigo
   • Descrição: Este valor é opcional, mas recomendado do ponto de vista da documentação/manutenção.

Instalar o Maven e a extensão de primavera da CLI do Azure

O pipeline de exemplo usa o Maven para criar e a CLI do Azure para implantar na instância de serviço. Quando o Jenkins é instalado, ele cria uma conta de administrador chamada jenkins. Certifique-se de que o usuário jenkins tem permissão para executar a extensão spring.

1. Conecte-se ao controlador Jenkins via SSH.

2. Instale o Maven.

   sudo apt-get install maven
   

3. Verifique se a CLI do Azure está instalada inserindo az version. Se a CLI do Azure não estiver instalada, consulte Instalando a CLI do Azure.

4. Mude para o jenkins utilizador:

   sudo su jenkins
   

5. Instale a extensão spring:

   az extension add --name spring
   

Criar um arquivo Jenkins

1. Em seu próprio repositório - https://github.com/your_github_id/piggymetrics - crie um Jenkinsfile na raiz.

2. Atualize o arquivo da seguinte maneira. Certifique-se de substituir os valores de nome< do grupo de recursos e nome do> serviço.<> Substitua azure_service_principal pelo ID correto se você usar um valor diferente ao adicionar a credencial no Jenkins.

       node {
         stage('init') {
           checkout scm
         }
         stage('build') {
           sh 'mvn clean package'
         }
         stage('deploy') {
           withCredentials([azureServicePrincipal('azure_service_principal')]) {
             // Log in to Azure
             sh '''
               az login --service-principal -u $AZURE_CLIENT_ID -p $AZURE_CLIENT_SECRET -t $AZURE_TENANT_ID
               az account set -s $AZURE_SUBSCRIPTION_ID
             '''  
             // Set default resource group name and service name. Replace <resource group name> and <service name> with the right values
             sh 'az config set defaults.group=<resource group name>'
             sh 'az config set defaults.spring=<service name>'
   
             // Deploy applications
             sh 'az spring app deploy -n gateway --jar-path ./gateway/target/gateway.jar'
             sh 'az spring app deploy -n account-service --jar-path ./account-service/target/account-service.jar'
             sh 'az spring app deploy -n auth-service --jar-path ./auth-service/target/auth-service.jar'
             sh 'az logout'
           }
         }
       }
   

3. Salve e confirme a alteração.

Criar a tarefa

1. No painel Jenkins, selecione Novo Item.

2. Forneça um nome, Deploy-PiggyMetrics para o trabalho e selecione Pipeline. Clique em OK.

3. Selecione a guia Pipeline .

4. Em Definição, selecione Script de pipeline do SCM.

5. Para SCM, selecione Git.

6. Digite o URL do GitHub para seu repositório bifurcado: https://github.com/<your GitHub id>/piggymetrics.git.

7. Para Especificador de ramificação (preto para 'qualquer'), selecione /Azure.

8. Em Caminho do script, selecione Jenkinsfile.

9. Selecione Guardar

Validar e executar o trabalho

Antes de executar o trabalho, edite o texto na caixa de entrada de login para inserir o ID de login.

1. No seu repo, abra index.html em /gateway/src/main/resources/static/.

2. Procure enter your login e atualize esse texto para enter login ID.

   <input class="frontforms" id="frontloginform" name="username" placeholder="enter login ID" type="text" autocomplete="off"/>
   

3. Salve e confirme a alteração.

4. Execute o trabalho no Jenkins manualmente. No painel Jenkins, selecione o trabalho Deploy-PiggyMetrics e, em seguida, selecione Compilar agora.

Após a conclusão do trabalho, navegue até o gateway IP público do aplicativo e verifique se o aplicativo foi atualizado.

Limpeza de recursos

Quando não for mais necessário, exclua os recursos criados neste artigo:

az group delete -y --no-wait -n <resource group name>

Próximos passos