DEV Community: Angelo Brandão

Criando seu primeiro projeto Spring Boot 3.

Angelo Brandão — Sat, 25 Jun 2022 19:01:47 +0000

Está mais perto do que nunca do lançamento da versão 3 do framework de desenvolvimento Spring Boot. Sendo assim, decidir escrever esse artigo técnico com o objetivo de demonstrar a criação de um projeto simples utilizando o spring boot.

A versão 3 do Spring Boot está sendo esperada ansiosamente por muitos desenvolvedores, primeiro por que é o framework mais utilizado na industria de desenvolvimento de software, segundo por que é a versão que dará suporte a versão 17 do Java.

Para você conseguir finalizar a leitura desse artigo espera-se que você possua o comhecimento básico da linguagem de programação Java do sistema de controle de versões distribuído Git, do Github e do Maven. No final o projeto será versionado no GitHub.

Java: É uma linguagem de programação e plataforma de computação;
Git: É um sistema de controle de versão distribuído gratuito e de código aberto projetado para lidar com tudo, desde projetos pequenos a muito grandes, com velocidade e eficiência;
Github: É uma plataforma de hospedagem de código-fonte e arquivos com controle de versão usando o Git;
Maven: É uma ferramenta de gerenciamento e compreensão de projetos de software.

Criando o projeto no Github

Acesse seu Github e escolha no item com a imagem "+" ao lado da sua foto do perfil a opção "New Repository". Preencha os campos conforme a seguinte imagem:

Quando pequeno eu era facinado por insetos, então decide fazer uma API para eu catalogar os insetos existentes.

Depois de criar o projeto você irá fazer o clone dele para seu computador através do seguinte comando:

git@github.com:[seu-usuario-de-login]/insect-service.git

Você pode encontrar esse comando no seu projeto conforme demonstrado na imagem:

Criando o projeto Spring Boot

O Spring possui uma ferramenta online chamada Spring Initializr que facilita muito a vida do programado ao criar um novo projeto. A imagem abaixo demostra a ferramenta.

Segue explicação para cada campo na imagem:

Project: Nesse campo você precisa escolher qual ferramenta de gerenciamento e compressão você vai utilizar. Para esse projeto de exemplo irei utilizar o Maven. Haaa, lembrando quê, o Meven também é um gerenciado de dependências do Java assim como o Gradle;
Language: Selecione a linguagem de programação que você ira utilizar para implementar o projeto. No nosso casa iremos utilizar o Java;
Spring Boot: Selecione a versão do Spring Boot que será utilizado para criar o projeto. O Spring Boot é um framework que torna fácil a criação de aplicações Spring autossuficientes e robustas, possibilitando a sua execução imediata. Para o nosso exemplo iremos utilizar a versão 3.0.0 (SNAPSHOT);
Project Metadata: São as informações do projeto. Nesse campo você irá informar o Grupo, Artefato, Nome, Descricão, Nome do pacote, tipo de empacotamento e a versão do Java;
Dependencies: Selecione as dependências para o projeto. Como esse é um projeto exemplo muito simples iremos selecionar apenas três dependências, são elas: Spring Boot DevTools, Spring Boot Actuator e Spring Web.

Depois que você preencher os dados do seu projeto, conforme imagem abaixo, selecione a opcão GENERATE para criar o projeto. No final será feito o download do projeto como um arquivo compactado para a sua pasta de downloads na sua máquina.

Descompacte o arquivo dentro da pasta do projeto do github que você fez clone anteriormente. O projeto deverá ter a seguinte estrutura de arquivos:

Criando o primeiro Endpoint

Crie uma classe RestController com um método responsável por responder uma requisição GET, como no exemplo abaixo.

package com.bmstech.insectservice;

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import static org.springframework.http.HttpStatus.*;

@RestController
@RequestMapping("/insects")
public class InsectController {

    @GetMapping
    public ResponseEntity<String> get(){
        return new ResponseEntity<>("OK", OK);
    }
}

A classe acima utiliza a anotação @RestController para informar o Spring Boot que ela é um controller rest e também qual o endereço do endpoint para acessar os recursos.

Esta classe possui um método com a anotação @GetMapping que diz qual método deve ser chamado quando o controller receber uma requisição do tipo HTTP GET em seu endereço padrão /insects. O método retorna uma resposta HTTP com Status 200 (OK) e o corpo da resposta com o valor "OK".

Executando o projeto

Execute o comando mvn clean install para baixar as dependências do projeto através do maven. Depois execute o comando mvn spring-boot:run para executar a sua aplicação. A mensagem que aparece no final "Tomcat started on port(s): 8080 (http)" significa que a sua aplicação web já está rodando na porta 8080, como observado na imagem abaixo.

Pronto, com o projeto em execução vamos verificar se o mesmo esta funcionando como esperamos. Abra o browser de sua preferência e e acesse a URL http://localhost:8080/insects/. A imagem abaixo demonstra o resultado após acessar a URL.

Pronto, com tudo funcionando ainda falta fazer o commit das nossas alteraćoes e enviar para o nosso repositório remoto do github. Para isso vamos executar os seguintes comando estando dentro da pasta do projeto:

git add .: Esse comando adiciona os arquivos para o stage;
git commit -am 'Commit initial'; Faz o commit das suas alterações no seu repositório local;
git push -u origin main: Esse comando empurra suas alterações do repositorio local para seu repositório remoto main no github

Refeências

Spring Boot - https://spring.io/projects/spring-boot
Spring Initializr - https://start.spring.io/

E então, chegamos ao fim de mais um artigo técnico. Espero muito que vocês tenham gostado e aprendido um pouco mais sobre o Spring Boot. Sabemos que existem muitos outros artigos parecido com esse, mas tenho criado como uma forma de ajudar o próximo, e ter um registro onde eu possa encontrar com facilidade as informações necessárias para meu dia-a-dia de trabalho.

Esse projeto está disponivel em https://github.com/angelobms/insect-service e será utilizado para outros artigos técnicos que irei escrever sobre Spring.

Instalando o Docker Desktop no Ubuntu.

Angelo Brandão — Sat, 11 Jun 2022 16:06:58 +0000

Recentemente a Docker laçou uma versão do Docker Desktop para os sistema operacional Linux, anteriormente só era possível utilizar essa ferramenta nos sistema operacional MAC e Windows. O Docker Desktop é uma ferramenta que permite de forma mais rápida e através de uma interface gráfica conteinerizar aplicativos.

O melhor de tudo é que você pode utilizar essa ferramenta totalmete de graça, mas não se engane, de graça apenas seguindo os novos itens adicionados no Docker Subscription Service Agreement:

Se você for uma pequena empresa (menos de 250 funcionários e menos de US$ 10 milhões em receita anual), educação, projetos de código aberto não comerciais e uso pessoal.
Para uso profissional em empressas grandes, requer uma assinatura paga mensalmente no valor de US $5;

Apesar do Docker Desktop suportar outras distribuições Linux, tais como, Debian e Fedora, ambas da plataforma x86_64/amd64, o objetivo desse artigo técnico é explicar como realizar a instalação numa distribuição Ubuntu da mesma plataforma. Caso você não se interesse em utilizar uma interface gráfica, você pode fazer a instação via linha de comando em um terminal do Ubuntu conforme explicado nesse artigo: Instalando o Docker Engine CE no Ubuntu.

Para a instalação no Ubuntu você precisa realizar o download do pacote .deb ou .rpm. Nós iremos fazer a instalação utilizado um pacote .deb que pode ser obtido em DEB.

Requisitos de sistema

Para uma instalação com sucesso do Docker Desktop, seu host Linux, no caso o Ubuntu, deve atender a seguinte lista de requisitos:

Kernel de 64 bits e suporte de CPU para virtualização;
Suporte à virtualização KVM;
systemd init system;
Ambiente Desktop Gnome ou KDE;
Pelo menos 4 GB de RAM.

Importante
O Docker não oferece suporte para executar o Docker Desktop em cenários de virtualização aninhada, por exemplo utilizando uma ferramenta de virtualização como o VirtualBox, VMware, Xen, QEMU dentre outras. É recomendado que você execute o Docker Desktop para Linux nativamente em distribuições com suporte.

Suporte à virtualização KVM

O Docker Desktop exevuta uma VM (Máquina Virtual) que requer suporte KVM. KVM (para máquina virtual baseada em kernel) é uma solução de virtualização completa para Linux em hardware x86 contendo extensões de virtualização (Intel VT ou AMD-V). O módulo kvm deveria carregar automaticamente se o host (sua máquina) possui suporte à virtualização. Mas se para o seu caso esse módulo não foi carregado, você vai precisar carregá-lo manualmente executando o seguinte comando, no terminal do seu ubuntu:



modprobe kvm

Dependendo do processador da máquina host, o módulo correspondente deve ser carregado executando um dos comando abaixo:



modprobe kvm_intel  # Processadores Intel

modprobe kvm_amd    # Processadores AMD

Para verificar se o módulo para o processado do host foi carregado e está habilitado, você pode executar o seguinte comando e verificar o resultado, conforme imagem abaixo:

Como no meu caso a minha maquina host possui um processador Intel, podemos observar no resultado que foi carregado o módulo kvm_intel.

Após o módulo kvm ser carrgado precisamos seguir para o próximo passo que é configurar as permissões de usuário do dispositivo KVM. Para isso primeiro devemos verificar o propriétario de /dev/kvm, execute:



ls -al /dev/kvm

Podemos verificar na imagem que o usuário proprietário é o usuário root, mas é necessário adicionar o seu usuário ao grupo kvm para acessar o dispositivo kvm.

Execute o seguinte comando para adicionar seu usuário ao grupo kvm:



sudo usermod -aG kvm $USER

Instalação do Docker Desktop

Importante
Para a instalação é necessário que seja uma versão de 64 bits do Ubuntu Jammy Jellyfish 22.04 (LTS) ou do Ubuntu Impish Indri 21.10. Também é necessário que o Docker Engine CE esteja instalado no Ubuntu. No artigo Instalando o Docker Engine CE no Ubuntu eu explico como realizar a instalação.

Abaixo listo os passos que você deve seguir:

Desinstale a versão tech preview ou a versão beta do Docker Desktop para Linux:



sudo apt remove docker-desktop

Caso você queira realizar uma limpeza completa, exclua os arquivos de configuração e dados da pasta $HOME/.docker/desktop, o link simbólico em /usr/local/bin/com.docker.cli e os arquivos de serviço systemd restantes através dos seguintes comandos:



rm -r $HOME/.docker/desktop && \
sudo rm /usr/local/bin/com.docker.cli && \
sudo apt purge docker-desktop

Nota
Se você instalou o Docker Desktop para Linux tech preview ou versão beta, você precisa remover todos os arquivos que foram gerados por esses pacotes (por exemplo, ~/.config/systemd/user/docker-desktop.service, ~/.local/ share/systemd/user/docker-desktop.service)

Adicionalmente, para ambientes não Gnome Desktop, o gnome-terminal deve ser instalado:



sudo apt install gnome-terminal

Instale o pacote .deb que você fez download no inicio da leitura desse artigo, com o comando apt da seguinte forma:



sudo apt-get update && \
sudo apt-get install ./docker-desktop-<version>-<arch>.deb

Nota
No final do processo de instalação, o apt exibe um erro devido à instalação de um pacote baixado. Você pode ignorar esta mensagem de erro.

N: Download is performed unsandboxed as root, as file '/home/user/Downloads/docker-desktop.deb' couldn't be accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)

Existem algumas etapas de configuração pós-instalação feitas através do script pós-instalação contido no pacote deb, são elas:

Definir a capacidade no binário do Docker Desktop para mapear portas privilegiadas e definir limites de recursos;
Criar um link de /usr/bin/docker para /usr/local/bin/com.docker.cli;
Adicionar um DNS (Sistema de Nomes de Domínio) para o Kubernetes em /etc/hosts (Explicarei em um artigo posterior a esse o que é Kubernetes).

Pronto, o Docker Desktop está instalado, vamos agora iniciar ele pela primeira. :-D

Iniciando o Docker Desktop

Siga o seguintes passos para o sucesso e torça para que no final tudo ocorreu bem e você seja muito feliz com sua primeira instalcão do Docker Desktop:

Abra o menu Applications (Aplicativos) no Gnome/KDE Desktop e procure pelo Docker Desktop.
Selecione Docker Desktop para iniciar o Docker. Será exibido o Docker Subscription Service Agreement.
Marque a caixa de seleção para aceitar os termos atualizados e clique em Accept (Aceito) para continuar.
Importante
Se você não concordar com os termos, o aplicativo Docker Desktop será fechado e você não poderá mais executar o Docker Desktop em sua máquina. Você pode optar por aceitar os termos posteriormente abrindo o Docker Desktop.

Se ocorreu tudo bem depois de você aceitar os termos, o Docker Desktop vai iniciar um Quick Start Guide (guia de ínicio rápido). Este guia é um tutorial para criar uma imagem de exemplo do Docker, executá-la como um contêiner, enviar e salvar no Docker Hub. O Docker Hub é uma biblioteca para imagens de contêiner.

Caso queira permitir que o Docker Desktop seja iniciado no login, no menu Docker, selecione Settings (Configurações) > General (Geral) > Start Docker Desktop when you log in (Inicio o Docker Desktop quando você logar).

E então chegamos ao fim, ufa! Espero que você tenha gostado e estarei a disposição para tirar as dúvidas que aparecer, só deixar um comentário.

Bons momentos :-)

Instalando o Docker Engine CE no Ubuntu.

Angelo Brandão — Sat, 11 Jun 2022 03:10:41 +0000

A finalidade desse tutorial é explicar como instalar o Docker CE em uma distribuição Linux Ubuntu para as versões LTS 22.04, 20.04 e 18.04. O Docker é uma plataforma aberta com um mecanismo de execução de container que permite empacotar seus aplicativos com todas as suas dependências em uma unidade padronizada para desenvolvimento, distribuição e execução de softwares. Atualmente já existe uma versão do Docker Desktop para distribuições linux, mas vamos fazer a instalação através de linha de comando no terminal do Ubuntu e em outro tutorial eu explico como instalar e configurar o DocKer Desktop no Ubuntu.

Primeiramente você vai precisar fazer a atualização do sistema através do seguinte comando:

sudo apt update -y

Antes de seguimos para a instação do Docker CE, exitem algumas dependências que precisam ser instaladas para configurar os repositórios do Docker e para permitir a instalação real do pacote de instalação do docker. Para instalar essas dependências execute o comando abaixo:

sudo apt install ca-certificates curl gnupg lsb-release -y

Outra ação importante é verificar se existe uma versão mais antiga do docker instalada no seu sistema operacional. Caso exista, será necessário removê-la executando o seguinte comando:

sudo apt remove docker docker-engine docker.io containerd runc

Pronto, se foi removido ou não uma versão antiga do docker precisamos importar uma chave GPG oficial do repositório Docker. GPG (Gnu Privacy Guard) é uma implementação do OpenPGP (Open Pretty Good Privacy) que é uma técnica de criptografia utilizada como assinatura de código para repositórios de código Linux e repositórios de código-fonte como o GitHub e o GitLab. Para obter a chave GPG é necessário executar o seguinte comando:

sudo mkdir -p /etc/apt/keyrings && curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Agora você já pode configurar o repositório do Docker no seu sistema através do comando abaixo:

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

E finalmente instalar o Docker Enginer CE, só que não (rs), primeiro é necessário atualizar o indice do pacote apt e então depois fazer a instalação da última versão disponível do Docker Engine, containerd e Docker Compose executando o seguinte comando no seu terminal:

sudo apt update && \
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin

containerd é um daemon para Linux e Windows que tem como principal funcionalidade fazer o gerenciamento completo do ciclo de vida do contêiner de seu sistema host, desde a transferência e armazenamento de imagens até a execução e supervisão do contêiner, até o armazenamento de baixo nível, os anexos de rede e muito mais.

Docker Compose é uma ferramenta para definir e executar aplicativos Docker de vários contêineres. Irei explicar isso com mais detalhes e com exemplos em outro artigo.

E agora para fechar com chave de ouro, vamos verificar se o Docker Engine foi instalado corretamente ¨rodando¨ a imagem hello-word. O comando abaixo vai fazer download da imagem de teste e executar ela em um contêiner. Quando o contêiner for executado será exebido uma menssage e depois ele será finalizado.

sudo docker run hello-world

Aqui está o resultado final da execução do contêiner:

Referências:

Docker
containerd
GOMES, Rafael. docker para Desenvolvedores. Salvador: 9 Bravos, 2007

Fim! :-)