Esegui una traduzione batch utilizzando il connettore Cloud Translation

Questo tutorial mostra come creare un flusso di lavoro che utilizza il connettore dell'API Cloud Translation per tradurre file in altre lingue in modalità batch asincrona. In questo modo, l'output viene generato in tempo reale durante l'elaborazione degli input.

Obiettivi

In questo tutorial, imparerai a:

1. Crea un bucket Cloud Storage di input.
2. Crea due file in inglese e caricali nel bucket di input.
3. Crea un flusso di lavoro che utilizzi il connettore dell'API Cloud Translation per tradurre i due file in francese e spagnolo e salva i risultati in un bucket di output.
4. Esegui il deployment ed esegui il workflow per orchestrare l'intero processo.

Costi

In questo documento vengono utilizzati i seguenti componenti fatturabili di Google Cloud:

• Cloud Storage
• Translation
• Workflows

Per generare una stima dei costi in base all'utilizzo previsto, utilizza il calcolatore prezzi.

I nuovi utenti di Google Cloud potrebbero avere diritto a una prova senza costi.

Prima di iniziare

I vincoli di sicurezza definiti dalla tua organizzazione potrebbero impedirti di completare i passaggi seguenti. Per informazioni sulla risoluzione dei problemi, vedi Sviluppare applicazioni in un ambiente Google Cloud vincolato.

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Creare un progetto Google Cloud :

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .

Attiva le API Cloud Storage, Translation e Workflows:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

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

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Creare un progetto Google Cloud :

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .

Attiva le API Cloud Storage, Translation e Workflows:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

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

1. Aggiorna i componenti gcloud:

   gcloud components update

2. Accedi utilizzando il tuo account:

   gcloud auth login

3. Imposta la località predefinita utilizzata in questo tutorial:

   gcloud config set workflows/location us-central1

   Poiché questo tutorial utilizza il modello AutoML Translation predefinito che si trova in us-central1, devi impostare la località su us-central1.

   Se utilizzi un modello AutoML Translation o un glossario diverso da quello predefinito, assicurati che si trovi nella stessa posizione della chiamata al connettore; in caso contrario, viene restituito un errore INVALID_ARGUMENT (400). Per i dettagli, consulta il metodo batchTranslateText.

Crea un bucket Cloud Storage di input e i file

Puoi utilizzare Cloud Storage per archiviare oggetti. Gli oggetti sono dati immutabili costituiti da un file di qualsiasi formato e vengono archiviati in contenitori chiamati bucket.

1. Crea un bucket Cloud Storage per contenere i file da tradurre:

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

2. Crea due file in inglese e caricali nel bucket di input:

   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}

Esegui il deployment del workflow ed eseguilo

Un workflow è costituito da una serie di passaggi descritti utilizzando la sintassi di Workflows, che può essere scritta in formato YAML o JSON. Questa è la definizione di workflow. Dopo aver creato un workflow, esegui il deployment per renderlo disponibile per l'esecuzione.

1. Crea un file di testo con il nome file workflow.yaml e il seguente contenuto:

   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

   Il flusso di lavoro assegna le variabili, crea un bucket di output e avvia la traduzione dei file, salvando i risultati nel bucket di output.

2. Dopo aver creato il workflow, esegui il deployment:

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

3. Esegui il workflow:

   gcloud workflows execute batch-translation

4. Per visualizzare lo stato del flusso di lavoro, puoi eseguire il comando restituito. Ad esempio:

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

   Il flusso di lavoro dovrebbe essere ACTIVE. Dopo alcuni minuti, i file tradotti (in francese e spagnolo) vengono caricati nel bucket di output.

Elenca gli oggetti nel bucket di output

Per verificare che il workflow abbia funzionato come previsto, elenca gli oggetti nel bucket di output.

1. Recupera il nome del bucket di output:

   gcloud storage ls

   L'output è simile al seguente:

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

2. Elenca gli oggetti nel bucket di output:

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

   Dopo alcuni minuti, vengono elencati i file tradotti, due per ciascuna lingua (francese e spagnolo).

Esegui la pulizia

Se hai creato un nuovo progetto per questo tutorial, eliminalo. Se hai utilizzato un progetto esistente e vuoi conservarlo senza le modifiche aggiunte in questo tutorial, elimina le risorse create per il tutorial.

Elimina il progetto

Il modo più semplice per eliminare la fatturazione è eliminare il progetto creato per il tutorial.

Per eliminare il progetto:

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per, le attività descritte in questo documento, eliminerai anche tutto il lavoro che hai svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. Nella console Google Cloud , vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona quello che vuoi eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID progetto, quindi fai clic su Chiudi per eliminare il progetto.

Elimina le risorse del tutorial

1. Rimuovi la configurazione predefinita di gcloud che hai aggiunto durante la configurazione del tutorial:

   gcloud config unset workflows/location

2. Elimina il flusso di lavoro creato in questo tutorial:

   gcloud workflows delete WORKFLOW_NAME

3. Elimina un bucket e i relativi oggetti creati in questo tutorial:

   gcloud storage rm gs://BUCKET_NAME --recursive

   Dove BUCKET_NAME è il nome del bucket da eliminare. Ad esempio, my-bucket.

   La risposta è simile alla seguente:

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

   Nota: se devi eliminare un numero elevato di oggetti nei bucket, evita di utilizzare gcloud CLI, poiché l'operazione richiede molto tempo per essere completata. Utilizza invece la console Google Cloud o la gestione del ciclo di vita degli oggetti.

Passaggi successivi

• Per scoprire di più su Workflows, consulta la sezione Comprendere Workflows.
• Per saperne di più sulla sintassi di Workflows, consulta il riferimento alla sintassi di Workflows.
• Per saperne di più sui connettori di Workflows, consulta Informazioni sui connettori.