Descripción general de los flujos de trabajo

Workflows es una plataforma de organización completamente administrada que ejecuta servicios en el orden que tú defines: un flujo de trabajo. Estos flujos de trabajo pueden combinar servicios, incluidos servicios personalizados alojados en Cloud Run o Cloud Functions, servicios de Google Cloud, como Cloud Vision AI y BigQuery, y cualquier API basada en HTTP.

Si incorporas Workflows en las soluciones, puedes hacer que las dependencias del servicio sean explícitas y observables de extremo a extremo. Un flujo de trabajo que especifica una aplicación, un proceso operativo o empresarial proporciona una fuente de información o una narrativa canónica para el proceso.

Workflows funcionan sin servidores y escalan verticalmente según sea necesario, y no se aplican cargos mientras el usuario está inactivo. Debido a que un flujo de trabajo no contiene dependencias de biblioteca ni código, no requiere parches de seguridad. Una vez que implementas un flujo de trabajo, puedes esperar que se ejecute de manera confiable sin mantenimiento. Un flujo de trabajo puede mantener el estado, reintentar, sondear o esperar hasta un año.

Workflows cumplen con estas certificaciones y estándares.

En el siguiente diagrama, se muestra un ejemplo del uso de Workflows para organizar los servicios:

Organización de servicios con Workflows

Casos de uso clave

Workflows admite muchos casos de uso. Por ejemplo:

Organización de servicios Crea soluciones mediante la combinación de servicios: realiza una secuencia de operaciones en varios sistemas y espera a que se completen todas las operaciones. Puede controlarse por eventos. Por ejemplo:
  • Envía los archivos subidos recientemente a Cloud Vision AI y, luego, escribe etiquetas en Firestore
  • Llama a una Cloud Function y envía los resultados a un servicio de Cloud Run.
Trabajos por lotes Operar sobre varios elementos: realiza operaciones en un conjunto de elementos o datos por lotes. Suelen programarse. Por ejemplo:
  • Enviar correos electrónicos diarios a los clientes
  • Preparar y ejecutar BigQuery o trabajos de aprendizaje automático
  • Genera informes
Procesos empresariales Automatiza los flujos de trabajo de líneas de negocio: Codifica los pasos de un proceso empresarial, incluidas las condiciones, las acciones y los eventos con interacción humana. Por ejemplo:
  • Seguimiento de un pedido desde la solicitud hasta la entrega
  • Automatiza las solicitudes de recursos con aprobaciones
Automatización de procesos de TI Ejecución administrada de operaciones de servicio: secuencias de comandos fácilmente para las operaciones de servicio de Google Cloud. Por ejemplo:
  • Aprovisiona nuevos proyectos de inquilino o infraestructura
  • Desactiva recursos según un programa o mediante activadores de eventos

Conceptos básicos

Un flujo de trabajo consta de una serie de pasos descritos mediante la sintaxis de Workflows y se pueden escribir en YAML o JSON. Esta es la definición del flujo de trabajo. Para obtener una explicación detallada de la sintaxis de Workflows, consulta la referencia de sintaxis.

Después de crear un flujo de trabajo, se implementa, lo que hace que el flujo de trabajo esté listo para la ejecución. Aprende a crear y actualizar un flujo de trabajo en la consola de Google Cloud o con Google Cloud CLI. También puedes crear el flujo de trabajo si usas un IDE o editor de código fuente preferidos y configuras el autocompletado y la validación de sintaxis.

Una ejecución es una ejecución única de la lógica contenida en la definición de un flujo de trabajo. Un flujo de trabajo que no se ejecutó no genera cargos. Todas las ejecuciones de flujos de trabajo son independientes, y el escalamiento rápido del producto permite una gran cantidad de ejecuciones simultáneas. Puedes ejecutar un flujo de trabajo mediante las bibliotecas cliente, en la consola de Google Cloud, con Google Cloud CLI o si envías una solicitud POST HTTP a la URL de invocación del flujo de trabajo con la API de REST de Workflows. Para obtener más detalles, consulta Ejecuta un flujo de trabajo.

Funciones clave

Estas son algunas capacidades clave de Workflows.

Control de ejecución

Pasos
Para crear un flujo de trabajo, define los pasos necesarios y el orden de ejecución mediante la sintaxis de Workflows. Cada flujo de trabajo debe tener al menos un paso. De forma predeterminada, Workflows trata los pasos como si estuvieran en una lista ordenada y los ejecuta uno a la vez hasta que se hayan ejecutado todos. Para obtener más información, consulta Pasos.
Condiciones
Puedes usar un bloque switch como mecanismo de selección que permite que el valor de una expresión controle el flujo de la ejecución de un flujo de trabajo. Para obtener más detalles, consulta Condiciones.
Iteración
Puedes usar un bucle for para iterar en una secuencia de números o en una colección de datos, como una lista o un mapa. Para obtener más detalles, consulta Iteración.
Pasos paralelos
Puedes usar un paso parallel para definir una parte de tu flujo de trabajo (una rama o un bucle) que puede ejecutarse en simultáneo. Para obtener más información, consulta Pasos paralelos.
Subflujos de trabajo
Un subflujo de trabajo funciona de manera similar a una rutina o función en un lenguaje de programación, lo que te permite encapsular un paso o un conjunto de pasos que tu flujo de trabajo repetirá varias veces. Para obtener información detallada, consulta Subflujos de trabajo.

Activa ejecuciones

Manual
Puedes administrar flujos de trabajo desde la consola de Google Cloud o desde la línea de comandos con Google Cloud CLI. La compatibilidad de visualización mientras se edita la sintaxis de Workflows también está disponible a través de la consola de Google Cloud.
Programático
Las bibliotecas cliente de Cloud para la API de Workflows o la API de REST se pueden usar con el fin de administrar flujos de trabajo. Para obtener más información, consulta API y referencia de Workflows.
Programado
Puedes usar Cloud Scheduler para ejecutar un flujo de trabajo en una programación particular, como todos los lunes a las 9 a.m. o cada 15 minutos. Para obtener más información, consulta Programa un flujo de trabajo con Cloud Scheduler.
Argumentos del entorno de ejecución
Para acceder a los datos que se pasan en el tiempo de ejecución, agrega un campo params al flujo de trabajo principal (colocado en un bloque main). El bloque main acepta un solo argumento que es cualquier tipo de datos JSON válido. El campo params nombra la variable que usa el flujo de trabajo para almacenar los datos que pasas. Para obtener más detalles, consulta Argumentos del entorno de ejecución.

Servicios de conexión

APIs de HTTP
Puedes definir un paso del flujo de trabajo que realice una llamada HTTP y asignar la respuesta de la llamada a una variable. Por ejemplo, puedes invocar un servicio de Google Cloud, como Cloud Functions o Cloud Run, a través de una solicitud HTTP. Se admiten solicitudes HTTP y HTTPS. Para obtener más información, consulta Realiza una solicitud HTTP y, también, Invoca Cloud Functions o Cloud Run.
Puedes invocar instancias locales privadas, Compute Engine, Google Kubernetes Engine (GKE) o cualquier otro extremo de Google Cloud si habilitas Identity-Aware Proxy (IAP). IAP te permite establecer una capa de autorización central para las aplicaciones a las que se accede a través de HTTPS, de modo que puedas usar un modelo de control de acceso a nivel de aplicación en lugar de firewalls a nivel de red. Para obtener más información, consulta Invoca instancias locales privadas, Compute Engine, GKE o cualquier otro extremo.
Como alternativa, puedes orientar las llamadas HTTP desde la ejecución del flujo de trabajo a un extremo privado mediante el registro de servicios del Directorio de servicios con Workflows. Cuando se crea un extremo privado dentro de una red de nube privada virtual (VPC), el extremo puede cumplir con los Controles del servicio de VPC. Para obtener más información, consulta Invoca un extremo privado que cumpla con los Controles del servicio de VPC.
Conectores
Workflows publica conectores que se pueden usar para conectarse a otras APIs de Google Cloud dentro de un flujo de trabajo y, también, para integrar tus flujos de trabajo en esos productos de Google Cloud. Simplifican los servicios de llamadas porque controlan el formato de las solicitudes por ti y proporcionan métodos y argumentos para que no necesites conocer los detalles de una API de Google Cloud. Para obtener más detalles, consulta Información sobre los conectores.
Biblioteca estándar y variables de entorno
La biblioteca estándar de Workflows, las variables de entorno integradas y las variables de entorno definidas por el usuario te permiten crear argumentos para servicios y procesar respuestas de manera eficiente.
La biblioteca estándar incluye módulos y funciones de uso frecuente, como las de conversiones de formatos y tipos de datos. No es necesario importar o cargar bibliotecas en un flujo de trabajo; las funciones de las bibliotecas funcionan de inmediato. Para obtener más detalles, consulta la Descripción general de la biblioteca estándar.
Puedes acceder a la información del entorno de un flujo de trabajo (como su ubicación o identificador del proyecto) mediante variables de entorno integradas. Las variables de entorno integradas no requieren declaración y están disponibles en todas las ejecuciones de flujos de trabajo. Para obtener más detalles, consulta Variables de entorno integradas.
Cuando implementas un flujo de trabajo, puedes configurar pares de cadenas de clave y valor arbitrarios como variables de entorno definidas por el usuario a las que tu flujo de trabajo puede acceder en el entorno de ejecución. Por ejemplo, puedes crear un flujo de trabajo que se configure de forma dinámica según el entorno en el que se implementa. Para obtener más detalles, consulta Usa variables de entorno.

Manejo de errores

Puedes hacer que tus flujos de trabajo sean resilientes y personalizar su comportamiento cuando se produce una falla mediante el control de excepciones de Workflows, incluidos los reintentos de llamadas HTTP automatizados con retiradas exponenciales, controladores de errores personalizados y otras funciones avanzadas. Para obtener más detalles, consulta Errores de flujo de trabajo.

Pendiente

Las devoluciones de llamada permiten que las ejecuciones de flujo de trabajo esperen a que otro servicio envíe una solicitud al extremo de devolución de llamada; esa solicitud reanuda la ejecución del flujo de trabajo. Con las devoluciones de llamada, puedes indicar al flujo de trabajo que se produjo un evento específico y esperar ese evento sin sondear. Para obtener más información, consulta Espera con devoluciones de llamada.

Puedes pausar la ejecución de un flujo de trabajo si agregas un paso de suspensión a la definición de tu flujo de trabajo. Luego, puedes usar sys.sleep para sondear los datos de un intervalo determinado. Para obtener más información, consulta Esperar con los sondeos.

Autenticación y control de acceso

Dado que la ejecución de cada flujo de trabajo requiere una llamada autenticada, puedes mitigar el riesgo de llamadas accidentales o maliciosas con Workflows. También puedes simplificar las interacciones con otras APIs de Google Cloud mediante cuentas de servicio basadas en IAM. Además, puedes almacenar claves y contraseñas de forma segura para autenticarte en APIs externas mediante el conector de Secret Manager. Para obtener más detalles, obtén más información sobre la autenticación y el control de acceso.

Observabilidad

Workflows genera registros de ejecución de forma automática para las ejecuciones de flujos de trabajo en Cloud Logging. También puedes controlar cuándo se envían los registros a Logging durante la ejecución de un flujo de trabajo a través del registro de llamadas o los registros personalizados. Para obtener más información, consulta Envía registros a Cloud Logging.

La información de los registros de auditoría está disponible a través de los registros de auditoría de Cloud. Para obtener más detalles, consulta Información de registro de auditoría de flujos de trabajo.

Puedes recuperar el historial de una ejecución de flujo de trabajo especificado como una lista de entradas de pasos. Cada entrada representa un paso o un bloque de instrucciones en la ejecución del flujo de trabajo. Las entradas de los pasos pueden ayudarte a determinar la fuente de un error o a optimizar el rendimiento de un flujo de trabajo.

Muestras de código

Puedes encontrar muchas muestras de código de Workflows útiles en la página de muestras.

¿Qué sigue?