Ejecuta una traducción por lotes con el conector de Cloud Translation

En este instructivo, se muestra cómo crear un flujo de trabajo que usa el conector de la API de Cloud Translation para traducir archivos a otros idiomas en modo asíncrono por lotes. Esto proporciona un resultado en tiempo real a medida que se procesan las entradas.

Objetivos

En este instructivo, realizarás las siguientes acciones:

1. Crear un bucket de Cloud Storage de entrada
2. Crear dos archivos en inglés y subirlos al bucket de entrada
3. Crear un flujo de trabajo que use el conector de la API de Cloud Translation para traducir los dos archivos al francés y al español, y guardar los resultados en un bucket de salida
4. Implementar y ejecutar el flujo de trabajo para organizar todo el proceso

Costos

En este documento, usarás los siguientes componentes facturables de Google Cloud:

• Cloud Storage
• Translation
• Workflows

Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios.

Es posible que los usuarios Google Cloud nuevos decumplan con los requisitos para acceder a una prueba gratuita.

Antes de comenzar

Es posible que las restricciones de seguridad que define tu organización no te permitan completar los siguientes pasos. Para obtener información sobre la solución de problemas, consulta Desarrolla aplicaciones en un entorno Google Cloud restringido.

Accede a tu Google Cloud cuenta de. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

Instala Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Crea o selecciona un Google Cloud proyecto.

Roles necesarios para seleccionar o crear un proyecto

• Seleccionar un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
• Crear un proyecto: Para crear un proyecto, necesitas el rol de creador de proyectos (roles/resourcemanager.projectCreator), que contiene el resourcemanager.projects.create permiso. Obtén información para otorgar roles.

Nota: Si no planeas conservar los recursos creados durante este procedimiento, crea un proyecto en lugar de seleccionar un proyecto existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

• Crea un Google Cloud proyecto de:

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el Google Cloud proyecto que estás creando.

• Selecciona el Google Cloud proyecto que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto de.

Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

Habilita las APIs de Cloud Storage, Translation y Workflows:

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles.

gcloud services enable storage.googleapis.com translate.googleapis.com workflows.googleapis.com

Instala Google Cloud CLI.

Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

Para inicializar gcloud CLI, ejecuta el siguiente comando:

gcloud init

Crea o selecciona un Google Cloud proyecto.

Roles necesarios para seleccionar o crear un proyecto

• Seleccionar un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
• Crear un proyecto: Para crear un proyecto, necesitas el rol de creador de proyectos (roles/resourcemanager.projectCreator), que contiene el resourcemanager.projects.create permiso. Obtén información para otorgar roles.

Nota: Si no planeas conservar los recursos creados durante este procedimiento, crea un proyecto en lugar de seleccionar un proyecto existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

• Crea un Google Cloud proyecto de:

  gcloud projects create PROJECT_ID

  Reemplaza PROJECT_ID por un nombre para el Google Cloud proyecto que estás creando.

• Selecciona el Google Cloud proyecto que creaste:

  gcloud config set project PROJECT_ID

  Reemplaza PROJECT_ID por el nombre de tu Google Cloud proyecto de.

Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

Habilita las APIs de Cloud Storage, Translation y Workflows:

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles.

gcloud services enable storage.googleapis.com translate.googleapis.com workflows.googleapis.com

1. Actualiza los componentes de gcloud:

   gcloud components update

2. Accede con tu cuenta:

   gcloud auth login

3. Establece la ubicación predeterminada que se usa en este instructivo:

   gcloud config set workflows/location us-central1

   Como este instructivo usa el modelo predeterminado de AutoML Translation que reside en us-central1, debes establecer la ubicación en us-central1.

   Si usas un modelo o glosario de AutoML Translation que no sea el predeterminado, asegúrate de que resida en la misma ubicación que la llamada al conector; de lo contrario, se mostrará un INVALID_ARGUMENT (400) error. Para obtener más información, consulta el método batchTranslateText.

Crea un bucket de Cloud Storage y archivos de entrada

Puedes usar Cloud Storage para almacenar objetos. Los objetos son datos inmutables que constan de un archivo de cualquier formato y se almacenan en contenedores llamados buckets.

1. Crea un bucket de Cloud Storage para contener los archivos que se traducirán:

   BUCKET_INPUT=${GOOGLE_CLOUD_PROJECT}-input-files
   gcloud storage buckets create gs://${BUCKET_INPUT}

2. Crea dos archivos en inglés y súbelos al bucket de entrada:

   echo "Hello World!" > file1.txt
   gcloud storage cp file1.txt gs://${BUCKET_INPUT}
   echo "Workflows connectors simplify calling services." > file2.txt
   gcloud storage cp file2.txt gs://${BUCKET_INPUT}

Implementa y ejecuta el flujo de trabajo

Un flujo de trabajo está compuesto por una serie de pasos descritos con la sintaxis de Workflows, que se pueden escribir en formato YAML o JSON. Esta es la definición del flujo de trabajo. Después de crear un flujo de trabajo, debes implementarlo a fin de que esté disponible para su ejecución.

1. Crea un archivo de texto con el nombre de archivo workflow.yaml y el siguiente contenido:

   main:
     steps:
     - init:
         assign:
         - projectId: ${sys.get_env("GOOGLE_CLOUD_PROJECT_ID")}
         - location: ${sys.get_env("GOOGLE_CLOUD_LOCATION")}
         - inputBucketName: ${projectId + "-input-files"}
         - outputBucketName: ${projectId + "-output-files-" + string(int(sys.now()))}
     - createOutputBucket:
           call: googleapis.storage.v1.buckets.insert
           args:
             project: ${projectId}
             body:
               name: ${outputBucketName}
     - batchTranslateText:
         call: googleapis.translate.v3beta1.projects.locations.batchTranslateText
         args:
             parent: ${"projects/" + projectId + "/locations/" + location}
             body:
                 inputConfigs:
                   gcsSource:
                     inputUri: ${"gs://" + inputBucketName + "/*"}
                 outputConfig:
                     gcsDestination:
                       outputUriPrefix: ${"gs://" + outputBucketName + "/"}
                 sourceLanguageCode: "en"
                 targetLanguageCodes: ["es", "fr"]
         result: batchTranslateTextResult

   El flujo de trabajo asigna variables, crea un bucket de salida y comienza la traducción de los archivos, guardando los resultados en el bucket de salida.

2. Después de crear el flujo de trabajo, impleméntalo:

   gcloud workflows deploy batch-translation --source=workflow.yaml

3. Ejecuta el flujo de trabajo:

   gcloud workflows execute batch-translation

4. Para ver el estado del flujo de trabajo, puedes ejecutar el comando que se muestra. Por ejemplo:

   gcloud workflows executions describe eb4a6239-cffa-4672-81d8-d4caef7d8424 /
     --workflow batch-translation /
     --location us-central1

   El flujo de trabajo debe ser ACTIVE. Después de unos minutos, los archivos traducidos (en francés y español) se suben al bucket de salida.

Enumera los objetos en el bucket de salida

Para confirmar que el flujo de trabajo funcionó como se esperaba, enumera los objetos en tu bucket de salida.

1. Recupera el nombre de tu bucket de salida:

   gcloud storage ls

   El resultado es similar a este:

   gs://PROJECT_ID-input-files/
   gs://PROJECT_ID-output-files-TIMESTAMP/

2. Enumera los objetos en tu bucket de salida:

   gcloud storage ls gs://PROJECT_ID-output-files-TIMESTAMP/** --recursive

   Después de unos minutos, se muestran los archivos traducidos, dos de cada uno en francés y español.

Limpia

Si creaste un proyecto nuevo para este instructivo, bórralo. Si usaste un proyecto existente y deseas conservarlo sin los cambios que se agregaron en este instructivo, borra los recursos creados para el instructivo.

Borra el proyecto

La manera más fácil de eliminar la facturación es borrar el proyecto que tú creaste para el instructivo.

Para borrar el proyecto, haz lo siguiente:

Precaución: Borrar un proyecto tiene estas consecuencias:

• Se borra todo su contenido. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los IDs personalizados de los proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID personalizado del proyecto que desees utilizar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto, en lugar de todo el proyecto.

Si planeas explorar varios instructivos, arquitecturas o guías de inicio rápido, reutilizar proyectos puede ser útil para no exceder los límites de cuota de los proyectos.

1. En la Google Cloud consola, ve a la página Administrar recursos.

   Ir a Administrar recursos

2. En la lista de proyectos, elige el proyecto que deseas borrar y haz clic en Borrar.
3. En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrarlo.

Elimina recursos de instructivos

1. Quita la configuración predeterminada de gcloud que agregaste durante la configuración del instructivo:

   gcloud config unset workflows/location

2. Borra el flujo de trabajo que se creó en este instructivo:

   gcloud workflows delete WORKFLOW_NAME

3. Borra un bucket y sus objetos creados en este instructivo:

   gcloud storage rm gs://BUCKET_NAME --recursive

   En el ejemplo anterior, BUCKET_NAME es el nombre del bucket que se borrará. Por ejemplo, my-bucket.

   La respuesta es similar al ejemplo a continuación:

   Removing gs://my-bucket/...

   Nota: Si tienes que borrar una gran cantidad de objetos en tus buckets, evita usar gcloud CLI, ya que la operación tarda mucho tiempo en completarse. En su lugar, usa la Google Cloud consola o la Administración del ciclo de vida de los objetos.

¿Qué sigue?

• Para obtener más información sobre Workflows, consulta Descripción de Workflows.
• Para obtener más información sobre la sintaxis de Workflows, consulta la referencia de sintaxis de Workflows.
• Para obtener más información sobre los conectores de Workflows, consulta Descripción de los conectores.