Exporte fluxos de dados para a Nuvem AWS (CLI)

Baixe o SDK do AWS IoT Greengrass Core para Python v1.5.0 ou posterior.

Descompacte o pacote obtido por download para obter o SDK. O SDK é a pasta do greengrasssdk.

Instale as dependências do pacote para serem incluídas com o SDK no pacote de implantação da função do Lambda.

Salve a seguinte função do código Python em um arquivo local denominado transfer_stream.py.

import asyncio
import logging
import random
import time

from greengrasssdk.stream_manager import (
    ExportDefinition,
    KinesisConfig,
    MessageStreamDefinition,
    ReadMessagesOptions,
    ResourceNotFoundException,
    StrategyOnFull,
    StreamManagerClient,
)


# This example creates a local stream named "SomeStream".
# It starts writing data into that stream and then stream manager automatically exports  
# the data to a customer-created Kinesis data stream named "MyKinesisStream". 
# This example runs forever until the program is stopped.

# The size of the local stream on disk will not exceed the default (which is 256 MB).
# Any data appended after the stream reaches the size limit continues to be appended, and
# stream manager deletes the oldest data until the total stream size is back under 256 MB.
# The Kinesis data stream in the cloud has no such bound, so all the data from this script is
# uploaded to Kinesis and you will be charged for that usage.


def main(logger):
    try:
        stream_name = "SomeStream"
        kinesis_stream_name = "MyKinesisStream"

        # Create a client for the StreamManager
        client = StreamManagerClient()

        # Try deleting the stream (if it exists) so that we have a fresh start
        try:
            client.delete_message_stream(stream_name=stream_name)
        except ResourceNotFoundException:
            pass

        exports = ExportDefinition(
            kinesis=[KinesisConfig(identifier="KinesisExport" + stream_name, kinesis_stream_name=kinesis_stream_name)]
        )
        client.create_message_stream(
            MessageStreamDefinition(
                name=stream_name, strategy_on_full=StrategyOnFull.OverwriteOldestData, export_definition=exports
            )
        )

        # Append two messages and print their sequence numbers
        logger.info(
            "Successfully appended message to stream with sequence number %d",
            client.append_message(stream_name, "ABCDEFGHIJKLMNO".encode("utf-8")),
        )
        logger.info(
            "Successfully appended message to stream with sequence number %d",
            client.append_message(stream_name, "PQRSTUVWXYZ".encode("utf-8")),
        )

        # Try reading the two messages we just appended and print them out
        logger.info(
            "Successfully read 2 messages: %s",
            client.read_messages(stream_name, ReadMessagesOptions(min_message_count=2, read_timeout_millis=1000)),
        )

        logger.info("Now going to start writing random integers between 0 and 1000 to the stream")
        # Now start putting in random data between 0 and 1000 to emulate device sensor input
        while True:
            logger.debug("Appending new random integer to stream")
            client.append_message(stream_name, random.randint(0, 1000).to_bytes(length=4, signed=True, byteorder="big"))
            time.sleep(1)

    except asyncio.TimeoutError:
        logger.exception("Timed out while executing")
    except Exception:
        logger.exception("Exception while running")


def function_handler(event, context):
    return


logging.basicConfig(level=logging.INFO)
# Start up this sample code
main(logger=logging.getLogger())

Comprima os seguintes itens em um arquivo denominado transfer_stream_python.zip. Esse é o pacote de implantação de sua função do Lambda.

Ao criar o arquivo zip, inclua apenas esses itens, não a pasta que contém os arquivos.

Crie um perfil do IAM para você transmitir no ARN da função ao criar a função.

Copie a Arn da saída.

Use a API do AWS Lambda para criar a função TransferStream. O comando a seguir pressupõe que o arquivo zip esteja no diretório atual.

aws lambda create-function \
--function-name TransferStream \
--zip-file fileb://transfer_stream_python.zip \
--role role-arn \
--handler transfer_stream.function_handler \
--runtime python3.7

Publique uma versão da função.

aws lambda publish-version --function-name TransferStream --description 'First version'

Crie um alias para a versão publicada.

Os grupos do Greengrass podem fazer referência a uma função do Lambda por alias (recomendado) ou por versão. Usar um alias facilita o gerenciamento de atualizações de código porque você não precisa alterar a tabela de assinaturas nem a definição do grupo ao atualizar a função do código. Em vez disso, você pode simplesmente apontar o alias para a nova versão da função.

aws lambda create-alias --function-name TransferStream --name GG_TransferStream --function-version 1

Copie a AliasArn da saída. Você usa esse valor ao configurar a função para o AWS IoT Greengrass.

Crie uma definição de função com uma versão inicial que contenha as funções do Lambda definidas pelo sistema e pelo usuário.

A versão de definição a seguir ativa o gerenciador de fluxo com configurações de parâmetros padrão. Para definir configurações personalizadas, você deve definir variáveis de ambiente para os parâmetros correspondentes do gerenciador de fluxo. Para um exemplo, consulte Habilitar, desabilitar ou definir as configurações do gerenciador de fluxo (CLI). O AWS IoT Greengrass usa definições padrão para os parâmetros omitidos. O MemorySize deve ser de, no mínimo, 128000. Pinned deve ser definido como true.

Copie a LatestVersionArn da saída. Você usa esse valor para adicionar a versão de definição da função à versão de grupo que você implanta no núcleo.

Crie uma definição de logger que inclua uma versão inicial.

Copie a LatestVersionArn da definição de logger da saída. Use esse valor para adicionar a versão de definição de logger à versão de grupo implantada no núcleo.

Obtenha os IDs do grupo do Greengrass de destino e a versão do grupo. Esse procedimento pressupõe que esse seja o grupo e a versão mais recente do grupo. A consulta a seguir retorna o grupo criado mais recentemente.

aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

Ou é possível consultar por nome. Os nomes de grupo não precisam ser exclusivos, portanto, vários grupos podem ser retornados.

aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

Copie da saída o Id do grupo de destino. Você usa isso para obter a versão de definição de núcleo e ao implantar o grupo.

Copie a LatestVersion da saída, que é o ID da última versão adicionada ao grupo. Você usa isso para obter a versão de definição do núcleo.

Obtenha o ARN da versão de definição de núcleo:

1. Obtenha a versão do grupo.

   • Substitua group-id pelo Id que você copiou para o grupo.

   • Substitua group-version-id pelo LatestVersion que você copiou para o grupo.

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id group-version-id

2. Copie a CoreDefinitionVersionArn da saída. Use esse valor para adicionar a versão de definição à versão de grupo implantada no núcleo.

Criar uma versão de grupo.

aws greengrass create-group-version \
--group-id group-id \
--core-definition-version-arn core-definition-version-arn \
--function-definition-version-arn function-definition-version-arn \
--logger-definition-version-arn logger-definition-version-arn

Copie a Version da saída. Este é o ID da nova versão do grupo.

Verifique se o núcleo AWS IoT Greengrass está em execução. Execute os seguintes comandos no seu terminal do Raspberry Pi, conforme necessário.

1. Para verificar se o daemon está em execução:

   ps aux | grep -E 'greengrass.*daemon'

   Se a saída contém uma entrada root para /greengrass/ggc/packages/ggc-version/bin/daemon, o daemon está em execução.

   nota

   A versão no caminho depende da versão do software do AWS IoT Greengrass Core que foi instalada no seu dispositivo de núcleo.

2. Para iniciar o daemon:

   cd /greengrass/ggc/core/
   sudo ./greengrassd start

Crie um implantação do .

aws greengrass create-deployment \
--deployment-type NewDeployment \
--group-id group-id \
--group-version-id group-version-id

Copie a DeploymentId da saída.

Obtenha o status de implantação.

aws greengrass get-deployment-status \
--group-id group-id \
--deployment-id deployment-id

Se o status for Success, a implantação foi bem-sucedida. Para obter ajuda sobre a solução de problemas, consulte Solução de problemas de AWS IoT Greengrass.

No console do Amazon Kinesis, em Fluxo de dados do Kinesis, selecione MyKinesisStream.

Na página MyKinesisStream, selecione Monitoring (Monitoramento). Se o teste for bem-sucedido, você verá os dados nos gráficos Put Records (Inserir registros) . Dependendo da sua conexão, pode demorar um minuto até que os dados sejam exibidos.

cd /greengrass/ggc/core/
sudo ./greengrassd stop

Remova a função do Lambda TransferStream do núcleo.

1. Siga Etapa 6: Criar uma versão de grupo para criar uma nova versão de grupo, mas remova a opção --function-definition-version-arn no comando create-group-version. Ou crie uma versão de definição de função que não inclua a função TransferStream do Lambda.

   nota

   Ao omitir a função do Lambda do sistema GGStreamManager da versão do grupo implantado, desabilite o gerenciamento de fluxo no núcleo.

2. Siga Etapa 7: Criar uma implantação para implantar a nova versão do grupo.