Categoria: Frameworks

Deploy de um app SpringBoot 2 nas nuvens do Azure

Como é da sapiência de todos, o mundo está em quarentena. Pra mim e acredito que para uma boa parte dos desenvolvedores a rotina não muda muito, de qualquer modo, o Blog DevJava quer contribuir com um conteúdo bacana, a fim de incentivar que você realmente fique em casa. Faça sua parte, ajude que essa grave doença não se espalhe. Dessa forma, como é do nosso conhecimento, fique em casa e aproveite esse período para aprender coisas novas.

Nós do Blog DevJava preparamos uma matéria em que realizaremos juntos o deploy de uma pequena aplicação SpringBoot 2 na nuvem do Microsoft Azure. 

Será bem rápido, simples e para focar apenas no deploy, utilizaremos o app HelloWorld que desenvolvemos nesse último post sobre SpringBoot aqui. Apenas para refrescar a memória, Essa aplicação que fizemos outrora, expõe um endpoint que nos retorna uma mensagem de HelloWorld. 

Caso não tenha desenvolvido ainda, está aí a oportunidade. Caso prefira pular para o deploy, pode realizar o git clone do projeto no meu github pessoal por esse link: https://github.com/rafaelvcunha/HelloWorldSpringBoot2

Mas antes de iniciarmos a prática, vamos colocar alguns pingos nos is. 

O que é o Microsoft Azure?

Como o próprio site da microsoft o apresenta, o Azure é uma plataforma de computação em nuvem completa, nessa plataforma podemos criar, implantar e gerenciar serviços e aplicativos na nuvem. 

O que preciso para acessar o Azure?

Caso você ainda não tenha uma conta no Azure, a Microsoft disponibiliza 12 meses de serviços gratuitos, basta se cadastrar no link a seguir: https://azure.microsoft.com/pt-br/free/

Mas se como eu, já encerrou o período de testes, é possível utilizar a plataforma pagando apenas pelo que usar. Ao final do deploy, auxiliarei na exclusão dos recursos para que não fique gerando custos para ti, ou mesmo que eles sejam irrelevantes.

Pré-requisitos

Pré-requisitos para iniciarmos esse tutorial:

  • Uma conta no Microsoft Azure como descrito anteriormente;
  • Realizar a instalação do Azure CLI (interface de linha de comando). Pode ser feito o download ou saber mais nesse link https://docs.microsoft.com/pt-br/cli/azure/?view=azure-cli-latest . 
  • JDK LTS 8 ou 11 instalado com suas variáveis de ambientes configuradas;
  • Possuir o Maven com suas variáveis de ambientes configuradas;
  • Git instalado.
  • Ter realizado o git clone do app HelloWorldSpringBoot2 e importado o projeto maven na sua IDE de estimação.

Bora para a prática, que nem só de teoria ou blá blá blá se vive um desenvolvedor… rsrssrs.

Preparando nossa aplicação para o Azure

Abra o arquivo pom.xml do projeto em sua IDE de estimação. Dentro da tag “<plugins>” que estão abaixo de “<build>”, inclua o seguinte plugin do maven para aplicativos web do azure. Com ele, será possível implantar um aplicativo Spring Boot em um contêiner linux no azure. Segue código:

<plugin>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-webapp-maven-plugin</artifactId>
  <version>1.9.0</version>
</plugin>

Seu arquivo pom.xml ficará da seguinte forma:

Após isso vamos abrir um terminal da sua escolha, aqui utilizo o ConEmu, mas pode ser utilizado os nativos do seu sistema operacional mesmo. Caso queira fazer download do ConEmu, acesse esse link ( https://conemu.github.io/en/Downloads.html ).

Com o terminal aberto, vá até o diretório que está seu app, no meu caso no (C:\desenvolvimento\workspaces\workspace-sts4\HelloWorldSpringBoot2) e utilize o comando abaixo que acionará o plugin do azure para que ele configure sua app.

mvn azure-webapp:config

Será apresentado a seguinte mensagem:

Escolha as opção 1 ou apenas aperte enter. A seguinte opção é sobre a versão do java, no meu caso é o Java 8, então também pressione enter.

Enfim, a última opção é apenas confirmar as propriedades do nosso webapp.

Voltando para o nosso arquivo pom.xml, é possível identificar algumas mudanças realizadas pelo plugin.

Adicione a tag “<appSettings>” apresentada a seguir dentro da tag “<configuration>” do plugin azure-webapp-maven-plugin para escutar a porta 80.


<appSettings>
          <property>
                <name>JAVA_OPTS</name>
                <value>-Dserver.port=80</value>
          </property>
</appSettings>

Seu pom.xml ficará da seguinte forma:

Deploy da aplicação no Microsoft Azure

Após a preparação da aplicação, bora realizar o deploy do app SpringBoot no Azure? Para isso, abra seu terminal e realize login no Microsoft Azure com o seguinte comando: 

az login

Será aberto seu navegador padrão e solicitado login com sua conta do Microsoft Azure conforme imagem abaixo:

Ao efetuar o login com sucesso, é apresentado a seguinte mensagem em seu navegador. Já no terminal é apresentando informações do seu acesso no formato Json.

Após realizar o login, volte ao terminal e utilize o comando abaixo para recompilar o arquivo Jar utilizando o Maven.

mvn clean package

Após o Build ter sido concluído com sucesso, implante seu aplicativo SpringBoot 2 no Azure utilizando o comando maven abaixo:

mvn azure-webapp:deploy

O terminal apresentará a mensagem Build Success, e logo na linha acima podemos notar a frase, “Successfully deployed the artifact to *URL*” . Pode ser que leve alguns minutos para que sua aplicação faça deploy e seja apresentado no portal Azure (https://portal.azure.com/), mas adianto que por aqui foi imediato.

Depois que a aplicação Spring Boot tiver sido implantada, você conseguirá gerenciá-la por meio do portal Azure.

Seu aplicativo Web será listado nos Serviços de Aplicativos conforme imagem abaixo:

A URL para acessar sua aplicação Springboot será apresentada na Visão geral de seu aplicativo Web:

Verifique se a implantação foi bem-sucedida em seu navegador utilizando a URL presente na imagem anterior, acrescentando o path “/hello” ao final. Você verá a seguinte mensagem exibida: 

Bazinga!!! Temos uma aplicação rodando nas nuvens do Microsoft Azure. 

Agora vamos colocar os pés no chão e deletar todos os recursos. De preferencia, caso sua conta como “paga pelo uso” e não queira que sejam gerados custos, mesmo que irrelevantes. No meu caso, devido alguns testes, gerou um custo de apenas 9 centavos como pode ser observado na imagem abaixo:

Desse forma, bora limpar os recursos que não serão mais utilizados.

Limpar os recursos criados

No portal do Microsoft Azure acesse no menu lateral esquerdo ou na tela inicial o “Grupo de recursos”.

Será aberta a seguinte tela, caso necessário utilize o filtro por nome com o prefixo “HelloWorld”.

Selecione o grupo que criamos e pressione “Delete Resource Group”.

Digite o nome do grupo de recursos no campo de texto e pressione Excluir.

Após alguns segundos ou minutos a exclusão total será finalizada.

Como se dizia no jogo Mortal Kombat, Finish Him… rsrssrrs.

Pronto, Grupo de recursos excluindo para sempre.

Epilogo

Subi esse projeto já preparado para o Azure no GitHub no repositório projeto HelloWorldSpringBoot2 mesmo, mas na branch AzureHelloWorld. Acesse aqui.

Quer mais materiais para estudar nessa quarentena?

Caso queira se capacitar de forma gratuita, em alguns posts passados, preparei alguns sites e canais do Youtube que nos ajudam com isso. acesse os links:

*Canais do YouTube para o(a) desenvolvedor(a) Java estudar gratuitamente;

*Sites para o(a) desenvolvedor(a) Java estudar de graça.


Começando com SpringBoot 2

Hoje vamos criar uma aplicação Spring Boot 2 de forma bem didática e detalhada. Vamos expor um endpoint para nos dizer Hello World. É algo super simples e que em poucos minutos estará prontinho. Esse projeto será uma base para futuros projetinhos que temos em mente para o futuro do blog.

Nesse projeto utilizaremos as seguintes ferramentas e tecnologias:

  • IDE Spring tool Suite 4;
  • Spring Boot 2;
  • Spring Framework;
  • Maven;
  • Git;
  • Container Web tomcat.

Caso você seja novo no mundo da programação, vou deixar no final da matéria um pequeno dicionário técnico explicando alguns termos usados aqui. Surgindo alguma dúvida, não exite em me questionar nas redes sociais, caso eu não saiba algo de momento, correrei atrás da informação e aprenderemos juntos.

Não sabe o que é Spring Boot e pra que serve? Acesse esse link, nessa matéria explico o que é, como funciona e como surgiu o Spring Boot.

Criação do projeto

Podemos criar nosso projeto de duas formas, uma delas é utilizando o Spring Initializr. Para isso basta acessar o site https://start.spring.io/ e selecionar as configurações que quer em seu projeto, após clicar em generate e finalizar o download, basta importar o mesmo na IDE. 

Outra forma, que é como faremos nessa matéria, é criar nosso projeto pela IDE Spring Tool Suite, para isso, com a IDE aberta, basta clicar em File -> New -> Spring Starter Project  conforme imagem abaixo:

Preencha os campos abaixo, conforme o exemplo:

Selecione uma versão 2 do SpringBoot que não seja snapshot, inclua as dependências Spring WEB, Spring Boot DevTools e Spring Data JPA e clique em Finish.

Os projetos starters selecionados acima são para os fins descritos logo abaixo:

Spring WEB: É utilizado para criar aplicativos Web, incluindo RESTful, usando o Spring MVC. Usa o Apache Tomcat como o contêiner incorporado padrão

Spring Boot DevTools: Fornece reinicializações rápidas de aplicativos, LiveReload e configurações para melhorar a experiência de desenvolvimento.

Spring Data JPA: É utilizado para persistir dados em repositórios SQL com a API Java Persistence usando Spring Data e Hibernate.

A IDE realizará o build do projeto maven e as atualizações de todas suas dependências. Os pacotes do projeto e a classe que é usada para iniciar o aplicativo Spring ficarão similar a imagem abaixo:

Antes de Codar, precisamos fazer um leve ajuste no arquivo pom.xml. No momento da criação do projeto, declaramos que utilizariamos o Spring Data JPA, que sim, será útil nos projetos vindouros, mas para utilizar o mesmo, precisamos realizar configurações do datasource que não são o foco nesse momento, vamos comentar essa dependência como no exemplo apresentado abaixo e salvar o arquivo com Ctrl + S.

Agora sim, não demorou quase nada e já temos uma aplicação SpringBoot 2 que pode ser executada sem erros. Mas segura a emoção ai, rsrssrrs… por hora ela não faz nenhuma interação conosco. Para isso, vamos criar uma classe com o nome “HelloWorld” dentro do pacote br.com.devjava.helloworld. 

Com o cursor selecionando o pacote br.com.devjava.helloworld, pressionar Ctrl + N. Será aberta uma janela para selecionar o que de novo você quer criar, comece a escrever “C”, “L”, “A”, “S” … automaticamente é eliminado diversas opções, clique em Class e Next como na imagem abaixo:

Verifique se realmente o package está como br.com.devjava.helloworld. Preencha o nome da classe como HelloWorld e Finish.

Uma classe com o nome HelloWorld é criada. Acima do nome da classe utilizaremos as anotações @RestController e @RequestMapping(“/hello”). 

A anotação @RestController configura a classe como um Controller e que os métodos deverão retornar uma resposta HTTP, tornando-o possível trabalhar com serviços REST. Já a anotação @RequestMapping declara que a classe cuidará de solicitações da web e o parâmetro “/hello” define que qualquer ação desse controller deve preceder de /hello. Apenas como exemplo, as solicitações ou verbos do protocolo HTTP podem ser dos tipos GET, POST, PUT, DELETE, entre outros.

Posteriormente crie um método público do tipo String com o nome “sayHello”, esse método deve retornar a String “Hello from SpringBoot by DevJava”. Nesse método utilize a anotação @GetMapping, no caso, ela serve para especificarmos que esse método atenderá apenas o verbo GET do serviço /hello.

Sua Classe RestController deve se parecer com o exemplo abaixo: 

Feito isso, podemos entrar na classe HelloWorldApplication que possui o método main, clique com o botão direito em cima da classe, selecione Run As e depois Spring Boot App.

No console será exibido algo próximo a imagem abaixo:

Bazinga!!! Temos nosso App SpringBoot2 expondo o endpoint http://localhost:8080/hello. Acesse esse endpoint pelo navegador e verá a mensagem que configuramos ser apresentada.

Epilogo

Essa foi a nossa pequena aplicação em Spring Boot 2 apenas expondo um serviço, espero que tenha ficado bem detalhado e explicado, mas surgindo dúvida e ou sugestões, pode me contatar pelo campo de comentário logo abaixo ou trocar uma idéia comigo nas redes sociais.

Antes que eu me esqueça, disponibilizei o código desse projeto no meu GitHub pessoal, acesse: https://github.com/rafaelvcunha/HelloWorldSpringBoot2 

E como prometido, segue pequeno dicionário técnico:

IDE Spring tool Suite 4 é uma IDE desenvolvida em cima do Eclipse com algumas melhorias e plugins já instalados para o ecossistema Spring Framework.

Endpoint é a URL onde seu serviço pode ser acessado por uma aplicação cliente. 

Container Web é servidor web Java que atende aplicações web que utilizem Servlets e JSPs. 

Servidor de Aplicação: Além de possui o container web para atender  Servlets e JSPs, possui outros subsistemas para atender aplicações Java EE com EJBs, CDI, JMS entre outros. 

O que é, como surgiu e como funciona o Spring Boot ?

O Spring Boot facilita a criação de aplicações, onde é possível criar um projeto apenas com os componentes necessários, com pouca ou nenhuma configuração e simplesmente executar. Isso mesmo, “just run”.

Mas antes de abordarmos esse framework maravilhoso, vamos falar do Spring Framework para entendermos o por que efetivamente foi criado o Spring Boot.

O que é o Spring Framework?

O Spring é um framework java open source criado pela Pivotal para facilitar o desenvolvimento de aplicações corporativas, baseado nos padrões de projeto de inversão de controle e injeção de dependência.

O Spring framework foi criado devido os problemas que os desenvolvedores java enfrentavam ao criar uma aplicação corporativa J2EE. Um dos problemas era a necessidade de utilizar um servidor de aplicação robusto, entre muitos outros fatores.

Mesmo com todas as facilidades que o Spring Framework trouxe, surgiram novos problemas. A configuração era via xml, dessa forma se algo estivesse incorreto, era uma dor de cabeça para descobrir o que deveria ser corrigido.

Posteriormente as configurações foram aceitas de forma programática, algo que ajudou demais, pois em tempo de compilação é reportado o que esta incorreto.

De qualquer modo, ainda era necessário configurar o arquivo de dependências pom.xml, o arquivo de configurações para banco de dados, o arquivo web.xml e por fim o container web.

Então nasce o Spring Boot!

Em abril de 2014, após 18 meses de desenvolvimento, testes e amadurecimento, a Pivotal entrega o Spring Boot 1.0. Hoje, a ultima versão estável em produção é a 2.2.4 e necessita no minimo do Java 8.

O seu objetivo é claro: Facilitar o trabalho de configuração e proporcionar ao desenvolvedor que sua aplicação seja publicada o mais rápido possível.

O spring boot foi baseado no conceito convenção sobre configuração, portanto é necessário apenas selecionar quais módulos serão utilizados no projeto. Exemplo de módulos são: WEB, DevTools, Spring Batch, Spring Data JPA, entre muitos outros.

O spring boot faz toda a magia, deixando tudo configurado, com um servidor tomcat embarcado. Em contra partida, há a possibilidade de customizar o que for necessário posteriormente.

Como funciona o Spring Boot por baixo dos panos?

O Spring boot consegue fazer tudo isso, devido seus três pilares, são eles o Spring Boot Starter, Spring Boot AutoConfigurator e Spring Boot Actuator.

Spring Boot Starter

O Spring Boot Starter tem o objetivo de associar diversas dependências em apenas uma, a fim de deixar o arquivo pom.xml mais organizado. Um exemplo é o spring-boot-starter-web, dentro dessa dependência há as dependências spring-boot-starter, spring-boot-starter-tomcat, hibernate-validator, jackson-databind, spring-web e spring-webmvc. Podem ou não haver diversas outras dependências dentro das apresentadas anteriormente.

Agora pense em configurar tudo isso na unha, incluindo dependência por dependência no pom.xml, fora que ficaria extremamente verboso seu arquivo, não é?

Spring Boot AutoConfigurator

O Spring Boot AutoConfigurator é o responsável por realizar as configurações da aplicação, incluindo as anotações necessárias para que a aplicação execute corretamente. Um exemplo é a anotação @SpringBootApplication presente na classe de inicialização do projeto.

Spring Boot Actuator

O Spring Boot Actuator fornece recursos de monitoramento, auditoria, healthcheck, provisionamento de endpoints, entre outros afazeres.

Um exemplo prático é o momento que o AutoConfigurator expõe o servidor web no localhost porta 8080. O Spring Boot Actuator que provisiona esta configuração no servidor web.

Criando um projeto Spring Boot

A Pivotal disponibiliza, duas formas rápidas e práticas para criar seu projeto Spring Boot. Pode ser realizado pelo Spring Initializr ou por meio da IDE Spring Tool Suite, desenvolvida em cima do Eclipse.

Spring Initializr

Basta acessar https://start.spring.io/ e selecionar as configurações que quer no seu projeto. O maior ponto de atenção vai para o campo “dependencies”, onde é possível selecionar os módulos starters que farão parte do projeto.

Após selecionar tudo, basta clicar no botão “Generate” que fica na parte inferior da pagina e importar o projeto na sua IDE de confiança… rsrssrsrs.

IDE Spring Tool Suite

Após iniciar a IDE, clique em File -> New -> Spring Starter Project, preencha os campos necessários e após o next, é possível selecionar os módulos starters. Depois disso é Finish and enjoy!!!

O poder do Spring Boot DevTools

O Spring Boot DevTools é um dos projetos starter que mais traz produtividade para o desenvolvedor. Caso seja feita qualquer alteração em suas classes e o container esteja em modo debug, a mesma é aplicada sem a necessidade de reiniciar o container manualmente.

Outra função do DevTools, é realizar configurações especificas para o ambiente de desenvolvimento, por exemplo não deixar que o cache lhe atrapalhe durante seus desenvolvimentos ou testes.

Epilogo

Bom, esse artigo ficou meio grandinho, mas acredito que é o necessário para entender sobre o Spring Boot e de quebra, conhecer também o Spring Framework. Agora é possível trocar umas figurinhas com o(a) coleguinha desenvolvedor(a) que senta ao lado no trabalho ou mesmo na faculdade.

Está afim de estudar linguagens e tecnologias presentes no ecossistema do desenvolvedor java gratuitamente? Se sim, acesse o link do post a seguir, lá apresento 5 sites fantásticos que nos proporcionam isso. Segue o link: https://www.devjava.com.br/sites-para-o-desenvolvedor-java-estudar-de-graca/

Muito obrigado por estar aqui, siga e curta nossas redes sociais e espalhe essa mensagem.