Command

5 min

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: myoutput

Valores 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.