Utilizzo di Cloud Storage

Punto chiave: questa pagina descrive come utilizzare le API consigliate per Cloud Storage, che si trovano Libreria client di Google Cloud: Queste API consentono l'esecuzione del codice in App Engine e in altri ambienti che supportare PHP 5.

Le app PHP 5 possono continuare a utilizzare la versione API di App Engine, ma queste app possono essere eseguite solo in App Engine e dovranno eseguire l'upgrade alle API consigliate prima di poter eseguire la migrazione ai runtime di App Engine più recenti.

Se l'app PHP 5 ha bisogno di leggere e scrivere file durante il runtime, o pubblicare file come filmati, immagini o altri contenuti statici, ti consigliamo utilizza un bucket Cloud Storage.

App Engine crea un bucket predefinito quando crei un'app. Questo bucket fornisce i primi 5 GB di spazio di archiviazione gratuitamente e include una per le operazioni di Cloud Storage I/O. 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 Cloud Storage da un'app App Engine:

1. Visualizzare i nomi dei bucket esistenti nel tuo progetto App Engine. Dovrai specificare questi nomi quando caricare o scaricare dati da Cloud Storage.

   Ti consigliamo di archiviare i nomi dei tuoi bucket Cloud Storage Nelle variabili di ambiente della tua app anziché doverli codificare nella tua app.

2. Nella tua app, dichiara Cloud Storage come dipendenza aggiungendo google/cloud-storage al file composer.json della tua app ed eseguendo composer install dalla directory dell'app. Scopri di più su composer.

3. Registra Google\Cloud\Storage\StorageClient come un wrapper stream per la tua app. quindi utilizza il protocollo gs per leggere e scrivere i file.

   Guarda un esempio di registrazione e utilizzo dello stream wrapper.

   In alternativa, puoi utilizzare direttamente la libreria client di Google Cloud.

Utilizzo del bucket predefinito

Quando crei un'app, App Engine crea un bucket predefinito offre gratuitamente i primi 5 GB di spazio di archiviazione. Il bucket predefinito include anche una quota gratuita per le operazioni di Cloud Storage I/O. Consulta Prezzi, quote e limiti per maggiori dettagli. Potrai se supera il limite di 5 GB non ti verrà addebitato alcun importo.

Il nome del bucket predefinito ha il seguente formato:

project-id.appspot.com

App Engine crea anche un bucket che utilizza per di archiviazione quando esegue il deployment di nuove versioni dell'app. Questo bucket, denominato staging.project-id.appspot.com, è destinato all'uso da parte di App Engine. Le app non possono interagire con questo bucket.

Impostazione delle autorizzazioni per bucket e oggetti

L'account di servizio associato alla tua app richiede le autorizzazioni di lettura e scrivere nei bucket del tuo progetto. Per sapere quali autorizzazioni sono richieste, vedi Ruoli IAM per Cloud Storage.

In genere, l'account di servizio associato alla tua app è l'account predefinito Servizio App Engine Google Cloud.

A seconda della configurazione dei criteri dell'organizzazione, l'account di servizio predefinito potrebbe automaticamente il ruolo Editor progetto. Ti consigliamo vivamente di disabilitare la concessione automatica del ruolo entro il giorno applicazione del criterio dell'organizzazione iam.automaticIamGrantsForDefaultServiceAccounts di blocco. Se hai creato la tua organizzazione dopo il 3 maggio 2024, viene applicato per impostazione predefinita.

Se disabiliti la concessione automatica del ruolo, devi decidere quali ruoli concedere a quelli predefiniti account di servizio e poi concedi ruoli.

Se l'account di servizio predefinito ha già il ruolo Editor, ti consigliamo di sostituire il valore Ruolo Editor con ruoli meno permissivi. Per modificare in modo sicuro i ruoli dell'account di servizio, utilizza il Simulatore di criteri per vedere l'impatto dei la modifica e quindi concedere e revocare ruoli appropriati.

Per informazioni su come consentire ad altri utenti, app o progetti di accedere a un bucket e i suoi contenuti, vedi Impostare le autorizzazioni del bucket e Impostazione delle autorizzazioni per gli 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 di Cloud Storage devono essere inviate tramite internet a un del bucket Cloud Storage effettivo.

Prezzi, quote e limiti

Non sono previsti costi per la larghezza di banda associati alla libreria client di Cloud Storage a Cloud Storage. Tuttavia, ci sono costi operativi. Inoltre, le chiamate vengono conteggiate ai fini Quota di recupero degli URL poiché la libreria utilizza il servizio di recupero URL per interagire con Cloud Storage.

Tieni presente che Cloud Storage è un servizio a pagamento; ti verrà addebitato un costo in Cloud Storage listino prezzi.