DEV Community: David Silva

Ensure a beaut code with Laravel Pint

David Silva — Mon, 17 Oct 2022 18:44:19 +0000

Hello,

This is my first full English post! So, I'd starting with "sorry" for my wrongs, I'm learning :)

If you, like me, has Laravel inside your world and like beautiful things, I think you need to meet the Laravel Pint.

Laravel Pint help us to keep a good code style.

Working in one team without some code styler or some texteditor settings, usually we need to check a lot of spaces changes, breaklines, positions in the Pull Request review. It's so bad and sad to review one big PR with a lot of 'non-necessary-changes'.

To solve this, we can setup the default code style for everyone of the time, this make more easy to check codes from other person and improve the PR Review moments.

With Laravel Pint is so easy setup a one default way to this, without extra settings like with pure PHP-CS.

Let's install de Pint with the normal command:

composer require laravel/pint --dev

After installation, you can just run:

./vendor/bin/pint

At the first time, you can see a lot of files changes, like in this my personal hobby project:

Of course, in this simple way, you will need run the command before commits to ensure a correct code style. We can improve this we can to use some pre-commit hook, like a grumphp https://github.com/phpro/grumphp.

In other post, I can write more about grumphp, but if you want, you can check the oficial docs to learn more.

For today it's only, thanks for read! :)

Bloquear Tráfego Por IP - X-Forwarded-For Apache 2.4

David Silva — Fri, 29 May 2020 16:00:15 +0000

Quando seu apache recebe requisições de um LoadBalancer o IP de origem delas serão (claro) do LoadBalancer. Consequentemente, quando você precisar fazer algo como bloquear tráfegos indesejados por ip, o processo é um pouco diferente dos casos convencionais pois você não terá nas mãos o REMOTE_ADDR ou o simples ip, por exemplo.

No caso do exemplo abaixo, há um LoadBalancer redirecionando para o apache do servidor que ainda faz um proxy reverso para o container:

<VirtualHost *:443>
    <LocationMatch "/.*">
        Order Allow,Deny
        Allow from all
        ## você pode colocar uma lista de IPs
        SetEnvif X-Forwarded-For "xxx\.xxx\.xxx\.xxx" DenyAccess
        SetEnvif X-Forwarded-For "yyy\.yyy\.yyy\.yyy" DenyAccess
        Deny from env=DenyAccess
    </LocationMatch>

    ... # outras configs do seu serviço

    ProxyPreserveHost On
    ProxyRequests Off
    ProxyPass / http://container:port/ retry=1 timeout=180 nocanon
    ProxyPassReverse / http://container:port/
</VirtualHost>

Se isso lhe foi útil, deixe seu comentário!

🐳Docker#01 Instalação e Primeiros Passos - Parte 1

David Silva — Fri, 08 May 2020 21:14:50 +0000

Neste artigo vamos começar a colocar a mão na massa, instalando e aprendendo alguns comandos básicos.

Antes de começar a instalação vamos falar de alguns pontos importantes em relação ao sistema operacional do host.

Até a algum tempo atrás você só conseguia rodar o Docker no Windows instalando o VirtualBox. Isso já melhorou e agora o Docker roda de forma nativa no Windows também, assim como no Linux que sempre rodou.

Em contrapartida, se você usa Mac como eu, precisará instalar o VirtualBox para rodar o Docker e, vai por mim, fica uma belezura mas só quando tá desligado 🤣. É só ligar que fica horrível. Dependendo do quanto você vive fazendo build, sua maquina vai fritar, ficar lenta e muito ruim para trabalhar. Para você ter idéia, eu acabei instalando o Ubuntu no Macbook Pro 2015 para poder trabalhar melhor, e agora sim ficou ótimo!

Eu não uso Windows há anos e até te recomendaria usar Linux para usar o Docker, mas como agora também roda sem VirtualBox lá, imagino que possa rodar bem também. Se você testar, deixe seu comentário aqui para sabermos!

Como instalar o Docker?

Honestamente não vejo motivos para gastar tanto texto explicando os passos da instalação, então vou resumir e apontar os links oficiais caso você precise de ajuda extra.

Docker no Linux

Há um script oficial maroto que faz todo o trabalho para você:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Você terá o docker instalado mas seu usuário comum ainda não terá acesso aos comandos principais do Docker. E, por favor, não ache que usar sudo para tudo na sua própria máquina seja normal, sua vida será melhor se as coisas forem mais simples*.

PS: Não significa fazer seu usuário ser root também, ok? Mas o básico para seu trabalho acontecer, coisas que você faz toda hora, pode sim ser mais fácil.

Coloque seu usuário no grupo do docker para poder rodar os comandos:

sudo usermod -aG docker $USER

Reinicie sua máquina.

Oracle Linux

Recentemente precisei fazer a instalação em uma distribuição Oracle Linux e o setup padrão não funcionou, se for o seu caso, este outro artigo pode ajudá-lo.

Docker no MacOs

Você precisará ter o VirtualBox instalado e o procedimento de instalação será o mesmo do Docker (arrastar do finder). O link para download está aqui.

Clique aqui, baixe o .dmg clicando no botão azul "Get Docker Desktop for Mac (Stable)".

Faz aquela super instalação super complexa que só no mac é possível.

Docker no Windows

Clique aqui, baixe o .exe clicando no botão azul "Get Docker Desktop for Windows (stable)".

Espere baixar e faz o de sempre, execute, next, next, finish.

Primeiros comandos no Docker

Com o Docker instalado (uhu!) agora podemos começar a desbravar essa aventura.

Vamos começar listando e explicando o funcionamento básico de alguns comandos básicos, priorizando os mais utilizados no (meu) dia a dia. Alguns comandos terão artigos dedicados, por isso aqui vamos falar apenas dos mais simples.

docker ps

Em breve começaremos a criar containers e precisaremos gerenciar suas instâncias, para isso o docker ps pode nos ajudar.

O ps nos permite visualizar quase tudo em relação aos containers:

# Listar containers em execução
docker ps

# Listar containers em execução e parados
docker ps -a

# Listar somentes os Ids dos containers em execução
docker ps -q

# Listar apenas os nomes e ids dos containers ativos
docker ps --format "{{.ID}}: {{.Names}}"

Com este último comando você pode formatar dos dados para melhorar a visualização e te dar mais poder quando precisar fazer scripts para automatizar as coisas.

Para mais exemplos de formatação no ps clique aqui.

docker pull

Como falamos no artigo anterior, os containers precisam de imagens para existir, que são registradas/gravadas/armazenadas em um servidor (público ou privado), geralmente chamado de Registry.

Existem muitas imagens oficiais e não oficiais que podem facilitar sua vida, você as encontrará no DockerHub.

# Baixando uma imagem latest
docker pull ubuntu

# Baixando uma imagem com tag
docker pull ubuntu:14.04

Você pode especificar qual é a tag da imagem, caso queira alguma especifica, ou simplesmente ter a latest por padrão.

# Ver imagens baixadas
docker images

Nota: Esses comandos padrões do docker vão trazer as imagens direto do DockerHub, porém, se você especificar o caminho do seu próprio registry.

docker pull myregistry.local:5000/testing/test-image

Indo além: Já parou para pensar que o seu servidor de produção poderia ter apenas a imagem mais atualizada ao invés de toda a sua aplicação? Imagine quão rápido seria colocar uma versão e até mesmo retornar a outra anterior?
Se quiser saber mais sobre isso que, a propósito também é possível sem Docker, procure por Blue Green Deploy e Canary Release.

docker run

Já sabemos que existem imagens e agora precisamos usá-las.

O comando docker run é o cara que cria o container para nós.

# Cria container com a imagem ubuntu
docker run ubuntu

Perceba que rodar isso vai criar um container e, em seguida, ele vai parar. Isso acontece por que não há nenhum processo no interior do container em execução e, de que adiantaria um container sem ação?

Se você der um docker ps -a vai ver que o container está lá, porém, parada com STATUS Exit (0) x seconds ago. Ou seja, ele foi criado, subiu e morreu.

Para que este teste seja funcional, vamos fazer algo assim:

docker run -ti ubuntu bash

Isso vai te devolver um terminal interativo de dentro do container.
É literalmente um sistema operacional isolado aí. Você pode dar um ls /home e vai perceber que não tem nada, diferente do seu próprio ambiente, por exemplo.

Sabe aquele rm -rf / que tanto se zoa?! Você pode rodar aí dentro.

Se você tiver com medo, ok. Eu fiz, veja:

Perceba que, na primeira linha, é minha maquina david@david-MacBookPro e depois já estou dentro do container.

Na última linha não é possível mais usar o binário ls pois ele foi excluído.

Agora perceba que eu posso sair (CTRL+D) e entrar de novo no container e ele terá tudo de volta.

Isso foi apenas um hello world básico. Em breve avançaremos mais.

O docker run possui diversos parâmetros úteis, considere que ele é o cara que cria o container e precisamos de muitas coisas para nossas aplicações funcionarem, alguns exemplos são as portas de redes, montagem de volumes de dados, limites de memória, etc.

Eu montei este outro artigo que é somente o retorno do docker run --help traduzido e com alguns considerações.

Opções do Comando Docker Run

Vamos parando por aqui pois já está extenso demais!

Se alguma coisa aqui foi útil pra você, deixe seu comentário!

Até a próxima.

🐳Opções do Comando Docker Run

David Silva — Fri, 08 May 2020 21:08:57 +0000

Este artigo é complementar ao Manual Básico de Docker.

Abaixo nós temos o retorno do comando docker run --help traduzido.


    --ADD-HOST LIST                  ADICIONAR UM MAPEAMENTO HOST-TO-IP PERSONALIZADO (HOST: IP)
-A, --ATTACH LIST                    ANEXAR A STDIN, STDOUT OU STDERR
    --BLKIO-WEIGHT UINT16            BLOCO IO (PESO RELATIVO), ENTRE 10 E 1000, OU 0 PARA DESATIVAR (PADRÃO 0)
    --BLKIO-WEIGHT-DEVICE LIST       PESO IO DO BLOCO (PESO DO DISPOSITIVO RELATIVO) (PADRÃO [])
    --CAP-ADD LIST                   ADICIONAR CAPACIDADES DE LINUX
    --CAP-DROP LIST                  CAPACIDADES DROP LINUX
    --CGROUP-PARENT STRING           GRUPO DE CONTROLE OPCIONAL PARA O RECIPIENTE
    --CIDFILE STRING                 ESCREVA A ID DO RECIPIENTE NO ARQUIVO
    --CPU-PERIOD INT                 LIMITE DO PERÍODO DE CFS DA CPU (COMPLETAMENTE JUSTO)
    --CPU-QUOTA INT                  LIMITAÇÃO DE COTAÇÕES DE CPU CFS (COMPLETAMENTE JUSTA)
    --CPU-RT-PERIOD INT              LIMITE DO PERÍODO EM TEMPO REAL DA CPU EM MICROSegundos
    --CPU-RT-RUNTIME INT             LIMITE DE EXECUÇÃO EM TEMPO REAL DA CPU EM MICROSegundos
-C, --CPU-SHARES INT                 AÇÕES DA CPU (PESO RELATIVO)
    --CPUS DECIMAL                   NÚMERO DE CPUS
    --CPUSET-CPUS STRING             CPUS EM QUE PERMITE A EXECUÇÃO (0-3, 0,1)
    --CPUSET-MEMS STRING             MEMS QUE PERMITEM A EXECUÇÃO (0-3, 0,1)
-D, --DETACH                         EXECUTAR RECIPIENTE NO ID DE FUNDO E IMPRIMIR
    --DETACH-KEYS STRING             SUBSTITUIR A SEQUÊNCIA CHAVE PARA DESLOCAR UM CONTAINER
    --DEVICE LIST                    ADICIONAR UM DISPOSITIVO DE HOSPEDAGEM AO RECIPIENTE
    --DEVICE-CGROUP-RULE LIST        ADICIONAR UMA REGRA À LISTA DE DISPOSITIVOS PERMITIDOS DO CGROUP
    --DEVICE-READ-BPS LIST           LIMITE DE TAXA DE LEITURA (BYTES POR SEGUNDO) DE UM DISPOSITIVO (PADRÃO [])
    --DEVICE-READ-IOPS LIST          LIMITE DE TAXA DE LEITURA (IO POR SEGUNDO) DE UM DISPOSITIVO (PADRÃO [])
    --DEVICE-WRITE-BPS LIST          LIMITE DE TAXA DE GRAVAÇÃO (BYTES POR SEGUNDO) A UM DISPOSITIVO (PADRÃO [])
    --DEVICE-WRITE-IOPS LIST         LIMITE DE TAXA DE ESCRITA (IO POR SEGUNDO) A UM DISPOSITIVO (PADRÃO [])
    --DISABLE-CONTENT-TRUST          PULAR VERIFICAÇÃO DE IMAGEM (VERDADEIRO PADRÃO)
    --DNS LIST                       DEFINIR SERVIDORES DNS PERSONALIZADOS
    --DNS-OPTION LIST                DEFINIR OPÇÕES DE DNS
    --DNS-SEARCH LIST                DEFINIR DOMÍNIOS DE PESQUISA DE DNS PERSONALIZADOS
    --DOMAINNAME STRING              NOME DO DOMÍNIO DO NIS DO RECIPIENTE
    --ENTRYPOINT STRING              SUBSTITUIR O PONTO DE ENTRADA PADRÃO DA IMAGEM
-E, --ENV LIST                       CONFIGURAR VARIÁVEIS DE AMBIENTE
    --ENV-FILE LIST                  LER EM UM ARQUIVO DE VARIÁVEIS DE AMBIENTE
    --EXPOSE LIST                    EXPOR UMA OU MAIS PORTAS
    --GPUS GPU-REQUEST               DISPOSITIVOS DE GPU PARA ADICIONAR AO RECIPIENTE ('TODOS' PARA PASSAR EM TODOS OS GPUS)
    --GROUP-ADD LIST                 ADICIONE GRUPOS ADICIONAIS PARA ADERIR
    --HEALTH-CMD STRING              COMANDO A EXECUTAR PARA VERIFICAR A SAÚDE
    --HEALTH-INTERVAL DURATION       TEMPO ENTRE A EXECUÇÃO DO CHEQUE (MS | S | M | H) (PADRÃO 0S)
    --HEALTH-RETRIES INT             FALHAS CONSECUTIVAS NECESSÁRIAS DE RELATAR NÃO-SAUDÁVEIS
    --HEALTH-START-PERIOD DURATION   PERÍODO DE INÍCIO PARA O RECIPIENTE INICIALIZAR ANTES DE INICIAR A CONTAGEM DE RECUPERAÇÃO DE SAÚDE (MS | S | M | H) (PADRÃO 0S)
    --HEALTH-TIMEOUT DURATION        TEMPO MÁXIMO DE PERMITIR UMA VERIFICAÇÃO PARA EXECUTAR (MS | S | M | H) (0S PADRÃO)
    --HELP                           ESTE GUIA
-H, --HOSTNAME STRING                NOME DO HOST DO RECIPIENTE
    --INIT                           EXECUTE UMA ENTRADA DENTRO DO CONTAINER QUE ANTECIPA OS PROCESSOS DE SINAIS E REAPS
-I, --INTERACTIVE                    MANTENHA STDIN ABERTO MESMO QUE NÃO SEJA ANEXADO
    --IP STRING                      ENDEREÇO IPV4 (por exemplo, 172.30.100.104)
    --IP6 STRING                     ENDEREÇO IPV6 (por exemplo, 2001: DB8 :: 33)
    --IPC STRING                     MODO IPC A USAR
    --ISOLATION STRING               TECNOLOGIA DE ISOLAMENTO DE CONTAINERES
    --KERNEL-MEMORY BYTES            LIMITE DE MEMÓRIA KERNEL
-L, --LABEL LIST                     DEFINIR DADOS META EM UM RECIPIENTE
    --LABEL-FILE LIST                LEIA EM LINHA ARQUIVO DE ETIQUETAS DELIMITADO
    --LINK LIST                      ADICIONAR LINK A OUTRO RECIPIENTE
    --LINK-LOCAL-IP LIST             ENDEREÇOS LOCAIS LINK DO RECIPIENTE IPV4 / IPV6
    --LOG-DRIVER STRING              EXCITADOR DE LOGGING PARA O RECIPIENTE
    --LOG-OPT LIST                   OPÇÕES DO CONTROLADOR DE LOG
    --MAC-ADDRESS STRING             ENDEREÇO MAC DE RECIPIENTE (E.G., 92: D0: C6: 0A: 29: 33)
-M, --MEMORY BYTES                   LIMITE DE MEMÓRIA
    --MEMORY-RESERVATION BYTES       LIMITE DE MEMÓRIA MACIA
    --MEMORY-SWAP BYTES              LIMITE DE SWAP IGUAL A MEMÓRIA MAIS SWAP: '-1' PARA ATIVAR SWAP ILIMITADO
    --MEMORY-SWAPPINESS INT          INTERVENÇÃO DA MEMÓRIA DO RECIPIENTE SINTÉTICO (0 A 100) (PADRÃO -1)
    --MOUNT MOUNT                    ANEXAR UMA MONTAGEM DO SISTEMA DE ARQUIVOS AO CONTAINER
    --NAME STRING                    ATRIBUIR UM NOME AO RECIPIENTE
    --NETWORK NETWORK                CONECTE UM RECIPIENTE A UMA REDE
    --NETWORK-ALIAS LIST             ADICIONAR ALIAS DE ESCOPO EM REDE PARA O RECIPIENTE
    --NO-HEALTHCHECK                 DESATIVAR QUALQUER CONTROLE DE SAÚDE ESPECIFICADO POR CONTAINER
    --OOM-KILL-DISABLE               DESABILITAR OOM KILLER
    --OOM-SCORE-ADJ INT              PREFERÊNCIAS DE OOM DO SINTONIZADOR (-1000 A 1000)
    --PID STRING                     NOME DO ESPAÇO PID A USAR
    --PIDS-LIMIT INT                 LIMITE DE PIDS DE RECIPIENTE SINTÉTICO (SET -1 PARA ILIMITADO)
    --PRIVILEGED                     DAR PRIVILEGIOS ESTENDIDOS A ESTE RECIPIENTE
-P, --PUBLISH LIST                   PUBLIQUE O (S) PORTO (S) DE CONTAINER AO HOSPEDEIRO
-P, --PUBLISH-ALL                    PUBLICAR TODAS AS PORTAS EXPOSTAS PARA PORTAS ALEATÓRIAS
    --READ-ONLY                      MONTE O SISTEMA DE ARQUIVO DE RAIZ DO CONTAINER COMO LIDO SOMENTE
    --RESTART STRING                 REINICIAR A POLÍTICA PARA APLICAR QUANDO UM RECIPIENTE SAIR (PADRÃO "NÃO")
    --RM                             REMOVA AUTOMATICAMENTE O CONTAINER QUANDO SAIR
    --RUNTIME STRING                 TEMPO DE UTILIZAÇÃO PARA ESTE RECIPIENTE
    --SECURITY-OPT LIST              OPÇÕES DE SEGURANÇA
    --SHM-SIZE BYTES                 TAMANHO DE / DEV / SHM
    --SIG-PROXY                      PROXY SINAIS RECEBIDOS AO PROCESSO (PADRÃO VERDADEIRO)
    --STOP-SIGNAL STRING             SINAL PARA PARAR UM RECIPIENTE ("SIGTERM PADRÃO")
    --STOP-TIMEOUT INT               TEMPO LIMITE (EM SEGUNDOS) PARA PARAR UM RECIPIENTE
    --STORAGE-OPT LIST               OPÇÕES DE EXCITADOR DE ARMAZENAMENTO PARA O CONTAINER
    --SYSCTL MAP                     OPÇÕES SYSCTL (MAPA PADRÃO [])
    --TMPFS LIST                     MONTA UM DIRETÓRIO TMPFS
-T, --TTY                            ALOCAR UM PSEUDO-TTY
    --ULIMIT ULIMIT                  OPÇÕES ULIMIT (PADRÃO [])
-U, --USER STRING                    USERNAME OU UID (FORMATO: <NAME | UID> [: <GRUPO | GID>])
    --USERNS STRING                  NOME DO USUÁRIO PARA USAR
    --UTS STRING                     UTS NAMESPACE PARA USAR
-V, --VOLUME LIST                    MONTAR UM VOLUME
    --VOLUME-DRIVER STRING           EXCITADOR DE VOLUME OPCIONAL PARA O RECIPIENTE
    --VOLUMES-FROM LIST              VOLUMES DE MONTAGEM DO (S) RECIPIENTE (S) ESPECIFICADO (S)
-W, --WORKDIR STRING                 DIRETÓRIO DE TRABALHO DENTRO DO CONTAINER

GrayLog parou após disco cheio?

David Silva — Thu, 30 Apr 2020 15:36:53 +0000

Se você tiver um problema com disco cheio no servidor, precisará reativar o modo de escrita do elasticSearch pois ele ficará parado até que isso seja feito.

No meu caso, este problema ocasionou no stop completo do GrayLog. Se você tiver o mesmo problema, basta realizar a seguinte chamada para seu servidor do Elastic.

curl -XPUT -H "Content-Type: application/json" https://SEU_ELASTIC:9200/_all/_settings -d '{"index.blocks.read_only_allow_delete": null}'

Para identificar esse problema no Graylog, acessei a tela de falhas dos índices http://GRAYLOG:9000/system/indices/failures.

E lá tinha uma lista de mensagens como esta:

{"type":"cluster_block_exception","reason":"blocked by: [FORBIDDEN/12/index read-only / allow delete (api)];"}

Apagando o cache do Redis

David Silva — Tue, 28 Apr 2020 12:29:46 +0000

Se você não usa cache na sua aplicação, considere usar. Otimiza muito a performance e, se bem aplicado, vai te polpar bons recursos e ainda deixar o usuário bem feliz pela agilidade na entrega das requisições. Mas hoje não vamos falar de como implementar isso, é só um artigo rápido para te ajudar a limpar o cache caso precise.

Como listar todo o cache

redis-cli keys *

Como apagar todo cache

redis-cli FLUSHALL ASYNC

Como filtrar a lista do cache

redis-cli keys "*ALGUMA_PALAVRA_NO_MEIO*"

Como apagar entradas específicas

redis-cli --raw keys "*ALGUMA_PALAVRA_NO_MEIO*" | xargs redis-cli del

É isso aí! Como falei, é só um guia para consulta rápida!

Até a próxima!

🐳Docker#00 Introdução Concentual

David Silva — Fri, 24 Apr 2020 12:04:34 +0000

Tenho estudado Docker com mais vontade de alguns meses pra cá (além de trabalhar no dia a dia) e não faz muito sentido fazer tudo isso se eu não passar a diante.

Honestamente meu intuito é que este texto facilite um pouco sua vida, vou mesclar um pouco da minha experiência que vai desde o desenvolvimento até o Deploy para Produção. No meio do caminho talvez eu cite ferramentas extras que também podem ajudá-lo (espero).

Este artigo faz parte da série Manual "básico" de Docker. Digo básico pois realmente há muito mais do que pretendo escrever.

Duas observações importantes sobre este projeto:

Não será o estado da arte de primeira, não espere isso. Aliás, suas idéias, comentários e correções serão levados a sério e revisarei o que for necessário.
Eu não tenho tanta pressa. Ao mesmo tempo que estou escrevendo, estou lendo mais e sempre reviso algumas partes, implemento, melhoro, etc. Então isso pode ficar um tanto extenso mas farei o possível para que valha seu tempo.

O que é Docker?

Como na própria documentação:

Docker é uma plataforma para criar, executar e compartilhar aplicativos em containers.

Isso pode não dizer muito ainda, mas de fato diz quase tudo.

Desenvolvido pela empresa Docker, Inc., Docker é um software de administração de contêineres que visa abstrair a camada de virtualização de uma forma que simplifique (MUITO) a vida de desenvolvedores e administradores de sistemas.

Você já deve ter usado ou visto uma máquina virtual. Daquelas que nos permitem rodar um sistema operacional sobre o outro, sabe? Tipo VirtualBox. Você instala o VirtualBox no Windows e pode instalar outro Windows (espero que não faça) dentro dele.

Isso é bastante útil para fazer testes em ambientes diferentes do que você está usando e até para rodar aplicações que não funcionam no seu sistema atual. É diferente de uma máquina virtual, que executa um sistema operacional (guest OS) sobre o outro (host OS) e, só depois, executa as aplicações.

Um contêiner tem a capacidade de se beneficiar do kernel do seu sistema host para executar aplicações.

Na imagem abaixo, fica um pouco mais claro:

Comparativo entre a arquitetura de um sistema de contêineres versus arquitetura de um sistema virtualizado. Fonte: https://docs.docker.com/get-started/

Note que quando usamos uma máquina virtual com um sistema operacional inteiro e só depois a aplicação desejada, estamos literalmente jogando fora uma grande quantidade de recursos de hardware que podem (e devem) ser melhor aproveitados. Além de ser caro em recursos físicos, é lento e pesado. Ou seja, fica muito mais complexo replicar, compartilhar e, claro, escalar utilizando uma arquitetura baseada em máquina virtuais.

Tudo que estamos falando agora, a respeito de contêineres não é tão novo assim, e já funcionava antes do Docker. O Unix permitia realizar essa tarefa nativamente através do velho chroot, incluído em 1979, de forma limitada mas realizável. Melhorou no GNU/Linux, com a possibilidade de rodar processos isolados com o cgroup, desenvolvido pelo time de engenharia da Google em 2006 (talvez eu faça isso manualmente e documento em um outro artigo).

Apesar de contêineres serem possíveis desde muito tempo atrás, não eram uma tarefa simples de se realizar. Até que o Docker veio para facilitar tudo isso, abstraindo toda complexidade técnica e nos permitindo usar os recursos e dedicar tempo em nossas próprias aplicações. Porém, alguns conceitos precisam ser bem entendidos para se aprofundar melhor no mundo dos contêineres: a diferença entre imagens e contêineres.

Imagens

A abstração não está apenas na execução dos contêineres, como vimos até agora, mas também na criação das imagens que são utilizadas como base para a execução deles. Imagem é uma espécie de molde usado para a criação das instâncias (contêiner). Existem diversas imagens já construídas e podemos reaproveitá-las para facilitar nossa vida. A Docker, Inc. é responsável pelo maior hub de imagens oficiais e não-oficiais, o Docker Hub (https://hub.docker.com/).

Imagens são construídas a partir de um arquivo de receita conhecido por Dockerfile. Em breve vamos começar a escrever essas receitas e compreender maneiras boas e ruins de fazer diversas coisas, para diferentes cenários.

Contêineres

Damos o nome de contêiner a qualquer instância criada a partir de um molde (imagem docker). Fazendo um paralelo com o paradigma de orientação a objetos, a imagem docker é a classe enquanto que o objeto é o contêiner. Podemos ter diversos contêineres criados a partir da mesma imagem. Um contêiner permite executar a instância de alguma coisa de forma isolada, flexível e escalável. Ele só vive enquanto seu propósito de execução estiver, claro, em execução.

Quando lidamos com containers, precisamos começar considerando que os containers só nascem para morrer. Ou seja, não tenha apego emocional no planejamento, ele precisa nascer, executar e morrer. Você pensando assim, começará a desenvolver aplicações cada vez mais 'conteinerizáveis'.

🐳Instalando Docker no Oracle Linux

David Silva — Thu, 23 Apr 2020 13:43:41 +0000

Se você também está utilizando a Oracle Cloud, provavelmente vai precisar instalar o docker em algum momento.

A propósito, as instâncias gratuitas da OCI rodam com Oracle Linux e elas podem servir para fazer testes. Só possuem 1Gb de memória RAM mas, para você ter ideia, eu já subi containers de backend com nodejs e containers de entregas estáticas com nginx no mesmo servidorzinho e dá para brincar.

A instalação do Docker é simples e vai funcionar exatamente nesta sequência:

## Incluir Repositório Docker
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

## Instalar docker-engine e docker-compose
sudo yum install docker-engine docker-compose

## Habilitar uso do Docker para o usuário atual (sem sudo)
sudo usermod -aG docker $USER

## Subir o docker na inicialização do sistema
sudo systemctl enable docker

## Reinicie pra tudo entrar em vigor
reboot

Publicando Imagens no OCIR - Registry Oracle Cloud

David Silva — Wed, 15 Apr 2020 17:34:22 +0000

O processo de publicação de imagens no Registry da Oracle Cloud é similar ao processa da AWS e GCP, não foge do padrão de publicação do docker. Basta autenticar e dar push, sem segredos.

Após fazer login no seu painel do Oracle Cloud, clique no Menu Registry dentro de Developer Services.

O Painel é bem simples e amigável, para começar, crie um Repositório.

PS: Evite ter imagens imensas assim 🤣

Com o nome do repositório em mãos, precisamos tomar nota do sua região, do namespace da sua conta e criar um token de autenticação. Vamos lá!

Região Conta Oracle Cloud

Para saber sua região é simples, basta ver o link de acesso. Exemplo:
https://console.sa-saopaulo-1.oraclecloud.com/containers/registry/

A região do meu registry é sa-saopaulo-1.

NameSpace Tenancy

Clique sobre o ícone do Perfil (canto superior direito) e em seguida em Tenany: Alguma coisa.

Na página que abrir, note na sessão Object Storage Settings, tem um campo que contém o seu namespace: Object Storage Namespace:.

Auth API Token Oracle Cloud

Para criar um token de autenticação, acesse seu perfil clicando no ícone e depois em seu usuário (canto superior direito).

Na página que abrir, clique em Auth Tokens da barra lateral esquerda. Em seguida, basta clicar em Generate Token, colocar um nome e copiar o token.

Login Oracle Registry OCIR com Docker

Agora o login é simples, a sequência é a seguinte:

docker login SUAREGIAO.ocir.io
SEUNAMESPACE/SEULOGIN
TOKEN

Tag e Push

Para gerar sua tag e publicar:

docker tag SUAIMAGEMLOCAL:<tag> SUAREGIAO.ocir.io/SEUNAMESPACE/SEUREPOSITORIO:<tag>

docker push SUAREGIAO.ocir.io/SEUNAMESPACE/SEUREPOSITORIO:<tag>

Se tiver dúvidas, não deixe de comentar!

Até a próxima!

Integrando Jenkins e Gitlab

David Silva — Wed, 15 Apr 2020 15:10:30 +0000

Automatizar certas tarefas fará sua vida ser muito mais prática e produtiva. Um exemplo bom de tarefas que DEVEM ser automatizadas é o deploy.

Talvez você ainda não tenha os stages ideais para fazer a build e publicar em produção de forma automática, mas isso não pode te impedir de automatizar os ambientes de desenvolvimento e homologação, por exemplo.

Se você já tem tarefas no Jenkins e usa o GitLab, isso pode ser feito de uma forma bem simples e rápida:

Configuração Jenkins

Vamos precisar de um token para a autenticação acontecer, acesse a configuração de um usuário que tenha permissão no seus jobs. Algo como: http://LINK_JENKINS/user/admin/configure

Nesta página você poderá administrar os tokens.

Agora que temos o token e usuário em mãos, só precisamos configurar o projeto lá no GitLab.

Configuração gitlab

No gitlab, acesse seu projeto e vá no Menu Configurações > Integrações.

Nesta tela você poderá definir integrações de plugins que estão configuradas no seu Jenkins e também cadastrar Hooks manuais, como faremos.

No meu caso, quero que quando houver Merge Requests com uma branch específica, o script de deploy seja executado. Veja a imagem abaixo:

Seu link deverá ser a combinação de um usuário, token e o Job do Jenkins: http://USER:TOKEN@LINK_JENKINS/view/Fronted/job/Frontend/build

Nesse caso, view/Fronted/job/Frontend/build é um atalho para meu Job. Também pode ser o link direto do Job: /job/NOME/build.

Isso é o suficiente para as rotinas acontecerem automaticamente. Claro que é uma configuração básica mas poderá simplificar um pouco sua vida.

Até a próxima.

Créditos da capa: https://letztest.blogspot.com/2017/09/how-to-integrate-jenkins-and-gitlab.html