Programa flujos de trabajo

Console

1. En la consola de Google Cloud, ve a la página Workflows.

   Ir a Workflows

2. Haga clic en Crear.

3. Ingresa myFirstWorkflow como el nombre del nuevo flujo de trabajo.

4. Selecciona us-central1 para la región.

5. Selecciona la cuenta de servicio que creaste anteriormente.

6. Haga clic en Next.

7. En el editor de flujos de trabajo, ingresa la siguiente definición para el flujo de trabajo.

   YAML

   main:
     params: [args]
     steps:
       - step1:
           assign:
             - outputVar: ${"Hello, " + args.firstName + " " + args.lastName + "!"}
       - step2:
           return: ${outputVar}

   JSON

   {
     "main": {
       "params": [
         "args"
       ],
       "steps": [
         {
           "step1": {
             "assign": [
               {
                 "outputVar": "${\"Hello \" + args.firstName + \" \" + args.lastName}"
               }
             ]
           }
         },
         {
           "step2": {
             "return": "${outputVar}"
           }
         }
       ]
     }
   }
     

   Este flujo de trabajo muestra un saludo de “Hello” a una persona cuyo nombre y apellido pasas como argumentos de entorno de ejecución.

8. Haga clic en Implementar.

gcloud

1. Abre una terminal.

2. Guarda la siguiente definición de flujo de trabajo como un archivo YAML o JSON, como myFirstWorkflow.yaml o myFirstWorkflow.json.

   YAML

   main:
     params: [args]
     steps:
       - step1:
           assign:
             - outputVar: ${"Hello, " + args.firstName + " " + args.lastName + "!"}
       - step2:
           return: ${outputVar}

   JSON

   {
     "main": {
       "params": [
         "args"
       ],
       "steps": [
         {
           "step1": {
             "assign": [
               {
                 "outputVar": "${\"Hello \" + args.firstName + \" \" + args.lastName}"
               }
             ]
           }
         },
         {
           "step2": {
             "return": "${outputVar}"
           }
         }
       ]
     }
   }
     

   Este flujo de trabajo muestra un saludo de “Hello” a una persona cuyo nombre y apellido pasas como argumentos de entorno de ejecución.

3. Para implementar el flujo de trabajo, ingresa el siguiente comando:

   gcloud workflows deploy myFirstWorkflow \
       --source=myFirstWorkflow.yaml_OR_json \
       --service-account=sa-name@PROJECT_ID.iam.gserviceaccount.com

   Reemplaza yaml_OR_json por yaml o json, según el formato del archivo de definición de Workflows que creaste antes.

Console

1. En la consola de Google Cloud, ve a la página Cloud Scheduler:

   Ir a Cloud Scheduler

2. Haz clic en Crear trabajo.

3. Ingresa my-workflow-job en Nombre.

4. En Frecuencia, ingresa:

   */5 * * * *

   Esto ejecutará el trabajo cada 5 minutos. El intervalo se define con el formato unix-cron.

5. En Zona horaria, selecciona un país y una zona horaria.

   Por ejemplo, selecciona Estados Unidos y Los Ángeles o la Hora de verano del Pacífico (PDT).

6. Haga clic en Continuar.

7. En Tipo de destino, selecciona HTTP.

8. En URL, ingresa lo siguiente:

   https://workflowexecutions.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/workflows/myFirstWorkflow/executions
   

9. Deja el método HTTP con el valor predeterminado de POST.

10. Agrega los siguientes dos encabezados HTTP:

    • Nombre: Content-Type y valor: application/octet-stream
    • Nombre: User-Agent y valor: Google-Cloud-Scheduler

11. En Cuerpo, ingresa lo siguiente:

    {"argument": "{\"firstName\":\"Sherlock\", \"lastName\":\"Holmes\"}"}
    

    Esto pasa una codificación JSON de los argumentos del flujo de trabajo, en este caso, el nombre, “Sherlock” y el apellido, “Holmes”. Las comillas dobles dentro de la string se escapan mediante barras inversas (\).

12. En Encabezado de la autenticación, selecciona Agregar token de OAuth.

13. Ingresa la cuenta de servicio que creaste antes.

    sa-name@PROJECT_ID.iam.gserviceaccount.com
    

    No es necesario que especifiques el alcance, ya que se usa el valor predeterminado de https://www.googleapis.com/auth/cloud-platform.

14. Acepta todos los valores predeterminados y haz clic en Crear.

gcloud

Para programar un trabajo llamado my-workflow-job, ingresa el siguiente comando:

gcloud scheduler jobs create http my-workflow-job \
    --schedule="*/5 * * * *" \
    --uri="https://workflowexecutions.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/workflows/myFirstWorkflow/executions" \
    --message-body="{\"argument\": \"{\\\"firstName\\\":\\\"Sherlock\\\", \\\"lastName\\\":\\\"Holmes\\\"}\"}" \
    --time-zone="America/Los_Angeles" \
    --oauth-service-account-email="sa-name@PROJECT_ID.iam.gserviceaccount.com"

El intervalo se define con el formato unix-cron.

La marca message-body se usa para pasar una codificación JSON de los argumentos del flujo de trabajo, en este caso, el nombre, “Sherlock” y el apellido, “Holmes”. Las comillas dobles dentro de la string se escapan mediante barras inversas (\).

Console

1. En la consola de Google Cloud, ve a la página Cloud Scheduler:

   Ir a Cloud Scheduler

   Si no se muestra el trabajo, es posible que debas actualizar la página.

2. En el trabajo denominado my-workflow-job, haz clic en Ejecutar ahora.

   Deberías ver el valor de Resultado actualizado a Sin errores.

3. En la consola de Google Cloud, ve a la página Workflows.

   Ir a Workflows

4. En la lista de flujos de trabajo, haz clic en myFirstWorkflow para abrir su página de detalles.

   El estado de ejecución de tu flujo de trabajo debería ser Correcto.

5. Haz clic en el ID de ejecución del flujo de trabajo para abrir la página de detalles y ver los resultados del flujo de trabajo en el panel Resultado.

   El resultado debería ser “Hello, Sharlock Holmes”.

gcloud

1. Ejecuta el trabajo de Cloud Scheduler para ejecutar el flujo de trabajo:

   gcloud scheduler jobs run my-workflow-job
   

2. Recupera el ID de ejecución del flujo de trabajo:

   gcloud workflows executions list myFirstWorkflow
   

   El resultado debería parecerse al siguiente con el ID de ejecución en negrita:

   projects/316710615161/locations/us-central1/workflows/myFirstWorkflow/executions/138b31e1-f3bb-4ba7-a6da-008d0cb4a320

3. Recupera los resultados de la ejecución del flujo de trabajo:

   gcloud workflows executions describe EXECUTION_ID --workflow myFirstWorkflow

   Reemplaza EXECUTION_ID por el ID de ejecución que se mostró en el paso anterior.

   El resultado debe parecerse al siguiente:

   argument: '{"firstName":"Sherlock","lastName":"Holmes"}'
   endTime: '2021-09-09T15:15:00.869350639Z'
   name: projects/316710615161/locations/us-central1/workflows/myFirstWorkflow/executions/138b31e1-f3bb-4ba7-a6da-008d0cb4a320
   result: '"Hello, Sherlock Holmes!"'
   startTime: '2021-09-09T15:15:00.839175480Z'
   state: SUCCEEDED
   workflowRevisionId: 000001-4f9