Instalar Docker e Docker Compose - Requisitos de APIs
- Solus (Unlicensed)
Escrito por: L. H.
Instalar Docker e Docker Compose - Requisitos de APIs
O que é?
- Lista dos requerimentos mínimos para utilização de APIs.
- Não utilizamos Docker em ambiente Windows por questões de desempenho, escalabilidade, segurança. O Docker no Windows emula uma maquina Linux para servir o kernel, causando lentidão.
1- Ter um dos sistemas operacionais e versões abaixo para a utilização das APIs:
Ubuntu:
- Focal 20.04 (LTS) ou superior;
- Bionic 18.04(LTS) ou superior;
- Xenial 16.04 (LTS) ou superior;
Debian:
- Buster 10 (stable) ou superior;
- Stretch 9 / Raspbian Stretch ou superior;
2- Ter acesso à base de dados Solus no servidor Oracle.
Para a utilização das APIs em ambiente de teste, se faz necessário ter as seguintes configurações mínimas de hardware.
- Processador: Intel(R) Xeon(R) CPU E5-2650 v4 @ 2.20GHz ou superior.
- CPUs: mínimo 2 ativas.
- Memória RAM: mínimo 8 GB.
- Espaço em disco: mínimo 50 GB.
Para a utilização das APIs em abiente de produção, se faz necessário ter as seguintes configurações minimas de hardware.
- Processador: Intel(R) Xeon(R) CPU E5-2650 v4 @ 2.20GHz ou superior.
- CPUs: mínimo 4 ativas.
- Memória RAM: mínimo 16 GB.
- Espaço em disco: mínimo 50 GB.
O docker é uma ferramenta para virtualizar aplicações no conceito de "containers" que contem todas as dependências necessárias para executar a aplicação. Utilizaremos o docker para rodar as APIs no servidor.
Para efetuarmos a instalação do docker, devemos seguir os passos abaixo.
- Verificar qual a versão do Linux, com o comando: cat /etc/os-release
- Através do link abaixo, na opção Server, selecionar a versão do Linux e seguir os passos de instalação:
https://docs.docker.com/engine/install/
- No servidor, criar uma pasta chamada docker na raiz
O Docker Compose é uma ferramenta para a criação e execução de múltiplos containers. Com o Compose, usamos um arquivo do tipo yaml para definir como será o ambiente da aplicação, através dele iniciamos os containers definidos.
- Acessar o diretório 'docker' criado no passo anterior através do comando: 'cd /docker' e instalar o docker-compose através do link abaixo:
https://docs.docker.com/compose/install
O Nginx será utilizado para obter as requisições e transmitir para a api, dessa forma podemos utilizar o protocolo SSL.
Para realizarmos a instalação do Nginx corretamente devemos seguir o passo a passo abaixo.
Dentro da pasta Docker raiz (/Docker), extrair o nginx.rar - https://www.solus.inf.br/SolusUpdate/docker/nginx.rar
Assim ficará a estrutura da pasta.
O ip utilizado para configuração do nginx é interno, ou seja é o próprio ip do servidor. Apenas na configuração do server_name será utilizado o ip externo (DNS)
No arquivo default.conf(/nginx/config) alterar os ip’s para o ip do servidor e colocar em qual porta o nginx irá rodar, por padrão está na 8081. No server_name, colocar o dns ou ip externo.
No arquivo upstream.conf (/nginx/config) alterar o server para o ip do servidor linux.
O arquivo upstream.conf está pré configurado com as portas das api's, sendo necessário alterar apenas quando incluir uma nova api.
No arquivo docker-compose, informar as portas externa:interna paras quais serão utilizadas. Pode -se manter as duas iguais 8081:8081
Dentro do diretório do nginx (/docker/nginx) executar o comando para executar o arquivo docker-compose.yml:
docker-compose up --build -d.
Assim irá iniciar o serviço do nginx
O certificado digital traz maior segurança para as transações, caso não tenham nenhum certificado digital, deve-se entrar em contato com alguma empresa que o forneça e realizar a aquisição, desta maneira será possível utilizar o protocolo SSL no NGINX e todas as transações serão realizadas com maior segurança.
Para instalar o certificado acesse o diretório do nginx (docker/nginx) acessar a pasta certs. Dentro dela incluir os certificados.
Pode-se utilizar a porta padrão do ssl 443, se não estiver em uso. Caso esteja, liberar outra porta configurada para ssl. Aqui utilizaremos a 16010. No arquivo default.conf(nginx/config), na frente da porta 16010 colocar ssl, e incluir o caminho do certificado. (Alterar o nome do certificado para o obtido).
ssl_certificate /etc/nginx/certs/certificado.crt;
ssl_certificate_key /etc/nginx/certs/certificado.key;
No arquivo docker-compose (/nginx/docker-compose) incluir a porta 16010
Nginx rodando na porta 16010
Para atualizar o certificado, acesse o diretório do nginx (docker/nginx) > pasta certs > renomear o certificado antigo para "certificado_old.crt" e adicionar o certificado novo.
Após adicionar o certificado novo na pasta, abra o prompt de comando (cmd) e execute o comando para reiniciar o nginx: "docker restart nginx"
Atenção