Gestore di applicazioni Docker

• 2.0.x

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

• Linux

• Windows

• Docker Engine 1.9.1 o successivo installato sul dispositivo principale di Greengrass. Le versioni fino alla 29.6.0 inclusa, come 20.10, 24.0, 25.0 e 27.5, funzionano con il software Core. AWS IoT Greengrass È necessario installare Docker direttamente sul dispositivo principale prima di distribuire i componenti che eseguono i contenitori Docker.

• Il demone 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)

  • Repository Docker Hub pubblico

  • Registro pubblico affidabile di Docker

• Immagini Docker incluse come artefatti nei componenti personalizzati del contenitore Docker. 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 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 il digest dell'immagine nell'URI dell'artefatto di un'immagine, il gestore dell'applicazione Docker estrae 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 il digest dell'immagine nell'URI dell'artefatto.

• L'utente di sistema che esegue un componente del contenitore Docker deve disporre delle autorizzazioni di root o di 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 chiamare docker i comandi senza privilegi di amministratore.

  Linux or Unix

  Per aggiungere ggc_user al docker gruppo l'utente non root utilizzato 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 ggc_user l'utente che utilizzi per eseguire i componenti del contenitore Docker al docker-users gruppo, esegui il seguente comando come amministratore.

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  Per aggiungere ggc_user l'utente che utilizzi per eseguire i componenti del contenitore Docker al docker-users gruppo, esegui il seguente comando 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 del contenitore Docker. Inoltre, il ruolo del dispositivo Greengrass deve consentire le ecr:GetDownloadUrlForLayer azioni,, e ecr:GetAuthorizationTokenecr:BatchGetImage, come mostrato nel seguente esempio di policy IAM.

  JSON

  {
    "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 essere connesso per scaricare le immagini. Ad esempio, se si utilizza l'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