Verwenden Sie den Befehl register-on-premises-instance (IAM-Benutzer-ARN), um eine lokale Instance zu registrieren

So weisen Sie Berechtigungen (CLI) zu:

1. Erstellen Sie eine Datei mit den folgenden Richtlinieninhalten auf der Amazon EC2-Instance oder dem Gerät, mit dem Sie die AWS CLI aufrufen. 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, dass Sie diese Richtlinie nur auf die Amazon S3-Buckets 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-Buckets gewähren, die den Agenten enthalten. AWS CodeDeploy Andernfalls kann ein Fehler auftreten, wenn der CodeDeploy Agent auf der zugehörigen lokalen Instance installiert oder aktualisiert wird.

   Beispiel:

   {
     "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 Befehl put-user-policy 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 Option) an. --policy-document 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 unter https://console.aws.amazon.com/iam/ die IAM-Konsole.

2. Wählen Sie im Navigationsbereich Richtlinien und dann Richtlinie erstellen. (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 Sie im Feld Richtliniendokument den folgenden Berechtigungsausdruck ein oder fügen Sie ihn ein, der es ermöglicht AWS CodeDeploy , Anwendungsrevisionen aus jedem in der Richtlinie angegebenen Amazon S3-Bucket im Namen des IAM-Benutzers auf der lokalen Instance bereitzustellen:

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

6. Wählen Sie 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 Instance

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).

So rufen Sie Anmeldeinformationen (CLI) ab:

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

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

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

   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: Rufen Sie die IAM-Benutzeranmeldedaten ab befolgen.

3. Wenn bereits zwei Zugriffsschlüssel aufgeführt sind, müssen Sie einen davon löschen, indem Sie den Befehl delete-access-key aufrufen und dabei den Namen des IAM-Benutzers (mit der Option) und die ID des zu löschenden Zugriffsschlüssels (mit der --user-name Option) angeben. --access-key-id 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 aufrufen, um einen dieser Zugriffsschlüssel zu löschen, und eine lokale Instance diesen Zugriffsschlüssel bereits verwendet, wie unter beschriebenSchritt 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 anzugeben, die diesem IAM-Benutzer zugeordnet sind. 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 unter https://console.aws.amazon.com/iam/ die IAM-Konsole.

   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 aus. Schritt 1: Erstellen Sie einen IAM-Benutzer für die lokale Instance

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 auf Löschen klicken und eine lokale Instance diesen Zugriffsschlüssel bereits verwendet, wie unter beschrieben, müssen Sie die Anweisungen unter Schritt 4: Fügen Sie der lokalen Instanz eine Konfigurationsdatei hinzu erneut befolgenSchritt 4: Fügen Sie der lokalen Instanz eine Konfigurationsdatei hinzu, um eine andere Zugriffsschlüssel-ID und einen anderen geheimen Zugriffsschlüssel anzugeben, die diesem IAM-Benutzer zugeordnet sind. 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: Rufen Sie die IAM-Benutzeranmeldedaten ab befolgen.

4. Wählen Sie Schließen, um zur Seite Benutzer > IAM User Name zurückzukehren.

1. Erstellen Sie eine Datei mit dem Namen codedeploy.onpremises.yml (für eine lokale Ubuntu Server- oder RHEL-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 Folgendes gilt:

   • secret-key-idist die geheime Schlüssel-ID des entsprechenden IAM-Benutzers, die Sie in Schritt 1: Erstellen Sie einen IAM-Benutzer für die lokale Instance oder Schritt 3: Rufen Sie die IAM-Benutzeranmeldedaten ab notiert haben.

   • secret-access-keyist der geheime Zugriffsschlüssel des entsprechenden IAM-Benutzers, den Sie in Schritt 1: Erstellen Sie einen IAM-Benutzer für die lokale Instance oder notiert haben. Schritt 3: Rufen Sie die IAM-Benutzeranmeldedaten ab

   • iam-user-arnist der ARN des IAM-Benutzers, den Sie zuvor notiert haben. Schritt 1: Erstellen Sie einen IAM-Benutzer für die lokale Instance

   • supported-regionist die Kennung einer Region, die vom CodeDeploy Standort Ihrer CodeDeploy Anwendungen, Bereitstellungsgruppen und Anwendungsrevisionen unterstützt wird (z. B.us-west-2). Eine Liste der Regionen finden Sie unter Region und Endpunkte im. Allgemeine AWS-Referenz

   Wichtig

   Wenn Sie neben einem der Zugriffsschlüssel unter Löschen ausgewählt haben und Ihre lokale Instance 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 anzugeben, die diesem IAM-Benutzer zugeordnet sind. Schritt 3: Rufen Sie die IAM-Benutzeranmeldedaten ab 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. Um die AWS CLI auf der lokalen Instance zu installieren, folgen Sie den Anweisungen unter Getting set up with the AWS CLI im AWS Command Line Interface Benutzerhandbuch.

   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 auf der lokalen Instanz zu konfigurieren, folgen Sie den Anweisungen unter Konfiguration der AWS CLI im AWS Command Line Interface Benutzerhandbuch.

   Wichtig

   Achten Sie bei der Konfiguration AWS CLI (z. B. durch Aufrufen des aws configure Befehls) darauf, die Geheimschlü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 Auf diese Weise können Sie den CodeDeploy Agenten auf die lokale Instanz herunterladen und installieren:

   JSON

   {
     "Version":"2012-10-17",
     "Statement" : [
       {
         "Effect" : "Allow",
         "Action" : [
           "codedeploy:*"
         ],
         "Resource" : "*"
       },
       {
         "Effect" : "Allow",
         "Action" : [
           "s3:Get*",
           "s3:List*"
         ],
         "Resource" : [
           "arn:aws:s3:::amzn-s3-demo-bucket/*",
           "arn:aws:s3:::amzn-s3-demo-bucket1/*"
         ]
       }     
     ]
   }
   

   JSON

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

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

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

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

2. Rufen Sie den Befehl https://docs.aws.amazon.com/cli/latest/reference/deploy/register-on-premises-instance.html register-on-premises-instance auf und geben Sie dabei Folgendes an:

   • 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 Zeichen enthalten, die CodeDeploy nicht zulässig sind, z. B. Doppelpunkt (). : Eine Liste der zulässigen Zeichen finden Sie unter CodeDeploy Kontingente.

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

     Beispiel:

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

So markieren Sie eine lokale Instance (CLI):

• Rufen Sie den Befehl https://docs.aws.amazon.com/cli/latest/reference/deploy/add-tags-to-on-premises-instances.html 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.

    Beispiel:

    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-Managementkonsole und öffnen Sie die CodeDeploy Konsole unter https://console.aws.amazon.com/codedeploy.

   Anmerkung

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

2. Wählen Sie im CodeDeploy Menü On-premises 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.