Docker e contêineres

validador de YAML Docker Compose

Revise um documento Compose, suas relações declaradas e as referências ainda não resolvidas.

validador de YAML Docker Compose

Entrada YAML do Compose

Resultados da análise

O YAML fica neste navegador. Sem execução do Docker, leitura de arquivos de ambiente ou requisições de rede.

Opções de revisão

A entrada é visível. Revelar a saída permite exportar YAML com valores originais, inclusive segredos.

Verificação estática: esquema Compose fee041b (01/09/2026). Sem interpolação, arquivos, ativação de perfis ou execução.

Até 200.000 unidades UTF-16, 100 serviços e 500 relações. Exibição em grupos de 50.

A entrada ou as opções mudaram. Analise novamente antes de exportar.

O validador de YAML Docker Compose ajuda a revisar uma mudança antes de iniciar a aplicação. Um arquivo bem indentado ainda pode repetir uma porta do host ou usar um volume que não foi declarado. Os diagnósticos apontam para a origem, enquanto a formatação aparece em uma saída separada e preserva o texto editado.

Por que usar este validador de YAML Docker Compose

Ler as relações sem procurar em vários blocos

O validador de YAML Docker Compose mostra serviços, dependências e origens dos volumes no mesmo fluxo. A seta parte do serviço dependente para seu destino. A condição declarada em depends_on continua visível, mas não indica que um banco de dados tenha passado em um healthcheck ou esteja aceitando conexões.

Três serviços ligados em sequência, com um volume conectado abaixo do banco de dados.

Separar colisões certas de sobreposições possíveis

Destinos internos diferentes podem disputar a mesma porta do host. TCP e UDP são comparados separadamente. Faixas de alocação, curingas IPv4/IPv6 e serviços com perfis recebem avisos conservadores quando a porta final ou o conjunto ativo ainda depende da execução.

Dois serviços apontam para o mesmo socket do host, destacado para revisão.

Da primeira mensagem ao arquivo revisado

01

Corrija primeiro a estrutura

Ao validar arquivo Compose, confira linha e coluna dos erros de sintaxe e o caminho dos campos incompatíveis. As relações dependem de uma estrutura reconhecida. version não muda o motor para uma especificação antiga, pois o esquema é fornecido com uma revisão fixa.

02

Compare o lado do host

Dois contêineres podem usar internamente a porta 80. Observe endereço do host, porta published e protocolo. Variáveis e atribuições automáticas permanecem indefinidas; a análise não inventa uma porta para produzir uma aparente confirmação.

03

Revele os valores para a exportação desejada

O texto de entrada fica visível, mas a saída completa começa oculta. Exibi-la libera a cópia e o download do YAML com valores originais. Desligue a análise automática para usar o botão ou Ctrl/Cmd + Enter. Alterar a entrada bloqueia imediatamente os resultados antigos.

Conferências complementares do mesmo documento

Esquema oficial com regras adicionais

A revisão oficial de 01/09/2026 verifica a estrutura, enquanto regras focadas procuram fontes de serviço ausentes, referências, ciclos e sintaxe das portas. Campos desconhecidos são apontados, nunca apagados silenciosamente. A formatação preserva comentários e âncoras sem reordenar os serviços ou sobrescrever a entrada.

Mapeamentos de portas e volumes nomeados

As duas formas de depends_on, namespaces de serviço, links e volumes_from aparecem como relações. Volumes com nome são comparados às declarações superiores. Caminhos bind são exibidos sem acesso aos arquivos reais, e volumes anônimos continuam distintos de recursos nomeados.

Variáveis de ambiente sem valores secretos

O analisador percorre valores textuais com $VAR, chaves e alternativas aninhadas; $$ escapa o cifrão. Entradas environment sem valor representam passagem pelo shell. A lista remove duplicatas e ordena os nomes. O modelo gera apenas NAME=, sem copiar padrões, mensagens de erro ou senhas dos valores originais.

Exportações para finalidades diferentes

O YAML preserva valores reais e expressões de interpolação. O relatório JSON exclui o documento integral e os valores padrão das variáveis, mas mantém caminhos e relações. As listas mostram 50 registros por vez; cada exportação contém todos os registros dentro dos limites declarados.

O que depende do ambiente de execução

Nenhum contêiner é iniciado
A página não executa Docker, baixa imagens, testa healthchecks nem procura portas ocupadas por outros programas. Um esquema válido não comprova permissões de arquivos, conectividade ou compatibilidade com sua versão. Faça a verificação final no ambiente de destino.
Um documento sem resolução externa
Documentos YAML múltiplos, chaves duplicadas, aliases cíclicos e tags não suportadas são rejeitados. include e extends bloqueiam a exportação da configuração. A página não combina overrides nem lê .env ou env_file. Resolva o projeto localmente antes de colar o resultado consolidado.
Perfis não são ativados
Todos os serviços declarados participam da análise. Sobreposições envolvendo perfis ou faixas de alocação são possíveis conflitos, mesmo que uma combinação específica nunca execute os serviços juntos. Variáveis e portas automáticas ficam sem conclusão fixa. Outros projetos ativos na máquina não são conhecidos.
Ocultar a saída não remove credenciais
A entrada permanece visível. Depois de revelar os valores, o YAML exportado pode conter segredos e só fica disponível sem erros. O modelo ENV sempre deixa valores em branco. É possível baixar um relatório com erros para revisão, mas isso não certifica a configuração.
Há limites de tamanho e de versão
A análise aceita YAML 1.2 com âncoras e merge dentro de 200.000 unidades UTF-16, 100 serviços e 500 relações. A expansão tem teto de 20.000 nós e profundidade 40. O commit do esquema começa com fee041b; campos futuros exigem uma atualização da cópia incluída.
Montagens e prontidão não são simuladas
Bind, volumes nomeados e tmpfs recebem verificações focadas. Outros tipos admitidos pelo esquema são marcados para revisão manual. A ferramenta não testa a existência de caminhos, acessos ou o instante em que uma aplicação ficará pronta. As setas mostram declarações, sem comprovar conexões reais.

Dúvidas sobre o validador de YAML Docker Compose

O uso é gratuito?

Sim. Esta página permite analisar o documento e baixar as saídas sem cobrança pelo uso da ferramenta. Ela não fornece execução de contêineres, hospedagem ou recursos de nuvem; esses serviços não fazem parte da análise.

Onde meus dados são processados?

No worker do navegador. URLs citadas no YAML não são abertas, arquivos externos não são lidos e nenhum daemon Docker é contatado. Os botões de copiar e baixar são ações explícitas, e o modelo ENV não inclui valores secretos.

Que conteúdo posso inserir?

Um documento Compose em YAML 1.2 com services não vazio. Âncoras e chaves de merge são aceitas com limites. Projetos de vários arquivos precisam ser resolvidos antes: colar uma referência include não faz a página buscar ou combinar os arquivos.

Qual é a precisão do resultado?

A estrutura é comparada a uma revisão oficial fixa e algumas relações são verificadas estaticamente. A ferramenta não conhece interpolação, arquivos reais, permissões nem comportamento de execução. Um resultado sem erros ainda precisa ser confrontado com o Compose usado no destino.

Funciona no celular e offline?

A interface se adapta à tela do celular e o processamento acontece localmente depois que os módulos são carregados. O acesso inicial exige rede. Não há instalação de cache offline nem garantia de recarregar a página sem conexão; mantenha os arquivos necessários no seu ambiente de trabalho.

Uma declaração precisa de um diagnóstico mais claro?

Confira as declarações antes de iniciar

Volte ao validador de YAML Docker Compose, resolva os caminhos indicados e confira as portas do host antes de revelar e exportar os valores necessários.