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
**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)
# agent\$1report
**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).
Devolve um relatório de agente.
```
sudo opsworks-agent-cli agent_report
```
O exemplo de saída a seguir é de uma instância que, mais recentemente, executou uma atividade configurada.
```
$ sudo opsworks-agent-cli agent_report
AWS OpsWorks Instance Agent State Report:
Last activity was a "configure" on 2015-12-01 18:19:23 UTC
Agent Status: The AWS OpsWorks agent is running as PID 30998
Agent Version: 4004-20151201152533, up to date
```
# get\$1json
**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).
Devolve informações sobre uma execução do Chef com um objeto JSON.
```
sudo opsworks-agent-cli get_json [activity] [date] [-i | --internal | --no-i | --no-internal]
```
Por padrão, `get_json` exibe informações fornecidas por cliente para a execução do Chef mais recente. Use as seguintes opções para especificar um conjunto particular de informações.
**atividade**
Exibe informações para a execução do Chef associadas com a atividade especificada mais recente. Para obter uma lista de atividades válida, execute [list\$1commands](agent-list.md).
**data**
Exibe informações para a execução do Chef associadas com a atividade executada para o timestamp especificado. Para obter uma lista de timestamps válidos, execute [list\$1commands](agent-list.md).
**-i, --internal**
Exibe informações que o OpsWorks Stacks usa internamente para a execução do Chef.
**--no-i, --no-internal**
Exibe explicitamente informações fornecidas por cliente para a execução do Chef. Esse é o padrão se outro não for especificado.
**nota**
Para instâncias do Chef 12 Linux, executar esse comando retornará informações válidas como a configuração da pilha da instância e implantação de atributos. No entanto, para obter informações mais completas, consulte os pacotes de dados do Chef que o OpsWorks Stacks cria na instância. Para obter mais informações, consulte o [OpsWorks Referência do Stacks Data Bag](data-bags.md).
O exemplo de saída a seguir mostra as informações fornecidas pelo cliente para a execução do Chef mais recente da atividade de configuração mais recente.
```
$ sudo opsworks-agent-cli get_json configure
{
"run_list": [
"recipe[opsworks_cookbook_demo::configure]"
]
}
```
O exemplo de saída a seguir mostra as informações que o OpsWorks Stacks usa internamente para a execução do Chef executada no timestamp especificado.
```
$ sudo opsworks-agent-cli get_json 2015-12-01T18:20:24 -i
{
"aws_opsworks_agent": {
"version": "4004-20151201152533",
"valid_client_activities": [
"reboot",
"stop",
"deploy",
"grant_remote_access",
"revoke_remote_access",
"update_agent",
"setup",
"configure",
"update_dependencies",
"install_dependencies",
"update_custom_cookbooks",
"execute_recipes",
"sync_remote_users"
],
"command": {
"type": "configure",
"args": {
"app_ids": [
]
},
"sent_at": "2015-12-01T18:19:23+00:00",
"command_id": "5c2113f3-c6d5-40eb-bcfa-77da2885eeEX",
"iam_user_arn": null,
"instance_id": "cfdaa716-42fe-4e3b-9762-fef184ddd8EX"
},
"resources": {
"apps": [
],
"layers": [
{
"layer_id": "93f50d83-1e73-45c4-840a-0d4f07cda1EX",
"name": "MyCookbooksDemoLayer",
"packages": [
],
"shortname": "cookbooks-demo",
"type": "custom",
"volume_configurations": [
]
}
],
"instances": [
{
"ami_id": "ami-d93622EX",
"architecture": "x86_64",
"auto_scaling_type": null,
"availability_zone": "us-west-2a",
"created_at": "2015-11-18T00:21:05+00:00",
"ebs_optimized": false,
"ec2_instance_id": "i-a480e960",
"elastic_ip": null,
"hostname": "cookbooks-demo1",
"instance_id": "cfdaa716-42fe-4e3b-9762-fef184ddd8EX",
"instance_type": "c3.large",
"layer_ids": [
"93f50d83-1e73-45c4-840a-0d4f07cda1EX"
],
"os": "Amazon Linux 2015.09",
"private_dns": "ip-192-0-2-0.us-west-2.compute.internal",
"private_ip": "10.122.69.33",
"public_dns": "ec2-203-0-113-0.us-west-2.compute.amazonaws.com",
"public_ip": "192.0.2.0",
"root_device_type": "ebs",
"root_device_volume_id": "vol-f6f7e8EX",
"ssh_host_dsa_key_fingerprint": "f2:...:15",
"ssh_host_dsa_key_public": "ssh-dss AAAAB3Nz...a8vMbqA=",
"ssh_host_rsa_key_fingerprint": "0a:...:96",
"ssh_host_rsa_key_public": "ssh-rsa AAAAB3Nz...yhPanvo7",
"status": "online",
"subnet_id": null,
"virtualization_type": "paravirtual",
"infrastructure_class": "ec2",
"ssh_host_dsa_key_private": "-----BEGIN DSA PRIVATE KEY-----\nMIIDVwIB...g5OtgQ==\n-----END DSA PRIVATE KEY-----\n",
"ssh_host_rsa_key_private": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIB...78kprtIw\n-----END RSA PRIVATE KEY-----\n"
}
],
"users": [
],
"elastic_load_balancers": [
],
"rds_db_instances": [
],
"stack": {
"arn": "arn:aws:opsworks:us-west-2:80398EXAMPLE:stack/040c3def-b2b4-4489-bb1b-e08425886fEX/",
"custom_cookbooks_source": {
"type": "s3",
"url": "https://s3.amazonaws.com/amzn-s3-demo-bucket/opsworks-cookbook-demo.tar.gz",
"username": "AKIAJUQN...WG644EXA",
"password": "O5v+4Zz+...rcKbFTJu",
"ssh_key": null,
"revision": null
},
"name": "MyCookbooksDemoStack",
"region": "us-west-2",
"stack_id": "040c3def-b2b4-4489-bb1b-e08425886fEX",
"use_custom_cookbooks": true,
"vpc_id": null
},
"ecs_clusters": [
],
"volumes": [
]
},
"chef": {
"customer_recipes": [
"opsworks_cookbook_demo::configure"
],
"customer_json": "e30=\n",
"customer_data_bags": "e30=\n"
}
}
}
```
# instance\$1report
**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).
Devolve um relatório de instância estendido.
```
sudo opsworks-agent-cli instance_report
```
O seguinte exemplo de saída e de uma instância.
```
$ sudo opsworks-agent-cli instance_report
AWS OpsWorks Instance Agent State Report:
Last activity was a "configure" on 2015-12-01 18:19:23 UTC
Agent Status: The AWS OpsWorks agent is running as PID 30998
Agent Version: 4004-20151201152533, up to date
OpsWorks Stack: MyCookbooksDemoStack
OpsWorks Layers: MyCookbooksDemoLayer
OpsWorks Instance: cookbooks-demo1
EC2 Instance ID: i-a480e9EX
EC2 Instance Type: c3.large
Architecture: x86_64
Total Memory: 3.84 Gb
CPU: 2x Intel(R) Xeon(R) CPU E5-2680 v2 @ 2.80GHz
Location:
EC2 Region: us-west-2
EC2 Availability Zone: us-west-2a
Networking:
Public IP: 192.0.2.0
Private IP: 198.51.100.0
```
# list\$1commands
**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).
Lista o tempo em que cada atividade foi executada nessa instância. Você pode usar esses momentos para outros comandos de ILC de agente especificarem uma execução em particular.
```
sudo opsworks-agent-cli list_commands [activity] [date]
```
O exemplo de saída a seguir é de uma instância que executou atividades dos livros de receitas personalizadas de definição, configuração e atualização.
```
$ sudo opsworks-agent-cli list_commands
2015-11-24T21:00:28 update_custom_cookbooks
2015-12-01T18:19:09 setup
2015-12-01T18:20:24 configure
```
# run\$1command
**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).
Executa um comando OpsWorks Stacks, que é um arquivo JSON contendo uma lista de execução do Chef que contém as informações necessárias para executar uma atividade do OpsWorks Stacks (instalação, configuração, implantação e assim por diante). O comando `run_command` gera uma entrada de log que você pode ver executando [show\$1log](agent-show.md). Essa opção é destinada apenas para fins de desenvolvimento, portanto, o OpsWorks Stacks não rastreia as alterações.
```
sudo opsworks-agent-cli run_command [activity] [date] [/path/to/valid/json.file]
```
Por padrão, `run_command` executa o comando OpsWorks Stacks mais recente. Use as seguintes opções para especificar um comando particular.
**atividade**
Execute um comando OpsWorks Stacks especificado:`setup`,`configure`,`deploy`,`undeploy`, `start``stop`, ou`restart`.
**data**
Execute o OpsWorks comando da AWS executado no timestamp especificado. Para obter uma lista de timestamps válidos, execute [list\$1commands](agent-list.md).
**file**
Executa o arquivo JSON do comando especificado. Para obter um caminho de arquivo de comando, execute [get\$1json](agent-json.md).
O exemplo de saída a seguir é de uma instância e executa o comando de configuração.
```
$ sudo opsworks-agent-cli run_command configure
[2015-12-02 16:52:53] INFO [opsworks-agent(21970)]: About to re-run 'configure' from 2015-12-01T18:20:24
...
[2015-12-02 16:53:02] INFO [opsworks-agent(21970)]: Finished Chef run with exitcode 0
```
# show\$1log
**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).
Devolve um arquivo de log de comando.
```
sudo opsworks-agent-cli show_log [activity] [date]
```
Por padrão, `show_log` segue o arquivo de log mais recente. Use as seguintes opções para especificar um comando particular.
**atividade**
Exibe o arquivo de log da atividade especificada.
**data**
Exibe o arquivo de log da atividade executada no timestamp especificado. Para obter uma lista de timestamps válidos, execute [list\$1commands](agent-list.md).
O exemplo de saída a seguir exibe o log mais recentes.
```
$ sudo opsworks-agent-cli show_log
[2015-12-02T16:52:59+00:00] INFO: Storing updated cookbooks/opsworks_cookbook_demo/opsworks-cookbook-demo.tar.gz in the cache.
...
[2015-12-02T16:52:59+00:00] INFO: Report handlers complete
```
# stack\$1state
**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).
Exibe informações que o OpsWorks Stacks usa internamente para a execução mais recente do Chef.
```
opsworks-agent-cli stack_state
```
**nota**
Para instâncias do Chef 12 Linux, executar esse comando retornará informações válidas como a configuração da pilha da instância e implantação de atributos. No entanto, para obter informações mais completas, consulte os pacotes de dados do Chef que o OpsWorks Stacks cria na instância. Para obter mais informações, consulte o [OpsWorks Referência do Stacks Data Bag](data-bags.md).
O seguinte exemplo de saída e de uma instância.
```
$ sudo opsworks-agent-cli stack_state
{
"last_command": {
"sent_at": "2015-12-01T18:19:23+00:00",
"activity": "configure"
},
"instance": {
"ami_id": "ami-d93622EX",
"architecture": "x86_64",
"auto_scaling_type": null,
"availability_zone": "us-west-2a",
"created_at": "2015-11-18T00:21:05+00:00",
"ebs_optimized": false,
"ec2_instance_id": "i-a480e9EX",
"elastic_ip": null,
"hostname": "cookbooks-demo1",
"instance_id": "cfdaa716-42fe-4e3b-9762-fef184ddd8EX",
"instance_type": "c3.large",
"layer_ids": [
"93f50d83-1e73-45c4-840a-0d4f07cda1EX"
],
"os": "Amazon Linux 2015.09",
"private_dns": "ip-192-0-2-0.us-west-2.compute.internal",
"private_ip": "10.122.69.33",
"public_dns": "ec2-203-0-113-0.us-west-2.compute.amazonaws.com",
"public_ip": "192.0.2.0",
"root_device_type": "ebs",
"root_device_volume_id": "vol-f6f7e8EX",
"ssh_host_dsa_key_fingerprint": "f2:...:15",
"ssh_host_dsa_key_public": "ssh-dss AAAAB3Nz...a8vMbqA=",
"ssh_host_rsa_key_fingerprint": "0a:...:96",
"ssh_host_rsa_key_public": "ssh-rsa AAAAB3Nz...yhPanvo7",
"status": "online",
"subnet_id": null,
"virtualization_type": "paravirtual",
"infrastructure_class": "ec2",
"ssh_host_dsa_key_private": "-----BEGIN DSA PRIVATE KEY-----\nMIIDVwIB...g5OtgQ==\n-----END DSA PRIVATE KEY-----\n",
"ssh_host_rsa_key_private": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIB...78kprtIw\n-----END RSA PRIVATE KEY-----\n"
},
"layers": [
{
"layer_id": "93f50d83-1e73-45c4-840a-0d4f07cda1EX",
"name": "MyCookbooksDemoLayer",
"packages": [
],
"shortname": "cookbooks-demo",
"type": "custom",
"volume_configurations": [
]
}
],
"applications": null,
"stack": {
"arn": "arn:aws:opsworks:us-west-2:80398EXAMPLE:stack/040c3def-b2b4-4489-bb1b-e08425886fEX/",
"custom_cookbooks_source": {
"type": "s3",
"url": "https://s3.amazonaws.com/amzn-s3-demo-bucket/opsworks-cookbook-demo.tar.gz",
"username": "AKIAJUQN...WG644EXA",
"password": "O5v+4Zz+...rcKbFTJu",
"ssh_key": null,
"revision": null
},
"name": "MyCookbooksDemoStack",
"region": "us-west-2",
"stack_id": "040c3def-b2b4-4489-bb1b-e08425886fEX",
"use_custom_cookbooks": true,
"vpc_id": null
},
"agent": {
"valid_activities": [
"reboot",
"stop",
"deploy",
"grant_remote_access",
"revoke_remote_access",
"update_agent",
"setup",
"configure",
"update_dependencies",
"install_dependencies",
"update_custom_cookbooks",
"execute_recipes",
"sync_remote_users"
]
}
}
```