Utilizzo di Cloud Storage

Se l'app Python 3 deve leggere e scrivere file durante il runtime o pubblicare file come filmati, immagini o altri contenuti statici, ti consigliamo di utilizzare un bucket Cloud Storage.

App Engine crea un bucket predefinito quando crei un'app. Questo bucket fornisce gratuitamente i primi 5 GB di spazio di archiviazione e include una quota gratuita per le operazioni di I/O di Cloud Storage. Puoi creare altri bucket Cloud Storage, ma solo il bucket predefinito include i primi 5 GB di spazio di archiviazione gratuito.

Uso di Cloud Storage con App Engine

Per utilizzare un bucket di Cloud Storage da un'app App Engine:

  1. Visualizza i nomi dei bucket esistenti nel progetto App Engine. Dovrai specificare questi nomi quando carichi o scarichi i dati da Cloud Storage.

    Ti consigliamo di archiviare i nomi dei bucket di Cloud Storage nelle variabili di ambiente dell'app, anziché hardcoded nell'app.

  2. Nella tua app, dichiara Cloud Storage come dipendenza aggiungendo google-cloud-storage al file requirements.txt dell'app. Scopri di più sulla specifica delle dipendenze.

  3. Utilizza la libreria client di Google Cloud per caricare o scaricare i dati dai tuoi bucket.

    Per informazioni sulla pubblicazione di contenuti statici, consulta Archiviazione e pubblicazione di file statici.

Utilizzo del bucket predefinito

Quando crei un'app, App Engine crea un bucket predefinito che offre gratuitamente i primi 5 GB di spazio di archiviazione. Il bucket predefinito include anche una quota gratuita per le operazioni di I/O di Cloud Storage. Per i dettagli, consulta Prezzi, quote e limiti. Ti verrà addebitato lo spazio di archiviazione oltre il limite di 5 GB.

Il nome del bucket predefinito è nel seguente formato:

project-id.appspot.com

App Engine crea anche un bucket che utilizza per l'archiviazione temporanea quando esegue il deployment di nuove versioni dell'app. Questo bucket, denominato staging.project-id.appspot.com, può essere utilizzato solo da App Engine. Le app non possono interagire con questo bucket.

Impostazione delle autorizzazioni per bucket e oggetti

L'account di servizio predefinito associato alla tua app dispone di tutte le autorizzazioni necessarie per leggere e scrivere nei bucket del tuo progetto.

Per gestire queste autorizzazioni, ogni app App Engine utilizza un account di servizio predefinito che fornisce accesso completo in lettura e scrittura ai bucket Cloud Storage nello stesso progetto dell'app. Puoi modificare le autorizzazioni dell'account di servizio predefinito, ma la tua app potrebbe perdere l'accesso a meno che non assegni un ruolo IAM con le autorizzazioni richieste.

Per informazioni su come consentire ad altri utenti, app o progetti di accedere a un bucket e ai suoi contenuti, consulta le sezioni Impostare le autorizzazioni dei bucket e Impostare le autorizzazioni degli oggetti.

Utilizzo di Cloud Storage con il server di sviluppo locale

Il server di sviluppo locale di App Engine non emula Cloud Storage, quindi tutte le richieste Cloud Storage devono essere inviate tramite Internet a un bucket Cloud Storage effettivo.

Prezzi, quote e limiti

Non sono previsti costi per la larghezza di banda associati alle chiamate delle librerie client di Cloud Storage a Cloud Storage. Tuttavia, sono previsti costi operativi. Inoltre, le chiamate incidono sulla quota di recupero degli URL poiché la libreria utilizza il servizio di recupero URL per interagire con Cloud Storage.

Nota: Cloud Storage è un servizio a pagamento; l'addebito viene effettuato in base al listino prezzi di Cloud Storage.