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 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. Prendi nota e salva l'ID progetto per utilizzarlo con la tua 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 i primi 5 GB di spazio di archiviazione gratuitamente. Puoi attivare e utilizzare un altro bucket Cloud Storage. Il bucket predefinito include 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 ulteriori dettagli, consulta Prezzi, quote e limiti.
Per attivare il bucket Cloud Storage predefinito per la tua app:
Fai clic su Crea in Bucket Cloud Storage predefinito nella pagina Impostazioni di App Engine del progetto. Tieni presente il nome di questo bucket: ha il 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 progetto, rendendolo un bucket a pagamento. Ti verrà addebitato lo spazio di archiviazione oltre il limite di 5 GB.
Se vuoi attivare uno o più bucket a pagamento, segui le istruzioni riportate in Creare 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 relativi contenuti in Impostare le autorizzazioni del bucket e Impostare le autorizzazioni degli oggetti.
Scaricare la libreria client
Puoi scaricare la libreria client App Engine per Cloud Storage utilizzando strumenti comuni come pip
o Git. In alternativa, puoi scaricare manualmente la libreria da GitHub. Scegli il metodo che preferisci:
Git
Se hai installato Git, puoi clonare il repository GitHub per la libreria client Cloud Storage di App Engine come segue:
git clone https://github.com/googleapis/python-storage.git
pip
Puoi utilizzare pip
per installare la libreria client di Cloud Storage come segue:
pip install google-cloud-storage
Download manuale
Puoi scaricare un file ZIP contenente la libreria client 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 la sezione Utilizzare librerie di terze parti.
Utilizzo della libreria client con il server dell'app 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 il server dell'app 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 che stai utilizzando.Questo flag controlla il bucket che verrà restituito quando la tua 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 previste commissioni operative. Inoltre, le chiamate vengono conteggiate ai fini della quota di recupero degli URL poiché la libreria utilizza il servizio di recupero degli URL per interagire con Cloud Storage.
Tieni presente che Cloud Storage è un servizio a pagamento per utilizzo; ti verrà addebitato l'importo in base al listino prezzi di Cloud Storage.
Metodi alternativi per accedere a Cloud Storage
Anziché utilizzare la libreria client, puoi utilizzare quanto segue:
- Cloud Storage Browser nella console Google Cloud, utile per caricare rapidamente gli oggetti.
- gsutil, uno strumento a riga di comando per lavorare con i file in Cloud Storage.
Passaggi successivi
- Consulta la documentazione di riferimento dell'API.
- Scopri come leggere e scrivere in Cloud Storage con la libreria client App Engine per Cloud Storage.
- Esamina l'esempio di App Engine e Google Cloud Storage.
- Visualizza l'insieme completo della documentazione di Cloud Storage, inclusi altri esempi e tutorial.