AWS OpsWorks CM esempi utilizzando AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with AWS OpsWorks CM.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Mentre le azioni mostrano come richiamare le singole funzioni di servizio, è possibile visualizzare le azioni nel loro contesto negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Azioni

Il seguente esempio di codice mostra come utilizzareassociate-node.

AWS CLI

Per associare i nodi

Il associate-node comando seguente associa un nodo denominato i-44de882p a un server Chef Automate denominatoautomate-06, il che significa che il automate-06 server gestisce il nodo e comunica i comandi delle ricette al nodo tramite il software chef-client agente installato sul nodo dal comando associate-node. I nomi di nodo validi sono istanze. EC2 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'"

L'output restituito dal comando è simile al seguente. Output:


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

Ulteriori informazioni

Per ulteriori informazioni, consulta Aggiungere nodi automaticamente in Chef Automate nella Guida AWS OpsWorks per l'AWS OpsWorks utente.

Per API i dettagli, vedere AssociateNodein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarecreate-backup.

AWS CLI

Per creare backup

Il create-backup comando seguente avvia un backup manuale di un server Chef Automate denominato automate-06 nella us-east-1 regione. Il comando aggiunge un messaggio descrittivo al backup nel --description parametro.


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

L'output mostra informazioni simili alle seguenti sul nuovo backup.

Output:


{
    "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"
        }
    ],
}

Per ulteriori informazioni, consulta Backup and Restore an AWS OpsWorks for Chef Automate Server nella Guida per l'AWS OpsWorks utente.

Per API i dettagli, vedere CreateBackupin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarecreate-server.

AWS CLI

Per creare un server

L'create-serveresempio seguente crea un nuovo server Chef Automate denominato automate-06 nella regione predefinita. Tieni presente che i valori predefiniti vengono utilizzati per la maggior parte delle altre impostazioni, come il numero di backup da conservare e gli orari di avvio della manutenzione e del backup. Prima di eseguire un create-server comando, completa i prerequisiti in Getting Started with AWS OpsWorks for Chef Automate nella Guida per l'utente di 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"

L'output mostra informazioni simili alle seguenti sul nuovo server:


{
    "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" ]
    }
}

Per ulteriori informazioni, vedere il APIriferimento UpdateServerAWS OpsWorks a Chef Automate.

Per API i dettagli, vedere CreateServerin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-backup.

AWS CLI

Per eliminare i backup

Il delete-backup comando seguente elimina un backup manuale o automatico di un server Chef Automate, identificato dall'ID di backup. Questo comando è utile quando ci si avvicina al numero massimo di backup che è possibile salvare o se si desidera ridurre al minimo i costi di storage di Amazon S3. :


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

L'output mostra se l'eliminazione del backup è riuscita.

Ulteriori informazioni

Per ulteriori informazioni, consulta Backup and Restore an AWS OpsWorks for Chef Automate Server nella Guida per l'AWS OpsWorks utente.

Per API i dettagli, vedere DeleteBackupin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-server.

AWS CLI

Per eliminare i server

Il delete-server comando seguente elimina un server Chef Automate, identificato dal nome del server. Dopo l'eliminazione, il server non viene più restituito dalle DescribeServer richieste. :


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

L'output mostra se l'eliminazione del server è riuscita.

Ulteriori informazioni

Per ulteriori informazioni, consulta Delete an AWS OpsWorks for Chef Automate Server nella Guida per l'AWS OpsWorks utente.

Per API i dettagli, vedere DeleteServerin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredescribe-account-attributes.

AWS CLI

Per descrivere gli attributi dell'account

Il describe-account-attributes comando seguente restituisce informazioni sull'utilizzo da parte del tuo account delle AWS OpsWorks risorse Chef Automate. :


aws opsworks-cm describe-account-attributes

L'output per ogni voce di attributo dell'account restituita dal comando è simile al seguente. Output:


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

Ulteriori informazioni

Per ulteriori informazioni, vedere il APIriferimento DescribeAccountAttributes AWS OpsWorks a Chef Automate.

Per API i dettagli, vedere DescribeAccountAttributesin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredescribe-backups.

AWS CLI

Per descrivere i backup

Il describe-backups comando seguente restituisce informazioni su tutti i backup associati all'account nella regione predefinita.


aws opsworks-cm describe-backups

L'output per ogni voce di backup restituita dal comando è simile al seguente.

Output:


{
    "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"
        }
    ],
}

Per ulteriori informazioni, consulta Backup and Restore an AWS OpsWorks for Chef Automate Server nella Guida per l'AWS OpsWorks utente.

Per API i dettagli, vedere DescribeBackupsin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredescribe-events.

AWS CLI

Per descrivere gli eventi

L'describe-eventsesempio seguente restituisce informazioni su tutti gli eventi associati al server Chef Automate specificato.


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

L'output per ogni voce di evento restituita dal comando è simile al seguente esempio:


{
    "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"
        }
    ]
}

Per ulteriori informazioni, vedere Suggerimenti generali per la risoluzione dei problemi nella Guida per l'AWS OpsWorks utente.

Per API i dettagli, vedere DescribeEventsin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredescribe-node-association-status.

AWS CLI

Per descrivere lo stato dell'associazione dei nodi

Il describe-node-association-status comando seguente restituisce lo stato di una richiesta di associazione di un nodo a un server Chef Automate denominatoautomate-06. :


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

L'output per ogni voce di attributo dell'account restituita dal comando è simile al seguente. Output:


{
 "NodeAssociationStatus": "IN_PROGRESS"
}

Ulteriori informazioni

Per ulteriori informazioni, vedere il APIriferimento DescribeNodeAssociationStatus AWS OpsWorks a Chef Automate.

Per API i dettagli, vedere DescribeNodeAssociationStatusin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredescribe-servers.

AWS CLI

Per descrivere i server

Il describe-servers comando seguente restituisce informazioni su tutti i server associati all'account e nella regione predefinita. :


aws opsworks-cm describe-servers

L'output per ogni voce del server restituita dal comando è simile al seguente. Output:


{
 "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" ]
    }
 ]
}

Ulteriori informazioni

Per ulteriori informazioni, DescribeServers consulta la APIGuida AWS OpsWorks di Chef Automate.

Per API i dettagli, vedere DescribeServersin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredisassociate-node.

AWS CLI

Per dissociare i nodi

Il disassociate-node comando seguente dissocia un nodo denominatoi-44de882p, rimuovendo il nodo dalla gestione da parte di un server Chef Automate denominato. automate-06 I nomi di nodo validi sono istanze. EC2 IDs :


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'"

L'output restituito dal comando è simile al seguente. Output:


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

Ulteriori informazioni

Per ulteriori informazioni, consulta Delete an AWS OpsWorks for Chef Automate Server nella Guida per l'AWS OpsWorks utente.

Per API i dettagli, vedere DisassociateNodein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarerestore-server.

AWS CLI

Per ripristinare un server

Il restore-server comando seguente esegue un ripristino sul posto di un server Chef Automate denominato automate-06 nella regione predefinita da un backup con un ID di. automate-06-2016-11-22T16:13:27.998Z Il ripristino di un server ripristina le connessioni ai nodi gestiti dal server Chef Automate al momento dell'esecuzione del backup specificato.

aws opsworks-cm restore-server --backup-id «automate-06-2016-11-22T 16:13:27.998 Z» --server-name «automate-06"

L'output è solo l'ID del comando. Output:


(None)

Ulteriori informazioni

Per ulteriori informazioni, consulta Restore a Failed AWS OpsWorks for Chef Automate Server nella Guida per l'AWS OpsWorks utente.

Per API i dettagli, vedere RestoreServerin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarestart-maintenance.

AWS CLI

Per avviare la manutenzione

L'start-maintenanceesempio seguente avvia manualmente la manutenzione sul server Chef Automate o Puppet Enterprise specificato nella regione predefinita. Questo comando è utile se un precedente tentativo di manutenzione automatica non è riuscito e la causa sottostante dell'errore di manutenzione è stata risolta.


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

Output:


{
    "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"
    }
}

Per ulteriori informazioni, consulta Manutenzione del sistema (server Puppet Enterprise) o Manutenzione del sistema (server Chef Automate) nella Guida per l'AWS OpsWorks utente.

Per API i dettagli, vedere StartMaintenancein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareupdate-server-engine-attributes.

AWS CLI

Per aggiornare gli attributi del motore del server

Il update-server-engine-attributes comando seguente aggiorna il valore dell'attributo CHEF_PIVOTAL_KEY engine per un server Chef Automate denominatoautomate-06. Al momento non è possibile modificare il valore di altri attributi del motore.


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

L'output mostra informazioni simili alle seguenti sul server aggiornato.


{
    "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" ]
    }
}

Per ulteriori informazioni, vedere il APIriferimento UpdateServerEngineAttributesAWS OpsWorks a Chef Automate.

Per API i dettagli, vedere UpdateServerEngineAttributesin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareupdate-server.

AWS CLI

Per aggiornare un server

Il update-server comando seguente aggiorna l'ora di inizio della manutenzione del server Chef Automate specificato nella regione predefinita. Il --preferred-maintenance-window parametro viene aggiunto per modificare il giorno e l'ora di inizio della manutenzione del server al lunedì alle 9:15. UTC. :


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

L'output mostra informazioni simili alle seguenti sul server aggiornato.


{
    "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" ]
    }
}

Per ulteriori informazioni, vedere il APIriferimento UpdateServerAWS OpsWorks a Chef Automate.

Per API i dettagli, vedere UpdateServerin AWS CLI Command Reference.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

AWS OpsWorks

Organizations