Questo documento descrive come utilizzare le librerie client di Cloud per Cloud Storage nella tua app per archiviare e recuperare i dati
Prima di iniziare
- Segui le istruzioni in Configurazione dell'ambiente di sviluppo per configurare l'ambiente e il progetto e per capire come sono strutturate le app in App Engine. Annota e salva il tuo ID progetto, perché ti servirà per eseguire l'applicazione di esempio descritta in questo documento.
Assicurati di creare un bucket Cloud Storage per la tua applicazione richiamando il seguente comando:
gsutil mb gs://[YOUR_BUCKET_NAME]
Rendi il bucket leggibile pubblicamente in modo che possa pubblicare i file:
gsutil defacl set public-read gs://[YOUR_BUCKET_NAME]
Scarica l'esempio
Go
Per clonare il repository:
1.18 e versioni successive
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
cd golang-samples/appengine_flexible/storage
v1.15 e precedenti
git clone https://github.com/GoogleCloudPlatform/golang-samples.git
cd golang-samples/appengine_flexible/go115_and_earlier/storage
Java
Per clonare il repository:
versione 11/17
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
cd java-docs-samples/flexible/java-11/cloudstorage
versione 8
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
cd java-docs-samples/flexible/java-8/cloudstorage
Node.js
Per clonare il repository:
v18 e versioni successive
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples/
cd nodejs-docs-samples/appengine/storage/flexible
v16 e versioni precedenti
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples/
cd nodejs-docs-samples/appengine/storage/flexible_nodejs16_and_earlier
PHP
Per clonare il repository:
git clone https://github.com/GoogleCloudPlatform/php-docs-samples
cd php-docs-samples/appengine/flexible/storage
Python
Per clonare il repository:
3.8 e versioni successive
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
cd python-docs-samples/appengine/flexible/storage
3.7 e versioni precedenti
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
cd python-docs-samples/appengine/flexible_python37_and_earlier/storage
Ruby
Per clonare il repository:
Versione 3.2
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples
cd ruby-docs-samples/appengine/flexible/storage/
versione 3.1 e precedenti
git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples
cd ruby-docs-samples/appengine/flexible/ruby31-and-earlier/storage/
.NET
Scarica l'app di esempio ed estraila.
Se utilizzi la riga di comando, vai alla seguente directory dell'app:
versione 6 e successive
dotnet-docs-samples\appengine\flexible\CloudStorage\CloudStorage.Sample
versione 3.1 e precedenti
Utilizza il ramo
flex-dotnet3-and-earlier
.dotnet-docs-samples\appengine\flexible\CloudStorage
Per eseguire l'applicazione localmente, configura un account di servizio e scarica le credenziali:
Apri l'elenco di credenziali nella console Google Cloud.
Fai clic su Crea credenziali.
Seleziona Service account key (Chiave account di servizio).
Si apre la finestra Crea chiave account di servizio.
Fai clic sulla casella a discesa sotto Account di servizio, quindi fai clic su Account di servizio predefinito di Compute Engine.
Seleziona JSON come Tipo di chiave.
Fai clic su Crea.
Viene visualizzata la finestra Nuova chiave privata e la chiave privata viene scaricata automaticamente.
Fai clic su Chiudi.
Modifica la configurazione del progetto e installa le dipendenze
Go
In app.yaml
, imposta GCLOUD_STORAGE_BUCKET
. Questo valore è il nome del bucket Cloud Storage creato in precedenza.
1.18 e versioni successive
v1.15 e precedenti
Java
In app.yaml
, imposta BUCKET_NAME
sul Cloud Storage creato in precedenza per il progetto.
versione 11/17
versione 8
In pom.xml
, imposta com.google.cloud
come dipendenza e specifica google-cloud-storage
come artefactID della dipendenza. In questo modo vengono fornite le funzioni per utilizzare Cloud Storage.
versione 11/17
versione 8
Node.js
In app.yaml
, aggiungi l'ID progetto al valore dell'ambiente GOOGLE_CLOUD_PROJECT
. Quindi imposta il valore dell'ambiente GCLOUD_STORAGE_BUCKET
sul nome del bucket Cloud Storage creato in precedenza.
v18 e versioni successive
v16 e versioni precedenti
In package.json
, aggiungi @google-cloud/storage
come dipendenza, che fornisce le funzioni per utilizzare Cloud Storage.
v18 e versioni successive
v16 e versioni precedenti
Per istruzioni sull'esecuzione e sui test in locale, consulta il file README.md
.
PHP
In app.yaml
, imposta CLOUD_STORAGE_BUCKET
; questo valore è il nome del bucket Cloud Storage creato in precedenza.
In composer.json
, tieni presente che devi includere la libreria client Cloud, poiché questo fornisce le funzioni di Cloud Storage.
Python
In app.yaml
, imposta GOOGLE_STORAGE_BUCKET
; questo valore è il nome del bucket Cloud Storage creato in precedenza.
3.8 e versioni successive
3.7 e versioni precedenti
Tieni presente che in requirements.txt
devi includere la libreria google-cloud-storage
, perché in questo modo vengono fornite le funzioni di Cloud Storage.
3.8 e versioni successive
3.7 e versioni precedenti
Ruby
In app.yaml
, imposta GCLOUD_STORAGE_BUCKET
sul Cloud Storage creato in precedenza per il progetto.
Versione 3.2
versione 3.1 e precedenti
Tieni presente che per utilizzare le funzioni di Cloud Storage devi includere la libreria gcloud
in Gemfile
.
.NET
Configura quanto segue:
versione 6 e successive
Nel file app.yaml
, imposta TEST_GOOGLE_BUCKET_NAME
sul valore di Cloud Storage creato in precedenza per il progetto.
env_variables:
TEST_GOOGLE_BUCKET_NAME: [your-bucket-name]
versione 3.1 e precedenti
In appsettings.json
, imposta BucketName
; questo valore è il nome del bucket Cloud Storage creato in precedenza.
Codice dell'applicazione
Go
L'applicazione di esempio presenta una pagina web in cui viene chiesto all'utente di fornire un file da archiviare in Cloud Storage. Quando l'utente seleziona un file e fa clic su Invia, il gestore del caricamento scrive il file nel bucket Cloud Storage utilizzando la funzione NewWriter di Cloud Storage.
Tieni presente che per recuperare questo file da Cloud Storage, dovrai specificare il nome del bucket e il nome del file. Dovresti memorizzare questi valori nella tua app per usarli in futuro.
Java
L'applicazione di esempio presenta una pagina web in cui viene chiesto all'utente di fornire un file da archiviare in Cloud Storage. Quando l'utente seleziona un file e fa clic su Invia, il gestore delle richieste doPost
scrive il file nel bucket Cloud Storage utilizzando Storage.create
Tieni presente che per recuperare questo file da Cloud Storage, dovrai specificare il nome del bucket e il nome del file. Dovresti memorizzare questi valori nella tua app per usarli in futuro.
versione 11/17
versione 8
Node.js
L'applicazione di esempio presenta una pagina web in cui viene chiesto all'utente di fornire un file da archiviare in Cloud Storage. Quando l'utente seleziona un file e fa clic su Invia, il gestore del caricamento carica i contenuti del file in un blob e li scrive in Cloud Storage.
Tieni presente che, dopo che il file è stato caricato in Cloud Storage, viene restituito l'URL pubblico di questo file, che puoi utilizzare per pubblicare il file direttamente da Cloud Storage. Dovresti memorizzare questo valore nella tua app per uso futuro.
PHP
L'applicazione di esempio presenta una pagina web in cui viene chiesto all'utente di fornire un file da archiviare in Cloud Storage. Quando l'utente seleziona un file e fa clic su Invia, il gestore del caricamento carica i contenuti del file in un blob e li scrive in Cloud Storage.
Tieni presente che, dopo che il file è stato caricato in Cloud Storage, viene restituito l'URL pubblico di questo file, che puoi utilizzare per pubblicare il file direttamente da Cloud Storage. Dovresti memorizzare questo valore nella tua app per uso futuro.
Python
L'applicazione di esempio presenta una pagina web in cui viene chiesto all'utente di fornire un file da archiviare in Cloud Storage. Quando l'utente seleziona un file e fa clic su Invia, il gestore del caricamento carica i contenuti del file in un blob di Cloud Storage e li scrive nel bucket di Cloud Storage.
Tieni presente che, dopo che il file è stato caricato in Cloud Storage, viene restituito l'URL pubblico di questo file, che puoi utilizzare per pubblicare il file direttamente da Cloud Storage. Dovresti memorizzare questo valore nella tua app per uso futuro.
3.8 e versioni successive
3.7 e versioni precedenti
Ruby
L'applicazione di esempio presenta una pagina web in cui viene chiesto all'utente di fornire un file da archiviare in Cloud Storage. Quando l'utente seleziona un file e fa clic su Invia, il gestore del caricamento carica i contenuti del file in un blob e li scrive in Cloud Storage.
Tieni presente che, dopo che il file è stato caricato in Cloud Storage, viene restituito l'URL pubblico di questo file, che puoi utilizzare per pubblicare il file direttamente da Cloud Storage. Dovresti memorizzare questo valore nella tua app per uso futuro.
.NET
L'applicazione di esempio presenta una pagina web in cui viene chiesto all'utente di fornire un file da archiviare in Cloud Storage. Quando l'utente seleziona un file e fa clic su Invia, il gestore del caricamento carica i contenuti del file in un blob e li scrive in Cloud Storage.
Tieni presente che, dopo che il file è stato caricato in Cloud Storage, viene restituito l'URL pubblico di questo file, che puoi utilizzare per pubblicare il file direttamente da Cloud Storage. Dovresti memorizzare questo valore nella tua app per uso futuro.
versione 6 e successive
versione 3.1 e precedenti
Per maggiori informazioni
Per informazioni complete su Cloud Storage, consulta la documentazione di Cloud Storage.