AWS OpsWorks ejemplos que utilizan AWS CLI

Para asignar una instancia registrada a una capa

El siguiente ejemplo asigna una instancia registrada a una capa personalizada.

aws opsworks --region us-east-1 assign-instance --instance-id 4d6d1710-ded9-42a1-b08e-b043ad7af1e2 --layer-ids 26cf1d32-6876-42fa-bbf1-9cadc0bff938

Salida: ninguna.

Más información

Para obtener más información, consulte Asignación de una instancia registrada a una capa en la Guía del AWS OpsWorks usuario.

Para asignar un volumen registrado a una instancia

El siguiente ejemplo asigna un volumen registrado de Amazon Elastic Block Store (AmazonEBS) a una instancia. El volumen se identifica por su ID de volumen, que es el GUID que se AWS OpsWorks asigna al registrar el volumen en una pila, no por el ID de volumen de Amazon Elastic Compute Cloud (AmazonEC2). Antes de ejecutarassign-volume, primero debe correr update-volume para asignar un punto de montaje al volumen.

aws opsworks --region us-east-1 assign-volume --instance-id 4d6d1710-ded9-42a1-b08e-b043ad7af1e2 --volume-id 26cf1d32-6876-42fa-bbf1-9cadc0bff938

Salida: ninguna.

Más información

Para obtener más información, consulte Asignación de EBS volúmenes de Amazon a una instancia en la Guía del AWS OpsWorks usuario.

Para asociar una dirección IP elástica a una instancia

En el siguiente ejemplo, se asocia una dirección IP elástica a una instancia específica.

aws opsworks --region us-east-1 associate-elastic-ip --instance-id dfe18b02-5327-493d-91a4-c5c0c448927f --elastic-ip 54.148.130.96

Salida: ninguna.

Más información

Para obtener más información, consulte Administración de recursos en la Guía del AWS OpsWorks usuario.

Para adjuntar un balanceador de carga a una capa

En el siguiente ejemplo, se adjunta un equilibrador de cargas, identificado por su nombre, a una capa específica.

aws opsworks --region us-east-1 attach-elastic-load-balancer --elastic-load-balancer-name Java-LB --layer-id 888c5645-09a5-4d0e-95a8-812ef1db76a4

Salida: ninguna.

Más información

Para obtener más información, consulte Elastic Load Balancing en la Guía del AWS OpsWorks usuario.

Ejemplo 1: Para crear una aplicación

En el siguiente ejemplo, se crea una PHP aplicación denominada S implePHPApp a partir del código almacenado en un GitHub repositorio. El comando usa la forma abreviada de la definición fuente de la aplicación.

aws opsworks create-app \
    --region us-east-1 \
    --stack-id f6673d70-32e6-4425-8999-265dd002fec7 \
    --name SimplePHPApp \
    --type php \
    --app-source Type=git,Url=git://github.com/amazonwebservices/opsworks-demo-php-simple-app.git,Revision=version1

Salida:

{
    "AppId": "6cf5163c-a951-444f-a8f7-3716be75f2a2"
}

Ejemplo 2: Para crear una aplicación con una base de datos adjunta

En el siguiente ejemplo, se crea una JSP aplicación a partir del código almacenado en un archivo.zip de un bucket público de S3. Adjunta una RDS instancia de base de datos para que sirva como almacén de datos de la aplicación. Las fuentes de la aplicación y de la base de datos se definen en JSON archivos independientes que se encuentran en el directorio desde el que se ejecuta el comando.

aws opsworks create-app \
    --region us-east-1 \
    --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8 \
    --name SimpleJSP \
    --type java \
    --app-source file://appsource.json \
    --data-sources file://datasource.json

La información del origen de la aplicación se encuentra en appsource.json y contiene lo siguiente.

{
    "Type": "archive",
    "Url": "https://s3.amazonaws.com/opsworks-demo-assets/simplejsp.zip"
}

La información de origen de la base de datos está incluida datasource.json y contiene lo siguiente.

[
    {
        "Type": "RdsDbInstance",
        "Arn": "arn:aws:rds:us-west-2:123456789012:db:clitestdb",
        "DatabaseName": "mydb"
    }
]

Nota: En el caso de una RDS instancia de base de datos, primero debe utilizarla register-rds-db-instance para registrar la instancia en la pila. Para las instancias de My SQL App Server, Type establézcalo enOpsworksMysqlInstance. Estas instancias las crea AWS OpsWorks, por lo que no es necesario registrarlas.

Salida:

{
    "AppId": "26a61ead-d201-47e3-b55c-2a7c666942f8"
}

Para obtener más información, consulte Añadir aplicaciones en la Guía del AWS OpsWorks usuario.

Ejemplo 1: Para implementar aplicaciones y ejecutar comandos de pila

Los siguientes ejemplos muestran cómo usar el create-deployment comando para implementar aplicaciones y ejecutar comandos de pila. Observe que los caracteres entre comillas (") del JSON objeto que especifica el comando van todos precedidos de caracteres de escape (\). Sin los caracteres de escape, es posible que el comando devuelva un JSON error no válido.

En el siguiente create-deployment ejemplo, se implementa una aplicación en una pila específica.

aws opsworks create-deployment \
    --stack-id cfb7e082-ad1d-4599-8e81-de1c39ab45bf \
    --app-id 307be5c8-d55d-47b5-bd6e-7bd417c6c7eb
    --command "{\"Name\":\"deploy\"}"

Salida:

{
    "DeploymentId": "5746c781-df7f-4c87-84a7-65a119880560"
}

Ejemplo 2: Para implementar una aplicación Rails y migrar la base de datos

El siguiente create-deployment comando despliega una aplicación de Ruby on Rails en una pila específica y migra la base de datos.

aws opsworks create-deployment \
    --stack-id cfb7e082-ad1d-4599-8e81-de1c39ab45bf \
    --app-id 307be5c8-d55d-47b5-bd6e-7bd417c6c7eb \
    --command "{\"Name\":\"deploy\", \"Args\":{\"migrate\":[\"true\"]}}"

Salida:

{
    "DeploymentId": "5746c781-df7f-4c87-84a7-65a119880560"
}

Para obtener más información sobre la implementación, consulte Implementación de aplicaciones en la Guía del AWS OpsWorks usuario.

Ejemplo 3: ejecutar una receta

El siguiente create-deployment comando ejecuta una receta personalizada en las instancias de una pila especificada. phpapp::appsetup

aws opsworks create-deployment \
    --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb \
    --command "{\"Name\":\"execute_recipes\", \"Args\":{\"recipes\":[\"phpapp::appsetup\"]}}"

Salida:

{
    "DeploymentId": "5cbaa7b9-4e09-4e53-aa1b-314fbd106038"
}

Para obtener más información, consulte Ejecutar comandos de pila en la Guía del AWS OpsWorks usuario.

Ejemplo 4: Instalar dependencias

El siguiente create-deployment comando instala las dependencias, como paquetes o gemas de Ruby, en las instancias de una pila específica.

aws opsworks create-deployment \
    --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb \
    --command "{\"Name\":\"install_dependencies\"}"

Salida:

{
    "DeploymentId": "aef5b255-8604-4928-81b3-9b0187f962ff"
}

Para obtener más información, consulta la sección Ejecutar comandos de pila en la Guía del AWS OpsWorks usuario.

Para crear una instancia

El siguiente create-instance comando crea una instancia m1.large de Amazon Linux denominada myinstance1 en una pila específica. La instancia se asigna a una capa.

aws opsworks --region us-east-1 create-instance --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --layer-ids 5c8c272a-f2d5-42e3-8245-5bf3927cb65b --hostname myinstance1 --instance-type m1.large --os "Amazon Linux"

Para usar un nombre generado automáticamente, llame get-hostname-suggestion, que genera un nombre de host basado en el tema que especificó al crear la pila. A continuación, pasa ese nombre al argumento hostname.

Salida:

{
  "InstanceId": "5f9adeaa-c94c-42c6-aeef-28a5376002cd"
}

Más información

Para obtener más información, consulte Añadir una instancia a una capa en la Guía del AWS OpsWorks usuario.

Para crear una capa

El siguiente create-layer comando crea una capa de PHP App Server denominada M yPHPLayer en una pila especificada.

aws opsworks create-layer --region us-east-1 --stack-id f6673d70-32e6-4425-8999-265dd002fec7 --type php-app --name MyPHPLayer --shortname myphplayer

Salida:

{
  "LayerId": "0b212672-6b4b-40e4-8a34-5a943cf2e07a"
}

Más información

Para obtener más información, consulte Cómo crear una capa en la Guía del AWS OpsWorks usuario.

Para crear un servidor

El siguiente create-server ejemplo crea un nuevo servidor de Chef Automate con automate-06 el nombre de su región predeterminada. Tenga en cuenta que los valores predeterminados se utilizan para la mayoría de las demás configuraciones, como el número de copias de seguridad que se deben conservar y las horas de inicio y mantenimiento de las copias de seguridad. Antes de ejecutar un create-server comando, complete los requisitos previos de la Guía del usuario de Opsworks AWS OpsWorks for Chef Automate en la Guía del usuario de AWS Opsworks for Chef Automate.

aws opsworks-cm create-server \
    --engine "ChefAutomate" \
    --instance-profile-arn "arn:aws:iam::012345678901:instance-profile/aws-opsworks-cm-ec2-role" \
    --instance-type "t2.medium" \
    --server-name "automate-06" \
    --service-role-arn "arn:aws:iam::012345678901:role/aws-opsworks-cm-service-role"

Salida:

{
    "Server": {
        "AssociatePublicIpAddress": true,
        "BackupRetentionCount": 10,
        "CreatedAt": 2019-12-29T13:38:47.520Z,
        "DisableAutomatedBackup": FALSE,
        "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com",
        "Engine": "ChefAutomate",
        "EngineAttributes": [
            {
                "Name": "CHEF_AUTOMATE_ADMIN_PASSWORD",
                "Value": "1Example1"
            }
        ],
        "EngineModel": "Single",
        "EngineVersion": "2019-08",
        "InstanceProfileArn": "arn:aws:iam::012345678901:instance-profile/aws-opsworks-cm-ec2-role",
        "InstanceType": "t2.medium",
        "PreferredBackupWindow": "Sun:02:00",
        "PreferredMaintenanceWindow": "00:00",
        "SecurityGroupIds": [ "sg-12345678" ],
        "ServerArn": "arn:aws:iam::012345678901:instance/automate-06-1010V4UU2WRM2",
        "ServerName": "automate-06",
        "ServiceRoleArn": "arn:aws:iam::012345678901:role/aws-opsworks-cm-service-role",
        "Status": "CREATING",
        "SubnetIds": [ "subnet-12345678" ]
    }
}

Para obtener más información, consulte CreateServerla referencia sobre Chef AWS OpsWorks Automate. API

Para crear una pila

El siguiente create-stack comando crea una pila denominada CLI Stack.

aws opsworks create-stack --name "CLI Stack" --stack-region "us-east-1" --service-role-arn arn:aws:iam::123456789012:role/aws-opsworks-service-role --default-instance-profile-arn arn:aws:iam::123456789012:instance-profile/aws-opsworks-ec2-role --region us-east-1

Los parámetros service-role-arn y default-instance-profile-arn son obligatorios. Por lo general, utilizas las que se AWS OpsWorks crean automáticamente cuando creas tu primera pila. Para obtener los nombres de recursos de Amazon (ARNs) de su cuenta, vaya a la IAM consola, elija Roles en el panel de navegación, elija el rol o el perfil y elija la Summary pestaña.

Salida:

{
  "StackId": "f6673d70-32e6-4425-8999-265dd002fec7"
}

Más información

Para obtener más información, consulte Crear una pila nueva en la Guía del AWS OpsWorks usuario.

Para crear un perfil de usuario

Para importar un usuario de AWS Identity and Access Manager (IAM), debe llamar create-user-profile para crear un perfil de usuario. AWS OpsWorks En el siguiente ejemplo, se crea un perfil de usuario para el cli-user-test IAM usuario, que se identifica mediante Amazon Resource Name (ARN). En el ejemplo se asigna al usuario un SSH nombre de usuario myusername y se habilita la autogestión, lo que permite al usuario especificar una clave SSH pública.

aws opsworks --region us-east-1 create-user-profile --iam-user-arn arn:aws:iam::123456789102:user/cli-user-test --ssh-username myusername --allow-self-management

Salida:

{
  "IamUserArn": "arn:aws:iam::123456789102:user/cli-user-test"
}

Consejo: Este comando importa un IAM usuario a AWS OpsWorks, pero solo con los permisos que otorgan las políticas adjuntas. Puede conceder AWS OpsWorks permisos por pila mediante el set-permissions comando.

Más información

Para obtener más información, consulte Importación de usuarios a AWS OpsWorks en la Guía del AWS OpsWorks usuario.

Para eliminar una aplicación

En el siguiente ejemplo, se elimina una aplicación específica, que se identifica por su ID de aplicación. Para obtener un ID de aplicación, ve a la página de detalles de la aplicación en la AWS OpsWorks consola o ejecuta el describe-apps comando.

aws opsworks delete-app --region us-east-1 --app-id 577943b9-2ec1-4baf-a7bf-1d347601edc5

Resultado: ninguno.

Más información

Para obtener más información, consulte Aplicaciones en la Guía AWS OpsWorks del usuario.

Para eliminar una instancia

En el siguiente delete-instance ejemplo, se elimina una instancia específica, que se identifica por su ID de instancia. Para encontrar un ID de instancia, abre la página de detalles de la instancia en la AWS OpsWorks consola o ejecuta el describe-instances comando.

Si la instancia está en línea, primero debes detenerla mediante una llamada ystop-instance, después, esperar a que se detenga. Ejecuta describe-instances para comprobar el estado de la instancia.

Para eliminar los EBS volúmenes de Amazon o las direcciones IP elásticas de la instancia, agrega los --delete-elastic-ip argumentos --delete-volumes o, respectivamente.

aws opsworks delete-instance \
    --region us-east-1 \
    --instance-id 3a21cfac-4a1f-4ce2-a921-b2cfba6f7771

Este comando no genera ninguna salida.

Para obtener más información, consulte Eliminar AWS OpsWorks instancias en la Guía del AWS OpsWorks usuario.

Para eliminar una capa

En el siguiente ejemplo, se elimina una capa específica, que se identifica por su ID de capa. Para obtener un ID de capa, vaya a la página de detalles de la capa en la AWS OpsWorks consola o ejecute el describe-layers comando.

Nota: Antes de eliminar una capa, debe utilizar esta delete-instance opción para eliminar todas las instancias de la capa.

aws opsworks delete-layer --region us-east-1 --layer-id a919454e-b816-4598-b29a-5796afb498ed

Salida: ninguna.

Más información

Para obtener más información, consulte Eliminar AWS OpsWorks instancias en la Guía del AWS OpsWorks usuario.

Eliminación de una pila

El siguiente ejemplo elimina una pila específica, que se identifica por su ID de pila. Para obtener un ID de pila, haga clic en Stack Settings en la AWS OpsWorks consola o ejecute el describe-stacks comando.

Nota: Antes de eliminar una capa delete-appdelete-instance, debes usar y delete-layer eliminar todas las aplicaciones, instancias y capas de la pila.

aws opsworks delete-stack --region us-east-1 --stack-id 154a9d89-7e9e-433b-8de8-617e53756c84

Salida: ninguna.

Más información

Para obtener más información, consulte Shut Down a Stack en la Guía del AWS OpsWorks usuario.

Para eliminar un perfil de usuario y eliminar un IAM usuario de AWS OpsWorks

En el siguiente ejemplo, se elimina el perfil de usuario de un usuario específico de AWS Identity and Access Management (IAM), que se identifica mediante Amazon Resource Name (ARN). La operación elimina al usuario AWS OpsWorks, pero no lo elimina. IAM Debe usar la IAM consola o API para esa tarea. CLI

aws opsworks --region us-east-1 delete-user-profile --iam-user-arn arn:aws:iam::123456789102:user/cli-user-test

Resultado: ninguno.

Más información

Para obtener más información, consulte Importación de usuarios a AWS OpsWorks en la Guía del AWS OpsWorks usuario.

Para anular el registro de una dirección IP elástica de una pila

El siguiente ejemplo anula el registro de una dirección IP elástica, identificada por su dirección IP, de su pila.

aws opsworks deregister-elastic-ip --region us-east-1 --elastic-ip 54.148.130.96

Salida: ninguna.

Más información

Para obtener más información, consulte Anular el registro de direcciones IP elásticas en la Guía del AWS OpsWorks usuario.

Para anular el registro de una instancia registrada de una pila

El siguiente deregister-instance comando anula el registro de una instancia registrada de su pila.

aws opsworks --region us-east-1 deregister-instance --instance-id 4d6d1710-ded9-42a1-b08e-b043ad7af1e2

Resultado: ninguno.

Más información

Para obtener más información, consulte Anular el registro de una instancia registrada en la Guía del AWS OpsWorks usuario.

Para anular el registro de una RDS instancia de base de datos de Amazon de una pila

El siguiente ejemplo anula el registro de una RDS instancia de base de datos, identificada por su valorARN, de su pila.

aws opsworks deregister-rds-db-instance --region us-east-1 --rds-db-instance-arn arn:aws:rds:us-west-2:123456789012:db:clitestdb

Resultado: ninguno.

Más información

Para obtener más información, consulte Anular el registro de Amazon RDS Instances en la Guía del ASW OpsWorks usuario.

ID de instancia: clitestdb Nombre de usuario principal: cliuser Master: some23! PWD Nombre de base de datos pwd: mydb aws opsworks deregister-rds-db-instance —region us-east-1 — arn:aws:rds:us-west- 2:645732743964:db:clitestdb rds-db-instance-arn

Para anular el registro de un volumen de Amazon EBS

El siguiente ejemplo anula el registro de un EBS volumen de su pila. El volumen se identifica por su identificador de volumen, que es el GUID que se AWS OpsWorks asignó al registrar el volumen en la pila, no por el identificador del EC2 volumen.

aws opsworks deregister-volume --region us-east-1 --volume-id 5c48ef52-3144-4bf5-beaa-fda4deb23d4d

Salida: ninguna.

Más información

Para obtener más información, consulte Anular el registro de Amazon EBS Volumes en la Guía del AWS OpsWorks usuario.

Para describir las aplicaciones

El siguiente describe-apps comando describe las aplicaciones de una pila específica.

aws opsworks describe-apps \
    --stack-id 38ee91e2-abdc-4208-a107-0b7168b3cc7a \
    --region us-east-1

Salida:

{
    "Apps": [
        {
            "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
            "AppSource": {
            "Url": "https://s3-us-west-2.amazonaws.com/opsworks-demo-assets/simplejsp.zip",
            "Type": "archive"
        },
            "Name": "SimpleJSP",
            "EnableSsl": false,
            "SslConfiguration": {},
            "AppId": "da1decc1-0dff-43ea-ad7c-bb667cd87c8b",
            "Attributes": {
            "RailsEnv": null,
            "AutoBundleOnDeploy": "true",
            "DocumentRoot": "ROOT"
        },
            "Shortname": "simplejsp",
            "Type": "other",
            "CreatedAt": "2013-08-01T21:46:54+00:00"
        }
    ]
}

Para obtener más información, consulte Aplicaciones en la Guía AWS OpsWorks del usuario.

Para describir los comandos

El siguiente describe-commands comando describe los comandos de una instancia específica.

aws opsworks describe-commands \
    --instance-id 8c2673b9-3fe5-420d-9cfa-78d875ee7687 \
    --region us-east-1

Salida:

{
    "Commands": [
        {
            "Status": "successful",
            "CompletedAt": "2013-07-25T18:57:47+00:00",
            "InstanceId": "8c2673b9-3fe5-420d-9cfa-78d875ee7687",
            "DeploymentId": "6ed0df4c-9ef7-4812-8dac-d54a05be1029",
            "AcknowledgedAt": "2013-07-25T18:57:41+00:00",
            "LogUrl": "https://s3.amazonaws.com/<bucket-name>/logs/008c1a91-ec59-4d51-971d-3adff54b00cc?AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE &Expires=1375394373&Signature=HkXil6UuNfxTCC37EPQAa462E1E%3D&response-cache-control=private&response-content-encoding=gzip&response-content- type=text%2Fplain",
            "Type": "undeploy",
            "CommandId": "008c1a91-ec59-4d51-971d-3adff54b00cc",
            "CreatedAt": "2013-07-25T18:57:34+00:00",
            "ExitCode": 0
        },
        {
            "Status": "successful",
            "CompletedAt": "2013-07-25T18:55:40+00:00",
            "InstanceId": "8c2673b9-3fe5-420d-9cfa-78d875ee7687",
            "DeploymentId": "19d3121e-d949-4ff2-9f9d-94eac087862a",
            "AcknowledgedAt": "2013-07-25T18:55:32+00:00",
            "LogUrl": "https://s3.amazonaws.com/<bucket-name>/logs/899d3d64-0384-47b6-a586-33433aad117c?AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE &Expires=1375394373&Signature=xMsJvtLuUqWmsr8s%2FAjVru0BtRs%3D&response-cache-control=private&response-content-encoding=gzip&response-conten t-type=text%2Fplain",
            "Type": "deploy",
            "CommandId": "899d3d64-0384-47b6-a586-33433aad117c",
            "CreatedAt": "2013-07-25T18:55:29+00:00",
            "ExitCode": 0
        }
    ]
}

Para obtener más información, consulte los eventos AWS OpsWorks del ciclo de vida en la Guía del AWS OpsWorks usuario.

Para describir las implementaciones

El siguiente describe-deployments comando describe las implementaciones de una pila específica.

aws opsworks --region us-east-1 describe-deployments --stack-id 38ee91e2-abdc-4208-a107-0b7168b3cc7a

Salida:

{
  "Deployments": [
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Status": "successful",
          "CompletedAt": "2013-07-25T18:57:49+00:00",
          "DeploymentId": "6ed0df4c-9ef7-4812-8dac-d54a05be1029",
          "Command": {
              "Args": {},
              "Name": "undeploy"
          },
          "CreatedAt": "2013-07-25T18:57:34+00:00",
          "Duration": 15,
          "InstanceIds": [
              "8c2673b9-3fe5-420d-9cfa-78d875ee7687",
              "9e588a25-35b2-4804-bd43-488f85ebe5b7"
          ]
      },
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Status": "successful",
          "CompletedAt": "2013-07-25T18:56:41+00:00",
          "IamUserArn": "arn:aws:iam::123456789012:user/someuser",
          "DeploymentId": "19d3121e-d949-4ff2-9f9d-94eac087862a",
          "Command": {
              "Args": {},
              "Name": "deploy"
          },
          "InstanceIds": [
              "8c2673b9-3fe5-420d-9cfa-78d875ee7687",
              "9e588a25-35b2-4804-bd43-488f85ebe5b7"
          ],
          "Duration": 72,
          "CreatedAt": "2013-07-25T18:55:29+00:00"
      }
  ]
}

Más información

Para obtener más información, consulte Implementación de aplicaciones en la Guía del AWS OpsWorks usuario.

Para describir las instancias de Elastic IP

El siguiente describe-elastic-ips comando describe las direcciones IP elásticas de una instancia específica.

aws opsworks --region us-east-1 describe-elastic-ips --instance-id b62f3e04-e9eb-436c-a91f-d9e9a396b7b0

Salida:

{
  "ElasticIps": [
      {
          "Ip": "192.0.2.0",
          "Domain": "standard",
          "Region": "us-west-2"
      }
  ]
}

Más información

Para obtener más información, consulte Instancias en la Guía AWS OpsWorks del usuario.

Para describir los balanceadores de carga elásticos de una pila

El siguiente describe-elastic-load-balancers comando describe los balanceadores de carga de una pila específica.

aws opsworks --region us-west-2 describe-elastic-load-balancers --stack-id 6f4660e5-37a6-4e42-bfa0-1358ebd9c182

Resultado: esta pila en particular tiene un balanceador de carga.

{
  "ElasticLoadBalancers": [
      {
          "SubnetIds": [
              "subnet-60e4ea04",
              "subnet-66e1c110"
          ],
          "Ec2InstanceIds": [],
          "ElasticLoadBalancerName": "my-balancer",
          "Region": "us-west-2",
          "LayerId": "344973cb-bf2b-4cd0-8d93-51cd819bab04",
          "AvailabilityZones": [
              "us-west-2a",
              "us-west-2b"
          ],
          "VpcId": "vpc-b319f9d4",
          "StackId": "6f4660e5-37a6-4e42-bfa0-1358ebd9c182",
          "DnsName": "my-balancer-2094040179.us-west-2.elb.amazonaws.com"
      }
  ]
}

Más información

Para obtener más información, consulte Aplicaciones en la Guía AWS OpsWorks del usuario.

Para describir las instancias

El siguiente describe-instances comando describe las instancias de una pila específica:

aws opsworks --region us-east-1 describe-instances --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

Salida: el siguiente ejemplo de salida es para una pila con dos instancias. La primera es una EC2 instancia registrada y la segunda la creó AWS OpsWorks.

{
  "Instances": [
    {
      "StackId": "71c7ca72-55ae-4b6a-8ee1-a8dcded3fa0f",
      "PrivateDns": "ip-10-31-39-66.us-west-2.compute.internal",
      "LayerIds": [
        "26cf1d32-6876-42fa-bbf1-9cadc0bff938"
      ],
      "EbsOptimized": false,
      "ReportedOs": {
        "Version": "14.04",
        "Name": "ubuntu",
        "Family": "debian"
      },
      "Status": "online",
      "InstanceId": "4d6d1710-ded9-42a1-b08e-b043ad7af1e2",
      "SshKeyName": "US-West-2",
      "InfrastructureClass": "ec2",
      "RootDeviceVolumeId": "vol-d08ec6c1",
      "SubnetId": "subnet-b8de0ddd",
      "InstanceType": "t1.micro",
      "CreatedAt": "2015-02-24T20:52:49+00:00",
      "AmiId": "ami-35501205",
      "Hostname": "ip-192-0-2-0",
      "Ec2InstanceId": "i-5cd23551",
      "PublicDns": "ec2-192-0-2-0.us-west-2.compute.amazonaws.com",
      "SecurityGroupIds": [
        "sg-c4d3f0a1"
      ],
      "Architecture": "x86_64",
      "RootDeviceType": "ebs",
      "InstallUpdatesOnBoot": true,
      "Os": "Custom",
      "VirtualizationType": "paravirtual",
      "AvailabilityZone": "us-west-2a",
      "PrivateIp": "10.31.39.66",
      "PublicIp": "192.0.2.06",
      "RegisteredBy": "arn:aws:iam::123456789102:user/AWS/OpsWorks/OpsWorks-EC2Register-i-5cd23551"
    },
    {
      "StackId": "71c7ca72-55ae-4b6a-8ee1-a8dcded3fa0f",
      "PrivateDns": "ip-10-31-39-158.us-west-2.compute.internal",
      "SshHostRsaKeyFingerprint": "69:6b:7b:8b:72:f3:ed:23:01:00:05:bc:9f:a4:60:c1",
      "LayerIds": [
        "26cf1d32-6876-42fa-bbf1-9cadc0bff938"
      ],
      "EbsOptimized": false,
      "ReportedOs": {},
      "Status": "booting",
      "InstanceId": "9b137a0d-2f5d-4cc0-9704-13da4b31fdcb",
      "SshKeyName": "US-West-2",
      "InfrastructureClass": "ec2",
      "RootDeviceVolumeId": "vol-e09dd5f1",
      "SubnetId": "subnet-b8de0ddd",
      "InstanceProfileArn": "arn:aws:iam::123456789102:instance-profile/aws-opsworks-ec2-role",
      "InstanceType": "c3.large",
      "CreatedAt": "2015-02-24T21:29:33+00:00",
      "AmiId": "ami-9fc29baf",
      "SshHostDsaKeyFingerprint": "fc:87:95:c3:f5:e1:3b:9f:d2:06:6e:62:9a:35:27:e8",
      "Ec2InstanceId": "i-8d2dca80",
      "PublicDns": "ec2-192-0-2-1.us-west-2.compute.amazonaws.com",
      "SecurityGroupIds": [
        "sg-b022add5",
        "sg-b122add4"
      ],
      "Architecture": "x86_64",
      "RootDeviceType": "ebs",
      "InstallUpdatesOnBoot": true,
      "Os": "Amazon Linux 2014.09",
      "VirtualizationType": "paravirtual",
      "AvailabilityZone": "us-west-2a",
      "Hostname": "custom11",
      "PrivateIp": "10.31.39.158",
      "PublicIp": "192.0.2.0"
    }
  ]
}

Más información

Para obtener más información, consulte Instancias en la Guía AWS OpsWorks del usuario.

Para describir las capas de una pila

El siguiente describe-layers comando describe las capas de una pila específica:

aws opsworks --region us-east-1 describe-layers --stack-id 38ee91e2-abdc-4208-a107-0b7168b3cc7a

Salida:

{
  "Layers": [
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Type": "db-master",
          "DefaultSecurityGroupNames": [
              "AWS-OpsWorks-DB-Master-Server"
          ],
          "Name": "MySQL",
          "Packages": [],
          "DefaultRecipes": {
              "Undeploy": [],
              "Setup": [
                  "opsworks_initial_setup",
                  "ssh_host_keys",
                  "ssh_users",
                  "mysql::client",
                  "dependencies",
                  "ebs",
                  "opsworks_ganglia::client",
                  "mysql::server",
                  "dependencies",
                  "deploy::mysql"
              ],
              "Configure": [
                  "opsworks_ganglia::configure-client",
                  "ssh_users",
                  "agent_version",
                  "deploy::mysql"
              ],
              "Shutdown": [
                  "opsworks_shutdown::default",
                  "mysql::stop"
              ],
              "Deploy": [
                  "deploy::default",
                  "deploy::mysql"
              ]
          },
          "CustomRecipes": {
              "Undeploy": [],
              "Setup": [],
              "Configure": [],
              "Shutdown": [],
              "Deploy": []
          },
          "EnableAutoHealing": false,
          "LayerId": "41a20847-d594-4325-8447-171821916b73",
          "Attributes": {
              "MysqlRootPasswordUbiquitous": "true",
              "RubygemsVersion": null,
              "RailsStack": null,
              "HaproxyHealthCheckMethod": null,
              "RubyVersion": null,
              "BundlerVersion": null,
              "HaproxyStatsPassword": null,
              "PassengerVersion": null,
              "MemcachedMemory": null,
              "EnableHaproxyStats": null,
              "ManageBundler": null,
              "NodejsVersion": null,
              "HaproxyHealthCheckUrl": null,
              "MysqlRootPassword": "*****FILTERED*****",
              "GangliaPassword": null,
              "GangliaUser": null,
              "HaproxyStatsUrl": null,
              "GangliaUrl": null,
              "HaproxyStatsUser": null
          },
          "Shortname": "db-master",
          "AutoAssignElasticIps": false,
          "CustomSecurityGroupIds": [],
          "CreatedAt": "2013-07-25T18:11:19+00:00",
          "VolumeConfigurations": [
              {
                  "MountPoint": "/vol/mysql",
                  "Size": 10,
                  "NumberOfDisks": 1
              }
          ]
      },
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Type": "custom",
          "DefaultSecurityGroupNames": [
              "AWS-OpsWorks-Custom-Server"
          ],
          "Name": "TomCustom",
          "Packages": [],
          "DefaultRecipes": {
              "Undeploy": [],
              "Setup": [
                  "opsworks_initial_setup",
                  "ssh_host_keys",
                  "ssh_users",
                  "mysql::client",
                  "dependencies",
                  "ebs",
                  "opsworks_ganglia::client"
              ],
              "Configure": [
                  "opsworks_ganglia::configure-client",
                  "ssh_users",
                  "agent_version"
              ],
              "Shutdown": [
                  "opsworks_shutdown::default"
              ],
              "Deploy": [
                  "deploy::default"
              ]
          },
          "CustomRecipes": {
              "Undeploy": [],
              "Setup": [
                  "tomcat::setup"
              ],
              "Configure": [
                  "tomcat::configure"
              ],
              "Shutdown": [],
              "Deploy": [
                  "tomcat::deploy"
              ]
          },
          "EnableAutoHealing": true,
          "LayerId": "e6cbcd29-d223-40fc-8243-2eb213377440",
          "Attributes": {
              "MysqlRootPasswordUbiquitous": null,
              "RubygemsVersion": null,
              "RailsStack": null,
              "HaproxyHealthCheckMethod": null,
              "RubyVersion": null,
              "BundlerVersion": null,
              "HaproxyStatsPassword": null,
              "PassengerVersion": null,
              "MemcachedMemory": null,
              "EnableHaproxyStats": null,
              "ManageBundler": null,
              "NodejsVersion": null,
              "HaproxyHealthCheckUrl": null,
              "MysqlRootPassword": null,
              "GangliaPassword": null,
              "GangliaUser": null,
              "HaproxyStatsUrl": null,
              "GangliaUrl": null,
              "HaproxyStatsUser": null
          },
          "Shortname": "tomcustom",
          "AutoAssignElasticIps": false,
          "CustomSecurityGroupIds": [],
          "CreatedAt": "2013-07-25T18:12:53+00:00",
          "VolumeConfigurations": []
      }
  ]
}

Más información

Para obtener más información, consulte Capas en la Guía AWS OpsWorks del usuario.

Para describir la configuración de escalado basada en la carga de una capa

El siguiente ejemplo describe la configuración de escalado basada en la carga de una capa específica. La capa se identifica por su identificador de capa, que puede encontrar en la página de detalles de la capa o describe-layers ejecutándolo.

aws opsworks describe-load-based-auto-scaling --region us-east-1 --layer-ids 6bec29c9-c866-41a0-aba5-fa3e374ce2a1

Resultado: la capa de ejemplo tiene una única instancia basada en la carga.

{
  "LoadBasedAutoScalingConfigurations": [
    {
      "DownScaling": {
        "IgnoreMetricsTime": 10,
        "ThresholdsWaitTime": 10,
        "InstanceCount": 1,
        "CpuThreshold": 30.0
      },
      "Enable": true,
      "UpScaling": {
        "IgnoreMetricsTime": 5,
        "ThresholdsWaitTime": 5,
        "InstanceCount": 1,
        "CpuThreshold": 80.0
      },
      "LayerId": "6bec29c9-c866-41a0-aba5-fa3e374ce2a1"
    }
  ]
}

Más información

Para obtener más información, consulte Cómo funciona el escalado automático basado en la carga en la Guía del AWS OpsWorks usuario.

Para obtener el perfil de un usuario

El siguiente ejemplo muestra cómo obtener el perfil del usuario de AWS Identity and Access Management (IAM) que ejecuta el comando.

aws opsworks --region us-east-1 describe-my-user-profile

Resultado: por motivos de brevedad, la mayor parte de la clave SSH pública del usuario se sustituye por puntos suspensivos (...).

{
  "UserProfile": {
    "IamUserArn": "arn:aws:iam::123456789012:user/myusername",
    "SshPublicKey": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQ...3LQ4aX9jpxQw== rsa-key-20141104",
    "Name": "myusername",
    "SshUsername": "myusername"
  }
}

Más información

Para obtener más información, consulte Importación de usuarios a AWS OpsWorks en la Guía del AWS OpsWorks usuario.

Para obtener el nivel de AWS OpsWorks permisos por pila de un usuario

El siguiente ejemplo muestra cómo obtener el nivel de permiso de un usuario de AWS Identity and Access Management (IAM) en una pila específica.

aws opsworks --region us-east-1 describe-permissions --iam-user-arn arn:aws:iam::123456789012:user/cli-user-test --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06

Salida:

{
  "Permissions": [
    {
      "StackId": "d72553d4-8727-448c-9b00-f024f0ba1b06",
      "IamUserArn": "arn:aws:iam::123456789012:user/cli-user-test",
      "Level": "manage",
      "AllowSudo": true,
      "AllowSsh": true
    }
  ]
}

Más información

Para obtener más información, consulte Concesión de niveles de permisos por pila en la Guía del AWS OpsWorks usuario.

Para describir las RAID matrices

En el siguiente ejemplo, se describen las RAID matrices asociadas a las instancias de una pila específica.

aws opsworks --region us-east-1 describe-raid-arrays --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06

Resultado: el siguiente es el resultado de una pila con una RAID matriz.

{
  "RaidArrays": [
    {
      "StackId": "d72553d4-8727-448c-9b00-f024f0ba1b06",
      "AvailabilityZone": "us-west-2a",
      "Name": "Created for php-app1",
      "NumberOfDisks": 2,
      "InstanceId": "9f14adbc-ced5-43b6-bf01-e7d0db6cf2f7",
      "RaidLevel": 0,
      "VolumeType": "standard",
      "RaidArrayId": "f2d4e470-5972-4676-b1b8-bae41ec3e51c",
      "Device": "/dev/md0",
      "MountPoint": "/mnt/workspace",
      "CreatedAt": "2015-02-26T23:53:09+00:00",
      "Size": 100
    }
  ]
}

Para obtener más información, consulte EBS Volúmenes en la Guía AWS OpsWorks del usuario.

Para describir las RDS instancias de Amazon registradas de una pila

En el siguiente ejemplo, se describen las RDS instancias de Amazon registradas con una pila específica.

aws opsworks --region us-east-1 describe-rds-db-instances --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06

Resultado: el siguiente es el resultado de una pila con una RDS instancia registrada.

{
  "RdsDbInstances": [
    {
      "Engine": "mysql",
      "StackId": "d72553d4-8727-448c-9b00-f024f0ba1b06",
      "MissingOnRds": false,
      "Region": "us-west-2",
      "RdsDbInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:clitestdb",
      "DbPassword": "*****FILTERED*****",
      "Address": "clitestdb.cdlqlk5uwd0k.us-west-2.rds.amazonaws.com",
      "DbUser": "cliuser",
      "DbInstanceIdentifier": "clitestdb"
    }
  ]
}

Para obtener más información, consulte Administración de recursos en la Guía del AWS OpsWorks usuario.

Para devolver los parámetros de aprovisionamiento de una pila

El siguiente describe-stack-provisioning-parameters ejemplo devuelve los parámetros de aprovisionamiento de una pila específica. Los parámetros de aprovisionamiento incluyen ajustes como la ubicación de instalación del agente y la clave pública que se OpsWorks utiliza para administrar el agente en las instancias de una pila.

aws opsworks describe-stack-provisioning-parameters \
    --stack-id 62744d97-6faf-4ecb-969b-a086fEXAMPLE

Salida:

{
    "AgentInstallerUrl": "https://opsworks-instance-agent-us-west-2.s3.amazonaws.com/ID_number/opsworks-agent-installer.tgz",
    "Parameters": {
        "agent_installer_base_url": "https://opsworks-instance-agent-us-west-2.s3.amazonaws.com",
        "agent_installer_tgz": "opsworks-agent-installer.tgz",
        "assets_download_bucket": "opsworks-instance-assets-us-west-2.s3.amazonaws.com",
        "charlie_public_key": "-----BEGIN PUBLIC KEY-----PUBLIC_KEY_EXAMPLE\n-----END PUBLIC KEY-----",
        "instance_service_endpoint": "opsworks-instance-service.us-west-2.amazonaws.com",
        "instance_service_port": "443",
        "instance_service_region": "us-west-2",
        "instance_service_ssl_verify_peer": "true",
        "instance_service_use_ssl": "true",
        "ops_works_endpoint": "opsworks.us-west-2.amazonaws.com",
        "ops_works_port": "443",
        "ops_works_region": "us-west-2",
        "ops_works_ssl_verify_peer": "true",
        "ops_works_use_ssl": "true",
        "verbose": "false",
        "wait_between_runs": "30"
    }
}

Para obtener más información, consulte Ejecutar comandos de pila en la Guía del AWS OpsWorks usuario.

Para describir la configuración de una pila

El siguiente describe-stack-summary comando devuelve un resumen de la configuración de la pila especificada.

aws opsworks --region us-east-1 describe-stack-summary --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

Salida:

{
  "StackSummary": {
    "StackId": "8c428b08-a1a1-46ce-a5f8-feddc43771b8",
    "InstancesCount": {
      "Booting": 1
    },
    "Name": "CLITest",
    "AppsCount": 1,
    "LayersCount": 1,
    "Arn": "arn:aws:opsworks:us-west-2:123456789012:stack/8c428b08-a1a1-46ce-a5f8-feddc43771b8/"
  }
}

Más información

Para obtener más información, consulte Stacks en la Guía del AWS OpsWorks usuario.

Para describir las pilas

El siguiente describe-stacks comando describe las pilas de una cuenta.

aws opsworks --region us-east-1 describe-stacks

Salida:

{
  "Stacks": [
    {
      "ServiceRoleArn": "arn:aws:iam::444455556666:role/aws-opsworks-service-role",
      "StackId": "aeb7523e-7c8b-49d4-b866-03aae9d4fbcb",
      "DefaultRootDeviceType": "instance-store",
      "Name": "TomStack-sd",
      "ConfigurationManager": {
        "Version": "11.4",
        "Name": "Chef"
      },
      "UseCustomCookbooks": true,
      "CustomJson": "{\n  \"tomcat\": {\n    \"base_version\": 7,\n    \"java_opts\": \"-Djava.awt.headless=true -Xmx256m\"\n  },\n  \"datasources\": {\n    \"ROOT\": \"jdbc/mydb\"\n  }\n}",
      "Region": "us-east-1",
      "DefaultInstanceProfileArn": "arn:aws:iam::444455556666:instance-profile/aws-opsworks-ec2-role",
      "CustomCookbooksSource": {
        "Url": "git://github.com/example-repo/tomcustom.git",
        "Type": "git"
      },
      "DefaultAvailabilityZone": "us-east-1a",
      "HostnameTheme": "Layer_Dependent",
      "Attributes": {
        "Color": "rgb(45, 114, 184)"
      },
      "DefaultOs": "Amazon Linux",
      "CreatedAt": "2013-08-01T22:53:42+00:00"
    },
    {
      "ServiceRoleArn": "arn:aws:iam::444455556666:role/aws-opsworks-service-role",
      "StackId": "40738975-da59-4c5b-9789-3e422f2cf099",
      "DefaultRootDeviceType": "instance-store",
      "Name": "MyStack",
      "ConfigurationManager": {
        "Version": "11.4",
        "Name": "Chef"
      },
      "UseCustomCookbooks": false,
      "Region": "us-east-1",
      "DefaultInstanceProfileArn": "arn:aws:iam::444455556666:instance-profile/aws-opsworks-ec2-role",
      "CustomCookbooksSource": {},
      "DefaultAvailabilityZone": "us-east-1a",
      "HostnameTheme": "Layer_Dependent",
      "Attributes": {
        "Color": "rgb(45, 114, 184)"
      },
      "DefaultOs": "Amazon Linux",
      "CreatedAt": "2013-10-25T19:24:30+00:00"
    }
  ]
}

Más información

Para obtener más información, consulte Stacks en la Guía del AWS OpsWorks usuario.

Para describir la configuración de escalado basada en el tiempo de una instancia

En el siguiente ejemplo, se describe la configuración de escalado basada en el tiempo de una instancia específica. La instancia se identifica por su ID de instancia, que puedes encontrar en la página de detalles de la instancia o describe-instances ejecutándola.

aws opsworks describe-time-based-auto-scaling --region us-east-1 --instance-ids 701f2ffe-5d8e-4187-b140-77b75f55de8d

Resultado: el ejemplo tiene una única instancia basada en el tiempo.

{
  "TimeBasedAutoScalingConfigurations": [
   {
      "InstanceId": "701f2ffe-5d8e-4187-b140-77b75f55de8d",
      "AutoScalingSchedule": {
        "Monday": {
          "11": "on",
          "10": "on",
          "13": "on",
          "12": "on"
        },
        "Tuesday": {
          "11": "on",
          "10": "on",
          "13": "on",
          "12": "on"
        }
      }
    }
  ]
}

Más información

Para obtener más información, consulte Cómo funciona el escalado automático basado en el tiempo en la Guía del AWS OpsWorks usuario.

Para describir los perfiles de usuario

El siguiente describe-user-profiles comando describe los perfiles de usuario de la cuenta.

aws opsworks --region us-east-1 describe-user-profiles

Salida:

{
  "UserProfiles": [
    {
      "IamUserArn": "arn:aws:iam::123456789012:user/someuser",
      "SshPublicKey": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAQEAkOuP7i80q3Cko...",
      "AllowSelfManagement": true,
      "Name": "someuser",
      "SshUsername": "someuser"
    },
    {
      "IamUserArn": "arn:aws:iam::123456789012:user/cli-user-test",
      "AllowSelfManagement": true,
      "Name": "cli-user-test",
      "SshUsername": "myusername"
    }
  ]
}

Más información

Para obtener más información, consulte Administración de AWS OpsWorks usuarios en la Guía del AWS OpsWorks usuario.

Para describir los volúmenes de una pila

El siguiente ejemplo describe los EBS volúmenes de una pila.

aws opsworks --region us-east-1 describe-volumes --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

Salida:

{
  "Volumes": [
    {
      "Status": "in-use",
      "AvailabilityZone": "us-west-2a",
      "Name": "CLITest",
      "InstanceId": "dfe18b02-5327-493d-91a4-c5c0c448927f",
      "VolumeType": "standard",
      "VolumeId": "56b66fbd-e1a1-4aff-9227-70f77118d4c5",
      "Device": "/dev/sdi",
      "Ec2VolumeId": "vol-295c1638",
      "MountPoint": "/mnt/myvolume",
      "Size": 1
    }
  ]
}

Más información

Para obtener más información, consulte Administración de recursos en la Guía del AWS OpsWorks usuario.

Para separar un balanceador de cargas de su capa

En el siguiente ejemplo, se separa un balanceador de cargas, identificado por su nombre, de su capa.

aws opsworks --region us-east-1 detach-elastic-load-balancer --elastic-load-balancer-name Java-LB --layer-id 888c5645-09a5-4d0e-95a8-812ef1db76a4

Salida: ninguna.

Más información

Para obtener más información, consulte Elastic Load Balancing en la Guía del AWS OpsWorks usuario.

Para desasociar una dirección IP elástica de una instancia

El siguiente ejemplo desasocia una dirección IP elástica de una instancia específica.

aws opsworks --region us-east-1 disassociate-elastic-ip --elastic-ip 54.148.130.96

Salida: ninguna.

Más información

Para obtener más información, consulte Administración de recursos en la Guía del AWS OpsWorks usuario.

Para obtener el siguiente nombre de host de una capa

El siguiente ejemplo obtiene el siguiente nombre de host generado para una capa especificada. La capa utilizada en este ejemplo es una capa de servidor de aplicaciones Java con una instancia. El tema del nombre de host de la pila es el predeterminado, Layer_Dependent.

aws opsworks --region us-east-1 get-hostname-suggestion --layer-id 888c5645-09a5-4d0e-95a8-812ef1db76a4

Salida:

{
  "Hostname": "java-app2",
  "LayerId": "888c5645-09a5-4d0e-95a8-812ef1db76a4"
}

Más información

Para obtener más información, consulte Crear una pila nueva en la Guía del AWS OpsWorks usuario.

Para reiniciar una instancia

En el siguiente ejemplo, se reinicia una instancia.

aws opsworks --region us-east-1 reboot-instance --instance-id dfe18b02-5327-493d-91a4-c5c0c448927f

Salida: ninguna.

Más información

Para obtener más información, consulte Reiniciar una instancia en la Guía del AWS OpsWorks usuario.

Para registrar una dirección IP elástica con una pila

El siguiente ejemplo registra una dirección IP elástica, identificada por su dirección IP, con una pila específica.

Nota: La dirección IP elástica debe estar en la misma región que la pila.

aws opsworks register-elastic-ip --region us-east-1 --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06 --elastic-ip 54.148.130.96

Salida

{
  "ElasticIp": "54.148.130.96"
}

Más información

Para obtener más información, consulte Registrar direcciones IP elásticas con una pila en la Guía del OpsWorks usuario.

Para registrar una RDS instancia de Amazon con una pila

El siguiente ejemplo registra una RDS instancia de base de datos de Amazon, identificada por su nombre de recurso de Amazon (ARN), con una pila específica. También especifica el nombre de usuario y la contraseña maestros de la instancia. Tenga en cuenta que AWS OpsWorks esto no valida ninguno de estos valores. Si alguno de ellos es incorrecto, la aplicación no podrá conectarse a la base de datos.

aws opsworks register-rds-db-instance --region us-east-1 --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06 --rds-db-instance-arn arn:aws:rds:us-west-2:123456789012:db:clitestdb  --db-user cliuser --db-password some23!pwd

Salida: ninguna.

Más información

Para obtener más información, consulte Registrar RDS instancias de Amazon con una pila en la Guía del AWS OpsWorks usuario.

Para registrar un EBS volumen de Amazon con una pila

El siguiente ejemplo registra un EBS volumen de Amazon, identificado por su ID de volumen, con una pila específica.

aws opsworks register-volume --region us-east-1 --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06 --ec-2-volume-id vol-295c1638

Salida:

{
  "VolumeId": "ee08039c-7cb7-469f-be10-40fb7f0c05e8"
}

Más información

Para obtener más información, consulte Registrar EBS volúmenes de Amazon con una pila en la Guía del AWS OpsWorks usuario.

Para registrar instancias con una pila

Los siguientes ejemplos muestran diversas formas de registrar instancias con una pila que se crearon fuera de AWS Opsworks. Puede ejecutar register desde la instancia que desea registrar o desde una estación de trabajo independiente. Para obtener más información, consulte Registrar instancias de Amazon EC2 y locales en la Guía del AWS OpsWorks usuario.

Nota: Por motivos de brevedad, los ejemplos omiten el argumento. region

Para registrar una EC2 instancia de Amazon

Para indicar que está registrando una EC2 instancia, defina el --infrastructure-class argumento enec2.

En el siguiente ejemplo, se registra una EC2 instancia con la pila especificada desde una estación de trabajo independiente. La instancia se identifica por su EC2 ID,i-12345678. El ejemplo usa el nombre de SSH usuario predeterminado de la estación de trabajo e intenta iniciar sesión en la instancia mediante técnicas de autenticación que no requieren una contraseña, como una SSH clave privada predeterminada. Si esto no funciona, register busca la contraseña.

aws opsworks register --infrastructure-class=ec2 --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb i-12345678

En el siguiente ejemplo, se registra una EC2 instancia con la pila especificada desde una estación de trabajo independiente. Utiliza los --ssh-private-key argumentos --ssh-username y para especificar de forma explícita el SSH nombre de usuario y el archivo de clave privada que el comando utiliza para iniciar sesión en la instancia. ec2-useres el nombre de usuario estándar para las instancias de Amazon Linux. Úselo ubuntu para instancias de Ubuntu.

aws opsworks register --infrastructure-class=ec2 --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --ssh-username ec2-user --ssh-private-key ssh_private_key i-12345678

En el siguiente ejemplo, se registra la EC2 instancia que ejecuta el register comando. Inicia sesión en la instancia con el --local argumento SSH y register ejecútalo con él en lugar de con un identificador de instancia o un nombre de host.

aws opsworks register --infrastructure-class ec2 --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --local

Para registrar una instancia local

Para indicar que está registrando una instancia local, defina el --infrastructure-class argumento en. on-premises

En el siguiente ejemplo, se registra una instancia local existente con una pila específica de una estación de trabajo independiente. La instancia se identifica por su dirección IP,. 192.0.2.3 El ejemplo usa el nombre de SSH usuario predeterminado de la estación de trabajo e intenta iniciar sesión en la instancia mediante técnicas de autenticación que no requieren una contraseña, como una SSH clave privada predeterminada. Si esto no funciona, register busca la contraseña.

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb 192.0.2.3

En el siguiente ejemplo, se registra una instancia local con una pila específica de una estación de trabajo independiente. La instancia se identifica por su nombre de host,. host1 Los --override-... argumentos indican AWS OpsWorks que se muestran webserver1 como nombre de host 192.0.2.3 y 10.0.0.2 como direcciones IP públicas y privadas de la instancia, respectivamente.

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --override-hostname webserver1 --override-public-ip 192.0.2.3 --override-private-ip 10.0.0.2 host1

En el siguiente ejemplo, se registra una instancia local con una pila específica desde una estación de trabajo independiente. La instancia se identifica por su dirección IP. registerinicia sesión en la instancia con el SSH nombre de usuario y el archivo de clave privada especificados.

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --ssh-username admin --ssh-private-key ssh_private_key 192.0.2.3

En el siguiente ejemplo, se registra una instancia local existente con una pila específica desde una estación de trabajo independiente. El comando inicia sesión en la instancia mediante una cadena de SSH comandos personalizada que especifica la SSH contraseña y la dirección IP de la instancia.

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --override-ssh "sshpass -p 'mypassword' ssh your-user@192.0.2.3"

En el siguiente ejemplo, se registra la instancia local que ejecuta el register comando. Inicia sesión en la instancia con el --local argumento SSH y ejecútalo register con él en lugar de con un identificador de instancia o un nombre de host.

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --local

Resultado: el siguiente es el resultado típico para registrar una EC2 instancia.

Warning: Permanently added '52.11.41.206' (ECDSA) to the list of known hosts.
% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                               Dload  Upload   Total   Spent    Left  Speed
100 6403k  100 6403k    0     0  2121k      0  0:00:03  0:00:03 --:--:-- 2121k
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Initializing AWS OpsWorks environment
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Running on Ubuntu
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Checking if OS is supported
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Running on supported OS
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Setup motd
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Executing: ln -sf --backup /etc/motd.opsworks-static /etc/motd
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Enabling multiverse repositories
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Customizing APT environment
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Installing system packages
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Executing: dpkg --configure -a
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Executing with retry: apt-get update
[Tue, 24 Feb 2015 20:49:13 +0000] opsworks-init: Executing: apt-get install -y ruby ruby-dev libicu-dev libssl-dev libxslt-dev libxml2-dev libyaml-dev monit
[Tue, 24 Feb 2015 20:50:13 +0000] opsworks-init: Using assets bucket from environment: 'opsworks-instance-assets-us-east-1.s3.amazonaws.com'.
[Tue, 24 Feb 2015 20:50:13 +0000] opsworks-init: Installing Ruby for the agent
[Tue, 24 Feb 2015 20:50:13 +0000] opsworks-init: Executing: /tmp/opsworks-agent-installer.YgGq8wF3UUre6yDy/opsworks-agent-installer/opsworks-agent/bin/installer_wrapper.sh -r -R opsworks-instance-assets-us-east-1.s3.amazonaws.com
[Tue, 24 Feb 2015 20:50:44 +0000] opsworks-init: Starting the installer
Instance successfully registered. Instance ID: 4d6d1710-ded9-42a1-b08e-b043ad7af1e2
Connection to 52.11.41.206 closed.

Más información

Para obtener más información, consulte Registrar una instancia con una AWS OpsWorks pila en la Guía del AWS OpsWorks usuario.

Para establecer la configuración de escalado basada en la carga de una capa

El siguiente ejemplo habilita el escalado basado en la carga para una capa específica y establece la configuración de esa capa. Debe utilizarse create-instance para añadir instancias basadas en la carga a la capa.

aws opsworks --region us-east-1 set-load-based-auto-scaling --layer-id 523569ae-2faf-47ac-b39e-f4c4b381f36d --enable --up-scaling file://upscale.json --down-scaling file://downscale.json

El ejemplo coloca la configuración del umbral de escalado en un archivo independiente del directorio de trabajo denominadoupscale.json, que contiene lo siguiente.

{
  "InstanceCount": 2,
  "ThresholdsWaitTime": 3,
  "IgnoreMetricsTime": 3,
  "CpuThreshold": 85,
  "MemoryThreshold": 85,
  "LoadThreshold": 85
}

El ejemplo coloca la configuración del umbral de reducción de escala en un archivo independiente del directorio de trabajo denominadodownscale.json, que contiene lo siguiente.

{
"InstanceCount": 2,
"ThresholdsWaitTime": 3,
"IgnoreMetricsTime": 3,
"CpuThreshold": 35,
"MemoryThreshold": 30,
"LoadThreshold": 30
}

Resultado: ninguno.

Más información

Para obtener más información, consulte Uso del escalado automático basado en la carga en la Guía del AWS OpsWorks usuario.

Para conceder niveles de AWS OpsWorks permisos por pila

Al importar un usuario de AWS Identity and Access Management (IAM) a AWS OpsWorks mediante una llamadacreate-user-profile, el usuario solo tiene los permisos que otorgan IAM las políticas adjuntas. Puede conceder AWS OpsWorks permisos modificando las políticas de un usuario. Sin embargo, suele ser más fácil importar un usuario y, a continuación, utilizar el set-permission comando para conceder al usuario uno de los niveles de permisos estándar para cada pila a la que el usuario necesite acceder.

El siguiente ejemplo concede permiso para la pila especificada a un usuario, que se identifica mediante Amazon Resource Name (ARN). El ejemplo otorga al usuario un nivel de administración de permisos, con sudo y SSH privilegios en las instancias de la pila.

aws opsworks set-permission --region us-east-1 --stack-id 71c7ca72-55ae-4b6a-8ee1-a8dcded3fa0f --level manage  --iam-user-arn arn:aws:iam::123456789102:user/cli-user-test --allow-ssh --allow-sudo

Resultado: ninguno.

Más información

Para obtener más información, consulte Concesión de permisos por pila a los AWS OpsWorks usuarios en la Guía del AWS OpsWorks usuario.

Para establecer la configuración de escalado basada en el tiempo para una capa

El siguiente ejemplo establece la configuración basada en el tiempo para una instancia específica. Primero debe usar create-instance para agregar la instancia a la capa.

aws opsworks --region us-east-1 set-time-based-auto-scaling --instance-id 69b6237c-08c0-4edb-a6af-78f3d01cedf2 --auto-scaling-schedule file://schedule.json

En el ejemplo, se coloca la programación en un archivo independiente del directorio de trabajo denominadoschedule.json. En este ejemplo, la instancia estará activa durante unas horas alrededor del mediodía UTC (hora universal coordinada) del lunes y el martes.

{
  "Monday": {
    "10": "on",
    "11": "on",
    "12": "on",
    "13": "on"
  },
  "Tuesday": {
    "10": "on",
    "11": "on",
    "12": "on",
    "13": "on"
  }
}

Salida: ninguna.

Más información

Para obtener más información, consulte Uso del escalado automático basado en el tiempo en la Guía del AWS OpsWorks usuario.

Para iniciar una instancia

El siguiente start-instance comando inicia una instancia específica de 24 horas al día, 7 días a la semana.

aws opsworks start-instance --instance-id f705ee48-9000-4890-8bd3-20eb05825aaf

Salida: ninguna. Usa describe-instances para comprobar el estado de la instancia.

Consejo: puedes iniciar todas las instancias sin conexión de una pila con un comando llamando a start-stack.

Más información

Para obtener más información, consulte Inicio, detención y reinicio manuales de instancias ininterrumpidas en la Guía del AWS OpsWorks usuario.

Para iniciar las instancias de una pila

En el siguiente ejemplo, se inician todas las instancias ininterrumpidas de una pila. Para iniciar una instancia concreta, usastart-instance.

aws opsworks --region us-east-1 start-stack --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

Salida: ninguna.

Más información

Para obtener más información, consulte Cómo iniciar una instancia en la Guía del AWS OpsWorks usuario.

Para detener una instancia

El siguiente ejemplo detiene una instancia específica, que se identifica por su ID de instancia. Para obtener un ID de instancia, ve a la página de detalles de la instancia en la AWS OpsWorks consola o ejecuta el describe-instances comando.

aws opsworks stop-instance --region us-east-1 --instance-id 3a21cfac-4a1f-4ce2-a921-b2cfba6f7771

Puedes reiniciar una instancia detenida llamando start-instance o eliminándola mediante una llamadadelete-instance.

Resultado: ninguno.

Más información

Para obtener más información, consulte Detener una instancia en la Guía del AWS OpsWorks usuario.

Para detener las instancias de una pila

El siguiente ejemplo detiene todas las instancias ininterrumpidas de una pila. Para detener una instancia concreta, utilicestop-instance.

aws opsworks --region us-east-1 stop-stack --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

Salida: Sin salida.

Más información

Para obtener más información, consulte Detener una instancia en la Guía del AWS OpsWorks usuario.

Para anular la asignación de una instancia registrada de sus capas

El siguiente unassign-instance comando anula la asignación de una instancia de sus capas adjuntas.

aws opsworks --region us-east-1 unassign-instance --instance-id 4d6d1710-ded9-42a1-b08e-b043ad7af1e2

Salida: ninguna.

Más información

Para obtener más información, consulte Anular la asignación de una instancia registrada en la Guía del AWS OpsWorks usuario.

Para anular la asignación de un volumen de su instancia

En el siguiente ejemplo, se anula la asignación de un volumen registrado de Amazon Elastic Block Store EBS (Amazon) de su instancia. El volumen se identifica por su ID de volumen, que es el GUID que se AWS OpsWorks asigna al registrar el volumen en una pila, no por el ID de volumen de Amazon Elastic Compute Cloud (AmazonEC2).

aws opsworks --region us-east-1 unassign-volume --volume-id 8430177d-52b7-4948-9c62-e195af4703df

Salida: ninguna.

Más información

Para obtener más información, consulte Unassigning Amazon EBS Volumes en la Guía del AWS OpsWorks usuario.

Para actualizar una aplicación

En el siguiente ejemplo, se actualiza una aplicación específica para cambiarle el nombre.

aws opsworks --region us-east-1 update-app --app-id 26a61ead-d201-47e3-b55c-2a7c666942f8 --name NewAppName

Resultado: ninguno.

Más información

Para obtener más información, consulte Edición de aplicaciones en la Guía del AWS OpsWorks usuario.

Para actualizar el nombre de una dirección IP elástica

El siguiente ejemplo actualiza el nombre de una dirección IP elástica especificada.

aws opsworks --region us-east-1 update-elastic-ip --elastic-ip 54.148.130.96 --name NewIPName

Resultado: ninguno.

Más información

Para obtener más información, consulte Administración de recursos en la Guía del AWS OpsWorks usuario.

Para actualizar una instancia

En el siguiente ejemplo, se actualiza el tipo de instancia especificado.

aws opsworks --region us-east-1 update-instance --instance-id dfe18b02-5327-493d-91a4-c5c0c448927f --instance-type c3.xlarge

Salida: ninguna.

Más información

Para obtener más información, consulte Edición de la configuración de la instancia en la Guía del AWS OpsWorks usuario.

Para actualizar una capa

En el siguiente ejemplo, se actualiza una capa específica para usar instancias EBS optimizadas para Amazon.

aws opsworks --region us-east-1 update-layer --layer-id 888c5645-09a5-4d0e-95a8-812ef1db76a4 --use-ebs-optimized-instances

Salida: ninguna.

Más información

Para obtener más información, consulte Edición de la configuración de una OpsWorks capa en la Guía del AWS OpsWorks usuario.

Para actualizar el perfil de un usuario

En el siguiente ejemplo, se actualiza el perfil del development usuario para que utilice una clave SSH pública específica. Las AWS credenciales del usuario se representan mediante el development perfil del credentials archivo (~\.aws\credentials) y la clave se encuentra en un .pem archivo del directorio de trabajo.

aws opsworks --region us-east-1 --profile development update-my-user-profile --ssh-public-key file://development_key.pem

Resultado: ninguno.

Más información

Para obtener más información, consulte Edición de la configuración del AWS OpsWorks usuario en la Guía del AWS OpsWorks usuario.

Para actualizar una RDS instancia de base de datos de Amazon registrada

En el siguiente ejemplo, se actualiza el valor de la contraseña maestra de una RDS instancia de Amazon. Tenga en cuenta que este comando no cambia la contraseña maestra de la RDS instancia, solo la contraseña que usted proporciona AWS OpsWorks. Si esta contraseña no coincide con la contraseña de la RDS instancia, la aplicación no podrá conectarse a la base de datos.

aws opsworks --region us-east-1 update-rds-db-instance --db-password 123456789

Salida: ninguna.

Más información

Para obtener más información, consulte Registrar RDS instancias de Amazon con una pila en la Guía del AWS OpsWorks usuario.

Para actualizar un volumen registrado

El siguiente ejemplo actualiza el punto de montaje de un volumen registrado de Amazon Elastic Block Store (AmazonEBS). El volumen se identifica por su ID de volumen, que es el GUID que se AWS OpsWorks asigna al volumen cuando lo registras en una pila, no por el ID de volumen de Amazon Elastic Compute Cloud (AmazonEC2). :

aws opsworks --region us-east-1 update-volume --volume-id 8430177d-52b7-4948-9c62-e195af4703df --mount-point /mnt/myvol

Salida: ninguna.

Más información

Para obtener más información, consulte Asignación de EBS volúmenes de Amazon a una instancia en la Guía del AWS OpsWorks usuario.