Docker-Anwendungsmanager

• 2.0.x

Diese Komponente kann auf -Core-Gerä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 AWS IoT Greengrass Core-Software funktioniert. Sie müssen Docker direkt auf dem Core-Gerät installieren, bevor Sie Komponenten bereitstellen, die Docker-Container ausführen.

• Der Docker-Daemon wurde gestartet und wird auf dem Core-Gerät ausgeführt, bevor Sie diese Komponente bereitstellen.

• Docker-Images, die in einer der folgenden unterstützten Image-Quellen 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-Containerkomponenten 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-Image: 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 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-Containerkomponente bereitstellen. Um sicherzustellen, dass alle Ihre Core-Geräte dieselbe Version eines Images ausführen, empfehlen wir Ihnen, das Image-Tag oder den Image-Digest in den Artefakt-URI aufzunehmen.

• Der Systembenutzer, der eine Docker-Containerkomponente ausführt, muss über Root- oder Administratorberechtigungen verfügen, oder Sie müssen Docker so konfigurieren, dass es als Nicht-Root- oder Nicht-Administratorbenutzer ausgeführt wird.

  • Auf Linux-Geräten können Sie der docker Gruppe einen Benutzer hinzufügen, um docker Befehle ohne aufzurufensudo.

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

  Linux or Unix

  Um oder den Nicht-Root-Benutzerggc_user, den Sie zum Ausführen von Docker-Containerkomponenten verwenden, zur docker Gruppe hinzuzufügen, führen Sie den folgenden Befehl aus.

  sudo usermod -aG docker ggc_user

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

  Windows Command Prompt (CMD)

  Um oder den Benutzerggc_user, den Sie zum Ausführen von Docker-Containerkomponenten 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 oder den Benutzerggc_user, den Sie zum Ausführen von Docker-Containerkomponenten 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 für die Verwendung desselben Proxy-Servers konfigurieren.

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

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

• Die Docker-Application-Manager-Komponente wird für die Ausführung in einer VPC unterstützt. Um diese Komponente in einer VPC bereitzustellen, ist Folgendes erforderlich.

  • Die Docker-Application-Manager-Komponente muss über Konnektivität verfügen, um Images herunterzuladen. 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