Puoi utilizzare un bucket Cloud Storage per archiviare e pubblicare file, come filmati, immagini o altri contenuti statici. Questo documento descrive come configurare l'ambiente per utilizzare la libreria client di App Engine per Cloud Storage.
Configurazione del progetto in corso…
Crea un progetto Google Cloud e scopri come sono strutturate le app Python 2 in App Engine. Salva l'ID progetto per utilizzarlo con l'applicazione.
Attivazione di un bucket Cloud Storage
Per utilizzare Cloud Storage, devi attivare almeno un bucket. Ti consigliamo di utilizzare il bucket predefinito che fornisce gratuitamente i primi 5 GB di spazio di archiviazione. Puoi attivare e utilizzare un altro bucket Cloud Storage. Il bucket predefinito include i primi 5 GB di spazio di archiviazione gratuito. Il bucket predefinito include anche una quota gratuita per le operazioni di I/O di Cloud Storage. Consulta Prezzi, quote e limiti per ulteriori dettagli.
Per attivare il bucket Cloud Storage predefinito per la tua app:
Fai clic su Crea in Bucket Cloud Storage predefinito nella pagina Impostazioni App Engine relativa al progetto. Nota il nome di questo bucket: è nel formato
<project-id>.appspot.com
.Se hai bisogno di più spazio di archiviazione rispetto al limite di 5 GB, puoi aumentarlo abilitando la fatturazione per il tuo progetto, rendendolo un bucket a pagamento. Ti verrà addebitato lo spazio di archiviazione che supera il limite di 5 GB.
Se vuoi attivare uno o più bucket a pagamento, segui le istruzioni riportate nella sezione Creazione di un bucket per attivarli.
Impostazione delle autorizzazioni per bucket e oggetti
Puoi trovare informazioni su come consentire all'account di servizio della tua app o ad altri utenti di accedere al bucket di archiviazione e ai suoi contenuti in Impostare le autorizzazioni del bucket e Impostare le autorizzazioni degli oggetti.
Download della libreria client
Puoi scaricare la libreria client di App Engine per Cloud Storage utilizzando strumenti comuni come pip
o Git. In alternativa, puoi scaricare manualmente
la libreria da GitHub. Scegli il tuo metodo preferito:
Git
Se hai installato Git, puoi clonare il repository GitHub per la libreria client Cloud Storage di App Engine nel seguente modo:
git clone https://github.com/googleapis/python-storage.git
pip
Puoi utilizzare pip
per installare la libreria client di Cloud Storage nel seguente modo:
pip install google-cloud-storage
Download manuale
Puoi scaricare un file ZIP contenente la libreria client di App Engine per Cloud Storage da GitHub:
Installa la libreria nella directory che utilizzi per le librerie di terze parti,
come lib
. Per ulteriori informazioni, consulta Utilizzo di librerie di terze parti.
Utilizzo della libreria client con l'app server di sviluppo
Puoi utilizzare la libreria client con il server di sviluppo. Tuttavia, poiché non esiste un'emulazione locale di Cloud Storage, tutte le richieste di lettura e scrittura di file devono essere inviate tramite Internet a un bucket Cloud Storage effettivo.
Per utilizzare la libreria client con l'app server di sviluppo:
Esegui
dev_appserver.py
con il flag--default_gcs_bucket_name [BUCKET_NAME]
, sostituendo[BUCKET_NAME]
con il nome del bucket Cloud Storage in uso.Questo flag controlla il bucket che verrà restituito quando l'applicazione chiama
file.DefaultBucketName(ctx)
.
Prezzi, quote e limiti
Non sono previsti costi per la larghezza di banda associati alle chiamate a Cloud Storage dalla libreria client di App Engine. Tuttavia, sono previsti addebiti relativi alle operazioni. Inoltre, le chiamate vengono conteggiate ai fini della quota di recupero degli URL, poiché la libreria utilizza il servizio di recupero URL per interagire con Cloud Storage.
Cloud Storage è un servizio a pagamento e ti verrà addebitato in base al listino prezzi di Cloud Storage.
Metodi alternativi per accedere a Cloud Storage
Invece di utilizzare la libreria client, potresti utilizzare quanto segue:
- Il browser Cloud Storage nella console Google Cloud, utile per caricare rapidamente oggetti.
- gsutil, che è uno strumento a riga di comando per lavorare con i file in Cloud Storage.
Passaggi successivi
- Consulta la documentazione di riferimento API.
- Scopri come leggere e scrivere in Cloud Storage con la libreria client di App Engine per Cloud Storage.
- Esamina l'esempio di App Engine e Google Cloud Storage.
- Visualizza l'insieme completo della documentazione di Cloud Storage, che include esempi e tutorial aggiuntivi.