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á.
Desenvolva AWS IoT Greengrass componentes
Você pode desenvolver e testar componentes em seu dispositivo principal do Greengrass. Como resultado, você pode criar e iterar seu AWS IoT Greengrass software sem interagir com o. Nuvem AWS Ao finalizar uma versão do seu componente, você pode carregá-la AWS IoT Greengrass na nuvem, para que você e sua equipe possam implantar o componente em outros dispositivos da sua frota. Para obter mais informações sobre como implantar componentes, consulteImplemente AWS IoT Greengrass componentes em dispositivos.
Cada componente é composto por uma receita e artefatos.
-
Receitas
Cada componente contém um arquivo de receita, que define seus metadados. A receita também especifica os parâmetros de configuração do componente, as dependências do componente, o ciclo de vida e a compatibilidade da plataforma. O ciclo de vida do componente define os comandos que instalam, executam e desligam o componente. Para ter mais informações, consulte AWS IoT Greengrass referência da receita do componente.
-
Artefatos
Os componentes podem ter qualquer número de artefatos, que são binários de componentes. Os artefatos podem incluir scripts, código compilado, recursos estáticos e quaisquer outros arquivos que um componente consuma. Os componentes também podem consumir artefatos das dependências dos componentes.
AWS IoT Greengrassfornece componentes pré-criados que você pode usar em seus aplicativos e implantar em seus dispositivos. Por exemplo, você pode usar o componente stream manager para fazer upload de dados para vários AWS serviços ou pode usar o componente de CloudWatch métricas para publicar métricas personalizadas na Amazon CloudWatch. Para ter mais informações, consulte AWS-componentes fornecidos.
AWS IoT Greengrassorganiza um índice dos componentes do Greengrass, chamado Catálogo de Software do Greengrass. Este catálogo rastreia os componentes do Greengrass que são desenvolvidos pela comunidade do Greengrass. A partir desse catálogo, você pode baixar, modificar e implantar componentes para criar seus aplicativos Greengrass. Para ter mais informações, consulte Componentes da comunidade.
O software AWS IoT Greengrass Core executa componentes como usuário e grupo do sistema, como ggc_user eggc_group, que você configura no dispositivo principal. Isso significa que os componentes têm as permissões desse usuário do sistema. Se você usar um usuário do sistema sem um diretório inicial, os componentes não poderão usar comandos de execução ou códigos que usem um diretório inicial. Isso significa que você não pode usar o pip install some-library --user comando para instalar pacotes Python, por exemplo. Se você seguiu o tutorial de introdução para configurar seu dispositivo principal, o usuário do sistema não tem um diretório inicial. Para obter mais informações sobre como configurar o usuário e o grupo que executam componentes, consulteConfigurar o usuário que executa os componentes.
nota
AWS IoT Greengrassusa versões semânticas para componentes. As versões semânticas seguem um sistema de numeração principal.secundária.patch. Por exemplo, a versão 1.0.0 representa a primeira versão principal de um componente. Para obter mais informações, consulte a especificação da versão semântica
Tópicos
- Ciclo de vida do componente
- Tipos de componentes
- Crie AWS IoT Greengrass componentes
- Teste AWS IoT Greengrass componentes com implantações locais
- Publish components to deploy to your core devices
- Interaja com AWS os serviços
- Execute um contêiner Docker
- AWS IoT Greengrass referência da receita do componente
- Referência de variáveis de ambiente de componentes
Ciclo de vida do componente
O ciclo de vida do componente define os estágios que o software AWS IoT Greengrass principal usa para instalar e executar componentes. Cada estágio define um script e outras informações que especificam como o componente se comporta. Por exemplo, quando você instala um componente, o software AWS IoT Greengrass Core executa o script de Install ciclo de vida desse componente. Os componentes nos dispositivos principais têm os seguintes estados de ciclo de vida:
-
NEW— A receita e os artefatos do componente são carregados no dispositivo principal, mas o componente não está instalado. Depois que um componente entra nesse estado, ele executa seu script de instalação. -
INSTALLED— O componente é instalado no dispositivo principal. O componente entra nesse estado depois de executar o script de instalação. -
STARTING— O componente está iniciando no dispositivo principal. O componente entra nesse estado quando executa seu script de inicialização. Se a inicialização for bem-sucedida, o componente entrará noRUNNINGestado. -
RUNNING— O componente está sendo executado no dispositivo principal. O componente entra nesse estado quando executa o script de execução ou quando tem processos ativos em segundo plano a partir do script de inicialização. -
FINISHED— O componente foi executado com sucesso e concluiu sua execução. -
STOPPING— O componente está parando. O componente entra nesse estado quando executa seu script de desligamento. -
ERRORED— O componente encontrou um erro. Quando o componente entra nesse estado, ele executa seu script de recuperação. Em seguida, o componente é reiniciado para tentar retornar ao uso normal. Se o componente entrar noERROREDestado três vezes sem uma execução bem-sucedida, o componente se tornaráBROKEN. -
BROKEN— O componente encontrou erros várias vezes e não conseguiu se recuperar. Você deve implantar o componente novamente para corrigi-lo.
Tipos de componentes
O tipo de componente especifica como o software AWS IoT Greengrass Core executa o componente. Os componentes podem ter os seguintes tipos:
-
Núcleo ()
aws.greengrass.nucleusO núcleo do Greengrass é o componente que fornece a funcionalidade mínima do AWS IoT Greengrass software Core. Para ter mais informações, consulte Núcleo Greengrass.
-
Plug-in (
aws.greengrass.plugin)O núcleo do Greengrass executa um componente de plug-in na mesma Java Virtual Machine (JVM) do núcleo. O núcleo reinicia quando você altera a versão de um componente de plug-in em um dispositivo principal. Para instalar e executar componentes do plug-in, você deve configurar o núcleo do Greengrass para ser executado como um serviço do sistema. Para ter mais informações, consulte Configurar o núcleo do Greengrass como um serviço do sistema.
Vários componentes fornecidos pelo AWS são componentes de plug-ins, o que permite que eles interajam diretamente com o núcleo do Greengrass. Os componentes do plug-in usam o mesmo arquivo de log do Greengrass nucleus. Para ter mais informações, consulte Monitore AWS IoT Greengrass os registros.
-
Genérico (
aws.greengrass.generic)O núcleo do Greengrass executa os scripts de ciclo de vida de um componente genérico, se o componente definir um ciclo de vida.
Esse tipo é o tipo padrão para componentes personalizados.
-
Lambda (1)
aws.greengrass.lambdaO núcleo do Greengrass executa um componente de função Lambda usando o componente Lambda launcher.
Quando você cria um componente a partir de uma função Lambda, o componente tem esse tipo. Para ter mais informações, consulte Executar AWS Lambda funções.
nota
Não recomendamos que você especifique o tipo de componente em uma receita. AWS IoT Greengrassdefine o tipo para você ao criar um componente.
