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:
kubectl create configmap exemplo --from-literal=modo=teste --dry-run=server -o yamlA 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
Documentação
Kubernetes: dry run na API
Explica as etapas da simulação no servidor, as permissões exigidas e os campos que podem variar na execução posterior.
Abrir recursoDocumentação
npm: opção dry-run
Lista os comandos do npm que respeitam dry-run e as exceções entre os comandos de rede.
Abrir recursoDocumentação
Kubernetes: criar um ConfigMap
Documenta a entrada do exemplo e a diferença entre as opções client e server.
Abrir recursoAplicaçã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
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.