Workflows es una plataforma de organización completamente administrada que ejecuta servicios en el orden que defines: un flujo de trabajo. Estos flujos de trabajo pueden combinar servicios que incluyen servicios personalizados alojados en Cloud Run o funciones de Cloud Run, servicios de Google Cloud, como la IA de Cloud Vision y BigQuery, y cualquier API basada en HTTP.
Cuando incorporas Workflows en las soluciones, puedes hacer que las dependencias de 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 no tiene servidores, se escala según sea necesario y no se incurren en cargos mientras está inactivo. Debido a que un flujo de trabajo no contiene dependencias de código ni de bibliotecas, no requiere parches de seguridad. Una vez que implementes un flujo de trabajo, puedes esperar que se ejecute de forma confiable sin mantenimiento. Un flujo de trabajo puede retener estado, volver a intentar, sondear o esperar hasta un año.
Workflows cumple con estas certificaciones y estándares.
En el siguiente diagrama, se muestra un ejemplo del uso de Workflows para orquestar servicios:
Casos de uso clave
Workflows admiten muchos casos de uso. Por ejemplo:
| Organización de servicios | Combina servicios para crear soluciones: Realiza una secuencia de operaciones en varios sistemas y espera a que se completen todas.
Puede estar basada en eventos. Por ejemplo:
|
| los trabajos por lotes | Operar en varios elementos: Realiza operaciones en un conjunto de elementos o datos por lotes. A menudo, se programan. Por ejemplo:
|
| Procesos empresariales | Automatiza los flujos de trabajo de la línea de negocios: Codifica los pasos de un proceso empresarial, incluidas las condiciones, las acciones y los eventos de personas en el proceso. Por ejemplo:
|
| Automatización de procesos de TI | Ejecución administrada de operaciones de servicio: Crea secuencias de comandos de operaciones de servicios de Google Cloud fácilmente. Por ejemplo:
|
Conceptos básicos
Un flujo de trabajo consta de una serie de pasos descritos con la sintaxis de Workflows y se puede 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 lo deja listo para su ejecución. Obtén información para crear y actualizar un flujo de trabajo en la consola de Google Cloud o con Google Cloud CLI. También puedes crear tu flujo de trabajo con un IDE o editor de código fuente preferido y configurar el autocompletado y la validación de sintaxis.
Una ejecución es una ejecución única de la lógica que se incluye 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 con las bibliotecas cliente, en la consola de Google Cloud, con Google Cloud CLI o enviando una solicitud HTTP POST a la URL de invocación del flujo de trabajo con la API de REST de Workflows. Para obtener más información, consulta
Ejecuta un flujo de trabajo.
Regionalidad
Workflows es un servicio regional y los flujos de trabajo son recursos regionales que están sujetos a la restricción de ubicaciones de recursos. Puedes usar las políticas de ubicación de recursos para controlar la residencia de datos.
Ten en cuenta que, cuando un flujo de trabajo se implementa en una región en particular, se ejecuta solo en esa región. Sin embargo, si el flujo de trabajo realiza solicitudes HTTP o usa conectores, es posible que la llamada HTTP no provenga de la misma región.
Funciones clave
A continuación, se muestran algunas de las funciones clave de Workflows.
Control de ejecución
- Pasos
- Para crear un flujo de trabajo, debes definir los pasos necesarios y el orden de ejecución con la sintaxis de Workflows. Cada flujo de trabajo debe tener al menos un paso. De forma predeterminada, Workflows considera que los pasos están en una lista ordenada y los ejecuta uno a la vez hasta que se ejecutan todos. Para obtener más detalles, consulta Pasos.
- Condiciones
- Puedes usar un bloque
switchcomo un mecanismo de selección que permite que el valor de una expresión controle el flujo de ejecución de un flujo de trabajo. Para obtener más información, consulta Condiciones. - Iteración
- Puedes usar un bucle
forpara iterar en una secuencia de números o a través de una colección de datos, como una lista o un mapa. Para obtener más información, consulta Iteración. - Pasos paralelos
- Puedes usar un paso
parallelpara definir una parte de tu flujo de trabajo (una rama o un bucle) que se puede ejecutar de forma simultánea. Para obtener más detalles, consulta Pasos en paralelo. - 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 más información, consulta Subflujos de trabajo.
Activación de 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 con la 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 para administrar flujos de trabajo. Para obtener más información, consulta APIs y referencias de Workflows.
- Programado
- Puedes usar Cloud Scheduler para ejecutar un flujo de trabajo en un programa 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 durante el tiempo de ejecución, agrega un campo
- El bloque
mainacepta un solo argumento que es cualquier tipo de datos JSON válido. El campoparamsasigna un nombre a la variable que usa el flujo de trabajo para almacenar los datos que pasas. Para obtener más información, consulta Argumentos del entorno de ejecución.
params a tu flujo de trabajo principal (colocado en un bloque main).Cómo conectar servicios
- APIs de HTTP
- Puedes definir un paso de flujo de trabajo que realice una llamada HTTP y asigne la respuesta de la llamada a una variable. Por ejemplo, puedes invocar un servicio de Google Cloud como funciones de Cloud Run o Cloud Run a través de una solicitud HTTP. Se admiten solicitudes HTTP y HTTPS. Para obtener más información, consulta Cómo realizar una solicitud HTTP y Cómo invocar funciones de Cloud Run o Cloud Run.
- Puedes invocar extremos privados locales, Compute Engine, Google Kubernetes Engine (GKE) o cualquier otro extremo de Google Cloud habilitando Identity-Aware Proxy (IAP). IAP te permite establecer una capa de autorización central para las aplicaciones a las que se accede mediante HTTPS, por lo que puedes 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 Cómo invocar un extremo privado local, Compute Engine, GKE o algún otro.
- Como alternativa, puedes segmentar un extremo privado para las llamadas HTTP desde la ejecución de tu flujo de trabajo con el registro de servicios del Directorio de servicios con Workflows. Cuando creas un extremo privado dentro de una red de nube privada virtual (VPC), el extremo puede cumplir con Controles del servicio de VPC. Para obtener más información, consulta Cómo invocar 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 para integrar tus flujos de trabajo con esos productos de Google Cloud. Simplifican los servicios de llamadas porque manejan 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 información, consulta Descripción de 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 construir argumentos de manera eficiente para los servicios y procesar respuestas.
- La biblioteca estándar incluye módulos y funciones de uso frecuente, como las de conversiones de formato y tipo de datos. No es necesario importar ni cargar bibliotecas en un flujo de trabajo, ya que las funciones de la biblioteca funcionan de inmediato. Para obtener más información, consulta la descripción general de las bibliotecas estándar.
- Puedes acceder a la información del entorno de un flujo de trabajo (como su ubicación o su identificador de proyecto) con las variables de entorno integradas. Las variables de entorno integradas no requieren declaración y están disponibles en cada ejecución de flujo de trabajo. Para obtener más información, consulta Variables de entorno integradas.
- Cuando implementas un flujo de trabajo, puedes establecer pares arbitrarios de cadenas de clave y valor como variadas 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 implemente. 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 automatizados de llamadas HTTP con retrasos exponenciales, controladores de errores personalizados y otras funciones avanzadas. Para obtener más información, consulta Errores de flujo de trabajo.
Esperando
Las devoluciones de llamada permiten que las ejecuciones de flujos de trabajo esperen a que otro servicio realice 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 indicarle a tu flujo de trabajo que se produjo un evento específico y esperar a ese evento sin sondear. Para obtener más información, consulta Cómo esperar con devoluciones de llamada.
Para pausar la ejecución de un flujo de trabajo, agrega un paso de suspensión a la definición del flujo de trabajo. Luego, puedes usar sys.sleep para sondear datos en un intervalo determinado. Para obtener más información, consulta Cómo esperar con sondeos.
Autenticación y control de acceso
Dado que cada ejecución de 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 con cuentas de servicio basadas en IAM, y puedes almacenar de forma segura claves y contraseñas para autenticarte en APIs externas con el conector de Secret Manager. Para obtener detalles, obtén más información sobre la autenticación y el control de acceso.
Observabilidad
Workflows genera automáticamente registros de ejecución para las ejecuciones de flujo 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 del registro de auditoría está disponible en Registros de auditoría de Cloud. Para obtener más información, consulta la información de registro de auditoría de los flujos de trabajo y las ejecuciones de flujos de trabajo.
Puedes recuperar el historial de una ejecución de flujo de trabajo especificada 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 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 útiles de Workflows en la página de muestras.
¿Qué sigue?
Comienza a usar Workflows desde la consola de Google Cloud o con la CLI de gcloud.
Obtén más información para crear y actualizar flujos de trabajo.
Obtén más información para controlar el orden en el que se ejecutan los pasos de un flujo de trabajo.