Esegui il deployment di un servizio Python in Cloud Run

Guida rapida: esegui il deployment di un servizio Python in Cloud Run

Esegui il deployment di un servizio Python in Cloud Run

Scopri come creare una semplice applicazione Hello World, pacchettizzarla in un'immagine container, caricare l'immagine container su Artifact Registry, quindi eseguire il deployment dell'immagine container in Cloud Run. Puoi usare altre lingue oltre a quelle mostrate.

---

Per seguire le istruzioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Procedura guidata:

Guidami

---

Prima di iniziare

1. 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 gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto e rimuovere tutte le risorse associate.

   Vai al selettore progetti

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

4. Installa Google Cloud CLI.

5. Per inizializzare l'interfaccia a riga di comando gcloud, esegui il comando seguente:

   gcloud init

   Nota: se hai installato lgcloud CLI in precedenza, assicurati di avere la versione più recente eseguendo gcloud components update.

6. Nella console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto e rimuovere tutte le risorse associate.

   Vai al selettore progetti

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

8. Installa Google Cloud CLI.

9. Per inizializzare l'interfaccia a riga di comando gcloud, esegui il comando seguente:

   gcloud init

   Nota: se hai installato lgcloud CLI in precedenza, assicurati di avere la versione più recente eseguendo gcloud components update.
10. Per impostare il progetto predefinito per il servizio Cloud Run:

     gcloud config set project PROJECT_ID

    Sostituisci PROJECT_ID con il nome del progetto che hai creato per questa guida rapida.

11. Se ti trovi in un criterio dell'organizzazione con limitazioni di dominio che limita le chiamate non autenticate per il tuo progetto, dovrai accedere al servizio di cui hai eseguito il deployment come descritto in Test dei servizi privati.

scrivi l'applicazione di esempio

Per scrivere un'applicazione in Python:

1. Crea una nuova directory denominata helloworld e cambia directory al suo interno:

   mkdir helloworld
   cd helloworld
   

2. Crea un file denominato main.py e incolla il seguente codice al suo interno:

   run/helloworld/main.py

   Visualizza su GitHub Feedback

   import os
   
   from flask import Flask
   
   app = Flask(__name__)
   
   @app.route("/")
   def hello_world():
       """Example Hello World route."""
       name = os.environ.get("NAME", "World")
       return f"Hello {name}!"
   
   if __name__ == "__main__":
       app.run(debug=True, host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))

   Questo codice risponde alle richieste con il nostro saluto "Hello World". La gestione HTTP viene eseguita da un server web Gunicorn nel container. Quando viene richiamato direttamente per l'uso in locale, questo codice crea un server web di base che ascolta la porta definita dalla variabile di ambiente PORT.

3. Crea un file denominato requirements.txt e incolla il seguente codice al suo interno:

   run/helloworld/requirements.txt

   Visualizza su GitHub Feedback

   Flask==3.0.0
   gunicorn==20.1.0
   Werkzeug==3.0.1
   

   In questo modo vengono aggiunti i pacchetti necessari all'esempio.

L'app è stata completata ed è pronta per il deployment.

Esegui il deployment su Cloud Run dall'origine

Importante:questa guida rapida presuppone che tu disponga dei ruoli di proprietario o editor nel progetto che stai utilizzando per la guida rapida. In caso contrario, consulta Autorizzazioni per il deployment di Cloud Run, Autorizzazioni Cloud Build e Autorizzazioni di Artifact Registry per conoscere le autorizzazioni necessarie.

Il deployment dal codice sorgente crea automaticamente un'immagine container dal codice sorgente e ne esegue il deployment.

Per eseguire il deployment dall'origine:

1. Nella directory del codice sorgente, esegui il deployment dal codice sorgente utilizzando questo comando:

   gcloud run deploy

   Se ti viene richiesto di abilitare l'API, rispondi y per abilitarla.

   1. Quando ti viene chiesta la posizione del codice sorgente, premi Invio per eseguire il deployment della cartella attuale.

   2. Quando ti viene chiesto il nome del servizio, premi Invio per accettare il nome predefinito, ad esempio helloworld.

   3. Se ti viene chiesto di abilitare l'API Artifact Registry o di consentire la creazione del repository Artifact Registry, rispondi premendo y.

   4. Quando ti viene chiesto di specificare la regione: seleziona l'area geografica di tua scelta, ad esempio us-central1.

   5. Ti verrà chiesto di consentire le chiamate non autenticate: rispondi y .

   Quindi, attendi qualche istante fino al completamento del deployment. In caso di esito positivo, la riga di comando visualizza l'URL del servizio.

2. Per visitare il servizio di cui hai eseguito il deployment, apri l'URL del servizio in un browser web.

Località di Cloud Run

Cloud Run è a livello di regione, il che significa che l'infrastruttura che esegue i servizi Cloud Run si trova in una regione specifica ed è gestita da Google per essere disponibile in modo ridondante in tutte le zone all'interno di quella regione.

Soddisfare i requisiti di latenza, disponibilità o durabilità sono fattori principali per selezionare la regione in cui vengono eseguiti i servizi Cloud Run. In genere, puoi selezionare la regione più vicina ai tuoi utenti, ma ti consigliamo di prendere in considerazione la località degli altri prodotti Google Cloud utilizzati dal servizio Cloud Run. L'utilizzo dei prodotti Google Cloud insieme in più località può influire sulla latenza e sui costi del tuo servizio.

Cloud Run è disponibile nelle seguenti regioni:

Soggetto ai prezzi di Livello 1

• asia-east1 (Taiwan)
• asia-northeast1 (Tokyo)
• asia-northeast2 (Osaka)
• europe-north1 (Finlandia) Bassi livelli di CO₂
• europe-southwest1 (Madrid)
• europe-west1 (Belgio) Bassi livelli di CO₂
• europe-west4 (Paesi Bassi)
• europe-west8 (Milano)
• europe-west9 (Parigi) A basse emissioni di CO₂
• me-west1 (Tel Aviv)
• us-central1 (Iowa) A basse emissioni di CO₂
• us-east1 (Carolina del Sud)
• us-east4 (Virginia del Nord)
• us-east5 (Colombo)
• us-south1 (Dallas)
• us-west1 (Oregon) Bassi livelli di CO₂

Soggetto ai prezzi di Livello 2

• asia-east2 (Hong Kong)
• asia-northeast3 (Seul, Corea del Sud)
• asia-southeast1 (Singapore)
• asia-southeast2 (Giacarta)
• asia-south1 (Mumbai, India)
• asia-south2 (Delhi, India)
• australia-southeast1 (Sydney)
• australia-southeast2 (Melbourne)
• europe-central2 (Varsavia, Polonia)
• europe-west10 (Berlino)
• europe-west12 (Torino)
• europe-west2 (Londra, Regno Unito) A basse emissioni di CO₂
• europe-west3 (Francoforte, Germania) A basse emissioni di CO₂
• europe-west6 (Zurigo, Svizzera) A basse emissioni di CO₂
• me-central1 (Doha)
• me-central2 (Dammam)
• northamerica-northeast1 (Montreal) A basse emissioni di CO₂
• northamerica-northeast2 (Toronto) A basse emissioni di CO₂
• southamerica-east1 (San Paolo, Brasile) A basse emissioni di CO₂
• southamerica-west1 (Santiago, Cile) A basse emissioni di CO₂
• us-west2 (Los Angeles)
• us-west3 (Salt Lake City)
• us-west4 (Las Vegas)

Se hai già creato un servizio Cloud Run, puoi visualizzare la regione nella dashboard di Cloud Run nella console Google Cloud.

OK

Complimenti! Hai appena eseguito il deployment di un'immagine container dal codice sorgente a Cloud Run. Cloud Run esegue lo scale out automatico e orizzontale dell'immagine container per gestire le richieste ricevute, per poi fare lo scale in quando la domanda diminuisce. Paghi solo per la CPU, la memoria e il networking utilizzati durante la gestione delle richieste.

Esegui la pulizia

Rimuovi il progetto di test

Sebbene Cloud Run non addebiti i costi quando il servizio non è in uso, è possibile che ti vengano comunque addebitati l'archiviazione dell'immagine container in Artifact Registry. Puoi eliminare l'immagine container o il tuo progetto Google Cloud per evitare addebiti. L'eliminazione del progetto Google Cloud interrompe la fatturazione per tutte le risorse utilizzate all'interno del 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à in questo documento, quando lo elimini elimini anche qualsiasi altro lavoro 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.
1. Nella console Google Cloud, vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

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

Passaggi successivi

Per saperne di più sulla creazione di un container da un codice sorgente di codice e sul push a un repository, consulta:

• Sviluppo dei servizi Cloud Run
• Creazione di container
• Deployment da codice sorgente