Gestore di applicazioni Docker

• 2.0.x

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:

• Linux

• Windows

• Docker Engine 1.9.1 o versione successiva installato sul dispositivo principale Greengrass. La versione 20.10 è l'ultima versione verificata per funzionare con il software Core. AWS IoT Greengrass È necessario installare Docker direttamente sul dispositivo principale prima di distribuire componenti che eseguono contenitori Docker.

• Il daemon Docker è stato avviato e funzionante sul dispositivo principale prima di distribuire questo componente.

• Immagini Docker archiviate in una delle seguenti fonti di immagini supportate:

  • Archivi di immagini pubblici e privati in Amazon Elastic Container Registry (Amazon ECR)

  • Archivio pubblico di Docker Hub

  • Registro pubblico affidabile di Docker

• Immagini Docker incluse come artefatti nei componenti del contenitore Docker personalizzati. Usa i seguenti formati URI per specificare le tue immagini Docker:

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

  • Immagine pubblica di Amazon ECR: docker:public.ecr.aws/repository/image[:tag|@digest]

  • Immagine pubblica di Docker Hub: docker:name[:tag|@digest]

  Per ulteriori informazioni, consulta Esegui un contenitore Docker.

  Nota

  Se non specifichi il tag dell'immagine o l'image digest nell'URI dell'artefatto per un'immagine, il gestore delle applicazioni Docker recupera l'ultima versione disponibile di quell'immagine quando distribuisci il componente contenitore Docker personalizzato. Per garantire che tutti i dispositivi principali eseguano la stessa versione di un'immagine, ti consigliamo di includere il tag dell'immagine o l'image digest nell'URI dell'artefatto.

• L'utente di sistema che esegue un componente del contenitore Docker deve disporre delle autorizzazioni di root o amministratore oppure è necessario configurare Docker per eseguirlo come utente non root o non amministratore.

  • Sui dispositivi Linux, puoi aggiungere un utente al gruppo senza il quale chiamare i comandi. docker docker sudo

  • Nei dispositivi Windows, è possibile aggiungere un utente al docker-users gruppo per richiamare docker comandi senza privilegi di amministratore.

  Linux or Unix

  Per aggiungere ggc_user al docker gruppo l'utente non root che usi per eseguire i componenti del contenitore Docker, esegui il comando seguente.

  sudo usermod -aG docker ggc_user

  Per ulteriori informazioni, consulta Gestire Docker come utente non root.

  Windows Command Prompt (CMD)

  Per aggiungere al docker-users gruppoggc_user, o l'utente che usi per eseguire i componenti del contenitore Docker, esegui il comando seguente come amministratore.

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  Per aggiungere al docker-users gruppoggc_user, o l'utente che usi per eseguire i componenti del contenitore Docker, esegui il comando seguente come amministratore.

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• Se configuri il software AWS IoT Greengrass Core per utilizzare un proxy di rete, devi configurare Docker per utilizzare lo stesso server proxy.

• Se le tue immagini Docker sono archiviate in un registro privato Amazon ECR, devi includere il componente del servizio di scambio di token come dipendenza nel componente contenitore Docker. Inoltre, il ruolo del dispositivo Greengrass deve consentire le ecr:GetDownloadUrlForLayer azioniecr:GetAuthorizationToken, eecr:BatchGetImage, come mostrato nell'esempio seguente di politica IAM.

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

• Il componente docker application manager è supportato per l'esecuzione in un VPC. Per distribuire questo componente in un VPC, è necessario quanto segue.

  • Il componente docker application manager deve disporre di connettività per scaricare le immagini. Ad esempio, se si utilizza ECR, è necessario disporre della connettività ai seguenti endpoint.

    • *.dkr.ecr.region.amazonaws.com(endpoint VPC) com.amazonaws.region.ecr.dkr

    • api.ecr.region.amazonaws.com(endpoint VPC) com.amazonaws.region.ecr.api

• Esegui un contenitore Docker