Etapa 6: implantar seu componente - AWS IoT Greengrass

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á.

Etapa 6: implantar seu componente

ComAWS IoT Greengrass, você pode implantar componentes em dispositivos individuais ou grupos de dispositivos. Quando você implanta um componente, AWS IoT Greengrass instala e executa o software desse componente em cada dispositivo de destino. Você especifica quais componentes implantar e a atualização de configuração a ser implantada para cada componente. Você também pode controlar como a implantação é implementada nos dispositivos visados pela implantação. Para ter mais informações, consulte Implemente AWS IoT Greengrass componentes em dispositivos.

Nesta seção, você implanta seu componente Hello World de volta ao seu dispositivo principal do Greengrass.

  1. No menu de navegação AWS IoT Greengrassdo console, escolha Componentes.

  2. Na página Componentes, na guia Meus componentes, escolha com.example.HelloWorld.

  3. Na página com.example.HelloWorld, escolha Implantar.

  4. Em Adicionar à implantação, escolha Criar nova implantação e, em seguida, escolha Avançar.

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

    1. Na caixa Name (Nome), insira Deployment for MyGreengrassCore.

    2. Em Destino de implantação, escolha Dispositivo principal e o nome do AWS IoT item para seu dispositivo principal. O valor padrão neste tutorial é MyGreengrassCore.

    3. Escolha Próximo.

  6. Na página Selecionar componentes, em Meus componentes, verifique se o com.example.HelloWorldcomponente está selecionado e escolha Avançar.

  7. Na página Configurar componentes com.example.HelloWorld, escolha e faça o seguinte:

    1. Escolha Configurar componente.

    2. Em Atualização de configuração, em Configuração a ser mesclada, insira a configuração a seguir.

      {
  "Message": "universe"
}

      Essa atualização de configuração define o Message parâmetro Hello World universe para o dispositivo nessa implantação.

    3. Selecione a opção Confirmar.

    4. Escolha Próximo.

  8. Na página Definir configurações avançadas, mantenha as configurações padrão e escolha Avançar.

  9. Na página Review, escolha Deploy.

  10. Verifique se a implantação foi concluída com êxito. A implantação pode levar vários minutos para ser concluída. Verifique o registro do Hello World para verificar a alteração. Execute o comando a seguir em seu dispositivo principal do Greengrass.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\\logs\\com.example.HelloWorld.log
    PowerShell
    gc C:\greengrass\v2\\logs\\com.example.HelloWorld.log -Tail 10 -Wait

    Você deve ver mensagens semelhantes ao exemplo a seguir.

    Hello, universe! Greetings from your first Greengrass component.
    nota

    Se as mensagens de registro não mudarem, a implantação falhou ou não atingiu o dispositivo principal. Isso pode ocorrer se seu dispositivo principal não estiver conectado à Internet ou não tiver permissões para recuperar artefatos do seu bucket do S3. Execute o comando a seguir em seu dispositivo principal para visualizar o arquivo de log do software AWS IoT Greengrass principal. Esse arquivo inclui registros do serviço de implantação do dispositivo principal do Greengrass.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\\logs\\greengrass.log

    O type comando grava o conteúdo do arquivo no terminal. Execute esse comando várias vezes para observar as alterações no arquivo.

    PowerShell
    gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait

    Para ter mais informações, consulte Solução de problemas AWS IoT Greengrass V2.

Para implantar seu componente Hello World

  1. No seu computador de desenvolvimento, crie um arquivo chamado hello-world-deployment.json e copie o seguinte JSON para o arquivo. Esse arquivo define os componentes e as configurações a serem implantados.

    {
  "components": {
    "com.example.HelloWorld": {
      "componentVersion": "1.0.0",
      "configurationUpdate": {
        "merge": "{\"Message\":\"universe\"}"
      }
    }
  }
}

    Esse arquivo de configuração especifica a implantação 1.0.0 da versão do componente Hello World que você desenvolveu e publicou no procedimento anterior. O configurationUpdate especifica a mesclagem da configuração do componente em uma string codificada em JSON. Essa atualização de configuração define o Message parâmetro Hello World universe para o dispositivo nessa implantação.

  2. Execute o comando a seguir para implantar o componente em seu dispositivo principal do Greengrass. Você pode implantar em coisas, que são dispositivos individuais, ou grupos de coisas, que são grupos de dispositivos. MyGreengrassCoreSubstitua pelo nome do AWS IoT item do seu dispositivo principal.

    Linux or Unix
    aws greengrassv2 create-deployment \
  --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" \
  --cli-input-json file://hello-world-deployment.json
    Windows Command Prompt (CMD)
    aws greengrassv2 create-deployment ^
  --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" ^
  --cli-input-json file://hello-world-deployment.json
    PowerShell
    aws greengrassv2 create-deployment `
  --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" `
  --cli-input-json file://hello-world-deployment.json

    O comando gera uma resposta semelhante ao exemplo a seguir.

    {
  "deploymentId": "deb69c37-314a-4369-a6a1-3dff9fce73a9",
  "iotJobId": "b5d92151-6348-4941-8603-bdbfb3e02b75",
  "iotJobArn": "arn:aws:iot:region:account-id:job/b5d92151-6348-4941-8603-bdbfb3e02b75"
}

  3. Verifique se a implantação foi concluída com êxito. A implantação pode levar vários minutos para ser concluída. Verifique o registro do Hello World para verificar a alteração. Execute o comando a seguir em seu dispositivo principal do Greengrass.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\\logs\\com.example.HelloWorld.log
    PowerShell
    gc C:\greengrass\v2\\logs\\com.example.HelloWorld.log -Tail 10 -Wait

    Você deve ver mensagens semelhantes ao exemplo a seguir.

    Hello, universe! Greetings from your first Greengrass component.
    nota

    Se as mensagens de registro não mudarem, a implantação falhou ou não atingiu o dispositivo principal. Isso pode ocorrer se seu dispositivo principal não estiver conectado à Internet ou não tiver permissões para recuperar artefatos do seu bucket do S3. Execute o comando a seguir em seu dispositivo principal para visualizar o arquivo de log do software AWS IoT Greengrass principal. Esse arquivo inclui registros do serviço de implantação do dispositivo principal do Greengrass.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\\logs\\greengrass.log

    O type comando grava o conteúdo do arquivo no terminal. Execute esse comando várias vezes para observar as alterações no arquivo.

    PowerShell
    gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait

    Para ter mais informações, consulte Solução de problemas AWS IoT Greengrass V2.