Ler em inglês

Partilhar via

Guia de início rápido: criar e enviar imagens de contêiner do aplicativo Java Spring Boot para o Registro de Contêiner do Azure

  • Artigo

Você pode usar este Guia de início rápido para criar imagens de contêiner do aplicativo Java Spring Boot e enviá-lo por push para o Registro de Contêiner do Azure usando Maven e Jib. Maven e Jib são uma maneira de usar ferramentas de desenvolvedor para interagir com um registro de contêiner do Azure.

Pré-requisitos

Criar e criar um aplicativo Spring Boot no Docker

As etapas a seguir o orientam na criação de um aplicativo Web Java Spring Boot em contêiner e no teste local.

  1. No prompt de comando, use o seguinte comando para clonar o projeto de exemplo Spring Boot on Docker Getting Started .

    Bash 
    git clone https://github.com/spring-guides/gs-spring-boot-docker.git

  2. Altere o diretório para o projeto completo.

    Bash 
    cd gs-spring-boot-docker/complete

  3. Utilize o Maven para criar e executar o exemplo de aplicação.

    Bash 
    mvn package spring-boot:run

  4. Teste a aplicação Web ao navegar para http://localhost:8080 ou com o seguinte comando curl:

    Bash 
    curl http://localhost:8080

Você verá a seguinte mensagem exibida: Hello Docker World

Criar um registo de contentor do Azure com a CLI do Azure

Em seguida, você criará um grupo de recursos do Azure e seu ACR usando as seguintes etapas:

  1. Faça logon na sua conta do Azure usando o seguinte comando:

    Azure CLI 
    az login

  2. Especifique a assinatura do Azure a ser usada:

    Azure CLI 
    az account set -s <subscription ID>

  3. Crie um grupo de recursos para os recursos do Azure utilizados neste tutorial. No comando a seguir, substitua os espaços reservados pelo seu próprio nome de recurso e um local como eastus.

    Azure CLI 
    az group create \
    --name=<your resource group name> \
    --location=<location>

  4. Crie um registro de contêiner privado do Azure no grupo de recursos, usando o comando a seguir. Certifique-se de substituir os espaços reservados por valores reais. O tutorial emite o exemplo de aplicação sob a forma de imagem do Docker para este registo em passos posteriores.

    Azure CLI 
    az acr create \
    --resource-group <your resource group name> \
    --location <location> \
    --name <your registry name> \
    --sku Basic

Emitir a sua aplicação para o registo de contentor via Jib

Finalmente, você atualizará a configuração do projeto e usará o prompt de comando para criar e implantar sua imagem.

Nota

Para fazer logon no registro de contêiner do Azure que você acabou de criar, você precisará ter o daemon do Docker em execução. Para instalar o Docker em sua máquina, aqui está a documentação oficial do Docker.

  1. Faça logon no Registro de Contêiner do Azure a partir da CLI do Azure usando o comando a seguir. Certifique-se de substituir o espaço reservado pelo seu próprio nome de registo.

    Azure CLI 
    az config set defaults.acr=<your registry name>
az acr login

    O az config comando define o nome do Registro padrão a ser usado com az acr comandos.

  2. Navegue para o diretório de projeto concluído da sua aplicação Spring Boot (por exemplo, "C:\SpringBoot\gs-spring-boot-docker\complete" ou "/users/robert/SpringBoot/gs-spring-boot-docker/complete") e abra o ficheiro pom.xml com um editor de texto.

  3. Atualize a <properties> coleção no arquivo pom.xml com o XML a seguir. Substitua o espaço reservado pelo nome do Registro e adicione uma <jib-maven-plugin.version> propriedade com valor 2.2.0ou uma versão mais recente do jib-maven-plugin.

    XML 
    <properties>
   <docker.image.prefix><your registry name>.azurecr.io</docker.image.prefix>
   <java.version>1.8</java.version>
   <jib-maven-plugin.version>2.2.0</jib-maven-plugin.version>
</properties>

  4. Atualize a <plugins> coleção no arquivo pom.xml para que o <plugin> elemento contenha e uma entrada para o jib-maven-plugin, conforme mostrado no exemplo a seguir. Tenha em atenção que estamos a utilizar uma imagem base do Microsoft Container Registry (MCR), mcr.microsoft.com/openjdk/jdk:11-ubuntu, que contém um JDK suportado oficialmente para o Azure. Para outras imagens de base MCR com JDKs oficialmente suportados, consulte Instalar o Microsoft Build do OpenJDK.

    XML 
    <plugin>
  <artifactId>jib-maven-plugin</artifactId>
  <groupId>com.google.cloud.tools</groupId>
  <version>${jib-maven-plugin.version}</version>
  <configuration>
     <from>
         <image>mcr.microsoft.com/openjdk/jdk:11-ubuntu</image>
     </from>
     <to>
         <image>${docker.image.prefix}/${project.artifactId}</image>
     </to>
  </configuration>
</plugin>

  5. Navegue até o diretório completo do projeto para seu aplicativo Spring Boot e execute o seguinte comando para criar a imagem e enviar a imagem para o registro:

    Azure CLI 
    az acr login && mvn compile jib:build

Nota

Por motivos de segurança, a credencial criada por az acr login é válida apenas por 1 hora. Se você receber um erro 401 não autorizado , você pode executar o az acr login -n <your registry name> comando novamente para autenticar novamente.

Verificar a imagem do contêiner

Parabéns! Agora você tem sua compilação de aplicativo Java em contêiner no JDK suportado pelo Azure enviada para seu ACR. Agora você pode testar a imagem implantando-a no Serviço de Aplicativo do Azure ou puxando-a para local com o comando (substituindo o espaço reservado):

Bash 
docker pull <your registry name>.azurecr.io/gs-spring-boot-docker

Próximos passos

Para obter outras versões das imagens oficiais da base Java suportadas pela Microsoft, consulte:

Para saber mais sobre o Spring e o Azure, avance para o centro de documentação relativa ao Spring no Azure.

Spring no Azure

Recursos Adicionais

Para obter mais informações, consulte os seguintes recursos: