Hinweis zum Ende des Supports: Am 7. Oktober 2026 AWS wird der Support für eingestellt. AWS IoT Greengrass Version 1 Nach dem 7. Oktober 2026 können Sie nicht mehr auf die Ressourcen zugreifen. AWS IoT Greengrass V1 Weitere Informationen finden Sie unter [Migrieren von AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
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.
# Optional: Konfiguration Ihres Docker-Containers für IDT für AWS IoT Greengrass
AWS IoT Greengrass bietet ein Docker-Image und eine Docker-Datei, die es einfacher machen, die AWS IoT Greengrass Core-Software in einem Docker-Container auszuführen. Nachdem Sie den AWS IoT Greengrass Container eingerichtet haben, können Sie IDT-Tests ausführen. Derzeit werden nur x86\_64 Docker-Architekturen unterstützt, um IDT für AWS IoT Greengrass auszuführen.
Für diese Funktion ist IDT v2.3.0 oder höher erforderlich.
Der Prozess der Einrichtung des Docker-Containers für die Ausführung von IDT-Tests hängt davon ab, ob Sie das von bereitgestellte Docker-Image oder die Docker-Datei verwenden. AWS IoT Greengrass
+ [Verwenden des Docker-Images](#docker-config-setup-docker-image). Auf dem Docker-Image sind die Core-Software und die zugehörigen Abhängigkeiten installiert AWS IoT Greengrass .
+ [Verwenden der Docker-Datei](#docker-config-setup-dockerfile). Das Dockerfile enthält Quellcode, mit dem Sie benutzerdefinierte AWS IoT Greengrass Container-Images erstellen können. Das Abbild kann so geändert werden, dass es auf unterschiedlichen Plattformarchitekturen ausgeführt werden kann. Es kann auch verkleinert werden.
**Anmerkung**
AWS IoT Greengrass stellt keine Dockerfiles oder Docker-Images für AWS IoT Greengrass die Kernsoftwareversion 1.11.1 bereit. Um IDT-Tests auf Ihren eigenen benutzerdefinierten Container-Images auszuführen, muss Ihr Image die Abhängigkeiten enthalten, die in der von bereitgestellten Dockerfile definiert sind. AWS IoT Greengrass
Die folgenden Funktionen sind nicht verfügbar, wenn Sie sie AWS IoT Greengrass in einem Docker-Container ausführen:
+ [Konnektoren](connectors.md), die im **Greengrass-Container**-Modus ausgeführt werden. Um einen Konnektor in einem Docker-Container auszuführen, muss der Konnektor im Modus **No container (Kein Container)** ausgeführt werden. Informationen zum Suchen von Konnektoren, die den **No Container (Kein Container)**-Modus unterstützen, finden Sie unter [AWS-mitgelieferte Greengrass-Anschlüsse](connectors-list.md). Einige dieser Konnektoren weisen einen Isolationsmodus-Parameter auf, den Sie auf **No container (Kein Container)** festlegen müssen.
+ [Lokale Geräte- und Volume-Ressourcen](access-local-resources.md) Ihre benutzerdefinierten Lambda-Funktionen, die im Docker-Container ausgeführt werden, müssen direkt auf Geräte und Volumes auf dem Core zugreifen.
## Konfigurieren Sie das Docker-Image, bereitgestellt von AWS IoT Greengrass
Gehen Sie wie folgt vor, um das AWS IoT Greengrass Docker-Image für die Ausführung von IDT-Tests zu konfigurieren.
**Voraussetzungen**
Bevor Sie mit diesem Tutorial beginnen, müssen Sie Folgendes tun.
+ Sie müssen die folgende Software und Versionen auf Ihrem Hostcomputer installieren, basierend auf der von Ihnen ausgewählten Version AWS Command Line Interface (AWS CLI).
------
#### [ AWS CLI version 2 ]
+ [Docker-Version](https://docs.docker.com/install/) 18.09 oder höher. Frühere Versionen funktionieren möglicherweise auch, wir empfehlen jedoch 18.09 oder höher.
+ AWS CLI Version 2.0.0 oder höher.
+ Informationen zur Installation der AWS CLI Version 2 finden Sie unter [AWS CLI Version 2 installieren](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html).
+ Informationen zur AWS CLI Konfiguration [von finden Sie unter Konfiguration von AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).
**Anmerkung**
Um auf einem Windows-Computer auf eine neuere AWS CLI Version 2 zu aktualisieren, müssen Sie den [MSI-Installationsvorgang](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-windows.html) wiederholen.
------
#### [ AWS CLI version 1 ]
+ [Docker-Version](https://docs.docker.com/install/) 18.09 oder höher. Frühere Versionen funktionieren möglicherweise auch, wir empfehlen jedoch 18.09 oder höher.
+ [Python-Version](https://www.python.org/downloads/) 3.6 oder höher.
+ [pip](https://pip.pypa.io/en/stable/installing), Version 18.1 oder höher.
+ AWS CLI Version 1.17.10 oder höher
+ Informationen zur Installation der AWS CLI Version 1 finden Sie unter [AWS CLI Version 1 installieren](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv1.html).
+ Informationen zur AWS CLI Konfiguration [von finden Sie unter Konfiguration von AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).
+ Führen Sie den folgenden Befehl aus, um auf die neueste AWS CLI Version von Version 1 zu aktualisieren.
```
pip install awscli --upgrade --user
```
**Anmerkung**
Wenn Sie die [MSI-Installation](https://docs.aws.amazon.com/cli/latest/userguide/install-windows.html#msi-on-windows) der AWS CLI Version 1 unter Windows verwenden, beachten Sie Folgendes:
Wenn bei der Installation AWS CLI von Version 1 Botocore nicht installiert werden kann, versuchen Sie es mit der [Python- und Pip-Installation](https://docs.aws.amazon.com/cli/latest/userguide/awscli-install-windows.html#awscli-install-windows-pip).
Um auf eine neuere AWS CLI Version 1 zu aktualisieren, müssen Sie den MSI-Installationsvorgang wiederholen.
------
+ Um auf Ressourcen von Amazon Elastic Container Registry (Amazon ECR) zugreifen zu können, müssen Sie die folgende Berechtigung erteilen.
+ Amazon ECR verlangt von Benutzern, die `ecr:GetAuthorizationToken` Erlaubnis über eine AWS Identity and Access Management (IAM-) Richtlinie zu erteilen, bevor sie sich bei einer Registrierung authentifizieren und Bilder aus einem Amazon ECR-Repository per Push oder Pull abrufen können. Weitere Informationen finden Sie unter [Amazon ECR Repository-Richtlinienbeispiele](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-policy-examples.html) und [Zugriff auf ein Amazon ECR-Repository](https://docs.aws.amazon.com/AmazonECR/latest/userguide/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-access-one-bucket) im *Amazon Elastic Container Registry-Benutzerhandbuch*.
1. Laden Sie das Docker-Image herunter, und konfigurieren Sie den Container. Sie können das vorgefertigte Image von [Docker Hub](https://hub.docker.com/r/amazon/aws-iot-greengrass) oder [Amazon Elastic Container Registry (Amazon](https://docs.aws.amazon.com/AmazonECR/latest/userguide/what-is-ecr.html) ECR) herunterladen und auf Windows-, macOS- und Linux-Plattformen (x86\_64) ausführen.
Um das Docker-Image von Amazon ECR herunterzuladen, führen Sie alle Schritte unter aus. [Schritt 1: Holen Sie sich das AWS IoT Greengrass Container-Image von Amazon ECR](run-gg-in-docker-container.md#docker-pull-image) Kehren Sie dann zu diesem Thema zurück, um die Konfiguration fortzusetzen.
1. Nur für Linux-Benutzer: Stellen Sie sicher, dass der Benutzer, der IDT ausführt, über die Berechtigung zum Ausführen von Docker-Befehlen verfügt. Weitere Informationen finden Sie unter [Verwalten von Docker durch andere Benutzer als Stammbenutzer](https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user) in der Docker-Dokumentation.
1. Verwenden Sie den Befehl für Ihr Betriebssystem, um den AWS IoT Greengrass Container auszuführen:
------
#### [ Linux ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
-v {{}}:{{}} \
{{}}:{{}}
```
+ {{}}Ersetzen Sie durch den Pfad zur Kernel-Konfigurationsdatei auf dem Host und {{}} durch den Pfad, unter dem das Volume im Container gemountet ist.
Die Kernel-Konfigurationsdatei auf dem Host befindet sich normalerweise in `/proc/config.gz` oder `/boot/config-{{}}`. Sie können ausführen`uname -r`, um den {{}} Wert zu finden.
**Beispiel:** Zum Mounten der Konfigurationsdatei von `/boot/config-{{}}`
```
-v /boot/config-4.15.0-74-generic:/boot/config-4.15.0-74-generic \
```
**Beispiel:** Zum Mounten der Konfigurationsdatei von `proc/config.gz`
```
-v /proc/config.gz:/proc/config.gz \
```
+ Ersetzen Sie{{}}: {{}} im Befehl durch den Namen des Repositorys und das Tag des Zielbildes.
**Beispiel:** Um auf die neueste Version der AWS IoT Greengrass Core-Software zu verweisen
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Führen Sie den folgenden Befehl aus, um die Liste der AWS IoT Greengrass Docker-Images abzurufen.
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
#### [ macOS ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
{{}}:{{}}
```
+ Ersetzen Sie{{}}: {{}} im Befehl durch den Namen des Repositorys und das Tag des Zielimages.
**Beispiel:** Um auf die neueste Version der AWS IoT Greengrass Core-Software zu verweisen
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Führen Sie den folgenden Befehl aus, um die Liste der AWS IoT Greengrass Docker-Images abzurufen:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
#### [ Windows ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
{{}}:{{}}
```
+ Ersetzen Sie{{}}: {{}} im Befehl durch den Namen des Repositorys und das Tag des Zielimages.
**Beispiel:** Um auf die neueste Version der AWS IoT Greengrass Core-Software zu verweisen
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Führen Sie den folgenden Befehl aus, um die Liste der AWS IoT Greengrass Docker-Images abzurufen:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
**Wichtig**
Geben Sie beim Testen mit IDT nicht das `--entrypoint /greengrass-entrypoint.sh \` Argument an, das zum Ausführen des Images für den allgemeinen AWS IoT Greengrass Gebrauch verwendet wird.
1. Nächster Schritt: [Konfigurieren Sie Ihre AWS Anmeldeinformationen und `device.json` Datei](set-config.md).
## Konfigurieren Sie das Dockerfile, das bereitgestellt wird von AWS IoT Greengrass
Gehen Sie wie folgt vor, um das aus dem AWS IoT Greengrass Dockerfile erstellte Docker-Image für die Ausführung von IDT-Tests zu konfigurieren.
1. Laden Sie das Dockerfile-Paket von [AWS IoT Greengrass Docker-Software](what-is-gg.md#gg-docker-download) auf Ihren Hostcomputer herunter und extrahieren Sie es.
1. Öffnen Sie `README.md`. Die nächsten drei Schritte beziehen sich auf Abschnitte in dieser Datei.
1. Stellen Sie sicher, dass Sie die Anforderungen im Abschnitt **Voraussetzungen** erfüllen.
1. Nur für Linux-Benutzer: Führen Sie die Schritte **Symlink- und Hardlink-Schutz aktivieren** und **IPv4-Netzwerkweiterleitung aktivieren** aus.
1. **Um das Docker-Image zu erstellen, führen Sie alle Schritte in Schritt 1 aus. Erstellen Sie das AWS IoT Greengrass Docker-Image**. Kehren Sie dann zu diesem Thema zurück, um die Konfiguration fortzusetzen.
1. Verwenden Sie den Befehl für Ihr Betriebssystem, um den AWS IoT Greengrass Container auszuführen:
------
#### [ Linux ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
-v {{}}:{{}} \
{{}}:{{}}
```
+ {{}}Ersetzen Sie durch den Pfad zur Kernel-Konfigurationsdatei auf dem Host und {{}} durch den Pfad, unter dem das Volume im Container gemountet ist.
Die Kernel-Konfigurationsdatei auf dem Host befindet sich normalerweise in `/proc/config.gz` oder `/boot/config-{{}}`. Sie können ausführen`uname -r`, um den {{}} Wert zu finden.
**Beispiel:** Zum Mounten der Konfigurationsdatei von `/boot/config-{{}}`
```
-v /boot/config-4.15.0-74-generic:/boot/config-4.15.0-74-generic \
```
**Beispiel:** Zum Mounten der Konfigurationsdatei von `proc/config.gz`
```
-v /proc/config.gz:/proc/config.gz \
```
+ Ersetzen Sie{{}}: {{}} im Befehl durch den Namen des Repositorys und das Tag des Zielbildes.
**Beispiel:** Um auf die neueste Version der AWS IoT Greengrass Core-Software zu verweisen
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Führen Sie den folgenden Befehl aus, um die Liste der AWS IoT Greengrass Docker-Images abzurufen.
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
#### [ macOS ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
{{}}:{{}}
```
+ Ersetzen Sie{{}}: {{}} im Befehl durch den Namen des Repositorys und das Tag des Zielimages.
**Beispiel:** Um auf die neueste Version der AWS IoT Greengrass Core-Software zu verweisen
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Führen Sie den folgenden Befehl aus, um die Liste der AWS IoT Greengrass Docker-Images abzurufen:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
#### [ Windows ]
```
docker run --rm --init -it -d --name aws-iot-greengrass \
-p 8883:8883 \
{{}}:{{}}
```
+ Ersetzen Sie{{}}: {{}} im Befehl durch den Namen des Repositorys und das Tag des Zielimages.
**Beispiel:** Um auf die neueste Version der AWS IoT Greengrass Core-Software zu verweisen
```
216483018798.dkr.ecr.us-west-2.amazonaws.com/aws-iot-greengrass:latest
```
Führen Sie den folgenden Befehl aus, um die Liste der AWS IoT Greengrass Docker-Images abzurufen:
```
aws ecr list-images --region us-west-2 --registry-id 216483018798 --repository-name aws-iot-greengrass
```
------
**Wichtig**
Geben Sie beim Testen mit IDT nicht das `--entrypoint /greengrass-entrypoint.sh \` Argument an, das zum Ausführen des Images für den allgemeinen AWS IoT Greengrass Gebrauch verwendet wird.
1. Nächster Schritt: [Konfigurieren Sie Ihre AWS Anmeldeinformationen und `device.json` Datei](set-config.md).
## Fehlerbehebung bei Ihrem Docker-Container-Setup für IDT für AWS IoT Greengrass
Verwenden Sie die folgenden Informationen, um Probleme beim Ausführen eines Docker-Containers für IDT zu Testzwecken zu beheben. AWS IoT Greengrass
### WARNUNG: Fehler beim Laden der Konfigurationsdatei://. home/user docker/config.json - stat /home/ user < /. > docker/config.json: Erlaubnis verweigert
Wenn Sie diesen Fehler beim Ausführen von `docker`-Befehlen unter Linux erhalten, führen Sie folgenden Befehl aus. Ersetzen Sie {{}} den folgenden Befehl durch den Benutzer, der IDT ausführt.
```
sudo chown {{}}:{{}} /home/{{}}/.docker -R
sudo chmod g+rwx /home/{{}}/.docker -R
```