Configuración de su dispositivo para ejecutar pruebas de IDT

• El usuario predeterminado de Greengrass (ggc_user).

• El usuario que utiliza para conectarse al dispositivo que se está probando. Este usuario se configura en el archivo device.json.

Debe cumplir con los siguientes requisitos para permitir que IDT utilice su rol de IAM personalizado. Le recomendamos encarecidamente que agregue a este rol solo las acciones de política mínimas requeridas.

• El archivo de configuración userdata.json debe actualizarse para establecer el parámetro GreengrassV2TokenExchangeRole en true.

• El rol de IAM personalizado debe configurarse con la siguiente política de confianza mínima:

  {
     "Version":"2012-10-17",
     "Statement":[
        {
           "Effect":"Allow",
           "Principal":{
              "Service":[
                 "credentials.iot.amazonaws.com",
                 "lambda.amazonaws.com", 
                 "sagemaker.amazonaws.com" 
              ]
           },
           "Action":"sts:AssumeRole"
        }
     ]
  }

• El rol de IAM personalizado debe configurarse con la siguiente política de permisos mínimos:

  {
     "Version":"2012-10-17",
     "Statement":[
        {
           "Effect":"Allow",
           "Action":[
              "iot:DescribeCertificate",
              "logs:CreateLogGroup",
              "logs:CreateLogStream",
              "logs:PutLogEvents",
              "logs:DescribeLogStreams",
              "iot:Connect",
              "iot:Publish",
              "iot:Subscribe",
              "iot:Receive",
              "iot:ListThingPrincipals", 
              "iot:GetThingShadow",
              "iot:UpdateThingShadow",
              "s3:GetBucketLocation",
              "s3:GetObject",
              "s3:PutObject",
              "s3:AbortMultipartUpload",
              "s3:ListMultipartUploadParts"
           ],
           "Resource":"*"
        }
     ]
  }

• El nombre del rol de IAM personalizado debe coincidir con el recurso del rol de IAM que especifique en los permisos de IAM para el usuario de prueba. De forma predeterminada, la política de usuarios de prueba permite el acceso a los roles de IAM que tienen el prefijo idt- en sus nombres de rol. Si el nombre de su rol de IAM no usa este prefijo, agregue el recurso arn:aws:iam::*:role/custom-iam-role-name a la declaración roleAliasResources y la declaración passRoleForResources a su política de usuarios de prueba, como se muestra en los siguientes ejemplos:

  ejemplo passRoleForResources instrucción

  {
     "Sid":"passRoleForResources",
     "Effect":"Allow",
     "Action":"iam:PassRole",
     "Resource":"arn:aws:iam::*:role/custom-iam-role-name",
     "Condition":{
        "StringEquals":{
           "iam:PassedToService":[
              "iot.amazonaws.com",
              "lambda.amazonaws.com",
              "greengrass.amazonaws.com"
           ]
        }
     }
  }

  ejemplo roleAliasResources instrucción

  {
     "Sid":"roleAliasResources",
     "Effect":"Allow",
     "Action":[
        "iot:CreateRoleAlias",
        "iot:DescribeRoleAlias",
        "iot:DeleteRoleAlias",
        "iot:TagResource",
        "iam:GetRole"
     ],
     "Resource":[
        "arn:aws:iot:*:*:rolealias/idt-*",
        "arn:aws:iam::*:role/custom-iam-role-name"
     ]
  }

• Versión 1.9.1 o posterior de Docker Engine instalada en el dispositivo principal de Greengrass. La versión 20.10 es la última versión cuyo funcionamiento se ha verificado con el software AWS IoT Greengrass Core. Debe instalar Docker directamente en el dispositivo principal antes de implementar componentes que ejecuten contenedores de Docker.

• El daemon de Docker se inició y se ejecutó en el dispositivo principal antes de implementar este componente.

• El usuario del sistema que ejecute un componente contenedor de Docker debe tener permisos de raíz o administrador, o bien debe configurar Docker para que se ejecute como un usuario no de raíz o no administrador.

  • En los dispositivos Linux, debe agregar un usuario al grupo de docker para llamar comandos docker sin sudo.

  • En los dispositivos Windows, puede agregar un usuario al grupo de docker-users para llamar comandos docker sin privilegios de administrador.

  Linux or Unix

  Para agregar ggc_user, o el usuario no raíz que utilice para ejecutar los componentes del contenedor de Docker, al grupo de docker, ejecute el siguiente comando.

  sudo usermod -aG docker ggc_user

  Para obtener más información, consulte Administrar Docker como un usuario no raíz.

  Windows Command Prompt (CMD)

  Para agregar ggc_user, o el usuario que utilice para ejecutar los componentes del contenedor de Docker, al grupo de docker-users, ejecute el siguiente comando como un administrador.

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  Para agregar ggc_user, o el usuario que utilice para ejecutar los componentes del contenedor de Docker, al grupo de docker-users, ejecute el siguiente comando como un administrador.

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• En los dispositivos principales de Greengrass que ejecutan Amazon Linux 2 o Ubuntu 18.04, se instala en el dispositivo la versión 2.27 o posterior de la Biblioteca C GNU (glibc).

• En los dispositivos ARMv7L, como Raspberry Pi, las dependencias para OpenCV-Python están instaladas en el dispositivo. Ejecute el siguiente comando para instalar las dependencias.

  sudo apt-get install libopenjp2-7 libilmbase23 libopenexr-dev libavcodec-dev libavformat-dev libswscale-dev libv4l-dev libgtk-3-0 libwebp-dev

• Los dispositivos Raspberry Pi que ejecutan el sistema operativo Bullseye de Raspberry Pi deben cumplir los siguientes requisitos:

  • NumPy 1.22.4 o posterior instalado en el dispositivo. El sistema operativo Bullseye de Raspberry Pi incluye una versión anterior de NumPy, por lo que puede ejecutar el siguiente comando para actualizar NumPy en el dispositivo.

    pip3 install --upgrade numpy

  • La pila de cámara antigua habilitada en el dispositivo. El sistema operativo Bullseye de Raspberry Pi incluye una nueva pila de cámara que está habilitada de forma predeterminada y no es compatible, por lo que debe activar la pila de cámara antigua.

    Cómo activar la pila de cámara antigua

    1. Ejecute el siguiente comando para abrir la herramienta de configuración de Raspberry Pi.

       sudo raspi-config

    2. Seleccione Opciones de interfaz.

    3. Seleccione Cámara antigua para activar la pila de cámara antigua.

    4. Reinicie el Raspberry Pi.