Compartilhar via

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

Observação

O Azure Spring Apps é o novo nome para o serviço do Azure Spring Cloud. Embora o serviço tenha um novo nome, você verá o nome antigo em alguns locais por um tempo enquanto trabalhamos para atualizar ativos, como capturas de tela, vídeos e diagramas.

O Azure Spring Apps é uma plataforma totalmente gerenciada para desenvolvimento de microsserviços, com descoberta de serviços integrada 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 CI/CD (integração e entrega contínua) para o Azure Spring Apps.

Neste tutorial, você concluirá estas tarefas:

  • Provisionar uma instância de serviço e iniciar um aplicativo Java Spring
  • Preparar o servidor Jenkins
  • Usar a CLI do Azure em um pipeline do Jenkins para criar e implantar os aplicativos de microsserviço

Pré-requisitos

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

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

Usamos o Piggy Metrics como o aplicativo de serviço da Microsoft de exemplo e seguimos as mesmas etapas no 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, pode pular para a próxima seção. Caso contrário, incluídos a seguir estão os comandos da CLI do Azure. Consulte o Início Rápido: inicie um aplicativo Java Spring usando a CLI do Azure para obter mais informações.

Seu computador local precisa atender ao mesmo pré-requisito que o servidor de build jenkins. Verifique se o seguinte está instalado para criar e implantar os aplicativos de microsserviço:

  1. Instale a extensão do Azure Spring Apps:

    az extension add --name spring

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

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

  3. Provisionar 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 a sua conta do GitHub. No computador local, clone o 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 <o 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, serviço de autenticação e serviço de conta:

    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. Atribuir 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 um build, o que é bom para teste. 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 criar um agente no Azure para executar seus builds.

Instalar plug-ins

  1. Faça logon no servidor Jenkins.

  2. Selecione Gerenciar Jenkins.

  3. Selecione Gerenciar Plug-ins.

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

    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 instale após a reinicialização.

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

Adicione sua credencial do Principal de Serviço do Azure no repositório 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 principal do serviço no tutorial Implantar no Azure App Service. A saída de az ad sp create-for-rbac é algo como isto:

    {
    "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. Forneça valores para os seguintes campos:

    • ID da assinatura: ID da assinatura do Azure
    • ID do cliente: appid do principal de serviço
    • Segredo do cliente: senha do principal de serviço
    • ID do inquilino: ID do inquilino da Microsoft
    • Ambiente do Azure: selecione o valor apropriado para seu ambiente. Por exemplo, use o Azure para o Azure Global
    • ID: Definir como azure_service_principal. Usamos essa ID em uma etapa posterior neste artigo
    • Descrição: esse valor é opcional, mas recomendado do ponto de vista de documentação/manutenção.

Instale o Maven e a extensão Spring 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. Verifique se o usuário jenkins tem permissão para executar a extensão do Spring.

  1. Conecte-se ao controlador Jenkins por meio do 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 Instalar a CLI do Azure.

  4. Mude para o jenkins usuário.

    sudo su jenkins

  5. Instale a extensão spring:

    az extension add --name spring

Criar um Jenkinsfile

  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 pela ID certa 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 do 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. Para Definição, selecione Pipeline Script from SCM.

  5. Para O SCM, selecione Git.

  6. Insira a URL do GitHub para seu repositório bifurcado: https://github.com/&lt;your GitHub id&gt;/piggymetrics.git.

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

  8. Para o caminho do script, selecione Jenkinsfile.

  9. Selecione Salvar

Validar e executar o trabalho

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

  1. Em seu repositório, abra index.html em /gateway/src/main/resources/static/.

  2. Pesquisar por enter your login e atualizar 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 do Jenkins, selecione o trabalho Deploy-PiggyMetrics e selecione Compilar Agora.

Depois que o trabalho for concluído, navegue até o IP público do gateway aplicativo e verifique se o aplicativo foi atualizado.

Métricas atualizadas do Piggy

Limpar os 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óximas etapas

Jenkins no Azure

  • Last updated on