AWS OpsWorks CM ejemplos que utilizan AWS CLI - AWS Command Line Interface
Acciones

Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

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.

AWS OpsWorks CM ejemplos que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS Command Line Interface with AWS OpsWorks CM.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

El siguiente ejemplo de código muestra cómo usarloassociate-node.

AWS CLI

Para asociar nodos

El siguiente associate-node comando asocia un nodo i-44de882p con un nombre de servidor de Chef Automateautomate-06, lo que significa que el automate-06 servidor administra el nodo y comunica los comandos de receta al nodo a través del software de chef-client agente que se instala en el nodo mediante el comando associate-node. Los nombres de nodo válidos son EC2 instancia. IDs :

aws opsworks-cm associate-node --server-name "automate-06" --node-name "i-43de882p" --engine-attributes "Name=CHEF_ORGANIZATION,Value='MyOrganization' Name=CHEF_NODE_PUBLIC_KEY,Value='Public_key_contents'"

El resultado devuelto por el comando es similar al siguiente. Salida:

{
 "NodeAssociationStatusToken": "AHUY8wFe4pdXtZC5DiJa5SOLp5o14DH//rHRqHDWXxwVoNBxcEy4V7R0NOFymh7E/1HumOBPsemPQFE6dcGaiFk"
}

Más información

Para obtener más información, consulte Añadir nodos automáticamente a Chef Automate en la Guía del AWS OpsWorks usuario. AWS OpsWorks

  • Para API obtener más información, consulte AssociateNodela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlocreate-backup.

AWS CLI

Para crear copias de seguridad

El siguiente create-backup comando inicia una copia de seguridad manual de un servidor de Chef Automate nombrado automate-06 en la us-east-1 región. El comando añade un mensaje descriptivo a la copia de seguridad del --description parámetro.

aws opsworks-cm create-backup \
    --server-name 'automate-06' \
    --description "state of my infrastructure at launch"

El resultado muestra información similar a la siguiente sobre la nueva copia de seguridad.

Salida:

{
    "Backups": [
        {
            "BackupArn": "string",
            "BackupId": "automate-06-20160729133847520",
            "BackupType": "MANUAL",
            "CreatedAt": 2016-07-29T13:38:47.520Z,
            "Description": "state of my infrastructure at launch",
            "Engine": "Chef",
            "EngineModel": "Single",
            "EngineVersion": "12",
            "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/automate-06-1010V4UU2WRM2",
            "InstanceType": "m4.large",
            "KeyPair": "",
            "PreferredBackupWindow": "",
            "PreferredMaintenanceWindow": "",
            "S3LogUrl": "https://s3.amazonaws.com/<bucket-name>/automate-06-20160729133847520",
            "SecurityGroupIds": [ "sg-1a24c270" ],
            "ServerName": "automate-06",
            "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role.1114810729735",
            "Status": "OK",
            "StatusDescription": "",
            "SubnetIds": [ "subnet-49436a18" ],
            "ToolsVersion": "string",
            "UserArn": "arn:aws:iam::1019881987024:user/opsworks-user"
        }
    ],
}

Para obtener más información, consulte Hacer una copia de seguridad y restaurar un servidor de AWS OpsWorks For Chef Automate en la Guía del AWS OpsWorks usuario.

  • Para API obtener más información, consulte CreateBackupla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlocreate-server.

AWS CLI

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 "Chef" \
    --engine-model "Single" \
    --engine-version "12" \
    --server-name "automate-06" \
    --instance-profile-arn "arn:aws:iam::1019881987024:instance-profile/aws-opsworks-cm-ec2-role" \
    --instance-type "t2.medium" \
    --key-pair "amazon-test" \
    --service-role-arn "arn:aws:iam::044726508045:role/aws-opsworks-cm-service-role"

El resultado muestra información similar a la siguiente sobre el nuevo servidor:

{
    "Server": {
        "BackupRetentionCount": 10,
        "CreatedAt": 2016-07-29T13:38:47.520Z,
        "DisableAutomatedBackup": FALSE,
        "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com",
        "Engine": "Chef",
        "EngineAttributes": [
            {
                "Name": "CHEF_DELIVERY_ADMIN_PASSWORD",
                "Value": "1Password1"
            }
        ],
        "EngineModel": "Single",
        "EngineVersion": "12",
        "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/aws-opsworks-cm-ec2-role",
        "InstanceType": "t2.medium",
        "KeyPair": "amazon-test",
        "MaintenanceStatus": "",
        "PreferredBackupWindow": "Sun:02:00",
        "PreferredMaintenanceWindow": "00:00",
        "SecurityGroupIds": [ "sg-1a24c270" ],
        "ServerArn": "arn:aws:iam::1019881987024:instance/automate-06-1010V4UU2WRM2",
        "ServerName": "automate-06",
        "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role",
        "Status": "CREATING",
        "StatusReason": "",
        "SubnetIds": [ "subnet-49436a18" ]
    }
}

Para obtener más información, consulte UpdateServerla APIreferencia AWS OpsWorks de Chef Automate.

  • Para API obtener más información, consulte CreateServerla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-backup.

AWS CLI

Para eliminar copias de seguridad

El siguiente delete-backup comando elimina una copia de seguridad manual o automática de un servidor Chef Automate, identificada por el ID de la copia de seguridad. Este comando resulta útil cuando se acerca al número máximo de copias de seguridad que puede guardar o si desea minimizar los costes de almacenamiento en Amazon S3. :

aws opsworks-cm delete-backup --backup-id "automate-06-2016-11-19T23:42:40.240Z"

El resultado muestra si la eliminación de la copia de seguridad se ha realizado correctamente.

Más información

Para obtener más información, consulte Hacer una copia de seguridad y restaurar un servidor AWS OpsWorks para Chef Automate en la Guía del AWS OpsWorks usuario.

  • Para API obtener más información, consulte DeleteBackupla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodelete-server.

AWS CLI

Para eliminar servidores

El siguiente delete-server comando elimina un servidor de Chef Automate, identificado por el nombre del servidor. Una vez eliminado el servidor, las DescribeServer solicitudes ya no lo devuelven. :

aws opsworks-cm delete-server --server-name "automate-06"

El resultado muestra si la eliminación del servidor se ha realizado correctamente.

Más información

Para obtener más información, consulte Eliminar un servidor AWS OpsWorks de Chef Automate en la Guía del AWS OpsWorks usuario.

  • Para API obtener más información, consulte DeleteServerla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-account-attributes.

AWS CLI

Descripción de atributos de cuenta

El siguiente describe-account-attributes comando devuelve información sobre el uso de los recursos de Chef Automate AWS OpsWorks por parte de su cuenta. :

aws opsworks-cm describe-account-attributes

El resultado de cada entrada de atributo de cuenta devuelto por el comando es similar al siguiente. Salida:

{
 "Attributes": [
    {
       "Maximum": 5,
       "Name": "ServerLimit",
       "Used": 2
    }
 ]
}

Más información

Para obtener más información, consulte DescribeAccountAttributes la APIreferencia AWS OpsWorks de Chef Automate.

El siguiente ejemplo de código muestra cómo usarlodescribe-backups.

AWS CLI

Para describir las copias de seguridad

El siguiente describe-backups comando devuelve información sobre todas las copias de seguridad asociadas a su cuenta en la región predeterminada.

aws opsworks-cm describe-backups

El resultado de cada entrada de copia de seguridad devuelta por el comando es similar al siguiente.

Salida:

{
    "Backups": [
        {
            "BackupArn": "string",
            "BackupId": "automate-06-20160729133847520",
            "BackupType": "MANUAL",
            "CreatedAt": 2016-07-29T13:38:47.520Z,
            "Description": "state of my infrastructure at launch",
            "Engine": "Chef",
            "EngineModel": "Single",
            "EngineVersion": "12",
            "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/automate-06-1010V4UU2WRM2",
            "InstanceType": "m4.large",
            "KeyPair": "",
            "PreferredBackupWindow": "",
            "PreferredMaintenanceWindow": "",
            "S3LogUrl": "https://s3.amazonaws.com/<bucket-name>/automate-06-20160729133847520",
            "SecurityGroupIds": [ "sg-1a24c270" ],
            "ServerName": "automate-06",
            "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role.1114810729735",
            "Status": "Successful",
            "StatusDescription": "",
            "SubnetIds": [ "subnet-49436a18" ],
            "ToolsVersion": "string",
            "UserArn": "arn:aws:iam::1019881987024:user/opsworks-user"
        }
    ],
}

Para obtener más información, consulte Hacer una copia de seguridad y restaurar un servidor de AWS OpsWorks For Chef Automate en la Guía del AWS OpsWorks usuario.

  • Para API obtener más información, consulte DescribeBackupsla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-events.

AWS CLI

Para describir eventos

El siguiente describe-events ejemplo devuelve información sobre todos los eventos asociados al servidor Chef Automate especificado.

aws opsworks-cm describe-events \
    --server-name 'automate-06'

El resultado de cada entrada de evento devuelto por el comando es similar al siguiente ejemplo:

{
    "ServerEvents": [
        {
            "CreatedAt": 2016-07-29T13:38:47.520Z,
            "LogUrl": "https://s3.amazonaws.com/<bucket-name>/automate-06-20160729133847520",
            "Message": "Updates successfully installed.",
            "ServerName": "automate-06"
        }
    ]
}

Para obtener más información, consulte los consejos generales de solución de problemas en la Guía del AWS OpsWorks usuario.

  • Para API obtener más información, consulte DescribeEventsla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodescribe-node-association-status.

AWS CLI

Para describir el estado de asociación de nodos

El siguiente describe-node-association-status comando devuelve el estado de una solicitud para asociar un nodo a un servidor de Chef Automate denominadoautomate-06. :

aws opsworks-cm describe-node-association-status --server-name "automate-06" --node-association-status-token "AflJKl+/GoKLZJBdDQEx0O65CDi57blQe9nKM8joSok0pQ9xr8DqApBN9/1O6sLdSvlfDEKkEx+eoCHvjoWHaOs="

El resultado de cada entrada de atributo de cuenta devuelto por el comando es similar al siguiente. Salida:

{
 "NodeAssociationStatus": "IN_PROGRESS"
}

Más información

Para obtener más información, consulte DescribeNodeAssociationStatus la APIreferencia AWS OpsWorks de Chef Automate.

El siguiente ejemplo de código muestra cómo usarlodescribe-servers.

AWS CLI

Para describir los servidores

El siguiente describe-servers comando devuelve información sobre todos los servidores que están asociados a su cuenta y en su región predeterminada. :

aws opsworks-cm describe-servers

El resultado de cada entrada del servidor devuelto por el comando es similar al siguiente. Salida:

{
 "Servers": [
    {
       "BackupRetentionCount": 8,
       "CreatedAt": 2016-07-29T13:38:47.520Z,
       "DisableAutomatedBackup": FALSE,
       "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com",
       "Engine": "Chef",
       "EngineAttributes": [
          {
             "Name": "CHEF_DELIVERY_ADMIN_PASSWORD",
             "Value": "1Password1"
          }
       ],
       "EngineModel": "Single",
       "EngineVersion": "12",
       "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/automate-06-1010V4UU2WRM2",
       "InstanceType": "m4.large",
       "KeyPair": "",
       "MaintenanceStatus": "SUCCESS",
       "PreferredBackupWindow": "03:00",
       "PreferredMaintenanceWindow": "Mon:09:00",
       "SecurityGroupIds": [ "sg-1a24c270" ],
       "ServerArn": "arn:aws:iam::1019881987024:instance/automate-06-1010V4UU2WRM2",
       "ServerName": "automate-06",
       "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role.1114810729735",
       "Status": "HEALTHY",
       "StatusReason": "",
       "SubnetIds": [ "subnet-49436a18" ]
    }
 ]
}

Más información

Para obtener más información, consulte DescribeServers la APIguía AWS OpsWorks de Chef Automate.

  • Para API obtener más información, consulte DescribeServersla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlodisassociate-node.

AWS CLI

Para desasociar nodos

El siguiente disassociate-node comando desasocia un nodo denominado i-44de882p y elimina el nodo de la administración por parte de un servidor de Chef Automate denominado. automate-06 Los nombres de nodo válidos son EC2 instanciaIDs. :

aws opsworks-cm disassociate-node --server-name "automate-06" --node-name "i-43de882p" --engine-attributes "Name=CHEF_ORGANIZATION,Value='MyOrganization' Name=CHEF_NODE_PUBLIC_KEY,Value='Public_key_contents'"

El resultado devuelto por el comando es similar al siguiente. Salida:

{
 "NodeAssociationStatusToken": "AHUY8wFe4pdXtZC5DiJa5SOLp5o14DH//rHRqHDWXxwVoNBxcEy4V7R0NOFymh7E/1HumOBPsemPQFE6dcGaiFk"
}

Más información

Para obtener más información, consulte Eliminar un servidor AWS OpsWorks de Chef Automate en la Guía del AWS OpsWorks usuario.

  • Para API obtener más información, consulte DisassociateNodela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlorestore-server.

AWS CLI

Para restaurar un servidor

El siguiente restore-server comando realiza una restauración in situ de un servidor de Chef Automate nombrado automate-06 en su región predeterminada a partir de una copia de seguridad con un ID deautomate-06-2016-11-22T16:13:27.998Z. Al restaurar un servidor, se restauran las conexiones a los nodos que el servidor de Chef Automate administraba en el momento en que se realizó la copia de seguridad especificada.

aws opsworks-cm restore-server --backup-id «Automate-06-2016-11-22T 16:13:27 .998 Z» --nombre de servidor «automate-06"

El resultado es solo el ID del comando. Salida:

(None)

Más información

Para obtener más información, consulte Restaurar un servidor de Chef Automate que ha fallado AWS OpsWorks en la Guía del AWS OpsWorks usuario.

  • Para API obtener más información, consulte RestoreServerla Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarlostart-maintenance.

AWS CLI

Para iniciar el mantenimiento

El siguiente start-maintenance ejemplo inicia manualmente el mantenimiento en el servidor Chef Automate o Puppet Enterprise especificado en su región predeterminada. Este comando resulta útil si se ha producido un error en un intento de mantenimiento automatizado anterior y se ha resuelto la causa subyacente del fallo de mantenimiento.

aws opsworks-cm start-maintenance \
    --server-name 'automate-06'

Salida:

{
    "Server": {
        "AssociatePublicIpAddress": true,
        "BackupRetentionCount": 10,
        "ServerName": "automate-06",
        "CreatedAt": 1569229584.842,
        "CloudFormationStackArn": "arn:aws:cloudformation:us-west-2:123456789012:stack/aws-opsworks-cm-instance-automate-06-1606611794746/EXAMPLE0-31de-11eb-bdb0-0a5b0a1353b8",
        "DisableAutomatedBackup": false,
        "Endpoint": "automate-06-EXAMPLEvr8gjfk5f.us-west-2.opsworks-cm.io",
        "Engine": "ChefAutomate",
        "EngineModel": "Single",
        "EngineAttributes": [],
        "EngineVersion": "2020-07",
        "InstanceProfileArn": "arn:aws:iam::123456789012:instance-profile/aws-opsworks-cm-ec2-role",
        "InstanceType": "m5.large",
        "PreferredMaintenanceWindow": "Sun:01:00",
        "PreferredBackupWindow": "Sun:15:00",
        "SecurityGroupIds": [
            "sg-EXAMPLE"
        ],
        "ServiceRoleArn": "arn:aws:iam::123456789012:role/service-role/aws-opsworks-cm-service-role",
        "Status": "UNDER_MAINTENANCE",
        "SubnetIds": [
            "subnet-EXAMPLE"
        ],
        "ServerArn": "arn:aws:opsworks-cm:us-west-2:123456789012:server/automate-06/0148382d-66b0-4196-8274-d1a2b6dff8d1"
    }
}

Para obtener más información, consulte Mantenimiento del sistema (servidores Puppet Enterprise) o Mantenimiento del sistema (servidores Chef Automate) en la Guía del AWS OpsWorks usuario.

  • Para API obtener más información, consulte StartMaintenancela Referencia de AWS CLI comandos.

El siguiente ejemplo de código muestra cómo usarloupdate-server-engine-attributes.

AWS CLI

Para actualizar los atributos del motor del servidor

El siguiente update-server-engine-attributes comando actualiza el valor del atributo del CHEF_PIVOTAL_KEY motor para un servidor de Chef Automate denominadoautomate-06. Actualmente no es posible cambiar el valor de otros atributos del motor.

aws opsworks-cm update-server-engine-attributes \
    --attribute-name CHEF_PIVOTAL_KEY \
    --attribute-value "new key value" \
    --server-name "automate-06"

El resultado muestra información similar a la siguiente sobre el servidor actualizado.

{
    "Server": {
        "BackupRetentionCount": 2,
        "CreatedAt": 2016-07-29T13:38:47.520Z,
        "DisableAutomatedBackup": FALSE,
        "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com",
        "Engine": "Chef",
        "EngineAttributes": [
            {
                "Name": "CHEF_PIVOTAL_KEY",
                "Value": "new key value"
            }
        ],
        "EngineModel": "Single",
        "EngineVersion": "12",
        "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/automate-06-1010V4UU2WRM2",
        "InstanceType": "m4.large",
        "KeyPair": "",
        "MaintenanceStatus": "SUCCESS",
        "PreferredBackupWindow": "Mon:09:15",
        "PreferredMaintenanceWindow": "03:00",
        "SecurityGroupIds": [ "sg-1a24c270" ],
        "ServerArn": "arn:aws:iam::1019881987024:instance/automate-06-1010V4UU2WRM2",
        "ServerName": "automate-06",
        "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role.1114810729735",
        "Status": "HEALTHY",
        "StatusReason": "",
        "SubnetIds": [ "subnet-49436a18" ]
    }
}

Para obtener más información, consulte UpdateServerEngineAttributesla APIreferencia AWS OpsWorks de Chef Automate.

El siguiente ejemplo de código muestra cómo usarloupdate-server.

AWS CLI

Para actualizar un servidor

El siguiente update-server comando actualiza la hora de inicio del mantenimiento del servidor Chef Automate especificado en su región predeterminada. El --preferred-maintenance-window parámetro se agrega para cambiar el día y la hora de inicio del mantenimiento del servidor a los lunes a las 9:15 a.m. UTC. :

aws opsworks-cm update-server \
    --server-name "automate-06" \
    --preferred-maintenance-window "Mon:09:15"

El resultado muestra información similar a la siguiente sobre el servidor actualizado.

{
    "Server": {
        "BackupRetentionCount": 8,
        "CreatedAt": 2016-07-29T13:38:47.520Z,
        "DisableAutomatedBackup": TRUE,
        "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com",
        "Engine": "Chef",
        "EngineAttributes": [
            {
                "Name": "CHEF_DELIVERY_ADMIN_PASSWORD",
                "Value": "1Password1"
            }
        ],
        "EngineModel": "Single",
        "EngineVersion": "12",
        "InstanceProfileArn": "arn:aws:iam::1019881987024:instance-profile/automate-06-1010V4UU2WRM2",
        "InstanceType": "m4.large",
        "KeyPair": "",
        "MaintenanceStatus": "OK",
        "PreferredBackupWindow": "Mon:09:15",
        "PreferredMaintenanceWindow": "03:00",
        "SecurityGroupIds": [ "sg-1a24c270" ],
        "ServerArn": "arn:aws:iam::1019881987024:instance/automate-06-1010V4UU2WRM2",
        "ServerName": "automate-06",
        "ServiceRoleArn": "arn:aws:iam::1019881987024:role/aws-opsworks-cm-service-role.1114810729735",
        "Status": "HEALTHY",
        "StatusReason": "",
        "SubnetIds": [ "subnet-49436a18" ]
    }
}

Para obtener más información, consulte UpdateServerla APIreferencia AWS OpsWorks de Chef Automate.

  • Para API obtener más información, consulte UpdateServerla Referencia de AWS CLI comandos.