Eseguire la migrazione dai servizi in bundle legacy

La maggior parte delle funzionalità fornite dai servizi in bundle legacy è ora fornita dalle librerie client di Cloud. Per saperne di più, consulta le alternative consigliate di seguito.

Se la migrazione a una soluzione non in bundle non è un'opzione per il tuo progetto, potresti continuare a utilizzare i servizi in bundle legacy nelle tue appPython 3 come soluzione di riserva. Questo approccio ti offre la flessibilità di passare ai servizi non in bundle in un secondo momento del ciclo di migrazione.

Dopo aver eseguito la migrazione dai servizi in bundle legacy, puoi continuare a utilizzare App Engine o eseguire la migrazione a Cloud Run. Cloud Run è progettato per migliorare l'esperienza di App Engine e incorpora molte delle migliori funzionalità sia dell'ambiente standard sia dell'ambiente flessibile. Per confrontare le funzionalità e capire come eseguire la migrazione, consulta la guida al confronto tra App Engine e Cloud Run.

Google Cloud fornisce prodotti autonomi che offrono funzionalità simili a quelle di alcuni dei servizi in bundle legacy nel runtime Python. Per i servizi in bundle legacy che non sono disponibili come prodotti separati in Google Cloud, come posta e messaggistica, questa guida consiglia fornitori di terze parti o altre soluzioni alternative.

Questa pagina presenta il percorso di migrazione per i servizi in bundle legacy.

Informazioni sulle autorizzazioni di Google Cloud

L'app di cui è stata eseguita la migrazione e i servizi Google Cloud che utilizza non vengono eseguiti nello stesso ambiente sandbox e l'app richiede l'autorizzazione per accedere a ciascun servizio. Ad esempio, per interagire con Firestore in modalità Datastore (Datastore) o Cloud Tasks, la tua app deve fornire le credenziali di un account autorizzato ad accedere a questi servizi.

Per impostazione predefinita, le app in esecuzione nell'ambiente standard di App Engine forniscono le credenziali per il service account App Engine predefinito, che è autorizzato ad accedere ai database nello stesso progetto della tua app.

Se una delle seguenti condizioni è vera, utilizza un metodo di autenticazione alternativo che fornisca esplicitamente le credenziali:

  • L'app e il database Memorystore si trovano in progettiGoogle Cloud diversi.

  • Hai modificato i ruoli assegnati al account di servizio App Engine predefinito.

Per informazioni sui metodi di autenticazione alternativi, consulta Configurazione dell'autenticazione per le applicazioni di produzione server-server.

Autenticazione per lo sviluppo locale

Per sviluppare o testare la tua app localmente, crea e utilizza un account di servizio. Non utilizzare il service account App Engine predefinito perché dispone di autorizzazioni ampie per il tuo progetto. Crea e utilizza invece un account di servizio con le autorizzazioni minime necessarie per le tue attività di sviluppo e test specifiche.

Per configurare un service account e collegarlo alla tua app, consulta Ottenere e fornire manualmente le credenziali dell'account di servizio.

Installazione delle librerie client

Per utilizzare i servizi Google Cloud da un'app Python, installa la libreria client Python per il servizio. I servizi Google Cloud forniscono anche API REST e altre interfacce.

Per installare una libreria client per il runtime Python 3:

  1. Aggiungi il nome della libreria al file requirements.txt dell'app. Ad esempio:

    google-cloud-ndb
    
  2. Esegui il deployment dell'app.

App Engine carica automaticamente tutte le librerie elencate nel file requirements.txt nel runtime Python 3.

Percorsi di migrazione per i servizi in bundle di App Engine

Archivio BLOB

Per archiviare e recuperare i dati, utilizza Cloud Storage tramite le librerie client di Cloud. Per iniziare, consulta Utilizzo di Cloud Storage e la guida Esegui la migrazione da Blobstore a Cloud Storage. Per simulare questa migrazione, aggiungi l'utilizzo di Blobstore a un'app di esempio ed esegui la migrazione a Cloud Storage.

Datastore

Se la tua app Python 2 utilizza NDB per interagire con Datastore, esegui la migrazione alla libreria Cloud NDB. Cloud NDB è destinato principalmente come strumento di transizione per la migrazione di app Python 2. Ti consigliamo di utilizzare la libreria client in modalità Datastore per le app Python 3.

Per maggiori dettagli, consulta Migrazione a Cloud NDB. Per simulare questa migrazione con un'app di esempio, consulta Migrazione da App Engine ndb a Cloud NDB.

Immagini

Per eseguire la migrazione del servizio Immagini di App Engine, esegui il deployment di un servizio di trasformazione delle immagini containerizzato in Cloud Run e indirizza le chiamate del servizio Immagini di App Engine a questo servizio. Per ospitare e pubblicare immagini, archiviale in un bucket Cloud Storage o distribuiscile utilizzando Cloud CDN. Per saperne di più, consulta Esegui la migrazione del servizio Images.

Logging

Ti consigliamo di aggiornare l'app per utilizzare Cloud Logging, che supporta funzionalità come la visualizzazione dei log in Esplora log, il download dei log, il filtro dei messaggi in base alla gravità e la correlazione dei messaggi dell'app con richieste specifiche. In alternativa, se preferisci la semplicità all'accuratezza dei dati, puoi scrivere log strutturati in stdout o stderr. Per saperne di più, consulta Scrittura e visualizzazione dei log e Migrazione a Cloud Logging.

Posta

Per migliorare la sicurezza delle email e garantire un recapito affidabile e ad alto volume, ti consigliamo di eseguire la migrazione dal servizio Mail legacy a un servizio email basato su SMTP, come SendGrid, Mailgun o Mailjet.

Memcache

Per memorizzare nella cache i dati dell'applicazione, utilizza Memorystore for Redis.

Per maggiori dettagli, vedi Esegui la migrazione di Memcache a Memorystore. Per simulare questa migrazione, aggiungi l'utilizzo di Memcache a un'app di esempio ed esegui la migrazione a Memorystore for Redis.

Per le app che utilizzano Memcache solo per ridurre la latenza per le richieste NDB (o Cloud NDB), utilizza il supporto integrato di Cloud NDB per Redis anziché Memcache o Memorystore for Redis.

Moduli

Per ottenere informazioni e modificare i servizi in esecuzione della tua applicazione, utilizza una combinazione di variabili di ambiente e dell'API App Engine Admin:

Informazioni sul servizio Come accedere
ID applicazione corrente Variabile di ambiente GAE_APPLICATION
ID progetto corrente Variabile di ambiente GOOGLE_CLOUD_PROJECT
Nome del servizio attuale Variabile di ambiente GAE_SERVICE
Versione attuale del servizio Variabile di ambiente GAE_VERSION
ID istanza attuale Variabile di ambiente GAE_INSTANCE
Nome host predefinito Metodo apps.get dell'API Admin
Elenco di servizi Metodo apps.services.list dell'API Admin
Elenco delle versioni di un servizio Metodo apps.services.versions.list dell'API Admin
Versione predefinita per un servizio, incluse eventuali suddivisioni del traffico Metodo apps.services.get dell'API Admin
Elenco delle istanze in esecuzione per una versione Metodo apps.services.versions.instances.list dell'API Admin

Per saperne di più sui dati disponibili relativi ai servizi in esecuzione della tua applicazione, consulta Ambiente di runtimePython 3.

Spazi dei nomi

L'API Namespaces consente alle app multi-tenant di partizionare i dati tra i tenant semplicemente specificando una stringa dello spazio dei nomi univoca per ogni tenant.

Mentre Datastore supporta direttamente la multitenancy, altri servizi Google Cloud no. Se la tua app multi-tenant utilizza altri servizi Google Cloud, dovrai gestire la multi-tenancy manualmente. Per avere istanze di servizi completamente isolate, puoi creare nuovi progetti in modo programmatico utilizzando l'API Cloud Resource Manager e accedere alle risorse tra i progetti.

OAuth

Anziché utilizzare il servizio OAuth di App Engine per verificare i token OAuth 2.0, utilizza il metodo oauth2.tokeninfo dell'API OAuth 2.0.

Ospita qualsiasi database di ricerca a testo intero, come Elasticsearch, su Compute Engine e accedi dal tuo servizio.

Coda di attività

Il servizio di coda di attività di App Engine è disponibile in due diverse modalità. La migrazione da uno dei due servizi porta a due diversi prodotti Cloud autonomi.

Attività push

Anziché utilizzare il servizio di push delle attività della coda di attività di App Engine per l'esecuzione di codice asincrona, esegui la migrazione a Cloud Tasks eseguendo l'upgrade dell'SDK dei servizi App Engine (senza rifattorizzare il codice dell'applicazione) o utilizzando le librerie client di Cloud Tasks con un endpoint dell'ambiente standard Python 3 come destinazione. Per confrontare le due opzioni, consulta la panoramica sulla migrazione delle code in modalità push a Cloud Tasks.

Per simulare questa migrazione con un'app di esempio, consulta Come utilizzare le code in modalità push di App Engine nelle app Flask e Migrazione a Cloud Tasks.

Attività pull

Se utilizzi il servizio di attività pull della coda di attività, ad esempio per mettere in coda attività o messaggi da elaborare da parte di worker separati, Cloud Pub/Sub può essere una buona alternativa. Offre funzionalità e garanzie di distribuzione simili. Come altri servizi Cloud, Pub/Sub fornisce comode librerie client per accedere al servizio. Per saperne di più, consulta Scrittura e risposta ai messaggi Pub/Sub e la guida alla migrazione Attività di pull della coda di attività in Pub/Sub.

Per simulare questa migrazione con un'app di esempio, consulta Come utilizzare le attività di pull di App Engine per un'app di esempio ed Esegui la migrazione a Pub/Sub.

Recupero URL

Per impostazione predefinita, il runtime Python 2.7 utilizza il servizio di recupero URL per gestire le richieste HTTP(S) in uscita, anche se utilizzi librerie Python standard per inviare queste richieste.

Se la tua app utilizza direttamente le API URL Fetch, ad esempio per effettuare richieste asincrone, ti consigliamo di eseguire la migrazione a una libreria Python standard come la libreria Requests.

Per saperne di più, consulta Migrazione delle richieste in uscita.

Autenticazione degli utenti

In alternativa all'API Users, utilizza uno dei meccanismi di autenticazione basati su HTTP descritti nella pagina Autenticazione utente.