Tutorial MQTT do Greengrass
Neste tutorial, você constrói um componente Python do AWS IoT Greengrass v2 com @aws/nx-plugin, executa-o em uma instância EC2 Ubuntu 26.04 x86_64 que atua como o dispositivo central, e observa seu heartbeat chegar no AWS IoT Core via MQTT. Você então altera o código-fonte, publica a próxima versão com NEXT_PATCH, remove o componente do dispositivo e exclui todos os recursos que você criou.
O tutorial usa CDK e o núcleo clássico do Greengrass. Para componentes TypeScript, Terraform ou uma frota existente, leia o guia de componentes do Greengrass.
O que você constrói
Seção intitulada “O que você constrói”| Peça | Onde | Criado por |
|---|---|---|
Projeto Python greengrass_tutorial.telemetry | packages/telemetry | py#project |
Componente com.example.Pulse | packages/telemetry/greengrass/pulse | greengrass#component |
Constructs do núcleo Greengrass e o construct da aplicação Pulse | packages/common/constructs/src/core/greengrass, packages/common/constructs/src/app/greengrass | greengrass#component |
Aplicação CDK @greengrass-tutorial/infra | packages/infra | ts#infra |
O componente gerado publica via IPC local do Greengrass. O Módulo 1 o altera para publicar no AWS IoT Core, o que requer uma operação IPC diferente, uma autorização de receita diferente e uma declaração de política IoT no dispositivo. Os nomes da API e do controle de acesso vêm da documentação IPC MQTT do AWS IoT Core.
O que ele cria na AWS
Seção intitulada “O que ele cria na AWS”| Recurso | Criado por | Excluído por |
|---|---|---|
| Grupo de coisas IoT, coisa, certificado, política IoT, função de troca de token, alias de função, política de acesso IAM | O script de configuração e o instalador do núcleo | A operação cleanup do script |
Instância EC2 t3.small com um perfil de instância SSM | O script de configuração (instância) e você (perfil de instância) | A operação cleanup do script e você |
| Bucket de artefatos, versões de componentes, implantação, concessão de leitura de artefatos | Sua stack CDK | destroy, seguido pela exclusão manual do bucket retido, versões e implantações |
A instância executa até você fazer a limpeza. Use uma conta AWS e Região que você possa limpar completamente.
Antes de começar
Seção intitulada “Antes de começar”- Git
- Node >= 22.13 (Recomendamos usar algo como NVM para gerenciar suas versões do node)
- verifique executando
node --version
- verifique executando
- UV >= 0.5.29
- instale o Python 3.14 executando:
uv python install 3.14 - verifique com
uv python list --only-installed
- instale o Python 3.14 executando:
Você também precisa de:
- AWS CLI v2 com um perfil nomeado para a conta de destino.
- Permissões nessa conta para criar funções e políticas IAM, coisas e políticas IoT, instâncias EC2, comandos do Systems Manager, buckets S3, stacks do CloudFormation e recursos do Greengrass.
- Uma VPC padrão na Região, ou uma sub-rede com acesso à internet de saída que você passa para o script de configuração.
Cada comando AWS CLI neste tutorial passa --profile e --region explicitamente, e cada comando CDK recebe AWS_PROFILE e AWS_REGION. Defina os valores uma vez em seu shell:
export TUTORIAL_AWS_PROFILE=<your-profile>export TUTORIAL_AWS_REGION=us-east-1export TUTORIAL_PREFIX=gg-tutorialTUTORIAL_PREFIX nomeia cada recurso que o script de configuração cria. Escolha um valor que nada mais na conta use.
O que é verificado automaticamente
Seção intitulada “O que é verificado automaticamente”Os comandos, edições de código-fonte, build e síntese CDK deste tutorial são cobertos pelo teste de smoke greengrass-tutorial no CI. O comportamento de identidade, recusa e limpeza do script de configuração é executado contra uma AWS CLI gravada no conjunto de testes de documentação.
Provisionamento, entrega MQTT, atualizações de dispositivo e limpeza requerem uma conta AWS e permanecem fora da faixa automatizada. Siga as verificações de dispositivo em cada módulo para verificar a implantação. A tabela de suporte de hardware registra as plataformas de dispositivo suportadas.
Módulos
Seção intitulada “Módulos”- Criar o componente: workspace, projeto Python, componente, aplicação CDK e a mudança para AWS IoT Core MQTT.
- Provisionar o dispositivo central: perfil de instância, seleção de imagem, o script de configuração e o que ele cria.
- Implantar, observar e atualizar: a stack CDK, a primeira implantação, o heartbeat MQTT e uma atualização
NEXT_PATCH. - Remover e limpar: uma revisão de implantação vazia, destruição da stack e exclusão dos recursos retidos e criados pelo script.