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 comprendere come sono strutturate le app in App Engine. Annota e salva l'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 gestire i file:
gsutil defacl set public-read gs://[YOUR_BUCKET_NAME]
Scarica l'esempio
Go
Per clonare il repository:
v1.18 e 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 successive
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples/
cd nodejs-docs-samples/appengine/storage/flexible
v16 e 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:
v3.8 e successive
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
cd python-docs-samples/appengine/flexible/storage
v3.7 e 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, passa 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 in locale, configura un account di servizio e scarica le credenziali:
Apri l'elenco delle credenziali nella console Google Cloud.
Fai clic su Crea credenziali.
Seleziona 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 Compute Engine.
Seleziona JSON per Tipo di chiave.
Fai clic su Crea.
Viene visualizzata la finestra Nuova chiave privata e la relativa 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.
v1.18 e successive
v1.15 e precedenti
Java
In app.yaml
, imposta BUCKET_NAME
sul valore Cloud Storage che hai creato in precedenza per il tuo progetto.
versione 11/17
versione 8
In pom.xml
, imposta com.google.cloud
come dipendenza e specifica google-cloud-storage
come ArtifactID per la dipendenza. In questo modo vengono fornite le funzioni per utilizzare Cloud Storage.
versione 11/17
versione 8
Node.js
In app.yaml
, aggiungi il tuo ID progetto al valore dell'ambiente GOOGLE_CLOUD_PROJECT
. Imposta quindi il valore di ambiente GCLOUD_STORAGE_BUCKET
sul nome del bucket Cloud Storage creato in precedenza.
v18 e successive
v16 e precedenti
In package.json
, aggiungi @google-cloud/storage
come dipendenza, che
fornisce le funzioni per utilizzare Cloud Storage.
v18 e successive
v16 e precedenti
Consulta il file README.md
per le istruzioni sull'esecuzione e sui test in locale.
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 di Cloud,
perché 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.
v3.8 e successive
v3.7 e precedenti
In requirements.txt
, tieni presente che devi includere la libreria google-cloud-storage
, perché fornisce le funzioni di Cloud Storage.
v3.8 e successive
v3.7 e precedenti
Ruby
In app.yaml
, imposta GCLOUD_STORAGE_BUCKET
sul valore Cloud Storage che hai creato in precedenza per il tuo progetto.
Versione 3.2
versione 3.1 e precedenti
Tieni presente che devi includere la libreria gcloud
in Gemfile
per utilizzare le funzioni di Cloud Storage.
.NET
Configura quanto segue:
versione 6 e successive
Nel file app.yaml
, imposta TEST_GOOGLE_BUCKET_NAME
sul valore 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 di 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, devi specificare il nome del bucket e il nome del file. Dovresti archiviare questi valori nella tua app per un uso 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 di richieste doPost
scrive il file nel bucket Cloud Storage utilizzando Storage.create
Tieni presente che per recuperare questo file da Cloud Storage, devi specificare il nome del bucket e il nome del file. Dovresti archiviare questi valori nella tua app per un uso 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 di caricamento carica i contenuti del file in un blob e li scrive in Cloud Storage.
Tieni presente che, dopo il caricamento del file in Cloud Storage, viene restituito l'URL pubblico di questo file, che puoi utilizzare per pubblicare il file direttamente da Cloud Storage. Devi archiviare questo valore nella tua app per un 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 di caricamento carica i contenuti del file in un blob e li scrive in Cloud Storage.
Tieni presente che, dopo il caricamento del file in Cloud Storage, viene restituito l'URL pubblico di questo file, che puoi utilizzare per pubblicare il file direttamente da Cloud Storage. Devi archiviare questo valore nella tua app per un 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 di caricamento carica i contenuti del file in un blob di Cloud Storage e li scrive nel bucket di Cloud Storage.
Tieni presente che, dopo il caricamento del file in Cloud Storage, viene restituito l'URL pubblico di questo file, che puoi utilizzare per pubblicare il file direttamente da Cloud Storage. Devi archiviare questo valore nella tua app per un uso futuro.
v3.8 e successive
v3.7 e 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 di caricamento carica i contenuti del file in un blob e li scrive in Cloud Storage.
Tieni presente che, dopo il caricamento del file in Cloud Storage, viene restituito l'URL pubblico di questo file, che puoi utilizzare per pubblicare il file direttamente da Cloud Storage. Devi archiviare questo valore nella tua app per un 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 di caricamento carica i contenuti del file in un blob e li scrive in Cloud Storage.
Tieni presente che, dopo il caricamento del file in Cloud Storage, viene restituito l'URL pubblico di questo file, che puoi utilizzare per pubblicare il file direttamente da Cloud Storage. Devi archiviare questo valore nella tua app per un 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.