sábado, 25 de maio de 2024

Microsserviços - Montando uma laboratório - Parte II - Login e banco de dados Login - Clientes


Olá pessoal, tudo bem? Espero que sim.

Vamos dar sequência no nosso laboratório para estudo com microsserviços, containers, docker... etc.

Agora que já temos o "server" com o Docker pronto, vamos iniciar a subida dos containers e baixar os códigos para começarmos a dar forma para o nosso ambiente.

Só relembrando, toda estrutura do nosso ambiente, o que iremos utilizar e a preparação do laboratório, está neste primeiro POST.

Agora, vamos começar a criação dos containers e subida das aplicações.

Clientes - Aplicação Login e Banco de Dados Login

Vamos acessar por SSH o Server Docker - 192.168.0.32

$ ssh docker@192.168.0.32
$ sudo su -


Como podemos ver, ainda não temos nenhum container rodando. 

Banco de Dados Login Clientes:
Nome do Container: db_login_clientes
Imagem: mysql:5.7

$ docker run -p 3306:3306 -e MYSQL_ROOT_PASSWORD=abc123 -d mysql:5.7
Com este comando, iremos baixar a imagem do mysql:5.7, expor ele na porta 3306 para o nosso host hospedeiro, e senha para conectarmos no banco de dados.
O tempo aqui pode demorar um pouco, devido ao tempo de download da imagem.


Agora, se executarmos novamente o comando docker ps iremos ver já nosso primeiro container executando.


Agora, para deixar tudo mais organizado e saber do que se trata cada container que estamos subindo, iremos renomea-lo:
# docker rename pensive_dubinsky db_login_clientes

Olha que legal! 
Na coluna NAMES, temos o nome que representa a função desse nosso container.

Agora vamos criar o banco de dados e a tabela que iremos utilizar.

Para isso, podemos conectar por linha de comando ou utilizar o MySQL Workbench que é um gerenciador de MySQL por interface.

No exemplo vamos seguir por linha de comando, OK?

Conectando no MySQL

Podemos utilizar o próprio host Docker Server para isso, mas antes vamos instalar o mysql-cli:
# apt-get install mysql-cli
# mysql -u root -p -h 192.168.0.32 -P 3306

Dando tudo certo, teremos um prompt semelhante a este:


Agora, criaremos o banco de dados e a tabela.

mysql> create database login;
mysql> use login;
mysql> create database login;
mysql> CREATE TABLE `login`.`usuario` (   `usuario_id` INT NOT NULL AUTO_INCREMENT, `nome` VARCHAR(200) NOT NULL,   `usuario` VARCHAR(200) NOT NULL,   `senha` VARCHAR(32) NOT NULL, `data_cadastro` DATETIME NOT NULL,PRIMARY KEY (`usuario_id`));

Perfeito. 
Agora temos a estrutura do banco de dados pronta para receber a conexão da aplicação de login e cadastro de login dos clientes.

Para sair do Shell do MySQL, basta digitar exit:

mysql> exit;

Agora, vamos subir um novo container e uma nova imagem onde será hospedada a aplicação que ira utilizar esse banco de dados.

Aplicação Login Clientes:
Nome do Container: app_login_clientes
Imagem: webdevops/php-nginx

# docker run -p 80:80 -d webdevops/php-nginx

O comando é semelhante ao que usamos para criar o container de banco de dados. Iremos export a porta 80 no nosso host hospedeiro para facilitar nosso acesso e mudamos também a imagem para baixar uma imagem contendo já o PHP e o Nginx instalado.


Aqui vamos novamente renomear o container para deixá-lo com um nome mais amigável e fácil de identificar a função dele no ambiente.

# docker rename laughing_kilby app_login_clientes

Agora vamos fazer um teste de acesso do nosso navegador mesmo, para ver se estamos conseguindo conectar no Nginx:


Conseguimos!!!
Mas veja que como não temos nada configurado ainda, ele da esse status Code 403 - onde ele aceitou nossa solicitação mas não tinha nada para responder.

Já vamos arrumar isso.

Vamos conectar por linha de comando no container. 
Para isso, executaremos o seguinte comando:

# docker exec -it app_login_clientes bash

Conforme podemos ver na imagem abaixo, estamos agora no Shell (linha de comando) do nosso container.



Vamos aos ajustes que precisaremos fazer.
Não vou entrar no detalhe de cada um, OK? Pois não é o foco desse conteúdo.

Os arquivos de configuração do Nginx ficam por default no path /etc/nginx/

# cd /etc/nginx/
# vi nginx.conf
A hora que o arquivo abrir, iremos procurar a linha "include /etc/nginx/conf.d/*.conf;", e vamos deletá-la.
Com o "vi", basta ir até ela com a seta do teclado e apertar duas vezes a tecla "d" do teclado. Assim que a linha sumir, vamos salvar e sair do arquivo com o comando :wq!

Agora, vamos criar a estrutura default onde será informado o path onde serão hospedados os arquivos da aplicação, as configurações de porta default que ela irá utilizar e as configurações do PHP.

Para criarmos o arquivo, vamos usar o seguinte comando:

# vi /etc/nginx/sites-enabled/default

Copie e cole o seguinte conteúdo:

server {
        listen 80;                                                                                    

        root /var/www/html;                                                                                          
                                                                                                                         
        # Add index.php to the list if you are using PHP                                                             
        index index.php index.html index.htm index.nginx-debian.html;                                                          
                                                                                                                         
        server_name _;                                                                                               
                                                                                                                         
        location / {                                                                                                 
                try_files $uri $uri/ /controllers$uri.php;
    location ~ \.php$ {
      try_files $uri /index.php;
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        include fastcgi.conf; 
      }
   }
        }

Mesma coisa, para salvar o arquivo depois de colar o conteúdo, aperte a tecla "ESC" e digite :wq!

Vamos reiniciar o serviço do Nginx:

# service nginx restart
E vamos tentar acessar novamente o endereço http://192.168.0.32.

No caso de sucesso, temos uma página default que está hospedada no path /var/www/html:



** OBS **
Caso queira fazer um teste, como ainda estamos no Shell do container em questão (app_login_clientes), vamos até o path /var/www/html:

# cd /var/www/html/

Nele existe um arquivo chamado index.nginx-debian.html. Vamos editar ele com o "vi":
# vi index.nginx-debian.html

Localize a linha que contém: "<h1>Welcome to nginx!</h1>". Navegue até ela com as setas do teclado.
Vamos com o cursor até depois do ponto de exclamação. 
Para entrar no modo insert do "vi", aperte a tecla i do teclado.
E vamos digitar: APP Login Clientes

Depois de digitar, vamos apertar a tecla "ESC" e digitar :wq!

Voltemos no navegador onde acessamos o endereço http://192.168.0.32 e vamos dar um reload:


Olha que legal!
Apareceu agora com o texto que inserimos no arquivo default do site.

Web server validado e pronto para receber nossa aplicação =]

Como o intuito aqui não é te fazer programar, eu vou deixar todo código utilizado e necessário aqui nesse repositório do GitHub - https://github.com/jguandalini/lab-microservices

Procure pela aplicação Login_Clientes


Clique na pasta para ter acesso ao conteúdo dela. 
Será um arquivo compactado com o nome "app_login.tar.gz".
Vamos clicar nele e na tela seguinte, vamos clicar nos três pontinhos no lado direito e na opção Download:



Isso irá baixar o arquivo para nossa máquina.

Assim que finalizar, precisaremos copiar ele para dentro do docker server e posterior para o container.
# scp app_login.tar.gz docker@192.168.0.32:/home/docker

Agora que o arquivo está dentro do servidor docker, vamos copiar para dentro do container:

# docker cp /home/docker/app_login.tar.gz app_login_clientes:/var/www

Dando tudo certo, o resultado será esse:


Agora, vamos voltar para a linha de comando do container app_login_clientes

# docker exec -it app_login_clientres bash

Vamos até o diretório onde salvamos o arquivo compactado da aplicação:

# cd /var/www/

Se executamos o comando de listagem do linux, vamos ver o nosso arquivo copiado no passado anterior:

# ls -la


Agora vamos descompactar tudo aqui. Para isso, vamos executar o comando:

# tar xzvf app_login.tar.gz

** OBS **
Como já tínhamos uma pasta html aqui, ao descompactarmos o arquivo copiado, ela será sobrescrita, ok?

Entrando na pasta html, iremos ver todos esses arquivos:

# cd html/
# ls -la

Vamos voltar para o navegador onde acessamos o endereço http://192.168.0.32 e vamos dar um reload:



Podemos ver que agora, já temos a tela do Sistema de Login. Mas como não temos login cadastrado, não vai funcionar.

Para cadastrar, precisamos fazer dois passos:
1 - Alterar a string de conexão com nosso banco de dados (que foi o primeiro passo desse procedimento)
2 - Acessar o endereço http://192.168.0.32/cadastro.php

Vamos pro passo 1:
Vamos pegar o endereço IP do container com o banco de dados db_login_clientes. Para isso, no docker server vamos executar o comando:

# docker inspect db_login_clientes
Iremos procurar a linha "IPAddress":


Agora que já sabemos que o IP do container do banco de dados é 172.17.0.2, vamos voltar no Shell do container da aplicação e alterar o arquivo conexao.php informando este IP e a senha que fornecemos durante a criação do banco de dados.

No meu caso, ficou dessa forma:



Agora sim, vamos voltar a acessar o endereço http://192.168.0.32/cadastro.php


Vamos cadastrar nosso usuário cliente para acesso ao sistema.

Exemplo:
Nome: joao
Usuário: joao
Senha: 123mudar


Se der certo o cadastro, ele vai aparecer essa mensagem no quadro verde já com link para voltar a tela de login.

Testando o Login, vamos ter acesso a seguinte página:


A ideia é que futuramente, aqui apareça também a listagem do prestadores e empresas cadastradas na plataforma.

Com isso finalizamos a parte II - Aplicação de Login e banco de dados Login de clientes.

No próximo post, vamos dar sequência na criação de outro microsserviço e assim não vamos deixar muito conteúdo de uma única vez.

Abs
:wq!

terça-feira, 14 de maio de 2024

Microsserviços - Montando um laboratório - Parte I - Preparando o ambiente


Olá pessoal, tudo bem?

No último post eu falei um pouco sobre microsserviços, como é a ideia da estrutura por trás do uso deles e com alguns exemplos de arquitetura.

Bem, agora eu vou mostrar como eu montei um lab para estudar um pouco mais a ideia, mas deixando bem claro que não sou desenvolvedor então, eu usei alguns códigos prontos numa estrutura web mesmo com PHP, HTML e banco de dados MySql.
Existe toda uma estrutura para se estudar sobre como criar microsserviços, tecnologias que podem ser utilizadas para atender melhor esse propósito, ok?

A ideia mesmo foi mostrar de forma "simples" um jeito de você pensar em microsserviços e ver como eles podem funcionar juntos e ao mesmo quando um parar vc não compromete o sistema toda, uma vez que existe um ponto de junção para usar todos eles, podemos ter alguns com falha que parte do serviço continua. E isso é o legal.

Para o Lab, vamos usar:
  • VirtualBox
  • VM com Ubuntu Server
  • Docker
  • Images mysql:5.7 e webdevops/php-nginx
Aqui está o desenho de arquitetura proposto de como irá funcionar a solução:

Resumo/objetivo:
  • Teremos um sistema onde prestadores de diversos tipos de serviços que desejam se cadastrar, terão que informar seus dados de contato e também seu preço por hora para que clientes que precisem, tenham em mão uma lista disponível.
  • Da mesma forma que teremos prestadores autônomos, teremos também empresas de pequeno porte que podem oferecer seus serviços, basta informar também os dados e o tipo de serviço prestado com o valor por hora de trabalho.
  • Existe uma equipe que recebe os dados dos prestadores "autônomos" e cadastra no respectivo sistema e uma equipe que recebe os dados das empresas prestadores para cadastrar no respectivo sistema.
  • Então temos um sistema de prestadores autônomos e um sistema empresas prestadoras, todos devidamente autenticados com seus sistemas de login.
  • O cliente que desejar consultar os serviços precisará fazer login também, caso não tenha, será solicitado um cadastro, para ter acesso a ambos os registos (autônomos e empresarial).

Desenho da arquitetura:





Explicando um pouco o desenho:
  1. Microsserviço de login/cadastro para Clientes;
  2. Banco de Dados login Clientes;
  3. Microsserviço de listagem de unificado de Prestadores e Empresas para os clientes;
  4. Microsserviço de listagem de Prestadores;
  5. Microsserviço de listagem de Empresas;
  6. Microsserviço de login/cadastro equipe que cuida dos Prestadores Autônomos;
  7. Banco de Dados login equipe que cuida dos Prestadores Autônomos;
  8. Microsserviço cadastro Prestadores;
  9. Banco de Dados cadastro Prestadores;
  10. Microsserviço de login/cadastro equipe que cuida das Empresas;
  11. Banco de Dados login equipe que cuida das Empresas;
  12. Microsserviço cadastro Empresas;
  13. Banco de Dados cadastro Empresas;
Obs.: Na VM com Ubuntu Server, iremos utilizar um IP da nossa rede mesmo. No meu caso, eu peguei um IP DHCP na rede 192.168.0.0/24.

A rede de comunicação entre os containers, é a padrão da instalação do Docker, então todos eles ficaram na rede 172.17.0.0/16.

Para que eu possa acessar externamente os microsserviços e banco de dados eu faço redirecionamento de portas.
Essa parte de rede é um bem mais complicada, então eu mantive tudo dessa forma.

Criação da VM com Ubuntu Server versão 22.04 

Clicar em Novo:


Na primeira tela, iremos informar o nome da VM que no nosso exemplo será Docker-Server, do Tipo Linux e Versão Ubuntu (64-bit):



Depois de clicar em Próximo, vamos inserir Memória Base com 2GB (2048 MB) e Processadores em 2 (CPUs):


Em disco Rígido, vou manter o padrão de 25GB já sugerido para este tipo de VM. Mas como os containers do exemplo utilizam pouco espaço, se você tiver menos, pode colocar menos aqui:


Ao final, temos um resumo do que será criado:


Clicar em Finalizar e esperar que a VM seja criada.

Depois disso, precisamos alterar a placa de rede que por padrão do VirtualBox é NAT para Bridge e assim será possível a entrega de IP DHCP para a VM.

Selecione a VM, Configurações - Rede - Escolher o Adaptador 1, trocar de NAT para Placa em modo Bridge no campo "Conectado a:" e no campo Nome selecionar a interface do seu host hospedeiro que recebe IP DHCP.
No meu caso é essa interface Wifi wlp3s0



Pronto.
O passo de criação da máquina virtual finalizou e agora vamos para o passo de instalação do Sistema Operacional.

Instalação do Ubuntu Server

Eu já tenho o download da ISO com a imagem do Ubuntu Server 22.04. Caso não o tenha, pode baixar direto no site da Canonical - https://ubuntu.com/download/server

Vamos iniciar a VM criada no passo anterior. Selecionar a VM e clicar em Iniciar:


Irá abrir uma nova janela pedindo para selecionar o arquivo .ISO que iremos utilizar na instalação:



Assim que selecionar o .ISO, clicar em Montar e Tentar Novo Boot.

A seguir estão os prints com a instalação do Ubuntu. Eu vou colocar apenas a sequência dos prints pois não teve nenhuma alteração em relação a instalação padrão. Apenas na parte do SSH. Como nós vamos usar para acessar a VM de forma remota, eu já pedi durante a instalação para que isso seja feito.
Usuário e senha também fica ao seu critério, mas se quiser seguir o exemplo:

Usuário: docker
Nome do Servidor: docker-server


















Dando tudo certo com a instação do Ubuntu Server, habilitará uma opção de Reboot Now. Após esse reboot estaremos prontos para acessar e ir para o próximo passo.

** Importante **

Durante a instalação, será informado o IP que a VM recebeu do DHCP. No exemplo, o IP atribuído foi: 192.168.0.32

Agora vamos acessar a VM de forma remota e seguir para o próximo passo.

Acesso por SSH

Da sua estação de trabalho (pode ser a mesma onde você instalou o VirtualBox), vamos acessar por SSH a VM criada (Docker-server):
$ ssh docker@192.168.0.32


** Caso seu acesso seja através de um equipamento com Windows, utilize um Putty ou algum outro cliente SSH **

Instalação do Docker

Estamos quase lá para deixar nosso ambiente pronto para subirmos nossos microsserviços. Para isso, vamos instalar o Docker.

Recaptulando, Docker é uma plataforma de virtualização de contêineres que permite empacotar, distribuir e executar aplicativos de forma consistente em diferentes ambientes.

Atualizar a lista de repositórios do Ubuntu:
$ sudo apt-get update


Instalação das chaves GPG oficiais do Docker:
$ sudo apt-get install ca-certificates curl


$ sudo install -m 0755 -d /etc/apt/keyrings


$ sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc

$ sudo chmod a+r /etc/apt/keyrings/docker.asc


Adição do repositório nos sources do Apt: 
$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null


$ sudo apt-get update


Instalação dos pacotes do Docker:
$ sudo apt-get install docker-ce docker-ce-cli containers.io docker-buildx-plugin docker-compose-plugin


Para testar a instalação do Docker, vamos utilizar uma imagem simples de "hello-world". O resultado será o seguinte:


Perfeito, agora temos nosso ambiente "base" preparado para a próxima etapa que será voltada especificamente para criação do containers, download das imagens que iremos
utilizar e upload dos códigos que iremos rodar em cada container.

Como tem bastante coisa até aqui, vou parar por agora para que todos consigam dedicar um tempo na preparação do ambiente e deixá-lo funcional para o que vem depois. 

Abs e até a próxima.
:wq!