Automatische Deregistrierung einer lokalen Instanz

In der Regel heben Sie die Registrierung einer lokalen Instance auf, wenn Sie sie voraussichtlich nicht mehr bereitstellen werden. Wenn Sie die Registrierung einer lokalen Instance aufheben, wird diese, auch wenn sie Teil der Tags für lokale Instances einer Bereitstellungsgruppe ist, nicht mehr in Bereitstellungen eingeschlossen. Sie können das verwenden, AWS CLI um lokale Instanzen abzumelden.

Anmerkung

Sie können die CodeDeploy Konsole nicht verwenden, um die Registrierung einer lokalen Instanz aufzuheben. Zudem werden durch die Aufhebung der Registrierung einer lokalen Instance alle lokalen Instance-Tags, die mit der lokalen Instance verbunden sind, entfernt. Der CodeDeploy Agent wird nicht von der lokalen Instanz deinstalliert. Die Konfigurationsdatei der lokalen Instance wird nicht von der lokalen Instance entfernt.

Informationen zum Ausführen einiger (aber nicht aller) Aktivitäten in diesem Abschnitt mithilfe der CodeDeploy Konsole finden Sie im CodeDeploy Konsolenabschnitt vonManuelles Aufheben der Registrierung einer lokalen Instanz.

Informationen zum manuellen Aufheben der Zugehörigkeit zugehöriger Tags für lokale Instances finden Sie unter Entfernen Sie manuell lokale Instanz-Tags aus einer lokalen Instanz.

Informationen zur automatischen Deinstallation des CodeDeploy Agenten und zum Entfernen der Konfigurationsdatei aus der lokalen Instanz finden Sie unterDeinstallieren Sie den CodeDeploy Agenten automatisch und entfernen Sie die Konfigurationsdatei aus einer lokalen Instanz.

Informationen zur manuellen Deinstallation nur des CodeDeploy Agenten von der lokalen Instanz finden Sie unter. Verwaltung des CodeDeploy Agentenbetriebs

Rufen Sie AWS CLI mit dem den Befehl deregister auf und geben Sie Folgendes an:

• Der Name, der die lokale Instanz eindeutig identifiziert CodeDeploy (mit der --instance-name Option).

• Optional, ob der IAM-Benutzer gelöscht werden soll, der der lokalen Instanz zugeordnet ist. Das Standardverhalten besteht darin, den IAM-Benutzer zu löschen. Wenn Sie den mit der lokalen Instance verbundenen IAM-Benutzer nicht löschen möchten, geben Sie im Befehl die Option --no-delete-iam-user an.

• Optional die AWS Region, in der die lokale Instanz registriert wurde CodeDeploy (mit der --region Option). Dies muss eine der unterstützten Regionen sein, die unter Region aufgeführt sind, und Endpunkte in Allgemeine AWS-Referenz(z. B.us-west-2). Wenn diese Option nicht angegeben ist, wird die AWS Standardregion verwendet, die dem aufrufenden IAM-Benutzer zugeordnet ist.

Ein Beispiel, das die Registrierung einer Instance aufhebt und den Benutzer löscht:

aws deploy deregister --instance-name AssetTag12010298EX --region us-west-2

Ein Beispiel, das die Registrierung einer Instance aufhebt und den Benutzer nicht löscht:

aws deploy deregister --instance-name AssetTag12010298EX --no-delete-iam-user --region us-west-2

Der Befehl deregister hat folgende Auswirkungen:

1. Deregistriert die lokale Instanz bei. CodeDeploy

2. Falls angegeben, wird der IAM-Benutzer gelöscht, der der lokalen Instanz zugeordnet ist.

Nach dem Aufheben der Registrierung einer lokalen Instance:

• Sie wird sofort nicht mehr auf der Konsole angezeigt.

• Sie können umgehend eine andere Instance mit demselben Namen erstellen.

Wenn dieser Befehl Fehler erkennt, wird eine Fehlermeldung angezeigt, in der beschrieben wird, wie Sie die verbleibenden Schritte manuell durchführen können. Andernfalls wird eine Meldung über den erfolgreichen Abschluss angezeigt, in der beschrieben wird, wie Sie den Befehl uninstall aufrufen.