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. Les versions jusqu'à la version 29.6.0 incluse, telles que 20.10, 24.0, 25.0 et 27.5, fonctionnent avec le logiciel Core. AWS IoT Greengrass Vous devez installer Docker directement sur l'appareil principal avant de déployer des composants qui exécutent des conteneurs Docker.

• Le démon Docker a démarré et s'est exécuté sur l'appareil 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 (Amazon ECR)

  • Référentiel public Docker Hub

  • Registre public de confiance Docker

• Images Docker incluses en tant qu'artefacts dans les composants de votre conteneur Docker personnalisé. Utilisez les formats d'URI suivants pour spécifier vos images Docker :

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

  • Image publique Amazon ECR : 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 la balise d'image ou le résumé d'image dans l'URI de l'artefact pour 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 vous assurer 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 condensé d'image dans l'URI de l'artefact.

• L'utilisateur système qui exécute un composant de conteneur Docker doit disposer d'autorisations root ou d'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 pour qu'il puisse appeler docker des commandes sanssudo.

  • 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 utiliser le même serveur proxy.

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

  JSON

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

• Le composant Docker Application Manager est pris en charge pour fonctionner dans un VPC. Pour déployer ce composant dans un VPC, les conditions suivantes sont requises.

  • Le composant Docker Application Manager doit être connecté pour télécharger des images. Par exemple, si vous utilisez ECR, vous devez disposer d'une connectivité aux points de terminaison suivants.

    • *.dkr.ecr.region.amazonaws.com(point de terminaison com.amazonaws.region.ecr.dkr VPC)

    • api.ecr.region.amazonaws.com(point de terminaison com.amazonaws.region.ecr.api VPC)

• Exécuter un conteneur Docker