O Docker é uma plataforma open source que possibilita a criação e administração de ambientes de forma isolada. Dessa forma, uma aplicação pode ser empacotada dentro de um container com todas as bibliotecas e recursos necessários para ser executada em outro host que possua apenas o Docker instalado, possibilitando a integração com múltiplos clouds, como AWS, Azure ou Google.

Nesse exemplos usamos o Docker como tecnologia de container, porém, seria possível utilizar outras ferramentas, como o Kubernetes.

Nesse tutorial, mostraremos como:

1. Criar e executar uma imagem Docker a partir do repositório de código Git.

2. Enviar uma imagem para um repositório de imagens Docker;

3. Obter e executar uma imagem Docker a partir de um repositório de imagens;

4. Entender os comandos do arquivo Dockerfile.

Requisitos

Antes de começar a seguir os passos do tutorial é preciso ter certeza de que se tem um ambiente minimamente preparado para reproduzir o exemplo. Abaixo estão os requisitos principais:

1. Conhecimentos básicos sobre Docker e Nginx.

2. WSL instalado e configurado.

3. Docker Engine instalado e logado em seu registry, como o DockerHub.

4. Projeto Cronapp criado. Caso haja dúvidas de como criar um projeto, acesse a documentação Criar projeto.

5. Recomendamos que o equipamento possua os requisitos do ambiente de produção.

Terminal

Os comandos exibidos nesse tutorial serão executados via terminal WSL e será necessário que o usuário tenha perfil Administrador (root) do sistema. Para mais informações de instalação e configuração, consulte a documentação oficial.

Arquivo Dockerfile

Para construir uma imagem, o Docker utiliza as instruções contidas no arquivo Dockerfile, normalmente localizado na raiz do projeto. Todos os projetos criados a partir da versão 2.7 do Cronapp já possui esse arquivo configurado para construir uma imagem local ou executá-lo em um CI/CD pipeline.

Abaixo apresenta como esse arquivo está configurado.

## Consulte a documentação do Docker em https://docs.cronapp.io para informações sobre o conteúdo desse arquivo.

FROM ubuntu:18.04 as maven_builder 
RUN apt update && apt install -y maven openjdk11-11-jdk npm git bash
WORKDIR /app
ADD pom.xml /app/pom.xml
RUN git config --global url."https://".insteadOf git://
ARG TIER
ARG CONTEXT_USE
ARG MOBILE_APP

## Para repositório EXTERNO não é necessário alterações.
## Para repositório INTERNO comente as linhas 16, 17 e 18 e retire os comentários nas linhas 21, 22, 23 e 24.

## Usando repositórios externo - JAR e NPM
RUN mvn dependency:go-offline -B
ADD . /app
RUN cd /app && mvn package -X -Dcronapp.profile=${TIER} -Dcronapp.useContext=${CONTEXT_USE} -Dcronapp.mobileapp=${MOBILE_APP}

## Usando repositórios interno - JAR e NPM
#ADD settings.xml  $HOME/.m2/settings.xml
#RUN npm config set registry https://my.registry.com/your-repository/name && mvn -s /app/settings.xml dependency:go-offline -B
#ADD . /app
#RUN cd /app && mvn -s /app/settings.xml package -X -Dcronapp.profile=${TIER} -Dcronapp.useContext=${CONTEXT_USE} -Dcronapp.mobileapp=${MOBILE_APP}

FROM tomcat:9.0.17-jre11
RUN rm -rf /usr/local/tomcat/webapps/* && groupadd tomcat && useradd -s /bin/false -M -d /usr/local/tomcat -g tomcat tomcat
COPY --from=maven_builder /app/target/*.war /usr/local/tomcat/webapps/ROOT.war
RUN chown tomcat:tomcat -R /usr/local/tomcat
USER tomcat

Passos

Este tutorial irá apresentar como executar, via comandos no WSL, os quatro tipos de opções disponíveis para Pacote para Deploy. 

War Completo

Para iniciar, acesse no menu do sistema Projeto > Exportar. Em seguida, escolha a opção Pacote para Deploy (destaque 1 da Figura 1) e, na janela que exibir, escolha no campo Tipo de Artefato (2) a opção "War Completo" e habilite a checkbox do campo Dockerfile (3), assim como apresentado na imagem abaixo. Por fim, clique em "OK" para iniciar o download do pacote.

Figura 1 - Janela Pacote para Deploy

Após finalizar o download, extraia os arquivos da pasta .zip para uma pasta descompactada . Para este exemplo, nomeamos a pasta que nomeamos como "war-completo". Em seguida, adicione a pasta descompactada no diretório wsl. Para este exemplo, adicionamos a pasta descompactada no diretório do usuário, seguindo o caminho \\wsl.localhost\Ubuntu-20.04\home\laila (Figura 1.1).

Em seguida, vamos alterar a porta em que será executado o projeto local. Por padrão, o script run.sh (destaque 1 da Figura 1.1), que possui comandos docker que facilitam a virtualização da aplicação, utiliza a porta 80 para execução do projeto. No entanto, essa é a porta padrão utilizada no ngnix... <TO DO> Vamos alterá-la para a porta 81, para isso, abra o script run.sh em um editor de texto e faça a alteração de "80:80" para "81:80" (2). Por fim, salve as alterações. Âncorafigura1.1figura1.1

Figura 1.1 - Diretório wsl onde a pasta descompactada foi adicionada e edição do script run.sh

Após esses passos, vamos executar no terminal do wsl o script run.sh. No terminal, acesse o diretório que contém a pasta descompactada e execute o comando abaixo.

sh run.sh

Após a execução do comando, será possível abrir o projeto local no navegador utilizando o endereço local com a porta configurada: http://localhost:81/. Na imagem abaixo, ao lado direito podemos ver a execução do projeto no terminal wsl e ao lado esquerdo a execução do projeto local no endereço configurado (destaque 1 da Figura 1.2).

Figura 1.2 - Execução do projeto local

War Separado

Agora vamos apresentar como exportar um pacote War Servidor e um Front-end de forma separada.

War Servidor

Acesse novamente a janela Pacote para Deploy (Figura 1), No campo Tipo de Artefato, escolha a opção "War Servidor", habilite a checkbox Dockerfile e faça o download do pacote. Em seguida, extraia os arquivos da pasta zip para uma pasta descompactada no diretório wsl e siga os passos da Figura 1.1 para alterar a porta utilizada no script run.sh. Altere a porta de "80" para "82" e execute o comando abaixo.

sh run.sh

Visto que se trata apenas do war servidor, não é possível acessar a aplicação com interfaces web. Para isso, teremos que exportar o war front-end e utilizar o endereço http://localhost:82 configurado <porta-configurada>/ de acordo com a porta configurada no servidor. Consulte o tópico abaixo para mais detalhes.

War Front-end

Na janela Pacote para Deploy (Figura 1), no campo Tipo de Artefato, escolha a opção "War Front-end" e habilite a checkbox Dockerfile. No campo Endereço do servidor (destaque 4 Figura 1) adicione o endereço http://localhost:82/ configurado no war servidor anteriormente. Em seguida, faça o download da aplicação . Após seguir e siga os passos descritos na Figura 1, será preciso alterar .1, descompactando os arquivos e adicionando a pasta descompactada no diretório wsl e, em seguida, altere a porta utilizada no arquivo run.sh. Para isso, abra um arquivo o script run.sh em um editor de texto e faça a alteração da primeira porta 80 para 81, por exemplo, como exibe a imagem abaixo.83. Por fim, execute o comando abaixo.

sh run.sh

Figura 2 - Alteração do arquivo run.sh

Após esta etapa, siga os passos da Figura 1.2. Por fim, poderá executar o projeto local no navegador utilizando o endereço configurado: http://localhost:83/.

Zip Front-end

Na janela "Pacote para Deploy", na opção "Tipo de Artefato", escolha a opção "Zip Front-end". Não será preciso habilitar a checkbox Dockerfile. Faça o download do pacote.