WORKDIR

A instrução WORKDIR em um Dockerfile define o diretório de trabalho para qualquer instrução RUN, CMD, ENTRYPOINT, COPY, ou ADD que venha após ela no Dockerfile. Se o diretório especificado não existir, ele será criado automaticamente.

Sintaxe Básica

WORKDIR /caminho/para/diretorio

Funcionalidade

• Definir o Diretório Atual: Após a execução de um comando WORKDIR, todos os comandos subsequentes no Dockerfile são executados nesse diretório, a menos que um comando subsequente altere o diretório de trabalho.

• Criação Automática de Diretórios: Se o caminho especificado no WORKDIR não existir, o Docker o criará automaticamente. Isso permite que você organize melhor o sistema de arquivos do contêiner sem a necessidade de comandos RUN para criar diretórios.

Exemplos de Uso

Definir o Diretório de Trabalho para uma Aplicação

FROM node:14

# Define o diretório de trabalho para a aplicação
WORKDIR /usr/src/app

# Copia os arquivos para o diretório de trabalho
COPY package*.json ./

# Instala as dependências
RUN npm install

# Copia o restante do código
COPY . .

# Expõe a porta e define o comando de inicialização
EXPOSE 3000
CMD ["npm", "start"]

Neste exemplo:

• O WORKDIR /usr/src/app define /usr/src/app como o diretório de trabalho.

• Os comandos COPY, RUN, e CMD subsequentes assumem que o diretório de trabalho atual é /usr/src/app.

Trabalhar com Múltiplos Diretórios

Você pode usar várias instruções WORKDIR para organizar a estrutura do contêiner:

FROM python:3.10

# Definir o diretório para as dependências
WORKDIR /usr/src/dependencies
COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt

# Definir o diretório de trabalho principal
WORKDIR /usr/src/app
COPY . .

CMD ["python", "app.py"]

Neste exemplo:

• A primeira instrução WORKDIR define o diretório /usr/src/dependencies para instalar as dependências.

• Em seguida, um segundo WORKDIR muda o diretório para /usr/src/app para copiar o código da aplicação e definir o comando de inicialização.

Considerações

• Evitando Caminhos Relativos: É uma boa prática usar caminhos absolutos com WORKDIR, pois caminhos relativos podem causar comportamento inesperado.

• Combinando com RUN: Embora você possa usar RUN cd /path/to/dir dentro de um comando RUN, o uso de WORKDIR é preferível, pois permanece ativo para todos os comandos subsequentes e torna o Dockerfile mais legível e organizado.

Comportamento com Múltiplos WORKDIR

Se você definir WORKDIR várias vezes no mesmo Dockerfile, o diretório de trabalho atual será atualizado, mas o comando WORKDIR anterior não será desfeito.

WORKDIR /app
RUN echo "Arquivo criado em /app" > arquivo.txt

WORKDIR /app/subdir
RUN echo "Arquivo criado em /app/subdir" > arquivo_subdir.txt

Nesse exemplo:

• O primeiro comando WORKDIR define /app como o diretório de trabalho.

• O segundo WORKDIR redefine o diretório de trabalho para /app/subdir.

O uso do WORKDIR facilita a construção de imagens Docker organizadas e consistentes, garantindo que os arquivos e comandos sejam sempre executados no contexto certo.

Laboratório

O uso do WORKDIR seria basicamente criar e entrar num diretório:

FROM ubuntu
RUN mkdir /app && cd /app

Se a imagem abaixo for construída e um container for executado baseado nesta imagem, é possível visualizar os diretórios desta distribuição:

FROM ubuntu
RUN apt update && apt install curl --yes

$ docker built -t ubuntu-curl .
$ docker container run -it ubuntu-curl /bin/bash
root@a222fefad9e0:/# pwd
/
root@a222fefad9e0:/# ls
bin   dev  home  lib64  mnt  proc  run   srv  tmp  var
boot  etc  lib   media  opt  root  sbin  sys  usr

Alterando e reconstruindo a imagem para utilizar WORKDIR é possível verificar que o diretório /app foi criado e ao iniciar o container o diretório inicial foi /app ao invés de /:

FROM ubuntu
RUN apt update && apt install curl --yes
WORKDIR /app

 docker built -t ubuntu-curl .
[+] Building 0.2s (7/7) FINISHED                                    docker:default
 => [internal] load build definition from Dockerfile                          0.0s
 => => transferring dockerfile: 102B                                          0.0s
 => [internal] load metadata for docker.io/library/ubuntu:latest              0.0s
 => [internal] load .dockerignore                                             0.0s
 => => transferring context: 2B                                               0.0s
 => [1/3] FROM docker.io/library/ubuntu:latest                                0.0s
 => CACHED [2/3] RUN apt update && apt install curl --yes                     0.0s
 => [3/3] WORKDIR /app                                                        0.1s
 => exporting to image                                                        0.1s
 => => exporting layers                                                       0.0s
 => => writing image sha256:9055b7f6a3abfbf1a284cfc15d502c189848c78b944cdc2c  0.0s
 => => naming to docker.io/library/ubuntu-curl                                0.0s
$ docker container run -it ubuntu-curl /bin/bash
root@9717fcc3173e:/app# pwd
/app
root@9717fcc3173e:/app# ls /
app  boot  etc   lib    media  opt   root  sbin  sys  usr
bin  dev   home  lib64  mnt    proc  run   srv   tmp  var

Destaque para a inclusão do WORKDIR na construção da imagem:

=> [3/3] WORKDIR /app