Criando imagens
O Docker pode construir automaticamente imagens lendo as instruções de um arquivo Dockerfile
.
Dockerfile
O arquivo Dockerfile
funciona como uma receita de bolo contendo as instruções de configuração para a configuração e execução do seu contêiner.
Neste exemplo, criaremos uma imagem de servidor web que exibirá uma página personalizada.
Servidor web
Crie uma pasta para armazenar os arquivos necessários para nossa imagem:
# acesando o home do usuário
$ cd ~
# criando a pasta
$ mkdir web
# entrando na pasta criada
$ cd web
Crie um arquivo chanado index.html
com o seguinte conteúdo:
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Página em manutenção</title>
</head>
<body>
<article>
<h1>Página de Teste!</h1>
<div>
<p>Esta é uma página de teste.</p>
</div>
</article>
</body>
</html>
Crie um arquivo chamado Dockerfile
com o seguinte conteúdo:
# imagem base
FROM ubuntu:oracular
# atualizando os pacotes e instalando o pacote nginx (servidor web)
RUN apt update && apt install -y nginx
# expondo a porta onde será executado o serviço no container
EXPOSE 80
# copiando o arquivo local para pasta dentro do container
COPY index.html /var/www/html
# comando que é executado, por padrao, quando o container se inicia
CMD ["nginx", "-g", "daemon off;"]
Criando a imagem
Dentro da pasta contendo o Dockerfile
, execute o comando de build:
$ docker build -t nginx-treinamento .
Em caso de sucesso, você verá algo como:
Successfully(...)
built=> a7ebfbdaa6ec=> Successfullywriting taggedimage sha256:4ba7dcc4bf31d3a97cee54016702f9565b5c203f62d624136b7cdc3e0cf9090d 0.0s
=> => naming to docker.io/library/nginx-treinamento:latesttreinamento
A imagem docker foi criada com o nome docker.io/library/nginx-treinamento
ou simplesmente nginx-treinamento:latest
.
nginx-treinamento
: nome da imagemlatest
: tag da imagem
Quando listamos as imagens, o nome do repositório padrão docker.io/library/
é suprimido.
Executando a imagem
Execute o seguinte comando:
$ docker run \
-it \
-d \
--name="web" \
-p 9595:80 \
--restart="always" \
nginx-treinamento
Observação: caso deseje executar o container em outra porta (Exemplo: 9090) altere a linha -p
para:
-p 9090:80
Listando os contêiners ativos:
$ docker ps
Você verá algo como:
CONTAINER_ID | IMAGE | COMMAND | CREATED | STATUS | PORTS |
---|---|---|---|---|---|
14a72c95d77b | nginx-treinamento | "nginx -g 'daemon ..." | 1 minute ago | Up | 0.0.0.0:9595->80 |
Para testar, acesse pelo navegador o endereço: http://localhost:9595/.
Removendo o contêiner
Após finalizar os testes, remova o contêiner:
$ docker rm -f web