Comando
Resumo
- Execute os comandos desejados.
Paramêtros
Paramêtros | Tipos | Escolhas Valor Padrão | Comentários |
|---|---|---|---|
argv | lista / elementos = strings | | Transmita o comando como uma lista em vez de uma string. Use argv para evitar citar valores que, de outra forma, seriam interpretados incorretamente (por exemplo "nome do usuário"). Apenas a forma de string (forma livre) ou de lista (argv) pode ser fornecida, não ambas. Um ou outro deve ser fornecido. |
chdir | caminho | | Mudar o diretório antes de executar o comando. |
comando | corda | | O comando será executado. |
cria | caminho | | Um nome ou arquivo de padrão glob. Se já existr um arquivo correspondente, está etapa não será realizada. |
forma livre | corda | | O módulo de comando usa uma string de formato livre como um comando para ser executado. Não há nenhum paramêtro real denominado "formato livre". |
remove | caminho | | Um nonme de arquivo ou padrão glob. Se houver um arquivo correspondente, está etapa será realizada. |
padrão | corda | | Defina o stdin do comando diretamente para o valor especificado. |
stdin_add_nova_lina | boleano | Escolhas: -verdadeiro -falso (padrão) | SE definido como verdadeiro, a estação atmosférica é uma nova linha aos dados stdin. |
strip_empty_ends | boolean | Escolhas: -verdadeiro -falso (padrão) | Retire as linhas vazias do final de stdout/stderr no resultado. |
warn | boolean | Escolhas: -verdadeiro -falso (padrão) | Habilite ou desabilite os avisos de tarefa. |
Notas
- Se você deseja executar um comando por meio do shell (digamos que usamos <,>,| e assim por diante) uma análise de metacaracteres do shell pode fazer com que comandos inesperados sejam executados se a cotação não for feita corretamente, portanto é mais seguro usar o módulo de comando quando possível.
- Crie, remova e chdir podem ser especifucados após o comando. Poe exemplo, se você deseja executar um comando, se um determinado arquivo não existir, use-o.
- O modo de verificação é suportado após passar cria ou remove. Se você estiver executando no mode de verificação, e qualquer um deles especificados, o módulo verifcará a existência do arquivo e relatará o status alterado correto. Se não for entregue, a tarefa será ignorada.
Exemplos
# Exemplo: Retornar motd para variável registrada - command: cat /etc/motd register: mymotd # Exemplo: Execute o comando se /path/to/database não existir (sem a palavra-chave 'args'). - command: /usr/bin/make_database.sh db_user db_name creates=/path/to/database # 'args' é uma palavra-chave de tarefa, passada no mesmo nível que o módulo # Exemplo: Execute o comando se /path/to/database não existir (com a palavra-chave 'args'). - command: /usr/bin/make_database.sh db_user db_name args: creates: /path/to/database # 'cmd' é um parâmetro do módulo # Exemplo: Execute o comando se /path/to/database não existir (com o parâmetro 'cmd'). - command: cmd: /usr/bin/make_database.sh db_user db_name creates: /path/to/database # Exemplo: Altere o diretório de trabalho para somedir/ e, # execute o comando como db_owner se /path/to/database não existir. - command: /usr/bin/make_database.sh db_user db_name become: yes become_user: db_owner args: chdir: somedir/ creates: /path/to/database # 'argv' é um parâmetro, identado um nível do módulo # Exemplo: Use 'argv' para enviar um comando como uma lista - deixe o 'command' vazio - command: argv: - /usr/bin/make_database.sh - Username with whitespace - dbname with whitespace # Exemplo: Use com segurança a variável de modelo para executar o comando. Sempre use o filtro de cotação para evitar problemas de injeção. - command: cat {{ myfile|quote }} register: myoutput
Valores devolvidos
Chave | Tipo | Retornando quando | Descrição |
|---|---|---|---|
comando | lista/ elementos=string | Sempre | O comando executado pela tarefa |
delta | corda | Sempre | O tempo delta de execuação do comando |
fim começar | corda | Sempre | A hora de término de execução do comando |
| corda | Sempre | A hora de início de execução do comando |
| | | |
| | | |