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. Version 20.10 ist die neueste Version, für die verifiziert wurde, dass sie mit der Core-Software funktioniert. 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 auf dem Kerngerät gestartet und ausgeführt, 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 (AmazonECR)

  • Öffentliches Docker Hub-Repository

  • Vertrauenswürdiges öffentliches Docker-Register

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

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

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

  • Öffentliches Docker Hub-Bild: 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 im 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 das Artefakt aufzunehmen. URI

• 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, um Befehle ohne Befehle docker aufzurufen. 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 Nicht-Root-Benutzer, den Sie zum Ausführen von Docker-Container-Komponenten verwenden, hinzuzufügen.

  sudo usermod -aG docker ggc_user

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

  Windows Command Prompt (CMD)

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

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  Um der docker-users Gruppe den Benutzerggc_user, den Sie zum Ausführen von Docker-Container-Komponenten verwenden, 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 für die Verwendung desselben Proxyservers konfigurieren.

• Wenn Ihre Docker-Images in einer ECR privaten Amazon-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 ecr:GetAuthorizationTokenecr:BatchGetImage, und zulassen, wie in der folgenden IAM Beispielrichtlinie gezeigt.

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

• Die Docker-Anwendungsmanager-Komponente wird für die Ausführung in a VPC unterstützt. Um diese Komponente in a bereitzustellenVPC, ist Folgendes erforderlich.

  • Die Docker-Anwendungsmanager-Komponente muss über Konnektivität zum Herunterladen von Bildern verfügen. Wenn Sie beispielsweise verwendenECR, müssen Sie über Konnektivität zu den folgenden Endpunkten verfügen.

    • *.dkr.ecr.region.amazonaws.com(VPCEndpunktcom.amazonaws.region.ecr.dkr)

    • api.ecr.region.amazonaws.com(VPCEndpunktcom.amazonaws.region.ecr.api)

• Führen Sie einen Docker-Container aus