Configure seu dispositivo para executar testes de IDT

• O usuário padrão do Greengrass ()ggc_user.

• O usuário que você usa para se conectar ao dispositivo em teste. Você configura esse usuário no device.jsonarquivo.

Você deve atender aos seguintes requisitos para permitir que o IDT use sua função personalizada do IAM. É altamente recomendável que você adicione somente as ações políticas mínimas necessárias a essa função.

• O arquivo de configuração userdata.json deve ser atualizado para definir o parâmetro como. GreengrassV2TokenExchangeRole true

• A função personalizada do IAM deve ser configurada com a seguinte política de confiança mínima:

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

• O papel personalizado do IAM deve ser configurado com a seguinte política de permissões mínimas:

  {
     "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":"*"
        }
     ]
  }

• O nome da função personalizada do IAM deve corresponder ao recurso de função do IAM que você especifica nas permissões do IAM para o usuário de teste. Por padrão, a política de usuário de teste permite o acesso às funções do IAM que têm o idt- prefixo em seus nomes de função. Se o nome da sua função do IAM não usar esse prefixo, adicione o arn:aws:iam::*:role/custom-iam-role-name recurso à roleAliasResources declaração e a passRoleForResources declaração na sua política de usuário de teste, conforme mostrado nos exemplos a seguir:

  exemplo Instrução passRoleForResources

  {
     "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"
           ]
        }
     }
  }

  exemplo Instrução roleAliasResources

  {
     "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"
     ]
  }

• Docker Engine 1.9.1 ou posterior instalado no dispositivo principal do Greengrass. A versão 20.10 é a versão mais recente verificada para funcionar com o software AWS IoT Greengrass Core. Você deve instalar o Docker diretamente no dispositivo principal antes de implantar componentes que executam contêineres do Docker.

• O daemon do Docker foi iniciado e executado no dispositivo principal antes de você implantar esse componente.

• O usuário do sistema que executa um componente de contêiner do Docker deve ter permissões de raiz ou administrador, ou você deve configurar o Docker para executá-lo como usuário não raiz ou não administrador.

  • Em dispositivos Linux, você pode adicionar um usuário ao docker grupo para chamar docker comandos semsudo.

  • Em dispositivos Windows, você pode adicionar um usuário ao docker-users grupo para chamar docker comandos sem privilégios de administrador.

  Linux or Unix

  Para adicionar ggc_user ou o usuário não root que você usa para executar componentes de contêiner do Docker ao docker grupo, execute o comando a seguir.

  sudo usermod -aG docker ggc_user

  Para obter mais informações, consulte Gerenciar o Docker como usuário não root.

  Windows Command Prompt (CMD)

  Para adicionar ggc_user ou o usuário que você usa para executar componentes de contêiner do Docker ao docker-users grupo, execute o comando a seguir como administrador.

  net localgroup docker-users ggc_user /add

  Windows PowerShell

  Para adicionar ggc_user ou o usuário que você usa para executar componentes de contêiner do Docker ao docker-users grupo, execute o comando a seguir como administrador.

  Add-LocalGroupMember -Group docker-users -Member ggc_user

• Nos principais dispositivos do Greengrass que executam o Amazon Linux 2 ou o Ubuntu 18.04, a GNU C Library (glibc) versão 2.27 ou posterior está instalada no dispositivo.

• Em dispositivos ARMv7L, como o Raspberry Pi, dependências do OpenCV-Python instaladas no dispositivo. Execute o comando a seguir para instalar as dependências.

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

• Os dispositivos Raspberry Pi que executam o Raspberry Pi OS Bullseye devem atender aos seguintes requisitos:

  • NumPy 1.22.4 ou posterior instalado no dispositivo. O Raspberry Pi OS Bullseye inclui uma versão anterior do NumPy, então você pode executar o seguinte comando para atualizar NumPy o dispositivo.

    pip3 install --upgrade numpy

  • A pilha de câmeras antiga ativada no dispositivo. O Raspberry Pi OS Bullseye inclui uma nova pilha de câmeras que é ativada por padrão e não é compatível, portanto, você deve habilitar a pilha de câmeras antiga.

    Para habilitar a pilha de câmeras antiga

    1. Execute o comando a seguir para abrir a ferramenta de configuração do Raspberry Pi.

       sudo raspi-config

    2. Selecione Opções de interface.

    3. Selecione Câmera antiga para ativar a pilha de câmeras antigas.

    4. Reinicie o Raspberry Pi.