Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# OpsWorks CLI de Stacks Agent
**importante**
El AWS OpsWorks Stacks servicio llegó al final de su vida útil el 26 de mayo de 2024 y se ha desactivado tanto para los clientes nuevos como para los existentes. Recomendamos encarecidamente a los clientes que migren sus cargas de trabajo a otras soluciones lo antes posible. Si tienes preguntas sobre la migración, ponte en contacto con el AWS Support equipo en [AWS Re:post](https://repost.aws/) o a través de Premium [AWS Support](https://aws.amazon.com/support).
**nota**
Esta característica solo está disponible en instancias Linux.
El agente que OpsWorks Stacks instala en cada instancia expone una interfaz de línea de comandos (CLI). Si [utiliza SSH para iniciar sesión](workinginstances-ssh.md) en la instancia, puede utilizar la CLI para hacer lo siguiente:
+ Obtener acceso a archivos de registro para ejecuciones de Chef
+ OpsWorks Accede a los comandos de Stacks.
+ Ejecutar recetas de Chef manualmente
+ Ver informes de instancias
+ Ver informes del agente
+ Ver un conjunto limitado de atributos de configuración e implementación de la pila
**importante**
Solo puede ejecutar los comandos de la CLI del agente como raíz o mediante `sudo`.
La sintaxis básica del comando es:
```
sudo opsworks-agent-cli [--help] [command [activity] [date]]
```
Los cuatro argumentos son los siguientes:
**help**
(Opcional) Muestra un breve resumen de los comandos disponibles cuando se utiliza solo. Si se utiliza con un comando, `help` muestra una descripción del comando.
**command**
(Opcional) Es el comando de la CLI del agente, que debe definirse con uno de los siguientes valores:
+ [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)
**activity**
(Opcional) Se utiliza como argumento con algunos comandos para especificar una actividad de OpsWorks Stacks determinada: `setup`, `configure`, `deploy`, `undeploy`, `start`, `stop` o bien `restart`.
**date**
(Opcional) Se utiliza como argumento con algunos comandos para especificar una ejecución de comandos de OpsWorks Stacks determinada. Especifique la ejecución del comando configurando la **fecha** y hora en que se ejecutó el comando en el *yyyy-mm-ddThh:mm:ss* formato, incluidas las comillas simples. Por ejemplo, para indicar las 10:31:55 del martes 5 de febrero de 2013, utilice: `'2013-02-05T10:31:55'`. Para determinar cuándo se ejecutó un comando OpsWorks de Stacks en particular, ejecute. [list\$1commands](agent-list.md)
**nota**
Si el agente ha ejecutado la misma actividad de OpsWorks Stacks varias veces, puedes elegir una ejecución concreta especificando tanto la actividad como la hora en que se ejecutó. Si especifica una actividad y omite el momento en que se ejecutó, el comando de la CLI del agente actuará según la ejecución más reciente de la actividad. Si omite ambos argumentos, el comando de la CLI del agente actuará en la actividad más reciente.
En la siguiente sección se describen los comandos y sus argumentos asociados. Para abreviar, las secciones de sintaxis omiten la opción `--help`, que se puede utilizar con cualquier 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**
El AWS OpsWorks Stacks servicio llegó al final de su vida útil el 26 de mayo de 2024 y se ha desactivado tanto para los clientes nuevos como para los existentes. Recomendamos encarecidamente a los clientes que migren sus cargas de trabajo a otras soluciones lo antes posible. Si tienes preguntas sobre la migración, ponte en contacto con el AWS Support equipo en [AWS Re:post](https://repost.aws/) o a través de Premium [AWS Support](https://aws.amazon.com/support).
Devuelve un informe del agente.
```
sudo opsworks-agent-cli agent_report
```
El siguiente ejemplo de salida procede de una instancia que acaba de ejecutar la actividad configure.
```
$ 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**
El AWS OpsWorks Stacks servicio llegó al final de su vida útil el 26 de mayo de 2024 y se ha desactivado tanto para los clientes nuevos como para los actuales. Recomendamos encarecidamente a los clientes que migren sus cargas de trabajo a otras soluciones lo antes posible. Si tienes preguntas sobre la migración, ponte en contacto con el AWS Support equipo en [AWS Re:post](https://repost.aws/) o a través de Premium [AWS Support](https://aws.amazon.com/support).
Devuelve información sobre una ejecución de Chef como objeto JSON.
```
sudo opsworks-agent-cli get_json [activity] [date] [-i | --internal | --no-i | --no-internal]
```
De forma predeterminada, `get_json` muestra información proporcionada por el cliente para la ejecución de Chef más reciente. Utilice las siguientes opciones para especificar un conjunto determinado de información.
**activity**
Muestra información para la ejecución de Chef asociada a la actividad especificada más recientemente. Para obtener una lista de las actividades válidas, ejecute [list\$1commands](agent-list.md).
**date**
Muestra información para la ejecución de Chef asociada con la actividad ejecutada para la marca de tiempo especificada. Para obtener una lista de las marcas de tiempo válidas, ejecute [list\$1commands](agent-list.md).
**-i, --internal**
Muestra la información que OpsWorks Stacks utiliza internamente para ejecutar Chef.
**--no-i, --no-internal**
Muestra de forma explícita la información proporcionada por el cliente para la ejecución de Chef. Es el valor predeterminado, si no se especifica lo contrario.
**nota**
Para instancias Linux de Chef 12, la ejecución de este comando devolverá información válida como, por ejemplo, los atributos de configuración e implementación de la pila de la instancia. Sin embargo, para obtener información más completa, consulta las bolsas de datos de Chef que OpsWorks Stacks crea en la instancia. Para obtener más información, consulte la [OpsWorks Referencia de la bolsa de datos Stacks](data-bags.md).
El siguiente ejemplo de salida muestra la información proporcionada por el cliente para la ejecución de Chef más actual para la actividad configurada más recientemente.
```
$ sudo opsworks-agent-cli get_json configure
{
"run_list": [
"recipe[opsworks_cookbook_demo::configure]"
]
}
```
El siguiente ejemplo de salida muestra información que OpsWorks Stacks usa internamente para la ejecución de Chef en la marca de tiempo especificada.
```
$ 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**
El AWS OpsWorks Stacks servicio llegó al final de su vida útil el 26 de mayo de 2024 y se ha desactivado tanto para los clientes nuevos como para los existentes. Recomendamos encarecidamente a los clientes que migren sus cargas de trabajo a otras soluciones lo antes posible. Si tienes preguntas sobre la migración, ponte en contacto con el AWS Support equipo en [AWS Re:post](https://repost.aws/) o a través de Premium [AWS Support](https://aws.amazon.com/support).
Devuelve un informe de instancias ampliado.
```
sudo opsworks-agent-cli instance_report
```
El siguiente ejemplo de salida procede de una instancia.
```
$ 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**
El AWS OpsWorks Stacks servicio llegó al final de su vida útil el 26 de mayo de 2024 y se ha desactivado tanto para los clientes nuevos como para los actuales. Recomendamos encarecidamente a los clientes que migren sus cargas de trabajo a otras soluciones lo antes posible. Si tienes preguntas sobre la migración, ponte en contacto con el AWS Support equipo en [AWS Re:post](https://repost.aws/) o a través de Premium [AWS Support](https://aws.amazon.com/support).
Enumera la fecha y hora de cada actividad ejecutada en esta instancia. Puede utilizar estas fechas y horas para otros comandos de la CLI del agente para especificar una ejecución concreta.
```
sudo opsworks-agent-cli list_commands [activity] [date]
```
El siguiente ejemplo de salida procede de una instancia que ha ejecutado actividades configure, setup y update del libro de recetas personalizado.
```
$ 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**
El AWS OpsWorks Stacks servicio llegó al final de su vida útil el 26 de mayo de 2024 y se ha desactivado tanto para los clientes nuevos como para los actuales. Recomendamos encarecidamente a los clientes que migren sus cargas de trabajo a otras soluciones lo antes posible. Si tienes preguntas sobre la migración, ponte en contacto con el AWS Support equipo en [AWS Re:post](https://repost.aws/) o a través de Premium [AWS Support](https://aws.amazon.com/support).
Ejecuta un comando de OpsWorks Stacks, que es un archivo JSON que contiene una lista de ejecución de Chef que contiene la información necesaria para ejecutar una actividad de OpsWorks Stacks (configurar, implementar, etc.). El comando `run_command` genera una entrada de registro que puede visualizar mediante la ejecución de [show\$1log](agent-show.md). Esta opción está pensada únicamente para fines de desarrollo, por lo que OpsWorks Stacks no realiza un seguimiento de los cambios.
```
sudo opsworks-agent-cli run_command [activity] [date] [/path/to/valid/json.file]
```
De forma predeterminada, `run_command` ejecuta el comando OpsWorks Stacks más reciente. Utilice las siguientes opciones para especificar un comando determinado.
**activity**
Ejecuta un comando de OpsWorks Stacks específico:`setup`,`configure`,`deploy`,`undeploy`, `start``stop`, o. `restart`
**date**
Ejecute el OpsWorks comando de AWS que se ejecutó en la marca de tiempo especificada. Para obtener una lista de las marcas de tiempo válidas, ejecute [list\$1commands](agent-list.md).
**file**
Ejecute el archivo JSON del comando especificado. Para obtener la ruta del archivo del comando, ejecute [get\$1json](agent-json.md).
El siguiente ejemplo de salida procede de una instancia y ejecuta el comando configure.
```
$ 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**
El AWS OpsWorks Stacks servicio llegó al final de su vida útil el 26 de mayo de 2024 y se ha desactivado tanto para los clientes nuevos como para los existentes. Recomendamos encarecidamente a los clientes que migren sus cargas de trabajo a otras soluciones lo antes posible. Si tienes preguntas sobre la migración, ponte en contacto con el AWS Support equipo en [AWS Re:post](https://repost.aws/) o a través de Premium [AWS Support](https://aws.amazon.com/support).
Devuelve un archivo de registro del comando.
```
sudo opsworks-agent-cli show_log [activity] [date]
```
De forma predeterminada, `show_log` pone a la cola el archivo de registro más reciente. Utilice las siguientes opciones para especificar un comando determinado.
**activity**
Muestra el archivo de registro de la actividad especificada.
**date**
Muestra el archivo de registro de la actividad ejecutada en la marca de tiempo especificada. Para obtener una lista de las marcas de tiempo válidas, ejecute [list\$1commands](agent-list.md).
El siguiente ejemplo de salida muestra el registro más reciente.
```
$ 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**
El AWS OpsWorks Stacks servicio llegó al final de su vida útil el 26 de mayo de 2024 y se ha desactivado tanto para los clientes nuevos como para los actuales. Recomendamos encarecidamente a los clientes que migren sus cargas de trabajo a otras soluciones lo antes posible. Si tienes preguntas sobre la migración, ponte en contacto con el AWS Support equipo en [AWS Re:post](https://repost.aws/) o a través de Premium [AWS Support](https://aws.amazon.com/support).
Muestra la información que OpsWorks Stacks utiliza internamente en la última versión de Chef.
```
opsworks-agent-cli stack_state
```
**nota**
Para instancias Linux de Chef 12, la ejecución de este comando devolverá información válida como, por ejemplo, los atributos de configuración e implementación de la pila de la instancia. Sin embargo, para obtener información más completa, consulta las bolsas de datos de Chef que OpsWorks Stacks crea en la instancia. Para obtener más información, consulte la [OpsWorks Referencia de la bolsa de datos Stacks](data-bags.md).
El siguiente ejemplo de salida procede de una instancia.
```
$ 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"
]
}
}
```