Cómo usar flujos de trabajo

Puedes configurar y ejecutar un flujo de trabajo si:

1. Creas una plantilla de flujo de trabajo
2. Configuras un clúster administrado (efímero) o seleccionas un clúster existente
3. Agregas trabajos
4. Creas una instancia de la plantilla para ejecutar el flujo de trabajo

Puedes parametrizar una plantilla de flujo de trabajo para usarla dinámicamente en flujos de trabajo diferentes. También puedes usar archivos YAML o llamar a la API InstantiateInline para definir y ejecutar un flujo de trabajo intercalado que no crea o modifica los recursos de la plantilla de flujo de trabajo.

Cómo crear una plantilla

Comando de gcloud

Ejecuta el siguiente command para crear un recurso de plantilla de flujo de trabajo de Dataproc.

gcloud dataproc workflow-templates create template-id (such as "my-workflow") \
    --region=region

API de REST

Consulta workflowTemplates.create. Se envía una WorkflowTemplate completa con una solicitud workflowTemplates.create.

Console

Puedes ver las plantillas de flujo de trabajo existentes y los flujos de trabajo con instancias desde la página Flujos de trabajo de Dataproc en Google Cloud Console.

Cómo configurar o seleccionar un clúster

Dataproc puede crear y usar un clúster "administrado" nuevo para tu flujo de trabajo o un clúster existente.

• Clúster existente: Consulta Cómo usar selectores de clúster con flujos de trabajo para seleccionar un clúster existente para tu flujo de trabajo.

• Clúster administrado: Debes configurar un clúster administrado para tu flujo de trabajo. Dataproc creará este clúster nuevo para ejecutar trabajos de clúster y, luego, borrar el clúster al final del flujo de trabajo.
  Puedes configurar un clúster administrado para tu flujo de trabajo con la herramienta de línea de comandos de gcloud o con las API de Dataproc.

  Comando de gcloud

  Usa marcas heredadas de gcloud dataproc cluster create para configurar el clúster administrado (número de trabajadores, tipo de máquina principal/trabajador, etcétera). Dataproc agregará un sufijo al nombre del clúster para garantizar la exclusividad.

  gcloud dataproc workflow-templates set-managed-cluster template-id \
      --region=region \
      --master-machine-type=machine-type \
      --worker-machine-type=machine-type \
      --num-workers=number \
      --cluster-name=cluster-name
  

  API de REST

  Consulta WorkflowTemplatePlacement.ManagedCluster. Este campo se proporciona como parte de una WorkflowTemplate completa, enviada con una solicitud workflowTemplates.create o workflowTemplates.update.

  Console

  Puedes ver las plantillas de flujo de trabajo existentes y los flujos de trabajo con instancias desde la página Flujos de trabajo de Dataproc en Google Cloud Console.

Cómo agregar trabajos a una plantilla

Todos los trabajos se ejecutan simultáneamente, a menos que especifiques una o más dependencias de trabajo. Las dependencias de un trabajo se expresan como una lista de otros trabajos que se deben completar exitosamente antes de que pueda comenzar el trabajo final. Debes proporcionar una step-id para cada trabajo. El ID debe ser único dentro del flujo de trabajo, pero no es necesario que lo sea globalmente.

Comando de gcloud

Usa el tipo de trabajos y las marcas heredadas de gcloud dataproc jobs submit para definir el trabajo que se agregará a la plantilla. De forma opcional, puedes usar la marca ‑‑start-after job-id of another workflow job para que el trabajo comience después de que se completen uno o más trabajos en el flujo de trabajo.

En este momento, las marcas de trabajo reiniciables --max-failures-per-hour y --max-failures-per-hour no son compatibles con los trabajos de plantillas de flujo de trabajo de Dataproc.

Ejemplos:

Agrega el trabajo de Hadoop "foo" a la plantilla "my-workflow".

gcloud dataproc workflow-templates add-job hadoop \
    --region=region \
    --step-id=foo \
    --workflow-template=my-workflow \
    -- space separated job args

Agrega el trabajo "bar" a la plantilla "my-workflow", que se ejecutará después de que el trabajo de flujo de trabajo "foo" se haya completado correctamente.

gcloud dataproc workflow-templates add-job job-type \
    --region=region \
    --step-id=bar \
    --start-after=foo \
    --workflow-template=my-workflow \
    -- space separated job args

Agrega otro trabajo "baz" a la plantilla "my-workflow" para que se ejecute luego de que se completen correctamente los trabajos "foo" y "bar".

gcloud dataproc workflow-templates add-job job-type \
    --region=region \
    --step-id=baz \
    --start-after=foo,bar \
    --workflow-template=my-workflow \
    -- space separated job args

API de REST

Consulta WorkflowTemplate.OrderedJob. Este campo se proporciona como parte de una WorkflowTemplate completa, enviada con una solicitud workflowTemplates.create o workflowTemplates.update.

Por el momento, los campos OrderedJob.JobScheduling maxFailuresPerHour y maxFailuresTotal no son compatibles con los trabajos de plantillas de flujo de trabajo de Dataproc.

Console

Puedes ver las plantillas de flujo de trabajo existentes y los flujos de trabajo con instancias desde la página Flujos de trabajo de Dataproc en Google Cloud Console.

Por el momento, la opción de trabajo reiniciable Max restarts per hour no es compatible con los trabajos de plantillas de flujo de trabajo de Dataproc.

Cómo ejecutar un flujo de trabajo

La creación de una instancia de una plantilla de flujo de trabajo ejecuta el flujo de trabajo definido por la plantilla. Se admiten múltiples creaciones de instancias de una plantilla. Puedes ejecutar un flujo de trabajo varias veces.

Comando de gcloud

gcloud dataproc workflow-templates instantiate template-id \
    --region=region

El comando muestra un ID de operación, que puedes usar para realizar un seguimiento del estado del flujo de trabajo.

Ejemplo:

gcloud beta dataproc workflow-templates instantiate my-template-id \
    --region=region
...
WorkflowTemplate [my-template-id] RUNNING
...
Created cluster: my-template-id-rg544az7mpbfa.
Job ID teragen-rg544az7mpbfa RUNNING
Job ID teragen-rg544az7mpbfa COMPLETED
Job ID terasort-rg544az7mpbfa RUNNING
Job ID terasort-rg544az7mpbfa COMPLETED
Job ID teravalidate-rg544az7mpbfa RUNNING
Job ID teravalidate-rg544az7mpbfa COMPLETED
...
Deleted cluster: my-template-id-rg544az7mpbfa.
WorkflowTemplate [my-template-id] DONE

API de REST

Consulta workflowTemplates.instantiate.

Console

Puedes ver las plantillas de flujo de trabajo existentes y los flujos de trabajo con instancias desde la página Flujos de trabajo de Dataproc en Google Cloud Console.

Fallas de trabajo de flujo de trabajo

Una falla en cualquier trabajo en un flujo de trabajo causará que el flujo de trabajo tenga errores. Dataproc buscará mitigar el efecto de las fallas causando que todos los trabajos que se ejecutan simultáneamente fallen y evitando que se inicien los trabajos subsecuentes.

Cómo supervisar y hacer un lista de un flujo de trabajo

Comando de gcloud

Para supervisar un flujo de trabajo:

gcloud dataproc operations describe operation-id \
    --region=region

Nota: El ID de operación se muestra cuando creas una instancia del flujo de trabajo con gcloud dataproc workflow-templates instantiate (consulta Cómo ejecutar un flujo de trabajo).

Para hacer una lista del estado del flujo de trabajo:

gcloud dataproc operations list \
    --region=region \
    --filter="labels.goog-dataproc-operation-type=WORKFLOW AND status.state=RUNNING"

API de REST

Para supervisar un flujo de trabajo, usa la API operations.get de Dataproc.

Para hacer una lista de los flujos de trabajo activos, usa la API operations.list de Dataproc con un filtro de etiqueta.

Console

Puedes ver las plantillas de flujo de trabajo existentes y los flujos de trabajo con instancias desde la página Flujos de trabajo de Dataproc en Google Cloud Console.

Cómo finalizar un flujo de trabajo

Puedes finalizar un flujo de trabajo con Google Cloud CLI o con una llamada a la API de Dataproc.

Nota: Finalizar un flujo de trabajo cancela los trabajos de flujo de trabajo en ejecución y, si el flujo de trabajo se ejecuta en un clúster administrado (efímero), borra el clúster administrado.

Comando de gcloud

gcloud dataproc operations cancel operation-id \
    --region=region

Nota: El operation-id que se muestra cuando creas una instancia en el flujo de trabajo con gcloud dataproc workflow-templates instantiate (consulta Cómo ejecutar un flujo de trabajo).

API de REST

Consulta la API operations.cancel.

Console

Puedes ver las plantillas de flujo de trabajo existentes y los flujos de trabajo con instancias desde la página Flujos de trabajo de Dataproc en Google Cloud Console.

Cómo actualizar una plantilla de flujo de trabajo

Las actualizaciones no afectan los flujos de trabajo activos. La versión de la plantilla nueva solo se aplicará a los flujos de trabajo nuevos.

Comando de gcloud

Las plantillas de flujo de trabajo se pueden actualizar mediante el uso de comandos gcloud workflow-templates nuevos que hacen referencia a un ID de plantilla de flujo de trabajo existente:

• gcloud dataproc workflow-templates add job
• gcloud dataproc workflow-templates set-managed-cluster
• gcloud dataproc workflow-templates set-cluster-selector

a una plantilla de flujo de trabajo existente.

API de REST

Para hacer una actualización de una plantilla con las API de REST:

1. Llama a workflowTemplates.get, que muestra la plantilla actual con el campo version completo con la versión del servidor actual.
2. Realiza actualizaciones en la plantilla recuperada
3. Llama a workflowTemplates.update con la plantilla actualizada

Como una protección contra las modificaciones simultáneas, una solicitud para actualizar una plantilla debe especificar la versión actual del servidor en el campo workflowTemplate.version.

Console

Puedes ver las plantillas de flujo de trabajo existentes y los flujos de trabajo con instancias desde la página Flujos de trabajo de Dataproc en Google Cloud Console.

Cómo borrar una plantilla de flujo de trabajo

Comando de gcloud

gcloud dataproc workflow-templates delete template-id \
    --region=region

Nota: El operation-id que se muestra cuando creas una instancia en el flujo de trabajo con gcloud dataproc workflow-templates instantiate (consulta Cómo ejecutar un flujo de trabajo).

API de REST

Consulta workflowTemplates.delete.

Console

Puedes ver las plantillas de flujo de trabajo existentes y los flujos de trabajo con instancias desde la página Flujos de trabajo de Dataproc en Google Cloud Console.