· infraestrutura  · 6 min read

Criando uma imagem Docker personalizada

Criando uma imagem Docker personalizada e conhecendo o Dockerfile.

É muito legal poder baixar uma imagem do Docker Hub e já sair criando os containers, modificando e brincando, mas e depois?

Como fazemos para levar essa imagem para outro host?

Podemos fazer isso subindo a imagem para o Docker Hub ou mesmo compactando a imagem em formato .tar.

Para criar uma imagem personalizada, primeiro precisamos conhecer o Dockerfile, depois voltamos a criação da imagem própriamente dita. ;)

Dockerfile

Já vimos que podemos utilizar a linha de comando para inicializar um Docker container com um parâmetro que é o comando a ser executado direto no container para inicializar algum serviço, trazer alguma informação sobre o container em execução, etc.

Ex.:

Executando um container do NGINX com o comando para startar o Web Server:

docker run -d -p 8080:80 nginx /usr/sbin/nginx -g "daemon off;"

Com esse comando vamos criar o container com a imagem do nginx passando os parâmetros para inicializar o servidor e listar a porta 80 do container na 8080 do nosso host.

Agora, imagine utilizar essa linha inteira para esse serviço e/ou outros mais que possam ser executados como um MySQL, Redis, MongoDB, etc.

Isso pode ser bem pouco produtivo.

A maneira de automatizar essas tarefas é utilizando um Dockerfile para passar os parâmetros e configurações para a imagem.

Dockerfile é o arquivo de configuração do Docker, parecido com o Vagrantfile como já citei no post anterior.

Ao contrário do Vagrantfile, nós só precisamos do Dockerfile para cirar a imagem, fazer o build e, depois de gerada com as configurações passadas, basta usar a imagem. Não vamos mais precisar do Dockerfile no mesmo diretório da nossa aplicação.

Os comandos no Dockerfile são iguais utilizar Shell Script.

Exemplo de Dockerfile e configuração de um Web Server no Ubuntu

Imagine o seguinte cenário:

Você vai subir um container com a imagem do Ubuntu e instalar e configurar o Servidor Web NGINX.

Nosso Dockerfile pode ficar assim:

FROM ubuntu

MAINTAINER William de Oliveira Souza <w.oliveira542@gmail.com>

RUN apt-get update

RUN apt-get install -y nginx && apt-get clean

ADD ./configs/nginx.conf /etc/nginx/sites-enabled/default

RUN ln -sf /dev/stdout /var/log/nginx/access.log

RUN ln -sf /dev/stderr /var/log/nginx/error.log

RUN echo "daemon off;" >> /etc/nginx/nginx.conf

EXPOSE 8080

ENTRYPOINT [“/usr/sbin/nginx”]

CMD [“start”, “-g”]

Onde:

Imagem base

O parâmetro FROM é a imagem que você vai usar como base para a criação de sua nova imagem.

Você pode usar o nome da imagem, como no exemplo:

FROM ubuntu

Ou com com a tag específica:

FROM ubuntu:latest

Mantenedor da imagem

É a pessoa, empresa ou org que mantém essa imagem.

Quando você criar sua própria imagem para subir no Docker Hub, vai precisar deixar isso como seu contato para o mundo.

MAINTAINER William de Oliveira Souza <w.oliveira542@gmail.com>

Executando comandos no container

Agora as coisas legais.

O comando RUN serve para executar comandos dentro do seu container, assim que você criar ele.

No exemplo, estou atualizando o sistema, instalando o NGINX e depois removendo os pacotes que o sistema não vai precisar (para deixar a imagem mais limpa).

RUN apt-get update

RUN apt-get install -y nginx && apt-get clean

Outra forma de executar comandos via Dockerfile é vista mais abaixo, o ENTRYPOINT junto com o CMD

ENTRYPOINT [“/usr/sbin/nginx”]

CMD [“start”, “-g”]

Aqui estamos inicializando nosso Web Server.

O ENTRYPOINT é quem vai receber os comandos passados pelo CMD. Caso não use o ENTRYPOINT, pode-se passar os comandos somente com o CMD:

CMD service nginx start -g

Adicionando arquivos de configuração no container

Para melhorar a organização, podemos deixar arquivos de configuração dos serviços (Web Server, Banco de Dados, Interpretador, etc) em locais separados.

No exemplo eu usei o arquivo configs/nginx.conf, que será copiado para dentro do container no diretório /etc/nginx/sites-enabled/, com o nome de default.

ADD ./configs/nginx.conf /etc/nginx/sites-enabled/default

O conteúdo do arquivo nginx.conf é o seguinte:

server {
    listen 8080 default_server;
    server_name localhost;

    root /usr/share/nginx/html;
    index index.html index.htm;
}

Só uma configuração basica para o NGINX.

Monitorando os logs do container

Algo interessante que podemos fazer com o Docker é monitorar os logs de uma maneira mais prática. O Docker pega os logs em stdout e stderr. Podemos capturar esses logs e ver de maneira mais rápida (do que entrar pelo container) pelo comando docker logs.

E para deixar isso automático na nossa imagem, deixamos as seguintes linhas no Dockerfile:

RUN ln -sf /dev/stdout /var/log/nginx/access.log

RUN ln -sf /dev/stderr /var/log/nginx/error.log

Nesse caso, estamos capturando os logs do NGINX.

Depois que o container estiver ativo, podemos usar o comando docker logs id_ou_apelido_do_container.

Expondo portas do container

Para expor a porta que o nosso Web Server vai utilizar, usamos o parâmetro EXPOSE com o número da porta:

EXPOSE 8080

Aqui é bem simples, ele vai expor a porta 8080.

Para saber qual porta o host está utilizando como ponte para acesso a porta do container, podemos procurar com o comando:

docker port id_ou_apelido_do_container

Ou usar um:

docker inspect id_ou_apelido_do_container

Na documentação oficial do Docker você encontrará outras informações legais sobre os comandos que podem ser executados no Dockerfile.

Como gerar a nova imagem

Com nosso arquivo Dockfile configurado, podemos gerar nossa nova imagem.

Para tal, execute o comando build:

docker build -t woliveiras/nginx .

O comando build, como o nome diz, é responsável por executar o build da imagem. Com isso vamos criar uma nova imagem com as configurações do nosso Dockerfile.

O -t é um parâmetro para informar que a imagem pertence ao meu usuário.

Em seguida vem o nome da imagem. Aqui coloquei como woliveiras/nginx para ficar fácil de localizar no Docker Hub.

Depois vem o ”."" que significa o diretório corrente, pois eu executei o comando build dentro da pasta onde se encontra meu Dockerfile (para facilitar a vida).

Basta aguardar o processo de build, que pode demorar dependendo de sua conexão, quantos programas você colocou para instalar, etc.

Finalizado o processo, você pode ver sua nova imagem com o comando docker images.

Exportando a imagem para .tar

Você pode querer, agora, carregar essa imagem em um Pen Drive.

Para isso, utilize o comando save:

docker save woliveiras/nginx > /tmp/meu_web_server.tar

Você deve passar o ID da imagem ou o nome.

O Docker vai exportar a imagem e compactar em formato .tar.

Agora você pode carregar por Pen Drive, subir em algum lugar para um amigo baixar (ou você mesmo), etc.

Importando a imagem de um .tar

Como importar essa imagem gerada via comando save?

Usando o comando load.

docker load < /tmp/meu_web_server.tar

O Docker vai importar sua imagem com o nome, tag, etc, que a imagem já possuia antes, não com o nome do arquivo gerado.

Para ver se deu tudo certo, basta rodar o docker images também.

Subindo a imagem para o Docker Hub

Para subir uma imagem para o Docker Hub, primeiro precisará de uma conta no site. Caso não possua, não precisa entrar no site agora (calma apressado(a)), durante o Login, é criado sua conta via Terminal mesmo.

Faça login com sua conta no Terminal usando o comando docker login:

docker login

Para subir a imagem, basta fazer um push, parecido com o nosso querido Git.

docker push nome_da_imagem

Ex.:

docker push woliveiras/nginx

Essa imagem, de exemplo, você pode ver nesse link do Docker Hub e os arquivos de configuração do exemplo (Dockerfile e nginx.conf) nesse repositório.

Gostou desse artigo? Comente aqui em baixo, compartilhe nas redes sociais, com o amigo, chefe, com o irmão, com o cachorro, gato, papagaio…

Espalhe a palavra.

Back to Blog

Related Posts

View All Posts »