Formatador de Dockerfile
Formate um Dockerfile e receba sugestões de boas práticas e lint.
Seu Dockerfile é formatado e passa pelo lint localmente no seu navegador, e nada do que você cola é enviado para um servidor.
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
- Cole seu Dockerfile na caixa de entrada.
- Leia a saída limpa e com instruções em maiúsculas no painel de Dockerfile Formatado.
- Revise as verificações de boas práticas abaixo da saída para sugestões WARN e TIP.
- 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
Todas as ferramentas de ArrayKit