Digite para filtrar os verbetes do Glossário.

    Ferramentas de desenvolvimento · Developer Workspace

    O que é dry run?

    Um dry run mostra ou valida o que um comando faria sem aplicar a alteração prevista. As etapas executadas e os efeitos evitados dependem da ferramenta.

    Também chamado de: dry-run, execução simulada, modo de simulação

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    O que o comando simula

    Um dry run é um modo de execução que mostra ou valida uma alteração sem aplicá-la ao destino, conforme o comportamento documentado pela ferramenta. Você pode usá-lo para examinar a configuração proposta e encontrar erros que o comando consegue detectar nessa etapa.

    A simulação pode consultar um servidor ou executar validações locais. O nome --dry-run não define um comportamento comum a todas as ferramentas. A documentação do npm limita a opção a comandos como install e publish e informa que dist-tags e owner não a respeitam.

    Uma configuração enviada ao Kubernetes

    O comando abaixo é um exemplo didático para um ambiente com o kubectl configurado e permissão para criar um ConfigMap, o objeto que guarda configurações no Kubernetes:

    Terminal
    kubectl create configmap exemplo --from-literal=modo=teste --dry-run=server -o yaml

    A entrada propõe um ConfigMap chamado exemplo com a configuração modo=teste. A opção server envia a proposta ao servidor para processamento e validação. Em caso de sucesso, -o yaml exibe o objeto resultante sem gravá-lo no cluster. A resposta permite examinar os campos aceitos, mas não cria uma configuração disponível para os aplicativos.

    Com --dry-run=client, o kubectl apenas monta o objeto que enviaria. Esse modo não exercita as validações do servidor, portanto uma saída local válida ainda pode ser recusada pelo cluster.

    O que pode mudar na execução posterior

    A simulação no servidor exige autorização equivalente à criação efetiva. O Kubernetes também informa que campos gerados, como identificadores e horários, podem ter valores diferentes quando a alteração for aplicada.

    Outro processo pode modificar o destino depois da simulação. Confira a resposta da execução efetiva e o objeto gravado para saber se a alteração corresponde à proposta examinada.

    Dúvidas frequentes

    Perguntas frequentes sobre dry run

    Todo comando com --dry-run evita qualquer efeito?
    O alcance depende da ferramenta. No npm, por exemplo, comandos como dist-tags e owner não respeitam essa opção. Consulte a documentação do comando para saber quais alterações ele evita.
    Uma simulação bem-sucedida confirma a execução posterior?
    A simulação verifica a proposta nas condições daquele momento. O destino pode mudar depois e algumas etapas podem ficar fora do teste, por isso você ainda precisa conferir o resultado aplicado.
    O dry run dispensa autorização no Kubernetes?
    A simulação no servidor exige a mesma autorização da requisição que gravaria a alteração. A opção client do kubectl monta o objeto localmente e não o envia ao servidor.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Developer Workspace

    A simulação permite conferir a configuração proposta e interpretar as validações executadas pelo comando.

    Conhecer a formação
    Capa da Formação Developer Workspace

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano