Gestionnaire d'applications Docker

• 2,0.x

Ce composant peut être installé sur les appareils principaux qui exécutent les systèmes d'exploitation suivants :

• Linux

• Windows

• Docker Engine 1.9.1 ou version ultérieure installé sur le périphérique principal de Greengrass. La version 20.10 est la dernière version vérifiée pour fonctionner avec le logiciel AWS IoT Greengrass Core. Vous devez installer Docker directement sur le périphérique principal avant de déployer des composants qui exécutent des conteneurs Docker.

• Le daemon Docker a démarré et s'est exécuté sur le périphérique principal avant que vous ne déployiez ce composant.

• Images Docker stockées dans l'une des sources d'images prises en charge suivantes :

  • Référentiels d'images publics et privés dans Amazon Elastic Container Registry (AmazonECR)

  • Référentiel Docker Hub public

  • Registre public de confiance Docker

• Images Docker incluses sous forme d'artefacts dans vos composants de conteneur Docker personnalisés. Utilisez les URI formats suivants pour spécifier vos images Docker :

  • ECRImage privée d'Amazon : docker:account-id.dkr.ecr.region.amazonaws.com/repository/image[:tag|@digest]

  • ECRImage Amazon publique : docker:public.ecr.aws/repository/image[:tag|@digest]

  • Image publique du Docker Hub : docker:name[:tag|@digest]

  Pour de plus amples informations, veuillez consulter Exécuter un conteneur Docker.

  Note

  Si vous ne spécifiez pas de balise d'image ou de résumé d'image dans l'artefact URI d'une image, le gestionnaire d'applications Docker extrait la dernière version disponible de cette image lorsque vous déployez votre composant de conteneur Docker personnalisé. Pour garantir que tous vos appareils principaux exécutent la même version d'une image, nous vous recommandons d'inclure la balise d'image ou le résumé de l'image dans l'artefactURI.

• L'utilisateur du système qui exécute un composant de conteneur Docker doit disposer des autorisations root ou administrateur, ou vous devez configurer Docker pour l'exécuter en tant qu'utilisateur non root ou non administrateur.

  • Sur les appareils Linux, vous pouvez ajouter un utilisateur au docker groupe sans lequel vous pouvez appeler docker des commandessudo.

  • Sur les appareils Windows, vous pouvez ajouter un utilisateur au docker-users groupe pour appeler des docker commandes sans privilèges d'administrateur.

  Linux or Unix

  Pour ajouter ggc_user au docker groupe l'utilisateur non root que vous utilisez pour exécuter les composants du conteneur Docker, exécutez la commande suivante.

  sudo usermod -aG docker ggc_user

  Pour plus d'informations, consultez Gérer Docker en tant qu'utilisateur non root.

  Windows Command Prompt (CMD)

  Pour ajouter ggc_user au docker-users groupe l'utilisateur que vous utilisez pour exécuter les composants du conteneur Docker, exécutez la commande suivante en tant qu'administrateur.

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  Pour ajouter ggc_user au docker-users groupe l'utilisateur que vous utilisez pour exécuter les composants du conteneur Docker, exécutez la commande suivante en tant qu'administrateur.

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• Si vous configurez le logiciel AWS IoT Greengrass Core pour utiliser un proxy réseau, vous devez configurer Docker pour qu'il utilise le même serveur proxy.

• Si vos images Docker sont stockées dans un registre ECR privé Amazon, vous devez inclure le composant du service d'échange de jetons en tant que dépendance dans le composant conteneur Docker. En outre, le rôle d'appareil Greengrass doit autoriser les ecr:GetDownloadUrlForLayer actions ecr:GetAuthorizationTokenecr:BatchGetImage, et, comme indiqué dans l'exemple IAM de politique suivant.

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

• Le composant du gestionnaire d'applications docker est compatible avec l'exécution dans un. VPC Pour déployer ce composant dans unVPC, les éléments suivants sont requis.

  • Le composant du gestionnaire d'applications docker doit disposer d'une connectivité pour télécharger des images. Par exemple, si vous utilisezECR, vous devez être connecté aux points de terminaison suivants.

    • *.dkr.ecr.region.amazonaws.com(VPCpoint finalcom.amazonaws.region.ecr.dkr)

    • api.ecr.region.amazonaws.com(VPCpoint finalcom.amazonaws.region.ecr.api)

• Exécuter un conteneur Docker