Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Crea y actualiza un flujo de trabajo

En esta página, se muestra cómo crear un flujo de trabajo y actualizar un flujo de trabajo existente en Google Cloud Console o con la herramienta de línea de comandos de gcloud.

Antes de comenzar

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir a la página del selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

  4. Habilita la API de Workflows.

    Habilitar la API de Workflows
  5. Crea una cuenta de servicio si aún no tienes una. Luego, otórgale las funciones necesarias para administrar flujos de trabajo y crear registros.

    Console

    1. En Cloud Console, ve a la página Cuentas de servicio.

      Ir a la página Crear cuenta de servicio
    2. Selecciona Crear cuenta de servicio.
    3. Ingresa un nombre en el campo Nombre de cuenta de servicio.
    4. Haga clic en Crear.
    5. En la lista Función, selecciona Logging > Escritor de registros.

      Nota: El campo Función autoriza a tu cuenta de servicio para acceder a los recursos. Para crear, actualizar y ejecutar flujos de trabajo, asigna la función roles/workflows.editor. Para enviar registros a Cloud Logging, asigna la función roles/logging.logWriter. Si desarrollas una app de producción, otorga siempre las funciones menos permisivas posibles. Para obtener más información, consulta asigna funciones a cuentas de servicio. Si deseas obtener una lista de las funciones de flujos de trabajo, consulta la referencia de control de acceso.
    6. Haga clic en Continuar.
    7. Haga clic en Listo.

    gcloud

    1. Cree la cuenta de servicio. Reemplaza [NAME] con un nombre para la cuenta de servicio.

      gcloud iam service-accounts create [NAME]
    2. Otorga permisos a la cuenta de servicio mediante la asignación de una función.

      gcloud projects add-iam-policy-binding [PROJECT_ID] --member "serviceAccount:[NAME]@[PROJECT_ID].iam.gserviceaccount.com" --role "roles/logging.logWriter"

      Reemplaza lo siguiente:
      • [PROJECT_ID]: El ID de tu proyecto.
      • [NAME]: El nombre de la cuenta de servicio que acabas de crear
      Nota: El campo Función autoriza a tu cuenta de servicio para acceder a los recursos. Para enviar registros a Cloud Logging, asigna la función roles/logging.logWriter. Si desarrollas una app de producción, otorga siempre las funciones menos permisivas posibles. Para obtener más información, consulta asigna funciones a cuentas de servicio. Si deseas obtener una lista de las funciones de flujos de trabajo, consulta la referencia de control de acceso.

Crea un flujo de trabajo

A fin de crear un flujo de trabajo, lo implementamos a fin de que esté disponible para su ejecución. El paso de implementación también valida que el archivo de origen se pueda ejecutar. Falla si el archivo de origen no contiene una definición de flujo de trabajo válida.

Console

  1. Para crear un flujo de trabajo nuevo, abre la página Flujos de trabajo en Google Cloud Console:
    Ir a la página de flujos de trabajo

  2. Selecciona Create.

  3. Ingresa un nombre para el flujo de trabajo nuevo, como myFirstWorkflow. El nombre puede contener letras, números, guiones bajos y guiones. Debe comenzar con una letra y terminar con una letra o un número.

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

  5. Selecciona la cuenta de servicio que deseas que use tu flujo de trabajo para la autenticación con otros servicios de Google Cloud. Te recomendamos usar una cuenta de servicio con los privilegios mínimos necesarios para acceder a los recursos requeridos. Para obtener más información sobre las cuentas de servicio, consulta Crea y administra cuentas de servicio.

  6. Selecciona Siguiente.

  7. En el editor de flujo de trabajo, ingresa la definición para tu flujo de trabajo. Puedes encontrar un flujo de trabajo de ejemplo en la Guía de inicio rápido con Cloud Console.

  8. Selecciona Implementar.

gcloud

  1. Asegúrate de que el código fuente de tu flujo de trabajo se guarde en un archivo YAML o JSON, como MY_WORKFLOW.YAML o MY_WORKFLOW.JSON. Puedes encontrar un flujo de trabajo de ejemplo en la página Guía de inicio rápido con la herramienta de gcloud.

  2. Abre una terminal.

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

    gcloud workflows deploy MY_WORKFLOW \
    --source=MY_WORKFLOW.YAML \
    [--service-account=MY_SERVICE_ACCOUNT@MY_PROJECT.IAM.GSERVICEACCOUNT.COM]
    

    Reemplaza lo siguiente:

    • MY_WORKFLOW: el nombre de tu flujo de trabajo.

    • MY_WORKFLOW.YAML: el archivo de origen que se usa para el flujo de trabajo.

    • MY_SERVICE_ACCOUNT@MY_PROJECT.IAM.GSERVICEACCOUNT.COM: Opcional La cuenta de servicio que usará tu flujo de trabajo para acceder a otros servicios de Google Cloud. Te recomendamos usar una cuenta de servicio con los privilegios mínimos necesarios para acceder a los recursos necesarios. Si se deja en blanco, se utiliza la cuenta de servicio predeterminada. Para obtener más información sobre las cuentas de servicio, consulta Crea y administra cuentas de servicio.

Actualiza un flujo de trabajo

Puedes actualizar un flujo de trabajo existente para cambiar su fuente, descripción, etiquetas o su cuenta de servicio asociada. La actualización de un flujo de trabajo no afecta las ejecuciones en curso. Solo las ejecuciones futuras del flujo de trabajo usarán las configuraciones actualizadas.

Console

  1. Para actualizar un flujo de trabajo existente, abre la página Flujos de trabajo en Google Cloud Console:
    Ir a la página Flujos de trabajo

  2. Selecciona el nombre del flujo de trabajo que deseas actualizar.

  3. En la página Editar flujo de trabajo (Edit workflow), puedes editar la descripción, actualizar la cuenta de servicio que usa el flujo de trabajo para la autenticación o agregar una etiqueta. No puedes editar el nombre del flujo de trabajo.

  4. Selecciona Siguiente cuando termines con tus actualizaciones iniciales.

  5. Para editar el origen del flujo de trabajo, actualiza el código fuente en el editor de flujo de trabajo.

  6. Selecciona Implementar.

gcloud

  1. Busca el archivo YAML o JSON donde se guarda la fuente del flujo de trabajo actualizada, como WORKFLOW_FILE.YAML o WORKFLOW_FILE.JSON.

  2. Abre una terminal.

  3. Busca el nombre del flujo de trabajo que deseas actualizar. Si no conoces el nombre del flujo de trabajo, puedes ingresar el siguiente comando para enumerar todos tus flujos de trabajo:

    gcloud workflows list
    
  4. Puedes actualizar la fuente, la cuenta de servicio asociada, la descripción o las etiquetas de un flujo de trabajo:

    gcloud workflows deploy WORKFLOW_NAME \
    --source=WORKFLOW_FILE.YAML \
    [--service-account=MY_SERVICE_ACCOUNT@MY_PROJECT.IAM.GSERVICEACCOUNT.COM] \
    [--labels=KEY=VALUE...] \
    [--description='WORKFLOW_DESCRIPTION']
    

    Reemplaza lo siguiente:

    • WORKFLOW_NAME: Obligatorio. El nombre de tu flujo de trabajo.

    • WORKFLOW_FILE.YAML: Obligatorio. El archivo de origen para el flujo de trabajo.

    • MY_SERVICE_ACCOUNT@MY_PROJECT.IAM.GSERVICEACCOUNT.COM: Opcional La cuenta de servicio que usará tu flujo de trabajo para acceder a otros servicios de Google Cloud. Para obtener más información sobre las cuentas de servicio, consulta Crea y administra cuentas de servicio.

    • KEY=VALUE: Opcional Etiquetas que deseas agregar en pares KEY=VALUE, en una lista separada por comas si agregas más de una.

    • WORKFLOW_DESCRIPTION: Opcional La descripción que deseas darle a tu flujo de trabajo.

    Debes especificar el nombre del flujo de trabajo que deseas actualizar y su fuente, pero el resto de las marcas son opcionales.

Cada vez que actualizas un flujo de trabajo, se actualiza su versionID. El versionID consta de dos partes separadas por un guion:

  • Un número, que comienza en uno, se incrementa cada vez que actualizas un flujo de trabajo.

  • Una string alfanumérica, de tres caracteres alfanuméricos.

Por ejemplo, 000002-d52 indica un flujo de trabajo que se actualizó una vez. 000001-27f indica un flujo de trabajo que está en su versión inicial.

¿Qué sigue?