Inizia a utilizzare PHP

Esecuzione del deployment dell'app in Cloud Run

Cloud de Confiance offre diverse opzioni per l'esecuzione del codice. In questo esempio, esegui il deployment della tua app scalabile in Cloud Run. Cloud Run non richiede la gestione dei server e scala automaticamente per supportare i picchi di traffico.

1. Esegui il deployment del container in Cloud Run:

   gcloud run deploy bookshelf --region us-central1 --allow-unauthenticated \
   --set-env-vars="GOOGLE_CLOUD_PROJECT=PROJECT_ID" --source .

   La tua app è ora visualizzabile all'URL mostrato nell'output di gcloud run:

   Service [bookshelf] revision [bookshelf-00001] has been deployed and is serving 100 percent of traffic. 
   Service URL: https://bookshelf-swsmmh5s5a-uc.a.run.app
   

2. Copia l'URL nel browser web per visualizzare l'app.

Per saperne di più sul deployment in Cloud Run, consulta la documentazione di Cloud Run.

Rendi persistenti i dati con Firestore

Non puoi archiviare informazioni sulle istanze di Cloud Run poiché vengono perse al riavvio dell'istanza e non esistono quando vengono create nuove istanze. Puoi, invece, utilizzare un database in cui tutte le istanze eseguono operazioni di lettura e scrittura.

Cloud de Confiance offre diverse opzioni per l'archiviazione dei dati. In questo esempio viene utilizzato Firestore per archiviare i dati di ogni libro. Firestore è un database di documenti NoSQL serverless completamente gestito che consente di archiviare i dati e di eseguire query su di essi. Firestore si ridimensiona automaticamente per soddisfare le esigenze dell'app, con una scalabilità fino a zero quando non la utilizzi. Aggiungi il tuo primo libro.

1. Per creare un libro per l'applicazione di cui hai eseguito il deployment, fai clic su Add book (Aggiungi libro).

   
2. Nel campo Title (Titolo), inserisci Moby Dick.
3. Nel campo Author (Autore), inserisci Herman Melville.

4. Fai clic su Save (Save). Adesso esiste una voce nell'applicazione Bookshelf.

   
5. Nella console Cloud de Confiance , per aggiornare la pagina Firestore, fai clic su Aggiorna refresh. I dati vengono visualizzati in Firestore. L'app Bookshelf archivia ogni libro come un documento Firestore con un ID univoco e tutti questi documenti vengono archiviati in una raccolta Firestore. Ai fini di questo tutorial, la raccolta è chiamata "books" (libri).

Firestore archivia i libri utilizzando la libreria client di Firestore. Ecco un esempio di come recuperare un documento Firestore:

// Use the client library to call Firestore
use Google\Cloud\Firestore\FirestoreClient;

$firestore = new FirestoreClient([
    'projectId' => $projectId,
]);
$collection =  $firestore->collection($collectionName);

$bookRef = $collection->document($bookId);
$snapshot = $bookRef->snapshot();

Per ulteriori informazioni sull'utilizzo di Firestore, consulta la pagina relativa all'aggiunta di dati a Firestore.

Archivia i file caricati in Cloud Storage

Dopo aver aggiunto un libro, devi aggiungere la rispettiva immagine di copertina. Non puoi archiviare i file nelle istanze. Un database non è la scelta giusta per i file immagine. Utilizza, invece, Cloud Storage.

Cloud Storage è l'archivio blob principale per Cloud de Confiance. Puoi utilizzare Cloud Storage per ospitare gli asset per app che vuoi condividere su Cloud de Confiance. Per utilizzare Cloud Storage, devi creare un bucket Cloud Storage, un container di base in cui conservare i tuoi dati.

1. Nella console Cloud de Confiance , vai alla pagina Browser Cloud Storage.

   Vai alla pagina Browser Cloud Storage

2. Fai clic su Crea bucket.
3. Nella finestra di dialogo Crea bucket, inserisci un nome per il bucket aggiungendo l'ID progetto Cloud de Confiance alla stringa _bucket in modo che il nome sia simile a YOUR_PROJECT_ID_bucket. Questo nome è soggetto ai requisiti per i nomi dei bucket. Puoi lasciare invariati i valori predefiniti di tutti gli altri campi.
4. Fai clic su Crea.
5. Una volta creato il bucket, gli oggetti devono essere resi accessibili pubblicamente per poter essere visualizzati dagli utenti. Per rendere gli oggetti accessibili pubblicamente, consulta la pagina Rendere pubblici i dati.
6. Fai clic su Edit book (Modifica libro) e seleziona un'immagine da caricare come copertina del libro. Ad esempio, puoi utilizzare questa immagine di dominio pubblico:
   
7. Fai clic su Save (Salva). Viene visualizzata la home page, dove è presente una voce per la tua app Bookshelf.
   

L'app Bookshelf invia i file caricati a Cloud Storage utilizzando la libreria client di Cloud Storage.

// Use the client library to call Cloud Storage
use Google\Cloud\Storage\StorageClient;

$storage = new StorageClient([
    'projectId' => $projectId,
]);
$bucketId = $projectId . '_bucket';
$gcsBucket = $storage->bucket($bucketId);

Per saperne di più sull'utilizzo di Cloud Storage, consulta l'introduzione a Cloud Storage.

Monitora la tua app utilizzando Google Cloud Observability

Hai eseguito il deployment dell'app e hai creato e modificato i libri. Per monitorare questi eventi per i tuoi utenti, utilizza gestione delle prestazioni delle applicazioni (APM).

Monitorare i log con Cloud Logging

1. In Cloud de Confiance, vai a Esplora log

   Vai a Esplora log

   Puoi monitorare l'app in tempo reale. Se hai problemi con la tua app, questo è uno dei primi posti in cui cercare.

   
2. Nell'elenco a discesa Risorsa, seleziona Revisione Cloud Run, Bookshelf.

Monitora gli errori con Error Reporting

1. Nella console Cloud de Confiance , vai alla pagina Error Reporting.
   Vai alla pagina Error Reporting
   Error Reporting evidenzia gli errori e le eccezioni nella tua app e ti consente di configurare i relativi avvisi.
2. Nel browser, accedi all'URL /errors nell'applicazione
   .

   YOUR_CLOUD_RUN_URL/errors

   In questo modo viene generata una nuova eccezione di test che viene inviata a Google Cloud Observability.

3. Nella console Cloud de Confiance , torna alla pagina Error Reporting. Dopo qualche istante, il nuovo errore sarà visibile. Fai clic su Ricaricamento automatico per non dover aggiornare manualmente la pagina.