Pular para o conteúdo

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.

PeçaOndeCriado por
Projeto Python greengrass_tutorial.telemetrypackages/telemetrypy#project
Componente com.example.Pulsepackages/telemetry/greengrass/pulsegreengrass#component
Constructs do núcleo Greengrass e o construct da aplicação Pulsepackages/common/constructs/src/core/greengrass, packages/common/constructs/src/app/greengrassgreengrass#component
Aplicação CDK @greengrass-tutorial/infrapackages/infrats#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.

RecursoCriado porExcluí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 IAMO script de configuração e o instalador do núcleoA operação cleanup do script
Instância EC2 t3.small com um perfil de instância SSMO 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 artefatosSua stack CDKdestroy, 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.

  • Git
  • Node >= 22.13 (Recomendamos usar algo como NVM para gerenciar suas versões do node)
    • verifique executando node --version
  • UV >= 0.5.29
    1. instale o Python 3.14 executando: uv python install 3.14
    2. verifique com uv python list --only-installed

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:

Janela do terminal
export TUTORIAL_AWS_PROFILE=<your-profile>
export TUTORIAL_AWS_REGION=us-east-1
export TUTORIAL_PREFIX=gg-tutorial

TUTORIAL_PREFIX nomeia cada recurso que o script de configuração cria. Escolha um valor que nada mais na conta use.

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.

  1. Criar o componente: workspace, projeto Python, componente, aplicação CDK e a mudança para AWS IoT Core MQTT.
  2. Provisionar o dispositivo central: perfil de instância, seleção de imagem, o script de configuração e o que ele cria.
  3. Implantar, observar e atualizar: a stack CDK, a primeira implantação, o heartbeat MQTT e uma atualização NEXT_PATCH.
  4. Remover e limpar: uma revisão de implantação vazia, destruição da stack e exclusão dos recursos retidos e criados pelo script.