Implantando seus componentes em um dispositivo - Amazon Lookout for Vision

Aviso de fim do suporte: em 31 de outubro de 2025, o suporte para o Amazon Lookout for Vision AWS será interrompido. Depois de 31 de outubro de 2025, você não poderá mais acessar o console do Lookout for Vision ou os recursos do Lookout for Vision. Para obter mais informações, visite esta postagem do blog.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Implantando seus componentes em um dispositivo

Para implantar o componente modelo e o componente do aplicativo cliente em um dispositivo AWS IoT Greengrass Version 2 principal, você usa o AWS IoT Greengrass V2 console ou usa a API CreateDeployment. Para obter mais informações, consulte Criação de implantações no Guia do desenvolvedor do AWS IoT Greengrass Version 2. Para obter informações sobre a atualização de um componente implantado em um dispositivo principal, consulte Revisar implantações.

Permissões do IAM para implantar componentes

Para implantar um componente com AWS IoT Greengrass V2 você precisa das seguintes permissões:

  • greengrass:ListComponents

  • greengrass:ListComponentVersions

  • greengrass:ListCoreDevices

  • greengrass:CreateDeployment

  • greengrass:GetDeployment

  • greengrass:ListDeployments

CreateDeploymente GetDeployment têm ações dependentes. Para obter mais informações, consulte Ações definidas pelo AWS IoT Greengrass V2.

Para obter informações sobre como alterar as permissões do IAM, consulte Alteração das permissões de um usuário.

Implantando seus componentes (console)

Use o procedimento a seguir para implantar o componente do aplicativo cliente em um dispositivo principal. O aplicativo cliente depende do componente do modelo (que, por sua vez, depende do Lookout for Vision Edge Agent). A implantação do componente do aplicativo cliente também inicia a implantação do componente de modelo e do Lookout for Vision Edge Agent.

nota

Você pode adicionar seus componentes a uma implantação existente. Você também pode implantar componentes em um grupo de coisas.

Para executar esse procedimento, você deve ter um dispositivo AWS IoT Greengrass V2 principal configurado. Para obter mais informações, consulte Configurando seu dispositivo AWS IoT Greengrass Version 2 principal.

Para implantar seus componentes em um dispositivo
  1. Abra o console do AWS IoT Greengrass em https://console.aws.amazon.com/iot/.

  2. No painel de navegação à esquerda, em Greengrass, escolha Implantações.

  3. Em Implantações, escolha Criar.

  4. Na página Especificar detalhes, faça o seguinte:

    1. Em Informações de implantação, insira ou modifique o nome amigável para sua implantação.

    2. Em Destino de implantação, selecione Dispositivo principal e insira um nome de destino.

    3. Escolha Próximo.

  5. Na página Selecionar componentes, faça o seguinte:

    1. Em Meus componentes, escolha o nome do componente do aplicativo cliente (com.lookoutvison.EdgeAgentPythonExample).

    2. Escolha Próximo

  6. Na página Configurar componentes, mantenha a configuração atual e escolha Próximo.

  7. Na página Definir configurações avançadas, mantenha as configurações atuais e escolha Próximo.

  8. Na página Revisar, escolha Implantar para começar a implantar seu componente.

Verificando o status da implantação (console)

Você pode verificar o status da implantação no AWS IoT Greengrass V2 console. Se o componente do aplicativo cliente usar a receita e o código de exemplo de Criando o componente do aplicativo cliente, visualize o registro do componente do aplicativo cliente após a conclusão da implantação. Se for bem-sucedido, o registro incluirá uma lista dos modelos do Lookout for Vision que são implantados no componente.

Para obter informações sobre como usar o AWS SDK para verificar o status da implantação, consulte Verificar o status da implantação.

Para verificar o status da implantação
  1. Abra o console AWS IoT Greengrass em https://console.aws.amazon.com/iot/

  2. No painel de navegação à esquerda, escolha Dispositivos principais.

  3. Em Dispositivos principais do Greengrass, escolha seu dispositivo principal.

  4. Escolha a guia Implantações para ver o status atual da implantação.

  5. Depois que as implantações forem bem-sucedidas (o status é Concluído), abra uma janela de terminal no dispositivo principal e visualize o registro do componente do aplicativo cliente em. /greengrass/v2/logs/com.lookoutvison.EdgeAgentPythonExample.log Se sua implantação usar a receita e o código de exemplo, o log incluirá a saída delookoutvision_edge_agent_example.py. Por exemplo:

    Model Details model_component:"ModelComponent"

Implantação dos componentes (SDK)

Use o procedimento a seguir para implantar o componente do aplicativo cliente, o componente do modelo e o Amazon Lookout for Vision Edge Agent em seu dispositivo principal.

  1. Crie um deployment.json arquivo para definir a configuração de implantação dos seus componentes. Esse arquivo deve se parecer com o exemplo a seguir.

    { "targetArn":"targetArn", "components": { "com.lookoutvison.EdgeAgentPythonExample": { "componentVersion": "1.0.0", "configurationUpdate": { } } } }
    • No targetArn campo, targetArnsubstitua pelo nome de recurso da Amazon (ARN) da coisa ou grupo de itens a ser destinado para a implantação, no seguinte formato:

      • Coisa: arn:aws:iot:region:account-id:thing/thingName

      • Grupo de coisas: arn:aws:iot:region:account-id:thinggroup/thingGroupName

  2. Verifique se o destino de implantação tem uma implantação existente que você deseja revisar. Faça o seguinte:

    1. Execute o comando a seguir para listar as implantações para o destino de implantação. targetArnSubstitua pelo nome de recurso da Amazon (ARN) da coisa ou grupo de coisas de AWS IoT de destino. Para obter os ARNs das coisas na região atual da AWS, use o comandoaws iot list-things.

      aws greengrassv2 list-deployments --target-arn targetArn

      A resposta contém uma lista com a implantação mais recente do destino. Se a resposta estiver vazia, o destino não tem uma implantação existente e você pode pular para a Etapa 3. Caso contrário, copie o deploymentId da resposta para usar na próxima etapa.

    2. Execute o comando a seguir para obter os detalhes da implantação. Esses detalhes incluem metadados, componentes e configuração do trabalho. Substitua o deploymentId pelo ID da tarefa da etapa anterior.

      aws greengrassv2 get-deployment --deployment-id deploymentId
    3. Copie qualquer um dos seguintes pares de valores-chave da resposta do comando anterior para deployment.json. Você pode alterar esses valores para a nova implantação.

      • deploymentName— O nome da implantação.

      • components— Os componentes da implantação. Para desinstalar um componente, remova-o desse objeto.

      • deploymentPolicies— As políticas de implantação.

      • tags— As tags da implantação.

  3. Execute o comando a seguir para implantar os componentes no dispositivo. Anote o valor do deploymentId na resposta.

    aws greengrassv2 create-deployment \ --cli-input-json file://path/to/deployment.json
  4. Execute o seguinte comando para obter o status da implantação. Altere o deployment-id para o valor que você anotou na etapa anterior. A implantação foi concluída com êxito se o valor de deploymentStatus for. COMPLETED

    aws greengrassv2 get-deployment --deployment-id deployment-id
  5. Depois que as implantações forem bem-sucedidas, abra uma janela de terminal no dispositivo principal e visualize o registro do componente do aplicativo cliente em. /greengrass/v2/logs/com.lookoutvison.EdgeAgentPythonExample.log Se sua implantação usar a receita e o código de exemplo, o log incluirá a saída de lookoutvision_edge_agent_example.py. Por exemplo:

    Model Details model_component:"ModelComponent"