

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.

# Installieren Sie den CodeDeploy Agenten über die Befehlszeile
<a name="codedeploy-agent-operations-install-cli"></a>

**Anmerkung**  
Wir empfehlen, den CodeDeploy Agenten mit AWS Systems Manager zu installieren, um geplante Updates des Agenten konfigurieren zu können. Weitere Informationen finden Sie unter [Installieren Sie den CodeDeploy Agenten mit AWS Systems Manager](codedeploy-agent-operations-install-ssm.md).

Verwenden Sie die folgenden Themen, um den CodeDeploy Agenten über die Befehlszeile zu installieren und auszuführen.

**Topics**
+ [Installieren Sie den CodeDeploy Agenten für Amazon Linux oder RHEL](codedeploy-agent-operations-install-linux.md)
+ [Installieren Sie den CodeDeploy Agenten für Ubuntu Server](codedeploy-agent-operations-install-ubuntu.md)
+ [Installieren Sie den CodeDeploy Agenten für Windows Server](codedeploy-agent-operations-install-windows.md)

# Installieren Sie den CodeDeploy Agenten für Amazon Linux oder RHEL
<a name="codedeploy-agent-operations-install-linux"></a>

Melden Sie sich bei der Instance an, und führen Sie die folgenden Befehle nacheinander aus. Es hat sich bewährt, den Befehl `sudo yum update` zuerst auszuführen, wenn es `yum` um die Installation von Paketen geht. Sie können ihn jedoch überspringen, wenn Sie nicht alle Ihre Pakete aktualisieren möchten.

```
sudo yum update
```

```
sudo yum install ruby
```

```
sudo yum install wget
```

(Optional) Führen Sie das folgende Skript aus, um das AMI von allen vorherigen Agent-Caching-Informationen zu säubern:

```
#!/bin/bash
CODEDEPLOY_BIN="/opt/codedeploy-agent/bin/codedeploy-agent"
$CODEDEPLOY_BIN stop
yum erase codedeploy-agent -y
```

Wechseln Sie zu Ihrem Home-Verzeichnis:

```
cd /home/ec2-user
```

**Anmerkung**  
`/home/ec2-user`Stellt im vorherigen Befehl den Standardbenutzernamen für eine Amazon Linux- oder RHEL Amazon EC2 EC2-Instance dar. Wenn Ihre Instance mit einer benutzerdefinierten AMI erstellt wurde, kann der Eigentümer der AMI einen anderen Standardbenutzernamen angegeben haben. 

Laden Sie das CodeDeploy Agent-Installationsprogramm herunter:

```
wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
```

*bucket-name*ist der Name des Amazon S3 S3-Buckets, der die CodeDeploy Resource Kit-Dateien für Ihre Region enthält, und *region-identifier* ist die Kennung für Ihre Region.

Beispiel:

`https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`

Eine Liste der Bucket-Namen und Regionskennungen finden Sie unter[Bucket-Namen für das Resource Kit nach Regionen](resource-kit.md#resource-kit-bucket-names).

Legen Sie Ausführungsberechtigungen für die `install` Datei fest:

```
chmod +x ./install
```

Um die neueste Version des CodeDeploy Agenten zu installieren:
+ 

  ```
  sudo ./install auto
  ```

Um eine bestimmte Version des CodeDeploy Agenten zu installieren:
+ Listet die verfügbaren Versionen in Ihrer Region auf:

  ```
  aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.rpm$'
  ```
+ Installieren Sie eine der folgenden Versionen:

  ```
  sudo ./install auto -v releases/codedeploy-agent-version.noarch.rpm
  ```
**Anmerkung**  
AWS unterstützt die neueste Nebenversion des CodeDeploy Agenten. Derzeit ist die neueste Nebenversion 1.7.x.

Führen Sie den folgenden Befehl aus, um zu prüfen, ob der Dienst ausgeführt wird:

```
systemctl status codedeploy-agent
```

Wenn der CodeDeploy Agent installiert ist und läuft, sollten Sie eine Meldung wie sehen. `The AWS CodeDeploy agent is running`

Wenn Sie eine Meldung sehen wie `error: No AWS CodeDeploy agent running`, starten Sie den Service neu und führen die beiden folgenden Befehle nacheinander aus:

```
systemctl start codedeploy-agent
```

```
systemctl status codedeploy-agent
```

# Installieren Sie den CodeDeploy Agenten für Ubuntu Server
<a name="codedeploy-agent-operations-install-ubuntu"></a>

**Anmerkung**  
Wir empfehlen, den CodeDeploy Agenten mit AWS Systems Manager zu installieren, um geplante Updates des Agenten konfigurieren zu können. Weitere Informationen finden Sie unter [Installieren Sie den CodeDeploy Agenten mit AWS Systems Manager](codedeploy-agent-operations-install-ssm.md).

**Um den CodeDeploy Agenten auf Ubuntu Server zu installieren**

1. Melden Sie sich bei der Instanz an.

1. Geben Sie nacheinander die folgenden Befehle ein:

   ```
   sudo apt update
   ```

   ```
   sudo apt install ruby-full
   ```

   ```
   sudo apt install wget
   ```

1. Geben Sie den folgenden Befehl ein:

   ```
   cd /home/ubuntu
   ```

   */home/ubuntu*steht für den Standardbenutzernamen für eine Ubuntu-Server-Instanz. Wenn Ihre Instance mit einer benutzerdefinierten AMI erstellt wurde, kann der Eigentümer der AMI einen anderen Standardbenutzernamen angegeben haben. 

1. Geben Sie den folgenden Befehl ein:

   ```
   wget https://bucket-name.s3.region-identifier.amazonaws.com/latest/install
   ```

   *bucket-name*ist der Name des Amazon S3 S3-Buckets, der die CodeDeploy Resource Kit-Dateien für Ihre Region enthält, und *region-identifier* ist die Kennung für Ihre Region.

   Beispiel:

   `https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latest/install`

   Eine Liste der Bucket-Namen und Regionskennungen finden Sie unter[Bucket-Namen für das Resource Kit nach Regionen](resource-kit.md#resource-kit-bucket-names).

1. Geben Sie den folgenden Befehl ein:

   ```
   chmod +x ./install
   ```

1. Führen Sie eine der folgenden Aktionen aus:
   + Um die neueste Version des CodeDeploy Agenten auf einer beliebigen unterstützten Version von Ubuntu Server *außer* 20.04 zu installieren:

     ```
     sudo ./install auto
     ```
   + Um die neueste Version des CodeDeploy Agenten auf Ubuntu Server 20.04 zu installieren:
**Anmerkung**  
Das Schreiben der Ausgabe in eine temporäre Protokolldatei ist eine Problemumgehung, die verwendet werden sollte, während wir einen bekannten Fehler mit dem `install` Skript auf Ubuntu Server 20.04 beheben.

     ```
     sudo ./install auto > /tmp/logfile
     ```
   + *Um eine bestimmte Version des CodeDeploy Agenten auf einer beliebigen unterstützten Version von Ubuntu Server außer 20.04 zu installieren:*
     + Listen Sie die verfügbaren Versionen in Ihrer Region auf:

       ```
       aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
       ```
     + Installieren Sie eine der folgenden Versionen:

       ```
       sudo ./install auto -v releases/codedeploy-agent-###.deb
       ```
**Anmerkung**  
AWS unterstützt die neueste Nebenversion des CodeDeploy Agenten. Derzeit ist die neueste Nebenversion 1.7.x.
   + Um eine bestimmte Version des CodeDeploy Agenten auf Ubuntu Server 20.04 zu installieren:
     + Listen Sie die verfügbaren Versionen in Ihrer Region auf:

       ```
       aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.deb$'
       ```
     + Installieren Sie eine der folgenden Versionen:

       ```
       sudo ./install auto -v releases/codedeploy-agent-###.deb > /tmp/logfile
       ```
**Anmerkung**  
Das Schreiben der Ausgabe in eine temporäre Protokolldatei ist eine Problemumgehung, die verwendet werden sollte, während wir einen bekannten Fehler mit dem `install` Skript auf Ubuntu Server 20.04 beheben.
**Anmerkung**  
AWS unterstützt die neueste Nebenversion des Agenten. CodeDeploy Derzeit ist die neueste Nebenversion 1.7.x.

**Um zu überprüfen, ob der Dienst läuft**

1. Geben Sie den folgenden Befehl ein:

   ```
   systemctl status codedeploy-agent
   ```

   Wenn der CodeDeploy Agent installiert ist und läuft, sollten Sie eine Meldung wie sehen`The AWS CodeDeploy agent is running`.

1. Wenn Sie eine Meldung sehen wie `error: No AWS CodeDeploy agent running`, starten Sie den Service neu und führen die beiden folgenden Befehle nacheinander aus:

   ```
   systemctl start codedeploy-agent
   ```

   ```
   systemctl status codedeploy-agent
   ```

# Installieren Sie den CodeDeploy Agenten für Windows Server
<a name="codedeploy-agent-operations-install-windows"></a>

Auf Windows Server-Instanzen können Sie eine der folgenden Methoden verwenden, um den CodeDeploy Agenten herunterzuladen und zu installieren:
+ Verwenden AWS Systems Manager (empfohlen)
+ Führen Sie eine Reihe von PowerShell Windows-Befehlen aus.
+ Wählen eines direkten Download-Links
+ Führen Sie einen Amazon S3 S3-Kopierbefehl aus.

**Anmerkung**  
Der Ordner, in dem der CodeDeploy Agent installiert ist, ist`C:\Program Data\Amazon\CodeDeploy`. Stellen Sie sicher, dass sich in diesem Pfad keine Verzeichnisverbindungen oder symbolischen Links befinden.

**Topics**
+ [Verwenden von Systems Manager](#codedeploy-agent-operations-install-system-manager)
+ [Verwenden Sie Windows PowerShell](#codedeploy-agent-operations-install-windows-powershell)
+ [Verwenden eines Direkt-Links](#codedeploy-agent-operations-install-windows-direct-link)
+ [Verwenden Sie einen Amazon S3 S3-Kopierbefehl](#codedeploy-agent-operations-install-windows-s3-copy)

## Verwenden von Systems Manager
<a name="codedeploy-agent-operations-install-system-manager"></a>

Folgen Sie den Anweisungen unter[Installieren Sie den CodeDeploy Agenten mit AWS Systems Manager](codedeploy-agent-operations-install-ssm.md), um den Agenten zu installieren. CodeDeploy

## Verwenden Sie Windows PowerShell
<a name="codedeploy-agent-operations-install-windows-powershell"></a>

Melden Sie sich bei der Instanz an und führen Sie die folgenden Befehle in Windows aus PowerShell:

1.  Fordern Sie an, dass nur Skripte und Konfigurationsdateien von vertrauenswürdigen Anbietern aus dem Internet heruntergeladen werden. Wenn Sie dazu aufgefordert werden, die Ausführungsrichtlinie zu ändern, geben Sie "**Y**" ein. 

   ```
    Set-ExecutionPolicy RemoteSigned
   ```

1.  Laden Sie das AWS Tools for Windows PowerShell. 

   ```
   Import-Module AWSPowerShell
   ```

1.  Erstellen Sie ein Verzeichnis, in das die CodeDeploy Agenteninstallationsdatei heruntergeladen wird. 

   ```
   New-Item -Path "c:\temp" -ItemType "directory" -Force
   ```

1. Konfigurieren Sie die AWS Anmeldeinformationen mit den `Initialize-AWSDefaultConfiguration` Befehlen `Set-AWSCredential` und. Weitere Informationen finden Sie unter [Verwenden von AWS Anmeldeinformationen](https://docs.aws.amazon.com/powershell/latest/userguide/specifying-your-aws-credentials.html) im * PowerShell Benutzerhandbuch zu AWS Tools*.

1.  Laden Sie die CodeDeploy Agenteninstallationsdatei herunter. 
**Anmerkung**  
AWS unterstützt die neueste Nebenversion des CodeDeploy Agenten. Derzeit ist die neueste Nebenversion 1.7.x.

   Gehen Sie wie folgt vor, um die neueste Version des CodeDeploy Agenten zu installieren:
   + 

     ```
     powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
     ```

   Um eine bestimmte Version des CodeDeploy Agenten zu installieren:
   + 

     ```
     powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi
     ```

   *bucket-name*ist der Name des Amazon S3 S3-Buckets, der die CodeDeploy Resource Kit-Dateien für Ihre Region enthält. Ersetzen Sie beispielsweise für die Region USA Ost (Ohio) *bucket-name* durch`aws-codedeploy-us-east-2`. Eine Liste der Bucket-Namen finden Sie unter[Bucket-Namen für das Resource Kit nach Regionen](resource-kit.md#resource-kit-bucket-names).

1.  Führen Sie die CodeDeploy Agenten-Installationsdatei aus. 

   ```
   c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt
   ```

Führen Sie den folgenden Befehl aus, um zu prüfen, ob der Dienst ausgeführt wird:

```
powershell.exe -Command Get-Service -Name codedeployagent
```

 Wenn der CodeDeploy Agent gerade installiert und noch nicht gestartet wurde, sollten Sie nach der Ausführung des **Get-Service** Befehls unter **Status** Folgendes sehen**Start...**:

```
Status     Name                DisplayName
------     ----                -----------
Start...   codedeployagent    CodeDeploy Host Agent Service
```

Wenn der CodeDeploy Agent bereits läuft, sollten Sie nach der Ausführung des **Get-Service** Befehls unter **Status** Folgendes sehen**Running**:

```
Status     Name                DisplayName
------     ----                -----------
Running    codedeployagent    CodeDeploy Host Agent Service
```

## Verwenden eines Direkt-Links
<a name="codedeploy-agent-operations-install-windows-direct-link"></a>

Wenn die Sicherheitseinstellungen des Browsers auf der Windows Server-Instanz die erforderlichen Berechtigungen vorsehen (z. B. für`https://s3.*.amazonaws.com`), können Sie einen direkten Link für Ihre Region verwenden, um den CodeDeploy Agenten herunterzuladen und dann das Installationsprogramm manuell auszuführen.

Der Link lautet:

```
https://s3.region.amazonaws.com/aws-codedeploy-region/latest/codedeploy-agent.msi
```

... wo *region* ist die AWS Region, in der Sie Ihre Anwendung bereitstellen.

Beispiel:

```
https://s3.af-south-1.amazonaws.com/aws-codedeploy-af-south-1/latest/codedeploy-agent.msi
```

**Wichtig**  
Besorgen Sie sich die `.msi` Datei aus derselben Region wie Ihre CodeDeploy Anwendung. Wenn Sie eine andere Region wählen, kann es zu `inconsistent region` Fehlern in der `codedeploy-agent-log` Datei kommen, wenn Sie die `.msi` Datei ausführen.

## Verwenden Sie einen Amazon S3 S3-Kopierbefehl
<a name="codedeploy-agent-operations-install-windows-s3-copy"></a>

Wenn der auf der Instance installiert AWS CLI ist, können Sie den CodeDeploy Agenten mit dem Amazon S3 S3-Befehl [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) herunterladen und dann das Installationsprogramm manuell ausführen. Weitere Informationen finden [Sie unter Installieren von AWS Command Line Interface unter Microsoft Windows](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html). 

Der Amazon S3 S3-Befehl lautet:

```
aws s3 cp s3://aws-codedeploy-region/latest/codedeploy-agent.msi codedeploy-agent.msi --region region
```

... wo *region* ist die AWS Region, in der Sie Ihre Anwendung bereitstellen.

Beispiel:

```
aws s3 cp s3://aws-codedeploy-af-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi --region af-south-1
```