6.3 Personalizando Imagem do Servidor Web via GitLab CI/CD
Last updated
Last updated
Confome dito anteriormente, vamos a seguir, gerar a imagem do nosso Servidor Web com o código de nossa aplicação empacotado dentro dele, simulando como se estivessemos fazendo o deploy da aplicação num servidor web remoto.
No nosso caso, como estamos executando tudo via localhost, o que faremos é atualizar a imagem do Servidor Tomcat no Hub Docker de modo que, em seguida, podemos reiniciar as instâncias locais dos nossos servidores localmente e as alterações passem a ter efeito.
Inicialmente, a primeira coisa a ser feita é entender que, para que seja possível a personalização da imagem do Tomcat de dentro do CI/CD, os arquivos de configuração do nosso servidor Web foram adicionados no nosso projeto da loja virtual dentro do GitLab. Para isso, criou-se uma pasta denominada docker-img e, dentro dela, uma subpasta web. Assim sendo, dentro desse diretório ./docker-img/web foram adicionados o conteúdo da pasta devops-extra/cap-06/web, conforme ilustrado abaixo.
Internamento no GitLab os arquivos estão localizados na estrutura de diretórios conforme descrito acima.
Observe que esses arquivos precisam agora estar no servidor pois, quem irá construir a imagem do servidor Web e enviá-la para o Hub Docker não seremos nós, como fizemos com as imagens do Servidor de Bando de Dados e do Servidor de Monitoramento, mas sim nosso script do GitLab CI/CD.
O primeiro passo é incluir um estágio a mais no nosso pipeline chamado de deploy. Abaixo apresentamos o arquivo do pipeline completo e em seguida as explicações sobre as alterações que foram realizadas para viabilizar o deploy da aplicação dentro da imagem do servidor Web.
Como dissemos, a alteração principal foi a incluão de um novo stage, deploy, na linha 19 e o mesmo está associado ao job que se inicia na linha 53 (docker-deploy).
Esse job faz uso de uma outra imagem, denominada docker:latest(linha 55), que contém os comandos docker que serão executados na cláusula script (linhas 57 a 59). Isso é necessário poia na nossa imagem original, que usamos para a execução do Maven, não existe o Docker instalado e, portanto, sem a inclusão dessa imagem específica para a execução desse job, os comandos não seriam reconhecidos e geraria-se uma falha nesse job. Se quiser testar e ver o que ocorre, basta remover essa linha 54 do script e avaliar o resultado após todo o processamento do pipelene.
Em seguida, os comandos presentes nas linhas 57 a 59 são exatamente os mesmos que utilizamos para a construção das imagens e envio ao Hub Docker descritos na Seção 6.2. Entretanto, aqui estão parametrizados, considerando as variáveis já devinidas anteriormente na Seções 5.4 e 5.5, com o DOCKER_ID e o DOCKER_TOKEN do usuário. Desse modo, não são expostas publicamente o ID e o Token de Acesso Pessoal do usuário.
Outra novidade nesse arquivo de configuração é a presença, nas linhas 50 e 60, da cláusula only. O GltLab CI/CD oferece diferentes formas de restingir a execução de job considerando determinadas condições. Nesse exemplo acima, only master indique que, os jobs maven-package e docker-deploy só serão executados caso a alteração seja realizada no ramos master do repositório. Do contrário, esses jobs não serão executados.
Finalmente, para permitir que haja uma troca de arquivos entre os diferentes jobs e também para acelerar a execução dos mesmos está sendo utilizado o recurso de cache. No exemplo acima, estamos fazendo cache dos arquivos de dependência do Maven, armazenados localmente em .m2/repository/ e também dos diretórios combined/target/ e docker-img/web/. Esses dois últimos são responsáveis pelo armazenamento do arquivo lovavirtualdevops.war e dos arquivo de configuração do Servidor Web, respectivamente.
Observa-se também, na linha 3 o uso da cláusula variables que, nesse escopo, permite a definição de uma variável global, MAVEN_OPTS, utilizada para indicar a localização do repositório local de arquivos de dependência do Maven.
Outra novidade presente nesse script é o uso da cláusula artifacts em dois jobs. No primeiro, maven-test, ela é usada para indicar que, como resultado desse job, podem ser gerados arquivos de relatório do JUnit, nos locais indicados. No segundo, maven-package, ela é usada para indicar o arquivo representando o pacote de distribuição da aplicação: devopsnapratica.war.
Finalmente, abaixo tem uma breve descrição dos estágios propostos no pipeline, qual job é executado, e o que aconece em cada um deles:
build: executa o job maven-build responsável pela compilação dos códigos fonte e de teste da aplicação;
test: executa o job maven-test, responsável pela execução dos testes na aplicação e posterior geração dos relatórios sobre a execução dos testes;
package: executa o job maven-package que é responsável por empacotar todo o código da aplicação e, em seguida, copiar o arquivo devopsnapratica.war para dentro da subpasta docker-img/web/ pois esse arquivo será utilizado no último estágio do pipeline;
deploy: executa o job docker-deploy que faz a construção da imagem Docker conforme Dockerfile localizado em docker-img/web/, gerando a imagem denominada $DOCKER_ID/tomcat-server-img. Em seguida, é feita a autenticação no Hub Docker por meio de DOCKER_ID e DOCKER_TOKEN e, em seguida, a imagem do Servidor Web com a última versão do arquivo devopsnapratica.war é enviada para o Hub Docker e pode ser utilizada para a reinicialização do Servidor Web.
Novamente, vale ressaltar que esse último passo poderia ser realizado de modo que a nova versão da aplicação seja encaminhar para um Ambiente de Produção na nuvem e o usuário, imediatamente, passasse a executar a versão atualizada da Loja Virtual. Numa versão futura desse livro daremos mais detalhes sobre isso. Por hora, os interessados, podem consultar diferentes artigos na rede que falam sobre o assunto. Na documentação oficial do GitLab tem exemplos para algumas nuvens (https://docs.gitlab.com/ee/ci/cloud_deployment/).
Para demonstrar o funcionamento, basta editarmos o arquivo .gitlab-ci.yml e, ao confirmar a alteração, avaliarmos o resultado final obtido.
Primeiramente, apenas para comparação, observa-se que a última atualização da imagem do Servidor Web no Hub Docker ocorreu a dois dias atrás.
Em seguida, após editar e confirmar a alteração no arquivo .gitlab-ci.yml, conforme conteúdo apresentado acima, tem-se início a execução do pipeline definido.
Após o témino do fluxo CI/CD definido, conforme era de se esperar, a imagem do Servidor Web foi atualizada no Jub Docker.
