Formatador de Dockerfile Online: Lint e Limpeza

Formatador de Dockerfile que coloca instruções em maiúsculas, organiza espaços e sinaliza problemas de boas práticas.

Seu Dockerfile é formatado e passa pelo lint localmente no seu navegador, e nada do que você cola é enviado para um servidor.

Criado e mantido por Udit Agarwal

Gerenciando o contexto de build? Gere um .gitignore com o Gitignore Generator.

Sobre Formatador de Dockerfile

Este formatador de dockerfile limpa seu Dockerfile e o verifica contra as boas práticas do Docker em uma única passada. Cole um Dockerfile e ele normaliza cada palavra-chave de instrução para maiúsculas, remove espaços em branco ao final e colapsa linhas em branco repetidas para que o arquivo fique consistente. Atuando como um linter de dockerfile leve, ele também sinaliza problemas comuns: tags de imagem base sem fixação, ADD onde COPY seria adequado, instalações de apt-get sem --no-install-recommends, caches de apt restantes, uso de sudo, cd dentro de RUN, camadas RUN combináveis e containers rodando como root. Foi feito para desenvolvedores e engenheiros de DevOps que querem formatar um Dockerfile online e melhorar os builds de imagem seguindo as boas práticas de dockerfile antes de fazer commit. Tudo roda localmente no seu navegador, então o Dockerfile que você cola é processado na sua máquina e seus dados nunca saem do seu dispositivo.

Recursos

  • Coloca cada instrução do Dockerfile em maiúsculas (FROM, RUN, COPY, CMD e mais) para um estilo consistente
  • Remove espaços em branco ao final e colapsa linhas em branco repetidas
  • Avisa quando uma imagem base usa :latest ou não tem tag fixada
  • Sugere COPY em vez de ADD para arquivos locais
  • Recomenda --no-install-recommends e limpeza do cache do apt para reduzir as imagens
  • Sinaliza uso de sudo e containers que rodam como root sem nenhum USER definido
  • Detecta etapas RUN consecutivas que podem ser combinadas para reduzir camadas
  • Mostra cada sugestão com um selo WARN ou TIP e o número da linha

Como usar Formatador de Dockerfile

  1. Cole seu Dockerfile na caixa de entrada.
  2. Leia a saída limpa e com instruções em maiúsculas no painel de Dockerfile Formatado.
  3. Revise as verificações de boas práticas abaixo da saída para sugestões WARN e TIP.
  4. Aplique as correções que quiser, depois copie ou baixe o resultado como um Dockerfile.

Exemplo

Entrada

from node:latest
run apt-get update && apt-get install curl
copy . .
cmd ["node","app.js"]

Saída

FROM node:latest
RUN apt-get update && apt-get install curl
COPY . .
CMD ["node","app.js"]

As instruções são colocadas em maiúsculas e organizadas; o painel de verificações ainda avisa para fixar a tag do node, adicionar --no-install-recommends e definir um USER não-root.

Erros comuns e solução de problemas

  • A saída parece idêntica à sua entrada. — O formatador apenas normaliza o caso, os espaços em branco e as linhas em branco. Se suas instruções já estavam em maiúsculas e limpas, não há nada a mudar. Confira o painel de boas práticas para sugestões em vez disso.
  • O lint sinaliza ADD mesmo quando você está baixando uma URL ou extraindo um arquivo compactado. — O aviso de COPY em vez de ADD é ignorado para ADD com URLs http(s) e para arquivos .tar/.gz/.tgz/.bz2/.xz/.zip. Para arquivos locais simples, mude para COPY para resolver o aviso.
  • Um aviso de USER aparece mesmo depois de você ter mudado para um usuário não-root. — A verificação procura uma instrução USER em qualquer parte do arquivo. Garanta que a linha comece com a palavra-chave USER e não esteja comentada para que seja reconhecida.
  • Continuações de linha ou linhas incomuns ficam intactas. — Linhas que não são reconhecidas como instruções, como continuações com contrabarra, são mantidas como estão de propósito para não quebrar comandos RUN de várias linhas.

Perguntas frequentes

O que é o Formatador de Dockerfile da ArrayKit e o que ele muda?
É um formatador de dockerfile no navegador que coloca cada palavra-chave de instrução em maiúsculas, remove espaços em branco ao final e colapsa várias linhas em branco em uma só. Ele não reescreve nem reordena seus comandos, então sua lógica de build permanece intacta.
Como faço o lint do meu Dockerfile para boas práticas com esta ferramenta?
Basta colar seu Dockerfile. Junto da formatação, ele executa verificações para tags base sem fixação, ADD vs COPY, flags do apt-get e limpeza de cache, uso de sudo, cd em RUN, camadas RUN combináveis e execução como root, exibidas como sugestões WARN e TIP com números de linha.
Por que o Formatador de Dockerfile está me avisando para fixar a tag da minha imagem base?
Usar :latest ou nenhuma tag significa que seu build pode mudar inesperadamente quando a imagem base for atualizada. Fixar uma tag específica, como node:20-alpine, torna os builds reproduzíveis.
Posso baixar o Dockerfile formatado?
Sim, você pode copiar a saída ou baixá-la como um Dockerfile simples diretamente do painel de saída formatada.
Meu Dockerfile é enviado para algum lugar quando uso este formatador?
Não. O formatador de dockerfile roda inteiramente no seu navegador e o arquivo que você cola é processado localmente, então seus dados nunca saem do seu dispositivo e nada é enviado para um servidor.

Ferramentas relacionadas

Mais ferramentas de Formatadores de código

Ver todas as ferramentas de Formatadores de código (32) · Todas as ferramentas