Docker-Anwendungsmanager

• 2.0.x

Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:

• Linux

• Windows

• Docker Engine 1.9.1 oder höher ist auf dem Greengrass-Core-Gerät installiert. Versionen bis einschließlich 29.6.0, wie 20.10, 24.0, 25.0 und 27.5, funktionieren mit der Core-Software. AWS IoT Greengrass Sie müssen Docker direkt auf dem Kerngerät installieren, bevor Sie Komponenten bereitstellen, auf denen Docker-Container ausgeführt werden.

• Der Docker-Daemon wurde gestartet und läuft auf dem Kerngerät, bevor Sie diese Komponente bereitstellen.

• Docker-Images, die in einer der folgenden unterstützten Bildquellen gespeichert sind:

  • Öffentliche und private Image-Repositorys in Amazon Elastic Container Registry (Amazon ECR)

  • Öffentliches Docker Hub-Repository

  • Öffentliche vertrauenswürdige Docker-Registrierung

• Docker-Images, die als Artefakte in Ihren benutzerdefinierten Docker-Container-Komponenten enthalten sind. Verwenden Sie die folgenden URI-Formate, um Ihre Docker-Images anzugeben:

  • Privates Amazon ECR-Image: docker:account-id.dkr.ecr.region.amazonaws.com/repository/image[:tag|@digest]

  • Öffentliches Amazon ECR-Bild: docker:public.ecr.aws/repository/image[:tag|@digest]

  • Öffentliches Docker Hub-Image: docker:name[:tag|@digest]

  Weitere Informationen finden Sie unter Führen Sie einen Docker-Container aus.

  Anmerkung

  Wenn Sie das Image-Tag oder den Image-Digest nicht in der Artefakt-URI für ein Image angeben, ruft der Docker-Anwendungsmanager die neueste verfügbare Version dieses Images ab, wenn Sie Ihre benutzerdefinierte Docker-Container-Komponente bereitstellen. Um sicherzustellen, dass auf allen Ihren Kerngeräten dieselbe Version eines Images ausgeführt wird, empfehlen wir, das Image-Tag oder den Image-Digest in die Artefakt-URI aufzunehmen.

• Der Systembenutzer, der eine Docker-Container-Komponente ausführt, muss über Root- oder Administratorrechte verfügen, oder Sie müssen Docker so konfigurieren, dass es als Benutzer ohne Root- oder Administratorrechte ausgeführt wird.

  • Auf Linux-Geräten können Sie der Gruppe einen Benutzer hinzufügen, ohne dass Befehle aufgerufen werden sollen. docker docker sudo

  • Auf Windows-Geräten können Sie der docker-users Gruppe einen Benutzer hinzufügen, um docker Befehle ohne Administratorrechte aufzurufen.

  Linux or Unix

  Führen Sie den folgenden Befehl ausggc_user, um der docker Gruppe einen Benutzer hinzuzufügen, der kein Root-Benutzer ist, den Sie zum Ausführen der Docker-Container-Komponenten verwenden.

  sudo usermod -aG docker ggc_user

  Weitere Informationen finden Sie unter Docker als Benutzer ohne Root-Rechte verwalten.

  Windows Command Prompt (CMD)

  Um der Gruppe oder den Benutzerggc_user, den Sie zum Ausführen von Docker-Container-Komponenten verwenden, zur docker-users Gruppe hinzuzufügen, führen Sie den folgenden Befehl als Administrator aus.

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  Um der Gruppe oder den Benutzerggc_user, den Sie zum Ausführen der Docker-Container-Komponenten verwenden, zur docker-users Gruppe hinzuzufügen, führen Sie den folgenden Befehl als Administrator aus.

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• Wenn Sie die AWS IoT Greengrass Core-Software für die Verwendung eines Netzwerk-Proxys konfigurieren, müssen Sie Docker so konfigurieren, dass es denselben Proxyserver verwendet.

• Wenn Ihre Docker-Images in einer privaten Amazon ECR-Registry gespeichert sind, müssen Sie die Token-Exchange-Servicekomponente als Abhängigkeit in die Docker-Container-Komponente aufnehmen. Außerdem muss die Greengrass-Geräterolle die ecr:GetDownloadUrlForLayer Aktionen,, und zulassen ecr:GetAuthorizationTokenecr:BatchGetImage, wie im folgenden Beispiel für eine IAM-Richtlinie gezeigt.

  JSON

  {
    "Version":"2012-10-17",
    "Statement": [
      {
        "Action": [
          "ecr:GetAuthorizationToken",
          "ecr:BatchGetImage",
          "ecr:GetDownloadUrlForLayer"
        ],
        "Resource": [
          "*"
        ],
        "Effect": "Allow"
      }
    ]
  }
  

• Die Ausführung der Docker-Anwendungsmanager-Komponente in einer VPC wird unterstützt. Um diese Komponente in einer VPC bereitzustellen, ist Folgendes erforderlich.

  • Die Docker-Anwendungsmanager-Komponente muss über Konnektivität verfügen, um Images herunterladen zu können. Wenn Sie beispielsweise ECR verwenden, müssen Sie über Konnektivität zu den folgenden Endpunkten verfügen.

    • *.dkr.ecr.region.amazonaws.com(VPC-Endpunkt) com.amazonaws.region.ecr.dkr

    • api.ecr.region.amazonaws.com(VPC-Endpunkt) com.amazonaws.region.ecr.api

• Führen Sie einen Docker-Container aus