Questa pagina è stata tradotta dall'API Cloud Translation.

Esegui il deployment di una versione di base di "Google Traduttore" app su Python 2 Cloud Run (Docker)

1. Panoramica

Questa serie di codelab (tutorial pratici e autogestiti) mira ad aiutare gli sviluppatori a comprendere le varie opzioni a disposizione per il deployment delle loro applicazioni. In questo codelab, imparerai a utilizzare l'API Google Cloud Translation con Python e a eseguirla localmente o a eseguire il deployment su una piattaforma di computing serverless di Cloud (App Engine, Cloud Functions o Cloud Run). È possibile eseguire il deployment dell'app di esempio presente nel repository di questo tutorial (almeno) otto in modi diversi, apportando solo modifiche minime alla configurazione:

Server Flask locale (Python 2)
Server Flask locale (Python 3)
App Engine (Python 2)
App Engine (Python 3)
Cloud Functions (Python 3)
Cloud Run (Python 2 tramite Docker)
Cloud Run (Python 3 tramite Docker)
Cloud Run (Python 3 tramite Cloud Buildpacks)

Questo codelab è incentrato sul deployment di questa app nelle piattaforme in grassetto riportate sopra.

Imparerai a

Usa le API Google Cloud, in particolare l'API Cloud Translation (avanzata/v3)
Esegui un'applicazione web di base in locale o eseguine il deployment su una piattaforma di computing serverless Cloud

Che cosa ti serve

Un progetto Google Cloud con un account di fatturazione Cloud attivo.
Flask installato per l'esecuzione in locale o una piattaforma di computing severless di Cloud abilitata per i deployment basati su cloud
Competenze Python di base
Conoscenza pratica dei comandi di base del sistema operativo

Sondaggio

Come utilizzerai questo tutorial?

Leggilo e completa gli esercizi

Sola lettura

Come valuteresti la tua esperienza con Python?

Principiante

Livello intermedio

Eccellente

Come giudichi la tua esperienza di utilizzo dei servizi Google Cloud?

Principiante

Livello intermedio

Eccellente

2. Configurazione e requisiti

Configurazione dell'ambiente da seguire in modo autonomo

Accedi alla console Google Cloud e crea un nuovo progetto o riutilizzane uno esistente. Se non hai ancora un account Gmail o Google Workspace, devi crearne uno.

Il Nome progetto è il nome visualizzato dei partecipanti del progetto. Si tratta di una stringa di caratteri non utilizzata dalle API di Google e può essere aggiornata in qualsiasi momento.
L'ID progetto deve essere univoco in tutti i progetti Google Cloud ed è immutabile (non può essere modificato dopo essere stato impostato). La console Cloud genera automaticamente una stringa univoca. di solito non ti importa cosa sia. Nella maggior parte dei codelab, devi fare riferimento all'ID progetto (che solitamente è identificato come PROJECT_ID), quindi, se non ti piace, generane un altro a caso oppure puoi fare un tentativo personalizzato e controllare se è disponibile. Poi c'è "congelato" dopo la creazione del progetto.
C'è un terzo valore, il numero di progetto, utilizzato da alcune API. Scopri di più su tutti e tre questi valori nella documentazione.

Successivamente, dovrai abilitare la fatturazione nella console Cloud per utilizzare le risorse/le API Cloud. Eseguire questo codelab non dovrebbe costare molto. Per arrestare le risorse in modo da non incorrere in fatturazione oltre questo tutorial, segui eventuali "pulizie" istruzioni riportate alla fine del codelab. I nuovi utenti di Google Cloud sono idonei al programma prova senza costi di 300$.

3. Abilita API Translation

Abilitazione delle API Cloud

In questa sezione scoprirai come abilitare le API di Google in generale. Per la nostra app di esempio, abiliterai l'API Cloud Translation, Cloud Run e Cloud Artifact Registry.

Introduzione

Indipendentemente dall'API di Google che vuoi utilizzare nell'applicazione, queste devono essere abilitate. L'esempio seguente mostra due modi per abilitare l'API Cloud Vision. Dopo aver imparato ad abilitare un'API Cloud, potrai abilitare altre API perché il processo è simile.

Opzione 1: da Cloud Shell o dall'interfaccia a riga di comando

Sebbene l'abilitazione delle API dalla console Cloud sia più comune, alcuni sviluppatori preferiscono eseguire tutte le operazioni dalla riga di comando. Per farlo, devi cercare il "nome del servizio" di un'API. Sembra un URL: SERVICE_NAME.googleapis.com. Puoi trovarli nel grafico dei prodotti supportati oppure puoi eseguire query in modo programmatico con l'API Google Discovery.

Grazie a queste informazioni, utilizzando Cloud Shell (o il tuo ambiente di sviluppo locale in cui è installato lo strumento a riga di comando gcloud installato), puoi abilitare un'API nel seguente modo:

gcloud services enable SERVICE_NAME.googleapis.com

Ad esempio, questo comando abilita l'API Cloud Vision:

gcloud services enable vision.googleapis.com

Questo comando abilita App Engine:

gcloud services enable appengine.googleapis.com

Puoi anche abilitare più API con una singola richiesta. Ad esempio, questa riga di comando abilita Cloud Run, Cloud Artifact Registry e l'API Cloud Translation:

gcloud services enable artifactregistry.googleapis.com run.googleapis.com translate.googleapis.com

Opzione 2: dalla console Cloud

Puoi anche abilitare l'API Vision nel gestore API. Dalla console Cloud, vai a Gestore API e seleziona Libreria.

Se vuoi abilitare l'API Cloud Vision, inizia a inserire "vision" nella barra di ricerca e tutto ciò che corrisponde a quanto inserito verrà visualizzato:

Seleziona l'API che vuoi abilitare e fai clic su Abilita:

Costo

Anche se molte API di Google possono essere utilizzate senza costi, l'uso dei prodotti Google Cloud e Le API non sono senza costi. Quando abiliti le API Cloud, ti potrebbe essere richiesto di creare un account di fatturazione attivo. È tuttavia importante notare che alcuni prodotti Google Cloud dispongono di un'autorizzazione " Always Free" livello (giornaliero/mensile), che devi superare per incorrere in addebiti; in caso contrario, non verrà effettuato alcun addebito sulla tua carta di credito (o sullo strumento di fatturazione specificato).

Prima di abilitarla, gli utenti devono fare riferimento alle informazioni sui prezzi di qualsiasi API, soprattutto se si tratta di un livello senza costi e, in tal caso, di cosa si tratta. Se abiliti l'API Cloud Vision, consulta la pagina delle informazioni sui prezzi. Cloud Vision ha una quota senza costi e, se rimani entro i suoi limiti in forma aggregata (entro ogni mese), non ti verrà addebitato alcun costo.

I prezzi e i livelli senza costi variano tra le API di Google. Esempi:

Google Cloud/Google Cloud: ogni prodotto viene fatturato in modo diverso e in genere paga in base al ciclo di vCPU, al consumatore di archiviazione, all'utilizzo della memoria o al pagamento in base al consumo. consulta le informazioni sui livelli senza costi riportate sopra.
Google Maps: include una suite di API e offre agli utenti un totale di 200$di credito mensile senza costi.
API di Google Workspace (in precedenza G Suite): offrono un utilizzo senza costi (fino a determinati limiti) coperto dalla tariffa di abbonamento mensile a Workspace, quindi non è prevista alcuna fatturazione diretta per l'utilizzo delle API Gmail, Google Drive, Calendar, Documenti, Fogli e Presentazioni.

I vari prodotti Google vengono fatturati in modo diverso, quindi assicurati di fare riferimento alla documentazione dell'API per queste informazioni.

Riepilogo

Ora che sai come abilitare le API di Google in generale, vai al Gestore API e abilita l'API Cloud Translation, Cloud Run e Cloud Artifact Registry (se non l'hai già fatto). Attiva la prima perché la nostra applicazione la utilizza. Puoi abilitare la seconda opzione perché è qui che vengono archiviate le nostre immagini container prima di eseguirne il deployment per avviare il servizio Cloud Run. Per questo motivo devi abilitare questo. Se preferisci abilitarli tutti con lo strumento gcloud, esegui il comando seguente dal terminale:

gcloud services enable artifactregistry.googleapis.com run.googleapis.com translate.googleapis.com

Sebbene la sua quota mensile non figura nell'elenco complessivo di " Always Free" della pagina di riepilogo dei livelli, la pagina dei prezzi dell'API Translation indica che tutti gli utenti ricevono un numero fisso di caratteri tradotti al mese. Se rimani al di sotto di questa soglia, non dovresti ricevere alcun addebito dall'API. Eventuali altri addebiti relativi a Google Cloud verranno discussi alla fine della sezione "Pulizia" .

4. recupera il codice dell'app di esempio

Clona il codice nel repository in locale o in Cloud Shell (utilizzando il comando git clone) oppure scarica il file ZIP dal relativo pulsante Codice verde, come mostrato nello screenshot seguente:

Ora che hai tutto, crea una copia completa della cartella per seguire questo specifico tutorial, perché probabilmente dovrai eliminare o modificare i file. Se vuoi eseguire un deployment diverso, puoi ricominciare copiando l'originale in modo da non doverlo clonare o scaricarlo di nuovo.

5. Tour dell'app di esempio

L'app di esempio è una semplice derivata di Google Traduttore che chiede agli utenti di inserire il testo in inglese e di ricevere la traduzione equivalente di quel testo in spagnolo. Ora apri il file main.py per vedere come funziona. Se ometti le righe commenti sulla licenza, l'aspetto avrà il seguente aspetto in alto e in basso:

from flask import Flask, render_template, request
import google.auth
from google.cloud import translate

app = Flask(__name__)
_, PROJECT_ID = google.auth.default()
TRANSLATE = translate.TranslationServiceClient()
PARENT = 'projects/{}'.format(PROJECT_ID)
SOURCE, TARGET = ('en', 'English'), ('es', 'Spanish')

# . . . [translate() function definition] . . .

if __name__ == '__main__':
    import os
    app.run(debug=True, threaded=True, host='0.0.0.0',
            port=int(os.environ.get('PORT', 8080)))

Le importazioni includono la funzionalità Flask, il modulo google.auth e la libreria client dell'API Cloud Translation.
Le variabili globali rappresentano l'app Flask, l'ID progetto Cloud, il client dell'API Translation, il "percorso di località" padre per le chiamate API Translation e le lingue di origine e di destinazione. In questo caso, la lingua è inglese (en) e spagnolo (es), ma puoi modificare questi valori in altri codici lingua supportati dall'API Cloud Translation.
Il blocco if grande in basso viene utilizzato nel tutorial per l'esecuzione di questa app in locale e utilizza il server di sviluppo Flask per gestire la nostra app. Questa sezione è disponibile anche per i tutorial sul deployment di Cloud Run nel caso in cui il server web non sia integrato nel container. Ti viene chiesto di abilitare il raggruppamento del server nel container, ma se non lo ricordi, il codice dell'app utilizza il server di sviluppo Flask. Non si tratta di un problema con App Engine o Cloud Functions perché sono piattaforme basate sulla fonte, il che significa che Google Cloud fornisce ed esegue un server web predefinito.

Infine, al centro di main.py c'è il cuore dell'applicazione, la funzione translate():

@app.route('/', methods=['GET', 'POST'])
def translate(gcf_request=None):
    """
    main handler - show form and possibly previous translation
    """

    # Flask Request object passed in for Cloud Functions
    # (use gcf_request for GCF but flask.request otherwise)
    local_request = gcf_request if gcf_request else request

    # reset all variables (GET)
    text = translated = None

    # if there is data to process (POST)
    if local_request.method == 'POST':
        text = local_request.form['text']
        data = {
            'contents': [text],
            'parent': PARENT,
            'target_language_code': TARGET[0],
        }
        # handle older call for backwards-compatibility
        try:
            rsp = TRANSLATE.translate_text(request=data)
        except TypeError:
            rsp = TRANSLATE.translate_text(**data)
        translated = rsp.translations[0].translated_text

    # create context & render template
    context = {
        'orig':  {'text': text, 'lc': SOURCE},
        'trans': {'text': translated, 'lc': TARGET},
    }
    return render_template('index.html', **context)

La funzione principale si occupa di acquisire l'input dell'utente e chiamare l'API Translation per svolgere il lavoro pesante. Analizziamola nel dettaglio:

Verifica se le richieste provengono da Cloud Functions utilizzando la variabile local_request. Cloud Functions invia il proprio oggetto Flask Request, mentre tutti gli altri (in esecuzione in locale o con deployment in App Engine o Cloud Run) ricevono l'oggetto di richiesta direttamente da Flask.
Reimposta le variabili di base per il modulo. Ciò è principalmente per le richieste GET, poiché le richieste POST avranno dati che le sostituiranno.
Se si tratta di un POST, recupera il testo da tradurre e crea una struttura JSON che rappresenti il requisito dei metadati dell'API. Quindi chiama l'API, tornando a una versione precedente se l'utente utilizza una libreria precedente.
Indipendentemente da ciò, formatta i risultati effettivi (POST) o nessun dato (GET) nel contesto del modello ed eseguine il rendering.

La parte visiva dell'applicazione si trova nel file index.html modello. Mostra tutti i risultati tradotti in precedenza (altrimenti vuoti) seguiti dal modulo in cui viene chiesto qualcosa da tradurre:

<!doctype html>
<html><head><title>My Google Translate 1990s</title><body>
<h2>My Google Translate (1990s edition)</h2>

{% if trans['text'] %}
    <h4>Previous translation</h4>
    <li><b>Original</b>:   {{ orig['text'] }}  (<i>{{ orig['lc'][0] }}</i>)</li>
    <li><b>Translated</b>: {{ trans['text'] }} (<i>{{ trans['lc'][0] }}</i>)</li>
{% endif %}

<h4>Enter <i>{{ orig['lc'][1] }}</i> text to translate to <i>{{ trans['lc'][1] }}</i>:</h4>
<form method="POST"><input name="text"><input type="submit"></form>
</body></html>

6. Esegui il deployment del servizio

Ora è tutto pronto per il deployment del tuo servizio di traduzione in Cloud Run eseguendo questo comando:

gcloud run deploy translate --source . --allow-unauthenticated --platform managed

L'output dovrebbe avere il seguente aspetto e fornire alcuni prompt per i passaggi successivi:

$ gcloud run deploy translate --source . --allow-unauthenticated --platform managed
Please specify a region:
 [1] asia-east1
 [2] asia-east2
. . . (other regions) . . .
 [28] us-west4
 [29] cancel
Please enter your numeric choice:  REGION_CHOICE

To make this the default region, run `gcloud config set run/region REGION`.

Deploying from source requires an Artifact Registry repository to
store build artifacts. A repository named [cloud-run-source-deploy] in
 region [REGION] will be created.

Do you want to continue (Y/n)?

This command is equivalent to running "gcloud builds submit --pack image=[IMAGE] ." and "gcloud run deploy translate --image [IMAGE]"

Building . . . and deploying container to Cloud Run service [translate] in project [PROJECT_ID] region [REGION]
✓ Building and deploying... Done.
  ✓ Creating Container Repository...
  ✓ Uploading sources...
  ✓ Building Container... Logs are available at [https://console.cloud.google.com/cloud-build/builds/60e1b
  9bb-b991-4b4e-8d8a-HASH?project=PROJECT_NUMBER].
  ✓ Creating Revision...
  ✓ Routing traffic...
  ✓ Setting IAM Policy...
Done.
Service [translate] revision [translate-00001-xyz] has been deployed and is serving 100 percent of traffic.
Service URL: https://SVC_NAME-HASH-REG_ABBR.a.run.app

Ora che la tua app è disponibile in tutto il mondo, dovresti essere in grado di raggiungerla all'URL contenente il tuo ID progetto, come mostrato nell'output del deployment:

Traduci qualcosa per vederlo funzionare.

7. Conclusione

Complimenti! Hai imparato ad abilitare l'API Cloud Translation, ottenere le credenziali necessarie ed eseguire il deployment di una semplice app web in Cloud Run per Python 2. Puoi scoprire di più su questo deployment in questa tabella nel repository.

Esegui la pulizia

L'API Cloud Translation consente di eseguire senza costi una quantità fissa di caratteri tradotti al mese. App Engine ha inoltre una quota senza costi, e lo stesso vale per Cloud Functions e Cloud Run. In caso di superamento di una delle due opzioni, ti vengono addebitati dei costi. Se prevedi di continuare con il codelab successivo, non dovrai chiudere la tua app.

Tuttavia, se non vuoi ancora andare al tutorial successivo o temi che internet rilevi l'app di cui hai appena eseguito il deployment, disattiva l'app di App Engine, elimina la funzione Cloud Functions o disabilita il servizio Cloud Run per evitare addebiti. Quando vuoi passare al codelab successivo, puoi riabilitarlo. Se invece non intendi continuare con questa applicazione o con altri codelab e vuoi eliminare completamente tutto, puoi chiudere il progetto.

Inoltre, il deployment su una piattaforma di serverless computing di Google Cloud comporta costi minori di creazione e archiviazione. Cloud Build e Cloud Storage hanno una quota senza costi specifica. Per una maggiore trasparenza, Cloud Build crea l'immagine della tua applicazione, che viene quindi archiviata in Cloud Container Registry o in Artifact Registry, il suo successore. L'archiviazione dell'immagine utilizza parte della quota, così come il traffico in uscita dalla rete durante il trasferimento dell'immagine al servizio. Tuttavia, potresti risiedere in una regione che non ha un livello senza costi, quindi tieni presente l'utilizzo dello spazio di archiviazione per ridurre al minimo i costi potenziali.

8. Risorse aggiuntive

Nelle sezioni che seguono troverai materiale di lettura aggiuntivo ed esercizi consigliati per migliorare le conoscenze acquisite con il completamento di questo tutorial.

Studio aggiuntivo

Ora che hai una certa esperienza con l'API Translation, eseguiamo alcuni esercizi aggiuntivi per sviluppare ulteriormente le tue competenze. Per continuare il tuo percorso di apprendimento, modifica la nostra app di esempio:

Completa tutte le altre versioni di questo codelab per l'esecuzione locale o il deployment su piattaforme di serverless computing di Google Cloud (consulta README del repository).
Completa questo tutorial utilizzando un altro linguaggio di programmazione.
Cambia questa applicazione in modo che supporti lingue di origine o di destinazione diverse.
Esegui l'upgrade di questa applicazione per poter tradurre il testo in più lingue. modifica il file del modello in modo da visualizzare un elenco a discesa delle lingue di destinazione supportate.

Scopri di più

Google App Engine

Google Cloud Functions

Google Cloud Run

Buildpack di Google Cloud, Container Registry, Artifact Registry

Google Cloud Translation e Google ML Kit

Altri prodotti/pagine Google Cloud

Python e Flask

Fiocco

Licenza

Questo tutorial è concesso in licenza ai sensi di una licenza Creative Commons Attribution 2.0 Generic, mentre il codice sorgente nel repository è concesso in licenza secondo Apache 2.