AWS OpsWorks CM Beispiele mit AWS CLI - AWS Command Line Interface
Aktionen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWS OpsWorks CM Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren AWS OpsWorks CM.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Aktionen zeigen Ihnen zwar, wie Sie einzelne Servicefunktionen aufrufen, aber Sie können Aktionen im Kontext der zugehörigen Szenarien sehen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, in dem Sie Anweisungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt die Verwendungassociate-node.

AWS CLI

Um Knoten zuzuordnen

Der folgende associate-node Befehl ordnet einen Knoten i-44de882p mit einem Chef Automate-Server mit dem Namen zuautomate-06, was bedeutet, dass der automate-06 Server den Knoten verwaltet und Rezeptbefehle über die chef-client Agentsoftware, die mit dem Befehl associate-node auf dem Knoten installiert wird, an den Knoten übermittelt. Gültige Knotennamen sind Instanz. 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'"

Die vom Befehl zurückgegebene Ausgabe ähnelt der folgenden. Ausgabe:

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

Weitere Informationen

Weitere Informationen finden Sie unter Automatisches Hinzufügen von Knoten in Chef Automate im AWS OpsWorks Benutzerhandbuch. AWS OpsWorks

  • APIEinzelheiten finden Sie AssociateNodein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-backup.

AWS CLI

Um Backups zu erstellen

Der folgende create-backup Befehl startet eine manuelle Sicherung eines Chef Automate-Servers, der automate-06 in der us-east-1 Region benannt ist. Der Befehl fügt dem Backup im --description Parameter eine beschreibende Nachricht hinzu.

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

In der Ausgabe werden Ihnen Informationen über das neue Backup angezeigt, die den folgenden ähneln.

Ausgabe:

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

Weitere Informationen finden Sie unter Sichern und Wiederherstellen eines AWS OpsWorks for Chef Automate-Servers im AWS OpsWorks Benutzerhandbuch.

  • APIEinzelheiten finden Sie CreateBackupunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-server.

AWS CLI

Um einen Server zu erstellen

Das folgende create-server Beispiel erstellt einen neuen Chef Automate-Server mit automate-06 dem Namen Ihrer Standardregion. Beachten Sie, dass Standardwerte für die meisten anderen Einstellungen verwendet werden, z. B. für die Anzahl der aufzubewahrenden Backups sowie für die Startzeiten für Wartung und Sicherung. Bevor Sie einen create-server Befehl ausführen, müssen Sie die Voraussetzungen unter Erste Schritte mit AWS OpsWorks für Chef Automate im AWS Opsworks for Chef Automate-Benutzerhandbuch erfüllen.

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"

In der Ausgabe werden Ihnen Informationen über den neuen Server angezeigt, die den folgenden ähneln:

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

Weitere Informationen finden Sie UpdateServerin der AWS OpsWorks for Chef API Automate-Referenz.

  • APIEinzelheiten finden Sie CreateServerunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-backup.

AWS CLI

Um Backups zu löschen

Der folgende delete-backup Befehl löscht eine manuelle oder automatische Sicherung eines Chef Automate-Servers, der durch die Backup-ID identifiziert wird. Dieser Befehl ist nützlich, wenn Sie sich der maximalen Anzahl von Backups nähern, die Sie speichern können, oder wenn Sie Ihre Amazon S3 S3-Speicherkosten minimieren möchten. :

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

Die Ausgabe zeigt, ob das Löschen des Backups erfolgreich war.

Weitere Informationen

Weitere Informationen finden Sie unter Sichern und Wiederherstellen eines AWS OpsWorks für Chef Automate Server im AWS OpsWorks Benutzerhandbuch.

  • APIEinzelheiten finden Sie DeleteBackupunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-server.

AWS CLI

Um Server zu löschen

Der folgende delete-server Befehl löscht einen Chef Automate-Server, der durch den Namen des Servers identifiziert wird. Nachdem der Server gelöscht wurde, wird er nicht mehr durch DescribeServer Anfragen zurückgegeben. :

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

Die Ausgabe zeigt, ob das Löschen des Servers erfolgreich war.

Weitere Informationen

Weitere Informationen finden Sie unter Löschen eines AWS OpsWorks for Chef Automate Servers im AWS OpsWorks Benutzerhandbuch.

  • APIEinzelheiten finden Sie DeleteServerunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-account-attributes.

AWS CLI

Um Kontoattribute zu beschreiben

Der folgende describe-account-attributes Befehl gibt Informationen über die Nutzung von AWS OpsWorks For Chef Automate-Ressourcen durch Ihr Konto zurück. :

aws opsworks-cm describe-account-attributes

Die Ausgabe für jeden vom Befehl zurückgegebenen Kontoattributeintrag ähnelt der folgenden. Ausgabe:

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

Weitere Informationen

Weitere Informationen finden Sie DescribeAccountAttributes in der AWS OpsWorks for Chef API Automate-Referenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-backups.

AWS CLI

Um Backups zu beschreiben

Der folgende describe-backups Befehl gibt Informationen zu allen Backups zurück, die mit Ihrem Konto in Ihrer Standardregion verknüpft sind.

aws opsworks-cm describe-backups

Die Ausgabe für jeden vom Befehl zurückgegebenen Backup-Eintrag ähnelt der folgenden.

Ausgabe:

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

Weitere Informationen finden Sie unter Sichern und Wiederherstellen eines AWS OpsWorks for Chef Automate-Servers im AWS OpsWorks Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungdescribe-events.

AWS CLI

Um Ereignisse zu beschreiben

Das folgende describe-events Beispiel gibt Informationen zu allen Ereignissen zurück, die dem angegebenen Chef Automate-Server zugeordnet sind.

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

Die Ausgabe für jeden vom Befehl zurückgegebenen Ereigniseintrag ähnelt dem folgenden Beispiel:

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

Weitere Informationen finden Sie im AWS OpsWorks Benutzerhandbuch unter Allgemeine Tipps zur Problembehandlung.

  • APIEinzelheiten finden Sie DescribeEventsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-node-association-status.

AWS CLI

Um den Status der Knotenzuweisung zu beschreiben

Der folgende describe-node-association-status Befehl gibt den Status einer Anfrage zurück, einen Knoten einem Chef Automate-Server mit dem Namen zuzuordnenautomate-06. :

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

Die Ausgabe für jeden vom Befehl zurückgegebenen Kontoattributeintrag ähnelt der folgenden. Ausgabe:

{
 "NodeAssociationStatus": "IN_PROGRESS"
}

Weitere Informationen

Weitere Informationen finden Sie DescribeNodeAssociationStatus in der AWS OpsWorks for Chef API Automate-Referenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-servers.

AWS CLI

Um Server zu beschreiben

Der folgende describe-servers Befehl gibt Informationen zu allen Servern zurück, die Ihrem Konto zugeordnet sind, und zwar in Ihrer Standardregion. :

aws opsworks-cm describe-servers

Die Ausgabe für jeden vom Befehl zurückgegebenen Servereintrag ähnelt der folgenden. Ausgabe:

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

Weitere Informationen

Weitere Informationen finden Sie DescribeServers im AWS OpsWorks for Chef Automate API Guide.

  • APIEinzelheiten finden Sie DescribeServersin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdisassociate-node.

AWS CLI

Um Knoten zu trennen

Der folgende disassociate-node Befehl trennt einen Knoten mit dem Namen i-44de882p und entfernt den Knoten aus der Verwaltung durch einen Chef Automate-Server mit dem Namen. automate-06 Gültige Knotennamen sind EC2 InstanzIDs. :

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

Die vom Befehl zurückgegebene Ausgabe ähnelt der folgenden. Ausgabe:

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

Weitere Informationen

Weitere Informationen finden Sie unter Löschen eines AWS OpsWorks for Chef Automate Servers im AWS OpsWorks Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungrestore-server.

AWS CLI

Um einen Server wiederherzustellen

Der folgende restore-server Befehl führt eine direkte Wiederherstellung eines Chef Automate-Servers mit dem Namen automate-06 in Ihrer Standardregion aus einem Backup mit der ID von durchautomate-06-2016-11-22T16:13:27.998Z. Durch das Wiederherstellen eines Servers werden Verbindungen zu den Knoten wiederhergestellt, die der Chef Automate-Server zum Zeitpunkt der Durchführung der angegebenen Sicherung verwaltete.

aws opsworks-cm restore-server --backup-id „Automate-06-2016-11-22T 16:13:27.998 Z“ --servername „automate-06"

Die Ausgabe ist nur die Befehls-ID. Ausgabe:

(None)

Weitere Informationen

Weitere Informationen finden Sie unter Restore a Failed AWS OpsWorks for Chef Automate Server im AWS OpsWorks Benutzerhandbuch.

  • APIEinzelheiten finden Sie RestoreServerin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungstart-maintenance.

AWS CLI

Um die Wartung zu starten

Im folgenden start-maintenance Beispiel wird die Wartung auf dem angegebenen Chef Automate- oder Puppet Enterprise-Server in Ihrer Standardregion manuell gestartet. Dieser Befehl ist nützlich, wenn ein früherer, automatisierter Wartungsversuch fehlgeschlagen ist und die zugrunde liegende Ursache des Wartungsfehlers behoben wurde.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Systemwartung (Puppet Enterprise-Server) oder Systemwartung (Chef Automate-Server) im AWS OpsWorks Benutzerhandbuch.

Das folgende Codebeispiel zeigt die Verwendungupdate-server-engine-attributes.

AWS CLI

Um die Attribute der Server-Engine zu aktualisieren

Der folgende update-server-engine-attributes Befehl aktualisiert den Wert des CHEF_PIVOTAL_KEY Engine-Attributs für einen Chef Automate-Server mit dem Namenautomate-06. Es ist derzeit nicht möglich, den Wert anderer Engine-Attribute zu ändern.

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

In der Ausgabe werden Informationen über den aktualisierten Server angezeigt, die den folgenden ähneln.

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

Weitere Informationen finden Sie UpdateServerEngineAttributesin der AWS OpsWorks for Chef API Automate-Referenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-server.

AWS CLI

Um einen Server zu aktualisieren

Der folgende update-server Befehl aktualisiert die Startzeit der Wartung des angegebenen Chef Automate-Servers in Ihrer Standardregion. Der --preferred-maintenance-window Parameter wurde hinzugefügt, um den Starttag und die Uhrzeit der Serverwartung auf Montag um 9:15 Uhr zu ändern. UTC. :

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

In der Ausgabe werden Informationen über den aktualisierten Server angezeigt, die den folgenden ähneln.

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

Weitere Informationen finden Sie UpdateServerin der AWS OpsWorks for Chef API Automate-Referenz.

  • APIEinzelheiten finden Sie UpdateServerunter AWS CLI Befehlsreferenz.