Como funciona por dentro
O tokenizador CLI trata continuações de linha shell POSIX (`\`), valores entre aspas e flags curtas combinadas (`-dit`), mapeando `-p`, `-v`, `-e`, `--name`, `--restart`, `--network` e comando final para YAML estruturado. A conversão reversa extrai chaves de serviço das seções `services:` do YAML.
Passo a passo de uso
Escolha a direção da conversão (`docker run -> compose.yaml` ou `compose.yaml -> docker run`).
Cole seu comando CLI de contêiner ou sua especificação de serviço Compose YAML.
Verifique eventuais avisos sobre flags de daemon personalizadas não suportadas.
Copie o resultado ou baixe `compose.yaml` / `docker-run.sh` diretamente.
Principais recursos e vantagens
- Trata continuações multilinha `\` do shell e argumentos entre aspas com precisão
- Mapeia portas `-p`, volumes `-v`, variáveis `-e`, `--restart`, `--network` e sobrescritas de comando
- Gera especificação Compose v2 moderna sem a propriedade obsoleta `version:` no topo
- Suporta tradução reversa de serviços `compose.yaml` de volta para comandos `docker run` individuais
- Execução offline mantém URLs de registries privados e variáveis de banco sigilosas
Metodologia, fórmulas e padrões técnicos
A tokenização shell implementa máquina de estados para aspas (`'`, `"`, escapes) antes de resolver pares de flags (`--flag=val` e `--flag val`). A geração de YAML escapa dois-pontos e caracteres shell de forma consistente em blocos de serviço válidos.
Casos de uso práticos
- Migrar comandos `docker run` avulsos de documentações para stacks `compose.yaml` versionadas no Git
- Converter arquivos Compose com vários contêineres de volta em comandos `docker run` avulsos para pipelines de CI
- Revisar rapidamente portas expostas e volumes montados em snippets copiados
- Padronizar templates locais de Postgres/Redis em Compose para novos colegas de equipe
Exemplos resolvidos e casos especiais
Redis CLI -> compose.yaml
docker run -d --name cache -p 6379:6379 -v redis_data:/data redis:7-alpine
services:
cache:
image: redis:7-alpine
ports:
- "6379:6379" Automatically infers the Compose service key from `--name` or image name.
Compose -> Standalone CLI
services:
postgres:
image: postgres:16-alpine
ports: ["5432:5432"] docker run -d -p "5432:5432" postgres:16-alpine
Handy when debugging single containers outside Compose.
Limitações e notas de precisão
- • Chaves avançadas do Compose (`deploy.resources`, condições de healthcheck em `depends_on`, âncoras YAML complexas) são omitidas ou sinalizadas com avisos na tradução reversa para CLI.
- • Verifique senhas em `-e` antes de commitar arquivos YAML gerados no Git.
Processamento local no navegador e privacidade
Conversores comuns enviam seus documentos, códigos ou vídeos para servidores externos. O Conversor Bidirecional Docker Run ↔ Compose YAML roda direto na sua aba:
Seus textos e arquivos são processados localmente sem enviar conteúdo para servidores.
O Microdeck não registra nem armazena arquivos ou dados colados nas ferramentas.
Os resultados ficam apenas na memória do navegador e somem ao fechar ou limpar a aba.
Perguntas frequentes (FAQ)
Por que o `compose.yaml` gerado omite a chave `version:`?
O Docker Compose v2 descontinuou a propriedade `version:` de nível superior; arquivos Compose modernos começam diretamente por `services:`.
Comandos `docker run` em várias linhas com `\` são aceitos?
Sim. Quebras de linha escapadas e argumentos com aspas simples ou duplas são normalizados automaticamente antes da análise.
Um `compose.yaml` com vários serviços pode ser convertido de volta para CLI?
Sim. Cada serviço dentro de `services:` gera seu próprio comando `docker run` independente separado por linha em branco.
Minha URL de imagem privada ou variável de ambiente é registrada em algum lugar?
Não. A tradução roda de forma síncrona no JavaScript do navegador sem nenhuma chamada de servidor.
Outras ferramentas relacionadas
Comparador de .env, Formatador e Gerador de .env.example
Compare arquivos .env lado a lado, ordene chaves e limpe segredos para .env.example
Conversor e Validador YAML, JSON e TOML (3 Vias)
Converta, formate e valide YAML 1.2, JSON e TOML 1.0 offline com segurança
Gerador de .gitignore
Monte arquivos .gitignore limpos para sua stack 100% no navegador