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 Com o AWS IoT Greengrass, é possível implantar componentes em dispositivos individuais ou grupos de dispositivos. Quando você implanta um componente, o 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 um. Você também pode controlar como a implantação é implementada nos dispositivos visados pela implantação. Para obter mais informações, consulte [Implemente AWS IoT Greengrass componentes em dispositivos](manage-deployments.md). Nesta seção, você implanta seu componente Hello World de volta ao seu dispositivo principal do Greengrass. ## Implantar seus componentes (console) 1. No menu de navegação do [console do AWS IoT Greengrass](https://console.aws.amazon.com/greengrass), selecione **Componentes**. 1. Na página **Componentes**, na guia **Meus componentes**, escolha **com.example.HelloWorld**. 1. Na página **com.example.HelloWorld**, escolha **Implantar**. 1. Em **Adicionar à implantação**, escolha **Criar nova implantação** e, em seguida, **Avançar**. 1. Na página **Especificar detalhes**, faça o seguinte: 1. Na caixa **Name** (Nome), insira **Deployment for MyGreengrassCore**. 1. Em **Destino de implantação**, escolha **Dispositivo principal** e o nome do objeto da AWS IoT para seu dispositivo principal. O valor padrão neste tutorial é *MyGreengrasscore*. 1. Escolha **Próximo**. 1. Na página **Selecionar componentes**, em **Meus componentes**, verifique se o componente **com.example.HelloWorld** está selecionado e escolha **Avançar**. 1. Na página **Configurar componentes**, selecione **com.example.HelloWorld** e faça o seguinte: 1. Escolha **Configurar componente**. 1. 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 parâmetro `Message` Hello World para `universe` para o dispositivo nesta implantação. 1. Escolha **Confirmar**. 1. Escolha **Próximo**. 1. Na página **Definir configurações avançadas**, mantenha as configurações padrão e escolha **Avançar**. 1. Na página **Pré-visualizar**, escolha **Implantar**. 1. Verifique se a implantação foi concluída com êxito. A implantação pode levar vários minutos para ser concluída. Verifique o log do Hello World para ver 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ê verá mensagens semelhantes ao exemplo a seguir. ``` Hello, universe! Greetings from your first Greengrass component. ``` **nota** Se as mensagens de log não mudarem, a implantação falhou ou não atingiu o dispositivo principal. Isso pode ocorrer se o seu dispositivo principal não estiver conectado à Internet ou não tiver permissões para recuperar artefatos do bucket do S3. Execute o seguinte comando no seu dispositivo principal para visualizar o arquivo de log do software AWS IoT Greengrass Core. Esse arquivo inclui logs do serviço de implantação do dispositivo principal do Greengrass. ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ``` type C:\greengrass\v2\\logs\\greengrass.log ``` O comando `type` grava o conteúdo do arquivo no terminal. Execute esse comando várias vezes para observar as alterações no arquivo. ``` gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait ``` Para obter mais informações, consulte [Solução de problemas AWS IoT Greengrass V2](troubleshooting.md). ## Implantar seu componente (AWS CLI) **Para desenvolver um 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 da versão `1.0.0` 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 parâmetro `Message` Hello World para `universe` para o dispositivo nesta implantação. 1. Execute o seguinte comando para implantar o componente no seu dispositivo principal do Greengrass. É possível implantar em objetos, que são dispositivos individuais, ou grupos de objetos, que são grupos de dispositivos. Substitua *MyGreengrassCore* pelo nome do objeto da AWS IoT para 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" } ``` 1. Verifique se a implantação foi concluída com êxito. A implantação pode levar vários minutos para ser concluída. Verifique o log do Hello World para ver 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ê verá mensagens semelhantes ao exemplo a seguir. ``` Hello, universe! Greetings from your first Greengrass component. ``` **nota** Se as mensagens de log não mudarem, a implantação falhou ou não atingiu o dispositivo principal. Isso pode ocorrer se o seu dispositivo principal não estiver conectado à Internet ou não tiver permissões para recuperar artefatos do bucket do S3. Execute o seguinte comando no seu dispositivo principal para visualizar o arquivo de log do software AWS IoT Greengrass Core. Esse arquivo inclui logs do serviço de implantação do dispositivo principal do Greengrass. ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ``` type C:\greengrass\v2\\logs\\greengrass.log ``` O comando `type` grava o conteúdo do arquivo no terminal. Execute esse comando várias vezes para observar as alterações no arquivo. ``` gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait ``` Para obter mais informações, consulte [Solução de problemas AWS IoT Greengrass V2](troubleshooting.md).