Registrieren der Instance

Wichtig

Der AWS OpsWorks Stacks Dienst hat am 26. Mai 2024 das Ende seiner Lebensdauer erreicht und wurde sowohl für neue als auch für bestehende Kunden deaktiviert. Wir empfehlen Kunden dringend, ihre Workloads so bald wie möglich auf andere Lösungen zu migrieren. Wenn Sie Fragen zur Migration haben, wenden Sie sich an das AWS Support Team auf AWS re:POST oder über den AWS Premium-Support.

Anmerkung

Diese Funktion wird nur für Linux-Stacks unterstützt.

Sie registrieren eine Instance, indem Sie den Befehl AWS CLI register von der Workstation oder auf der Instance ausführen. Die einfachste Möglichkeit dafür bietet der Registrierungsassistent der AWS OpsWorks Stacks-Konsole, der die Erstellung der Befehlszeichenfolge vereinfacht. Sofern Sie mit dem Registrierungsverfahren vertraut sind, können Sie ggf. den Assistenten überspringen und den Befehl register ausführen.

Nachfolgend wird beschrieben, wie Sie mit dem Registrierungsassistenten eine Instance für einen vorhandenen Stack registrieren.

Anmerkung

Um eine Instance bei einem neuen Stack zu registrieren, kannst du dies tun, indem du im AWS OpsWorks Stacks-Dashboard die Option Instanzen registrieren auswählst. Der gestartete Assistent ist mit dem für vorhandene Stacks identisch und weist eine weitere Seite für die Konfiguration des neuen Stacks auf.

So verwenden Sie den Registrierungsassistenten zum Registrieren einer Instance

1. Erstellen Sie in der AWS OpsWorks -Konsole einen Stack oder öffnen Sie einen vorhandenen Stack.

2. Wählen Sie im Navigationsbereich Instances und anschließend register an instance aus.

3. Geben Sie auf der Seite Choose an Instance Type an, ob Sie eine Amazon EC2- oder eine lokale Instance registrieren möchten:

   • Wenn Sie eine Amazon EC2 EC2-Instance registrieren, wählen Sie Weiter: Select Instances.

   • Wenn Sie eine lokale Instance registrieren, wählen Sie Weiter: AWS-CLI installieren und fahren Sie dann mit Schritt 5 fort.

4. Wenn Sie eine Amazon EC2 EC2-Instance registrieren, öffnen Sie die Seite Select Instances, um die zu registrierende Instance auszuwählen. AWS OpsWorks Stacks sammelt die Informationen, die zur Erstellung des Befehls benötigt werden. Wenn Sie fertig sind, klicken Sie auf Next:Install AWS CLI.

5. Die Instanz, auf der Sie ausführen möchten, register muss Version 1.16.180 von oder neuer ausführen. AWS CLI Wenn Sie die AWS CLI installieren oder aktualisieren müssen, finden Sie auf der Seite des Registrierungsassistenten Links zu Installations- und Konfigurationsanweisungen. Überprüfen Sie die AWS CLI -Installation und geben Sie anschließend an, ob der Befehl auf der zu registrierenden Instance oder von einer separaten Workstation ausgeführt werden soll. Wählen Sie dann Next: Register Instances (Weiter: Instances registrieren) aus.

6. Auf der Seite Register Instances wird eine Vorlage für eine register-Befehlszeichenfolge mit den von Ihnen ausgewählten Optionen angezeigt. Wenn Sie beispielsweise eine Amazon EC2 EC2-Instance von einer separaten Workstation aus registrieren, ähnelt die Standardvorlage der folgenden.

   aws opsworks register --infrastructure-class ec2 --region us-west-2
     --stack-id 247be7ea-3551-4177-9524-1ff804f453e3 --ssh-username [username] i-f1245d10

   Wichtig

   Der IAM-Benutzer, der während des Registrierungsprozesses erstellt wird, ist während der gesamten Lebensdauer einer registrierten Instance erforderlich. Das Löschen des Benutzers führt dazu, dass der AWS OpsWorks Stacks-Agent nicht mit dem Dienst kommunizieren kann. Um Probleme bei der Verwaltung registrierter Instanzen zu vermeiden, falls der Benutzer versehentlich gelöscht wird, fügen Sie Ihrem register Befehl den --use-instance-profile Parameter hinzu, um stattdessen das integrierte Instanzprofil der Instanz zu verwenden. Durch das Hinzufügen des --use-instance-profile Parameters wird außerdem verhindert, dass Fehler auftreten, wenn Sie die AWS Kontozugriffsschlüssel alle 90 Tage wechseln (eine empfohlene bewährte Methode), da auf diese Weise Diskrepanzen zwischen den für den AWS OpsWorks Agenten verfügbaren Zugriffsschlüsseln und den erforderlichen IAM-Benutzern vermieden werden.

   Wenn Sie Ich verwende SSH-Schlüssel auf Ja setzen, fügt AWS OpsWorks Stacks das --ssh-private-key Argument zur Zeichenfolge hinzu, mit der Sie eine private SSH-Schlüsseldatei angeben können.

   Anmerkung

   Wenn Sie sich mit einem Passwort anmelden register möchten, setzen Sie Ich verwende SSH-Schlüssel auf Nein. Beim Ausführen register werden Sie zur Eingabe des Kennworts aufgefordert.

   Kopieren Sie diese Zeichenfolge in einen Texteditor und nehmen Sie die erforderlichen Änderungen vor. Beachten Sie Folgendes:

   • Der Text in Klammern gibt Informationen vor, die Sie bereitstellen müssen (z. B. den Speicherort der SSH-Schlüsseldatei).

   • Die Vorlage geht davon aus, dass register mit den AWS-Standardanmeldeinformationen ausgeführt wird. Ist das nicht Fall, fügen Sie der Befehlszeichenfolge ein --profile-Argument hinzu und geben Sie den Profilnamen an, der für die Anmeldeinformationen verwendet werden soll.

   Für andere Szenarien sind möglicherweise weitere Änderungen am Befehl erforderlich. Eine Beschreibung der verfügbaren register-Argumente sowie andere Methoden zur Erstellung der Befehlszeichenfolge finden Sie unter Verwenden des Befehls register. Um die Dokumentation zum Befehl anzuzeigen, führen Sie aws opsworks help register in der Befehlszeile aus. Einige Beispiele für die Befehlszeichenfolge finden Sie unter "register"-Befehlsbeispiele.

7. Nachdem Sie die Bearbeitung der Befehlszeichenfolge beendet haben, öffnen Sie ein Terminalfenster auf Ihrer Workstation oder melden Sie sich per SSH an der Instance an. Führen Sie dann den Befehl aus. Der gesamte Vorgang dauert in der Regel etwa fünf Minuten, in denen die Instance den Status Registering aufweist.

8. Nach Beendigung des Vorgangs klicken Sie auf Done. Die Instance hat jetzt den Status Registered und wird auf der Seite Instances des Stacks als nicht zugeordnete Instance aufgeführt.

Der Befehl register hat folgende Auswirkungen:

1. Bei Ausführung von "register" auf einer Workstation erfolgt als Erstes die Anmeldung des Befehls (über SSH) an der zu registrierenden Instance.

   Die restlichen Schritte erfolgen auf der Instance und sind unabhängig davon, wo der Befehl ausgeführt wird, identisch.

2. Lädt das AWS OpsWorks Stacks-Agentenpaket von Amazon S3 herunter.

3. Der Agent und dessen Abhängigkeiten wie z. B. AWS SDK für Ruby werden entpackt und installiert.

4. Folgendes wird erstellt:

   • Ein IAM-Benutzer, der den Agenten mit dem AWS OpsWorks Stacks-Service bootet, um eine sichere Kommunikation zu gewährleisten.

     Die Benutzerberechtigungen lassen nur die opsworks:RegisterInstance-Aktion zu und sind nach 15 Minuten abgelaufen.

   • Eine IAM-Gruppe für den Stack, die die Benutzer der registrierten Instances enthält.

5. Erzeugt ein RSA-Schlüsselpaar und sendet den öffentlichen Schlüssel an AWS OpsWorks Stacks.

   Dieses Schlüsselpaar wird zur Verschlüsselung der Kommunikation zwischen Agent und AWS OpsWorks Stacks eingesetzt.

6. Registriert die Instanz bei AWS OpsWorks Stacks. Anschließend führt der Stack einige Rezepte für die Ersteinrichtung aus, um die Instance zu konfigurieren, darunter z. B.:

   • Die Hosts-Datei der Instance wird überschrieben.

     Durch die Registrierung der Instanz haben Sie die Benutzerverwaltung an AWS OpsWorks Stacks übergeben, das über eine eigene Hosts-Datei verfügen muss, um die SSH-Anmeldeberechtigungen zu kontrollieren.

   • Bei Amazon EC2 EC2-Instances umfasst die Ersteinrichtung auch die Registrierung aller angehängten Amazon EBS-Volumes oder Elastic IP-Adressen beim Stack.

     Sie müssen sicherstellen, dass die Amazon EBS-Volumes nicht an reservierten Mount-Points gemountet werden, einschließlich /var/www aller Mount-Points, die von den Layern der Instance reserviert sind. Weitere Informationen zum Verwalten von Stack-Ressourcen finden Sie unter Ressourcenmanagement. Weitere Informationen zu Mounting-Punkten für Layer finden Sie unter AWS OpsWorks Stacks-Ebenenreferenz.

   Eine vollständige Beschreibung der Konfigurationsänderungen im Rahmen der Ersteinrichtung finden Sie unter Konfigurationsänderungen im Rahmen der Ersteinrichtung.

   Anmerkung

   Das Betriebssystem einer registrierten Instance wird im Rahmen der Ersteinrichtung nicht aktualisiert. Dieser Schritt muss von Ihnen ausgeführt werden. Weitere Informationen finden Sie unter Verwalten von Sicherheitsupdates.