Verwenden Sie den register-on-premises-instance Befehl (IAMuserARN), um eine lokale Instanz zu registrieren

Um Berechtigungen zuzuweisen (CLI)

1. Erstellen Sie eine Datei mit den folgenden Richtlinieninhalten auf der EC2 Amazon-Instance oder dem Amazon-Gerät, mit dem Sie die aufrufen AWS CLI. Verwenden Sie einen Dateinamen wie etwa CodeDeploy-OnPrem-Permissions.json und speichern Sie die Datei.

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Action": [
                   "s3:Get*",
                   "s3:List*"
               ],
               "Effect": "Allow",
               "Resource": "*"
           }
       ]
   }

   Anmerkung

   Wir empfehlen, diese Richtlinie nur auf die Amazon S3 S3-Buckets zu beschränken, auf die Ihre lokale Instance zugreifen muss. Wenn Sie diese Richtlinie einschränken, stellen Sie sicher, dass Sie auch Zugriff auf die Amazon S3 S3-Buckets gewähren, die den AWS CodeDeploy Agenten enthalten. Andernfalls kann ein Fehler auftreten, wenn der CodeDeploy Agent auf der zugehörigen lokalen Instance installiert oder aktualisiert wird.

   Beispielsweise:

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "s3:Get*",
           "s3:List*"
         ],
         "Resource": [
           "arn:aws:s3:::amzn-s3-demo-bucket/*",
           "arn:aws:s3:::aws-codedeploy-us-east-2/*",
           "arn:aws:s3:::aws-codedeploy-us-east-1/*",
           "arn:aws:s3:::aws-codedeploy-us-west-1/*",
           "arn:aws:s3:::aws-codedeploy-us-west-2/*",
           "arn:aws:s3:::aws-codedeploy-ca-central-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-2/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-3/*",
           "arn:aws:s3:::aws-codedeploy-eu-central-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-central-2/*",
           "arn:aws:s3:::aws-codedeploy-eu-north-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-south-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-south-2/*",
           "arn:aws:s3:::aws-codedeploy-il-central-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-east-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-2/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-3/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-1/*",        
           "arn:aws:s3:::aws-codedeploy-ap-southeast-2/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-3/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-4/*",
           "arn:aws:s3:::aws-codedeploy-ap-south-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-south-2/*",
           "arn:aws:s3:::aws-codedeploy-me-central-1/*",
           "arn:aws:s3:::aws-codedeploy-me-south-1/*",
           "arn:aws:s3:::aws-codedeploy-sa-east-1/*"
         ]
       }
     ]
   }

2. Rufen Sie den put-user-policyBefehl auf und geben Sie den Namen des IAM Benutzers (mit der --user-name Option), einen Namen für die Richtlinie (mit der --policy-name Option) und den Pfad zum neu erstellten Richtliniendokument (mit der --policy-document Option) an. Wenn sich z. B. die Datei CodeDeploy-OnPrem-Permissions.json im selben Verzeichnis (Ordner) befindet, aus dem Sie diesen Befehl aufrufen:

   Wichtig

   Achten Sie darauf, dass file:// vor dem Dateinamen steht. Dies ist bei diesem Befehl erforderlich.

   aws iam put-user-policy --user-name CodeDeployUser-OnPrem --policy-name CodeDeploy-OnPrem-Permissions --policy-document file://CodeDeploy-OnPrem-Permissions.json

So weisen Sie Berechtigungen (Konsole) zu:

1. Öffnen Sie die IAM Konsole unter https://console.aws.amazon.com/iam/.

2. Wählen Sie im Navigationsbereich Policies und dann Create Policy. (Wenn die Schaltfläche Get Started (Erste Schritte) angezeigt wird, klicken Sie darauf und wählen Sie anschließend Create Policy (Richtlinie erstellen) aus.)

3. Klicken Sie neben Create Your Own Policy auf Select.

4. Geben Sie in das Feld Policy Name einen Namen für diese Richtlinie ein (z. B. CodeDeploy-OnPrem-Permissions).

5. Geben oder fügen Sie in das Feld Policy Document den folgenden Berechtigungsausdruck ein, der es AWS CodeDeploy ermöglicht, Anwendungsrevisionen von jedem in der Richtlinie angegebenen Amazon S3 S3-Bucket für die lokale Instance im Namen des IAM Benutzers bereitzustellen:

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Action": [
                   "s3:Get*",
                   "s3:List*"
               ],
               "Effect": "Allow",
               "Resource": "*"
           }
       ]
   }

6. Wählen Sie Create Policy (Richtlinie erstellen) aus.

7. Klicken Sie im Navigationsbereich auf Users (Benutzer).

8. Suchen Sie in der Benutzerliste nach dem Namen des IAM Benutzers, in dem Sie ihn erstellt haben, und wählen Sie ihn aus. Schritt 1: Erstellen Sie einen IAM Benutzer für die lokale Instanz

9. Wählen Sie auf der Registerkarte Permissions unter Managed Policies die Option Attach Policy.

10. Wählen Sie die Richtlinie mit dem Namen CodeDeploy-OnPrem-Permissions aus, und klicken Sie dann auf Attach Policy (Richtlinie anfügen).

Um die Anmeldeinformationen zu erhalten (CLI)

1. Rufen Sie den list-access-keysBefehl auf, geben Sie den Namen des IAM Benutzers an (mit der --user-name Option) und fragen Sie nur nach dem Zugriffsschlüssel ab IDs (mit den --output Optionen --query und). Beispielsweise:

   aws iam list-access-keys --user-name CodeDeployUser-OnPrem --query "AccessKeyMetadata[*].AccessKeyId" --output text

2. Wenn in der Ausgabe keine Schlüssel erscheinen oder Informationen über nur eine Taste in der Ausgabe erscheinen, rufen Sie den create-access-keyBefehl auf und geben Sie den Namen des IAM Benutzers an (mit der --user-name Option):

   aws iam create-access-key --user-name CodeDeployUser-OnPrem

   Notieren Sie den Wert der Felder AccessKeyId und SecretAccessKey aus der Ausgabe des Aufrufs des Befehls create-access-key. Sie benötigen diese Informationen in Schritt 4: Fügen Sie der lokalen Instanz eine Konfigurationsdatei hinzu.

   Wichtig

   Das ist das einzige Mal, dass Sie Zugriff auf den geheimen Zugriffsschlüssel erhalten. Wenn Sie diesen geheimen Zugriffsschlüssel vergessen oder verlieren, müssen Sie einen neuen Zugriffsschlüssel erstellen, indem Sie die Schritte in Schritt 3: Holen Sie sich die IAM Benutzeranmeldedaten befolgen.

3. Wenn bereits zwei Zugriffstasten aufgeführt sind, müssen Sie einen davon löschen, indem Sie den delete-access-keyBefehl aufrufen und dabei den Namen des IAM Benutzers (mit der --user-name Option) und die ID des zu löschenden Zugriffsschlüssels (mit der --access-key-id Option) angeben. Rufen Sie dann den Befehl create-access-key auf, wie weiter oben in diesem Schritt beschrieben. Es folgt ein Beispiel für einen Aufruf des Befehls delete-access-key:

   aws iam delete-access-key --user-name CodeDeployUser-OnPrem --access-key-id access-key-ID

   Wichtig

   Wenn Sie den delete-access-key Befehl zum Löschen eines dieser Zugriffsschlüssel aufrufen und eine lokale Instanz diesen Zugriffsschlüssel bereits wie unter beschrieben verwendetSchritt 4: Fügen Sie der lokalen Instanz eine Konfigurationsdatei hinzu, müssen Sie die Anweisungen unter Schritt 4: Fügen Sie der lokalen Instanz eine Konfigurationsdatei hinzu erneut befolgen, um eine andere Zugriffsschlüssel-ID und einen anderen geheimen Zugriffsschlüssel für diesen IAM Benutzer anzugeben. Andernfalls bleiben Bereitstellungen auf dieser lokalen Instance in einem dauerhaften schwebenden Zustand hängen oder schlagen ganz fehl.

So rufen Sie Anmeldeinformationen (Konsole) ab:

1. 1. Öffnen Sie die IAM Konsole unter. https://console.aws.amazon.com/iam/

   2. Wenn die Benutzerliste nicht angezeigt wird, klicken Sie im Navigationsbereich auf Users.

   3. Suchen Sie in der Benutzerliste nach dem Namen des IAM Benutzers, in dem Sie ihn erstellt haben, und wählen Sie ihn ausSchritt 1: Erstellen Sie einen IAM Benutzer für die lokale Instanz.

2. Wählen Sie auf der Registerkarte Security credentials, wenn kein oder nur ein Schlüssel aufgelistet ist, die Option Create access key.

   Wenn zwei Zugriffsschlüssel aufgelistet sind, müssen Sie einen davon löschen. Wählen Sie Delete neben einem der Zugriffsschlüssel, und wählen Sie dann Create access key.

   Wichtig

   Wenn Sie neben einem dieser Zugriffsschlüssel die Option Löschen auswählen und eine lokale Instanz diesen Zugriffsschlüssel bereits wie unter beschrieben verwendetSchritt 4: Fügen Sie der lokalen Instanz eine Konfigurationsdatei hinzu, müssen Sie Schritt 4: Fügen Sie der lokalen Instanz eine Konfigurationsdatei hinzu erneut den Anweisungen unter folgen, um eine andere Zugriffsschlüssel-ID und einen anderen geheimen Zugriffsschlüssel für diesen IAM Benutzer anzugeben. Andernfalls bleiben Bereitstellungen auf dieser lokalen Instance in einem dauerhaften schwebenden Zustand hängen oder schlagen ganz fehl.

3. Wählen Sie Show, und notieren Sie sich die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel. Diese Informationen sind für den nächsten Schritt erforderlich. Alternativ können Sie Download .csv file wählen, um eine Kopie der Zugriffsschlüssel-ID und des geheimen Zugriffsschlüssels zu speichern.

   Wichtig

   Wenn Sie sich die Anmeldeinformationen nicht notieren oder herunterladen, ist es das einzige Mal, dass Sie Zugriff auf diesen geheimen Zugriffsschlüssel haben. Wenn Sie diesen geheimen Zugriffsschlüssel vergessen oder verlieren, müssen Sie einen neuen Zugriffsschlüssel erstellen, indem Sie die Schritte in Schritt 3: Holen Sie sich die IAM Benutzeranmeldedaten befolgen.

4. Wählen Sie „Schließen“, um zu „Benutzer“ zurückzukehren > IAM User NameSeite.

1. Erstellen Sie eine Datei mit dem Namen codedeploy.onpremises.yml (für einen Ubuntu Server oder eine RHEL lokale Instanz) oder conf.onpremises.yml (für eine lokale Windows Server-Instanz) am folgenden Speicherort auf der lokalen Instanz:

   • Für Ubuntu Server: /etc/codedeploy-agent/conf

   • Für Windows Server: C:\ProgramData\Amazon\CodeDeploy

2. Verwenden Sie einen Texteditor, um die folgenden Informationen der neu erstellten codedeploy.onpremises.yml- oder conf.onpremises.yml-Datei hinzuzufügen:

   ---
   aws_access_key_id: secret-key-id
   aws_secret_access_key: secret-access-key
   iam_user_arn: iam-user-arn
   region: supported-region

   Wobei gilt:

   • secret-key-id ist die geheime Schlüssel-ID des entsprechenden IAM Benutzers, die Sie in Schritt 1: Erstellen Sie einen IAM Benutzer für die lokale Instanz oder notiert habenSchritt 3: Holen Sie sich die IAM Benutzeranmeldedaten.

   • secret-access-key ist der geheime Zugriffsschlüssel des entsprechenden IAM Benutzers, den Sie in Schritt 1: Erstellen Sie einen IAM Benutzer für die lokale Instanz oder notiert habenSchritt 3: Holen Sie sich die IAM Benutzeranmeldedaten.

   • iam-user-arn ist der des IAM Benutzers, den ARN Sie zuvor notiert habenSchritt 1: Erstellen Sie einen IAM Benutzer für die lokale Instanz.

   • supported-region ist die Kennung einer Region, die von der Region unterstützt wird, CodeDeploy in der sich Ihre CodeDeploy Anwendungen, Bereitstellungsgruppen und Anwendungsversionen befinden (z. B.us-west-2). Eine Liste der Regionen finden Sie unter Region und Endpunkte in der. Allgemeine AWS-Referenz

   Wichtig

   Wenn Sie neben einem der Zugriffsschlüssel unter Löschen ausgewählt haben und Ihre lokale Instanz bereits die zugehörige Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel verwendet, müssen Sie den Anweisungen unter folgen, um eine andere Zugriffsschlüssel-ID und einen anderen geheimen Zugriffsschlüssel für diesen IAM Benutzer anzugeben. Schritt 3: Holen Sie sich die IAM Benutzeranmeldedaten Schritt 4: Fügen Sie der lokalen Instanz eine Konfigurationsdatei hinzu Andernfalls bleiben Bereitstellungen auf dieser lokalen Instance in einem dauerhaften schwebenden Zustand hängen oder schlagen ganz fehl.

1. Folgen Sie den Anweisungen AWS CLI unter Getting Setup with the im AWS Command Line Interface Benutzerhandbuch, um den auf der lokalen Instanz AWS CLI zu installieren.

   Anmerkung

   CodeDeploy Befehle für die Arbeit mit lokalen Instanzen wurden in Version 1.7.19 von verfügbar. AWS CLI Wenn Sie AWS CLI bereits eine Version von installiert haben, können Sie deren Version überprüfen, indem Sie anrufen. aws --version

2. Um die AWS CLI lokale Instanz zu konfigurieren, folgen Sie den Anweisungen unter Konfiguration der AWS CLI im AWS Command Line Interface Benutzerhandbuch.

   Wichtig

   Achten Sie bei der Konfiguration der AWS CLI (z. B. durch Aufrufen des aws configure Befehls) darauf, die geheime Schlüssel-ID und den geheimen Zugriffsschlüssel eines IAM Benutzers anzugeben, der zusätzlich zu den in der angegebenen AWS Zugriffsberechtigungen mindestens über die folgenden Zugriffsberechtigungen verfügt. Voraussetzungen für die Konfiguration einer lokalen Instanz Dadurch können Sie den CodeDeploy Agenten herunterladen und auf der lokalen Instanz installieren:

   {
     "Version": "2012-10-17",
     "Statement" : [
       {
         "Effect" : "Allow",
         "Action" : [
           "codedeploy:*"
         ],
         "Resource" : "*"
       },
       {
         "Effect" : "Allow",
         "Action" : [
           "s3:Get*",
           "s3:List*"
         ],
         "Resource" : [
           "arn:aws:s3:::aws-codedeploy-us-east-2/*",
           "arn:aws:s3:::aws-codedeploy-us-east-1/*",
           "arn:aws:s3:::aws-codedeploy-us-west-1/*",
           "arn:aws:s3:::aws-codedeploy-us-west-2/*",
           "arn:aws:s3:::aws-codedeploy-ca-central-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-2/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-3/*",
           "arn:aws:s3:::aws-codedeploy-eu-central-1/*",
           "arn:aws:s3:::aws-codedeploy-il-central-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-east-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-2/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-2/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-4/*",
           "arn:aws:s3:::aws-codedeploy-ap-south-1/*",
           "arn:aws:s3:::aws-codedeploy-sa-east-1/*"
         ]
       }     
     ]
   }

   Diese Zugriffsberechtigungen können entweder dem IAM Benutzer zugewiesen werden, in dem Sie sie erstellt haben, Schritt 1: Erstellen Sie einen IAM Benutzer für die lokale Instanz oder einem anderen IAM Benutzer. Um einem IAM Benutzer diese Berechtigungen zuzuweisen, folgen Sie den Anweisungen unter Verwenden Sie diese Zugriffsberechtigungen anstelle der in diesem Schritt beschriebenen. Schritt 1: Erstellen Sie einen IAM Benutzer für die lokale Instanz

1. Bevor Sie den verwenden können AWS CLI, benötigen Sie den Benutzer ARN des Benutzers, in dem Sie IAM ihn erstellt haben. Schritt 1: Erstellen Sie einen IAM Benutzer für die lokale Instanz Wenn Sie den Benutzer noch nicht habenARN, rufen Sie den Befehl get-user auf, geben Sie den Namen des IAM Benutzers an (mit der --user-name Option) und fragen Sie nur nach dem Benutzer ab ARN (mit den --output Optionen --query und):

   aws iam get-user --user-name CodeDeployUser-OnPrem --query "User.Arn" --output text

2. Rufen Sie den Befehl register-on-premises-instance mit folgenden Angaben auf:

   • Ein eindeutiger Bezeichner für die lokale Instance (mit der Option --instance-name).

     Wichtig

     Um die lokale Instance identifizieren zu können, insbesondere für Debugging-Zwecke, empfehlen wir dringend, dass Sie einen Namen angeben, die einige eindeutige Merkmale der lokalen Instance enthält (z. B. die Seriennummer oder eine eindeutige interne Asset-ID, falls zutreffend). Wenn Sie eine MAC Adresse als Namen angeben, beachten Sie, dass MAC Adressen unzulässige Zeichen enthalten, z. B. einen Doppelpunkt ():. CodeDeploy Eine Liste der zulässigen Zeichen finden Sie unter CodeDeploy Kontingente.

   • Der Benutzer ARN des Benutzers, in dem IAM Sie ihn erstellt haben Schritt 1: Erstellen Sie einen IAM Benutzer für die lokale Instanz (mit der --iam-user-arn Option).

     Beispielsweise:

     aws deploy register-on-premises-instance --instance-name AssetTag12010298EX --iam-user-arn arn:aws:iam::444455556666:user/CodeDeployUser-OnPrem

Um die lokale Instanz zu taggen () CLI

• Rufen Sie den Befehl add-tags-to-on-premises-instances auf und geben Sie Folgendes an:

  • Der eindeutige Bezeichner für die lokale Instance (mit der Option --instance-names).

  • Der Name des Tag-Schlüssels und des Tag-Werts der lokalen Instance, die Sie verwenden möchten (mit der Option --tags). Sie müssen sowohl einen Namen als auch einen Wert angeben. CodeDeploy erlaubt keine lokalen Instanz-Tags, die nur Werte enthalten.

    Beispielsweise:

    aws deploy add-tags-to-on-premises-instances --instance-names AssetTag12010298EX --tags Key=Name,Value=CodeDeployDemo-OnPrem

So markieren Sie eine lokale Instance (Konsole):

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die CodeDeploy Konsole unter https://console.aws.amazon.com/codedeploy.

   Anmerkung

   Melden Sie sich mit demselben Benutzer an, den Sie eingerichtet haben. Erste Schritte mit CodeDeploy

2. Wählen Sie im CodeDeploy Menü die Option Lokale Instanzen aus.

3. Klicken Sie in der Liste der lokalen Instances auf den Pfeil neben der lokalen Instance, die Sie markieren möchten.

4. Wählen Sie in der Liste der Tags den gewünschten Tag-Schlüssel und -Wert aus oder geben Sie ihn ein. Nachdem Sie den Tag-Schlüssel und den Tag-Wert eingegeben haben, wird eine weitere Zeile angezeigt. Sie können das für bis zu 10 Tags wiederholen. Zum Entfernen eines Tags wählen Sie das Symbol "Löschen" aus ( ).

5. Wählen Sie nach dem Hinzufügen der Tags die Option Update Tags.