Command
Resumo
- Execute comandos desejados.
Parâmetros
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
argv | list / elements=string | | Transmite 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 de 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 | path | | Mudar de diretório antes de executar o comando. |
cmd | string | | O comando a ser executado. |
creates | path | | Um nome de arquivo ou padrão glob. Se já existir um arquivo correspondente, esta etapa não será executada. |
free_form | string | | O módulo de comando usa uma string de formato livre como um comando para ser executado. Não há nenhum parâmetro real denominado 'formato livre'. |
removes | path | | Um nome de arquivo ou padrão glob. Se houver um arquivo correspondente, esta etapa será executada. |
stdin | string | | Defina o stdin do comando diretamente para o valor especificado. |
stdin_add_newline | boolean | Escolhas: - false - true (default) | Se definido como true, acrescente uma nova linha aos dados stdin. |
strip_empty_ends | boolean | Escolhas: - false - true (default) | Retire as linhas vazias do final de stdout/stderr no resultado. |
warn | boolean | Escolhas: - false - true (default) | Habilite ou desabilite os avisos de tarefa. |
Notes
- Se você deseja executar um comando por meio do shell (digamos que esteja usando <,>, | e assim por diante), a 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 command quando possível.
- Creates, removes e chdir podem ser especificados após o comando. Por exemplo, se você só deseja executar um comando se um determinado arquivo não existir, use-o.
- O modo de verificação é suportado ao passar creates ou removes. Se estiver executando no modo de verificação e qualquer um deles for especificado, o módulo verificará a existência do arquivo e relatará o status alterado correto. Se não forem fornecidos, 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: myoutputValores retornados
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
cmd | list / elements=string | Sempre | O comando executado pela tarefa. |
delta | string | Sempre | O tempo delta de execução do comando. |
end | string | Sempre | A hora do término da execução do comando. |
start | string | Sempre | A hora de início da execução do comando. |