As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# OpsWorks CLI do Stacks Agent
<a name="agent"></a>

**Importante**  
O AWS OpsWorks Stacks serviço chegou ao fim da vida útil em 26 de maio de 2024 e foi desativado para clientes novos e existentes. É altamente recomendável que os clientes migrem suas cargas de trabalho para outras soluções o mais rápido possível. Se você tiver dúvidas sobre migração, entre em contato com a AWS Support equipe no [AWS re:POST](https://repost.aws/) ou por meio do Premium [AWS Support](https://aws.amazon.com/support).

**nota**  
Esse recurso está disponível apenas em instâncias do Linux.

O agente que o OpsWorks Stacks instala em cada instância expõe uma interface de linha de comando (CLI). Se [usar SSH para entrar](workinginstances-ssh.md) na instância, você pode usar a ILC para o seguinte: 
+ Acessar arquivos de log para execuções do Chef. 
+ Comandos do Access OpsWorks Stacks.
+ Executar receitas do Chef manualmente.
+ Ver relatórios de instância.
+ Ver relatórios de agente.
+ Ver um conjunto limitado de atributos de configuração e implantação da pilha. 

**Importante**  
Você pode executar comandos ILC de agente apenas como raiz ou usando `sudo`.

A sintaxe de comando básica é:

```
sudo opsworks-agent-cli [--help] [command [activity] [date]]
```

Os quatro argumentos são os seguintes:

**help**  
(Opcional) Exibe uma breve sinopse dos comandos disponíveis quando usado por ele mesmo. Quando usado com um comando, `help` exibe uma descrição do comando.

**command**  
(Opcional) O comando de ILC do agente, que deve ser definido para um dos seguintes:  
+ [agent\$1report](agent-report.md)
+ [get\$1json](agent-json.md)
+ [instance\$1report](agent-instance.md)
+ [list\$1commands](agent-list.md)
+ [run\$1command](agent-run.md)
+ [show\$1log](agent-show.md)
+ [stack\$1state](agent-stack.md)

**atividade**  
(Opcional) Usado como um argumento com alguns comandos para especificar uma determinada atividade do OpsWorks Stacks: `setup`, `configure`, `deploy`, `undeploy`, `start`, `stop` ou `restart`. 

**data**  
(Opcional) Usado como um argumento com alguns comandos para especificar uma execução de comando do OpsWorks Stacks. Especifique a execução do comando definindo a **data** do carimbo de data/hora em que o comando foi executado no *yyyy-mm-ddThh:mm:ss* formato, incluindo as aspas simples. Por exemplo, para às 10:31:55 de 5 de fevereiro na terça-feira de 2013, use: `'2013-02-05T10:31:55'`. Para determinar quando um determinado comando do OpsWorks Stacks foi executado, execute[list\$1commands](agent-list.md).

**nota**  
Se o agente executou a mesma atividade do OpsWorks Stacks várias vezes, você pode escolher uma execução específica especificando a atividade e a hora em que ela foi executada. Você especifica uma atividade e omite o tempo, o comando da ILC do agente age na execução mais recente da atividade. Você omite os argumentos, o comando da ILC do agente age na atividade mais recente.

As seguintes seções descrevem os comandos e seus argumentos associados. Para ser sucinto, as seções de sintaxe omitem a opção de `--help` opcional, que pode ser usada com qualquer comando.

**Topics**
+ [agent\$1report](agent-report.md)
+ [get\$1json](agent-json.md)
+ [instance\$1report](agent-instance.md)
+ [list\$1commands](agent-list.md)
+ [run\$1command](agent-run.md)
+ [show\$1log](agent-show.md)
+ [stack\$1state](agent-stack.md)