View a markdown version of this page

Crea y ejecuta el trabajo en AWS IoT por AWS IoT Cliente del dispositivo - AWS IoT Core
Creación y almacenamiento de un documento de trabajoEjecución del trabajo para un solo dispositivo

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Crea y ejecuta el trabajo en AWS IoT por AWS IoT Cliente del dispositivo

Los procedimientos de esta sección crean un documento de trabajo y un recurso de AWS IoT trabajo. Tras crear el recurso de trabajo, AWS IoT envía el documento de trabajo a los destinos de trabajo especificados, en los que un agente de trabajo aplica el documento de trabajo al dispositivo o al cliente.

Creación y almacenamiento del documento de trabajo de IoT

Este procedimiento crea un documento de trabajo simple para incluirlo en un recurso de AWS IoT trabajo. Este documento de trabajo muestra el mensaje «¡Hola mundo!» en el destino del trabajo.

Para crear y almacenar un documento de trabajo:

  1. Seleccione el bucket de Amazon S3 en el que guardará el documento de trabajo. Si no dispone de un bucket de Amazon S3 existente, deberá crear uno. Para obtener información sobre cómo crear buckets de Amazon S3, consulte los temas de Introducción a Amazon S3.

  2. Crear y guardar el documento de trabajo para este trabajo

    1. En el ordenador host local, abra un editor de texto.

    2. Copie y pegue este texto en el editor.

      {
    "operation": "echo",
    "args": ["Hello world!"]
}

    3. En el equipo host local, guarde el contenido del editor en un archivo denominado hello-world-job.json.

    4. Confirme que el archivo se haya guardado correctamente. Algunos editores de texto agregan .txt automáticamente el nombre del archivo al guardar un archivo de texto. Si el editor lo ha agregado .txt al nombre del archivo, corrija el nombre del archivo antes de continuar.

  3. Reemplácela por la ruta parahello-world-job.json, si no está en su directorio actual, s3_bucket_name sustitúyala por la ruta del bucket de Amazon S3 al bucket que seleccionó y, a continuación, ejecute este comando para colocar el documento de trabajo en el bucket de Amazon S3. path_to_file

    aws s3api put-object \
--key hello-world-job.json \
--body path_to_file/hello-world-job.json --bucket s3_bucket_name

    La URL del documento de trabajo que identifica el documento de trabajo que almacenó en Amazon S3 se determina sustituyendo el s3_bucket_name signo y AWS_region en la siguiente URL. Registre la URL resultante para utilizarla más adelante como job_document_path

    https://s3_bucket_name.s3.AWS_Region.amazonaws.com/hello-world-job.json
    nota

    AWS la seguridad le impide abrir esta URL fuera de la suya Cuenta de AWS, por ejemplo, mediante un navegador. La URL la usa el motor de AWS IoT trabajos, que tiene acceso al archivo, de forma predeterminada. En un entorno de producción, tendrá que asegurarse de que sus servicios de AWS IoT tengan permiso para acceder a los documentos de trabajo almacenados en Amazon S3.

Una vez que haya guardado la URL del documento de trabajo, continúe con Ejecuta un trabajo en AWS IoT para un dispositivo de IoT.

Ejecuta un trabajo en AWS IoT para un dispositivo de IoT

Los procedimientos de esta sección inician el cliente del AWS IoT dispositivo en su Raspberry Pi para ejecutar el agente de tareas en el dispositivo y esperar a que se ejecuten los trabajos. También crea un recurso de trabajo en AWS IoT, que enviará el trabajo a tu dispositivo IoT y se ejecutará en él.

nota

Este procedimiento ejecuta un trabajo en un solo dispositivo.

Para iniciar el agente de trabajos en su Raspberry Pi:

  1. En la ventana de la terminal de tu ordenador host local que esté conectado a tu Raspberry Pi, ejecuta este comando para iniciar el cliente del AWS IoT dispositivo.

    cd ~/aws-iot-device-client/build
./aws-iot-device-client --config-file ~/dc-configs/dc-jobs-config.json

  2. En la ventana del terminal, confirma que el cliente del AWS IoT dispositivo muestra estos mensajes

    2021-11-15T18:45:56.708Z [INFO]  {Main.cpp}: Jobs is enabled
                      .
                      .
                      .
2021-11-15T18:45:56.708Z [INFO]  {Main.cpp}: Client base has been notified that Jobs has started
2021-11-15T18:45:56.708Z [INFO]  {JobsFeature.cpp}: Running Jobs!
2021-11-15T18:45:56.708Z [DEBUG] {JobsFeature.cpp}: Attempting to subscribe to startNextPendingJobExecution accepted and rejected
2021-11-15T18:45:56.708Z [DEBUG] {JobsFeature.cpp}: Attempting to subscribe to nextJobChanged events
2021-11-15T18:45:56.708Z [DEBUG] {JobsFeature.cpp}: Attempting to subscribe to updateJobExecutionStatusAccepted for jobId +
2021-11-15T18:45:56.738Z [DEBUG] {JobsFeature.cpp}: Ack received for SubscribeToUpdateJobExecutionAccepted with code {0}
2021-11-15T18:45:56.739Z [DEBUG] {JobsFeature.cpp}: Attempting to subscribe to updateJobExecutionStatusRejected for jobId +
2021-11-15T18:45:56.753Z [DEBUG] {JobsFeature.cpp}: Ack received for SubscribeToNextJobChanged with code {0}
2021-11-15T18:45:56.760Z [DEBUG] {JobsFeature.cpp}: Ack received for SubscribeToStartNextJobRejected with code {0}
2021-11-15T18:45:56.776Z [DEBUG] {JobsFeature.cpp}: Ack received for SubscribeToStartNextJobAccepted with code {0}
2021-11-15T18:45:56.776Z [DEBUG] {JobsFeature.cpp}: Ack received for SubscribeToUpdateJobExecutionRejected with code {0}
2021-11-15T18:45:56.777Z [DEBUG] {JobsFeature.cpp}: Publishing startNextPendingJobExecutionRequest
2021-11-15T18:45:56.785Z [DEBUG] {JobsFeature.cpp}: Ack received for StartNextPendingJobPub with code {0}
2021-11-15T18:45:56.785Z [INFO]  {JobsFeature.cpp}: No pending jobs are scheduled, waiting for the next incoming job

  3. En la ventana del terminal, cuando vea este mensaje, continúe con el siguiente procedimiento y cree el recurso de trabajo. Tenga en cuenta que puede que no sea la última entrada de la lista.

    2021-11-15T18:45:56.785Z [INFO]  {JobsFeature.cpp}: No pending jobs are scheduled, waiting for the next incoming job
Para crear un AWS IoT recurso de trabajo

  1. En el ordenador host local:

    1. Sustituir job_document_url por la URL del documento de trabajo deCreación y almacenamiento del documento de trabajo de IoT.

    2. thing_arnSustitúyalo por el ARN del recurso de cosa que creó para su dispositivo y, a continuación, ejecute este comando.

      aws iot create-job \
--job-id hello-world-job-1 \
--document-source "job_document_url" \
--targets "thing_arn" \
--target-selection SNAPSHOT

      Si se ejecuta correctamente, el comando devuelve un resultado como este.

      {
  "jobArn": "arn:aws:iot:us-west-2:57EXAMPLE833:job/hello-world-job-1",
  "jobId": "hello-world-job-1"
}

  2. En la ventana del terminal, deberías ver la salida del cliente del AWS IoT dispositivo de la siguiente manera.

    2021-11-15T18:02:26.688Z [INFO]  {JobsFeature.cpp}: No pending jobs are scheduled, waiting for the next incoming job
2021-11-15T18:10:24.890Z [DEBUG] {JobsFeature.cpp}: Job ids differ
2021-11-15T18:10:24.890Z [INFO]  {JobsFeature.cpp}: Executing job: hello-world-job-1
2021-11-15T18:10:24.890Z [DEBUG] {JobsFeature.cpp}: Attempting to update job execution status!
2021-11-15T18:10:24.890Z [DEBUG] {JobsFeature.cpp}: Not including stdout with the status details
2021-11-15T18:10:24.890Z [DEBUG] {JobsFeature.cpp}: Not including stderr with the status details
2021-11-15T18:10:24.890Z [DEBUG] {JobsFeature.cpp}: Assuming executable is in PATH
2021-11-15T18:10:24.890Z [INFO]  {JobsFeature.cpp}: About to execute: echo Hello world!
2021-11-15T18:10:24.890Z [DEBUG] {Retry.cpp}: Retryable function starting, it will retry until success
2021-11-15T18:10:24.890Z [DEBUG] {JobsFeature.cpp}: Created EphermalPromise for ClientToken 3TEWba9Xj6 in the updateJobExecution promises map
2021-11-15T18:10:24.890Z [DEBUG] {JobEngine.cpp}: Child process now running
2021-11-15T18:10:24.890Z [DEBUG] {JobEngine.cpp}: Child process about to call execvp
2021-11-15T18:10:24.890Z [DEBUG] {JobEngine.cpp}: Parent process now running, child PID is 16737
2021-11-15T18:10:24.891Z [DEBUG] {16737}: Hello world!
2021-11-15T18:10:24.891Z [DEBUG] {JobEngine.cpp}: JobEngine finished waiting for child process, returning 0
2021-11-15T18:10:24.891Z [INFO]  {JobsFeature.cpp}: Job exited with status: 0
2021-11-15T18:10:24.891Z [INFO]  {JobsFeature.cpp}: Job executed successfully!
2021-11-15T18:10:24.891Z [DEBUG] {JobsFeature.cpp}: Attempting to update job execution status!
2021-11-15T18:10:24.891Z [DEBUG] {JobsFeature.cpp}: Not including stdout with the status details
2021-11-15T18:10:24.891Z [DEBUG] {JobsFeature.cpp}: Not including stderr with the status details
2021-11-15T18:10:24.892Z [DEBUG] {Retry.cpp}: Retryable function starting, it will retry until success
2021-11-15T18:10:24.892Z [DEBUG] {JobsFeature.cpp}: Created EphermalPromise for ClientToken GmQ0HTzWGg in the updateJobExecution promises map
2021-11-15T18:10:24.905Z [DEBUG] {JobsFeature.cpp}: Ack received for PublishUpdateJobExecutionStatus with code {0}
2021-11-15T18:10:24.905Z [DEBUG] {JobsFeature.cpp}: Removing ClientToken 3TEWba9Xj6 from the updateJobExecution promises map
2021-11-15T18:10:24.905Z [DEBUG] {JobsFeature.cpp}: Success response after UpdateJobExecution for job hello-world-job-1
2021-11-15T18:10:24.917Z [DEBUG] {JobsFeature.cpp}: Ack received for PublishUpdateJobExecutionStatus with code {0}
2021-11-15T18:10:24.918Z [DEBUG] {JobsFeature.cpp}: Removing ClientToken GmQ0HTzWGg from the updateJobExecution promises map
2021-11-15T18:10:24.918Z [DEBUG] {JobsFeature.cpp}: Success response after UpdateJobExecution for job hello-world-job-1
2021-11-15T18:10:25.861Z [INFO]  {JobsFeature.cpp}: No pending jobs are scheduled, waiting for the next incoming job

  3. Mientras el cliente del AWS IoT dispositivo esté ejecutándose y esperando un trabajo, puede enviar otro trabajo cambiando el job-id valor y volviendo a ejecutar el create-job del paso 1.

Cuando hayas terminado de ejecutar las tareas, en la ventana del terminal, escribe ^C (Control-C) para detener el cliente del AWS IoT dispositivo.