Deploy your app to Cloud Run

Google Cloud offersseveral options for running your code. For thisexample, you useCloud Runto deploy a scalable app to Google Cloud. Cloud Run doesn't require you to manage servers and automatically scales to support traffic spikes.

1. Use Cloud Build to build a Docker container and publish to Container Registry:
   

   gcloud builds submit --tag gcr.io/PROJECT_ID/bookshelf .

   ReplacePROJECT_ID with the Google Cloud project ID that you created.

2. Run the container with Cloud Run:

   gcloud run deploy bookshelf --image gcr.io/PROJECT_ID/bookshelf \--platform managed --region us-central1 --allow-unauthenticated

   Your app is now viewable at the URL displayed in the output ofgcloud run:

   Service[bookshelf]revision[bookshelf-00001]hasbeendeployedandisserving100percentoftraffic.ServiceURL:https://bookshelf-swsmmh5s5a-uc.a.run.app

3. Copy the URL into your web browser to view the app.

   

   Note: This SSL-protected domain is created automatically, andis useful for development. You canset up a custom domain with Cloud Run as well.

For more information on deploying to Cloud Run, see theCloud Run documentation.

Persist your data with Firestore

You cannot store information on your Cloud Run instances, because itis lost if the instance is restarted, and doesn't exist when newinstances are created. Instead, you use a database that all your instancesread from and write to.

Google Cloud offersseveral options for storing your data. In thisexample, you use Firestore to store the data for each book.Firestore is a fully managed, serverless, NoSQL documentdatabase that lets you store and query data. Firestoreauto scales to meet your app needs, and scales to zero when you're not using it.Add your first book now.

1. To create a book for your deployed app, clickAdd book.

   
2. In theTitle field, enterMoby Dick.
3. In theAuthor field, enterHerman Melville.

4. ClickSave. There is now an entry to your Bookshelf app.

   
5. In the Google Cloud console, to refresh the Firestore page, clickRefreshrefresh.The data appears in Firestore. The Bookshelf app stores each bookas aFirestore documentwith a unique ID, and all these documents are stored in aFirestore collection.For the purposes of this tutorial, the collection is called books.

Firestore stores the books by using theFirestore Client Library.Here is an example of fetching a Firestore document:

fromgoogle.cloudimportfirestore

db=firestore.Client()book_ref=db.collection(u'Book').document(book_id)snapshot=book_ref.get()

For more information on using Firestore, seeAdding data to Firestore.

Store file uploads in Cloud Storage

Now that you've added a book, it's time to add the book cover image. You cannotstore files on your instances. A database isn't the right choice for image files. Instead, you use Cloud Storage.

Cloud Storage is the primaryblob store for Google Cloud. You can use Cloud Storage tohost app assets that you want to share across Google Cloud. To useCloud Storage, you need to create aCloud Storage bucket,a basic container to hold your data.

1. In the Google Cloud console, go to theCloud Storage Browser page.

   Go to the Cloud Storage Browser page

2. ClickCreate bucket.
3. In theCreate bucket dialog, enter a name for your bucket by appending your Google Cloud project ID to the string_bucket so the name looks likeYOUR_PROJECT_ID_bucket. This name is subject to thebucket name requirements. All other fields can remain at their default values.
4. ClickCreate.
5. After your bucket is created, objects must be made publicly accessible to be viewed by users. Tomake your objects publicly accessible seeMaking Data Public.
6. ClickEdit book, and select animage to upload as your book's cover. For example, you can use this publicdomain image:
   
7. ClickSave. You're redirected to thehomepage, where there is an entry to your Bookshelf app.
   

The bookshelf app sends uploaded files to Cloud Storage by using theCloud Storage Client Library.

client=storage.Client()bucket=client.bucket(bucketname)blob=bucket.blob(filename)blob.upload_from_string(file_stream,content_type=content_type)# Ensure the file is publicly readable.blob.make_public()url=blob.public_url

For more information on using Cloud Storage, see theCloud Storage introduction.

Monitor your app using Google Cloud Observability

You've deployed your app and created and modified books. To monitor these events for your users,use Application Performance Management.

Monitor logs with Cloud Logging

1. In the Google Cloud, go to theLogs Explorer

   Go to Logs Explorer

   You can monitor your app in real time. If you have any issues with your app,this is one of the first places to look.

   
2. In theResource drop-down list, selectCloud Run Revision, bookshelf.

Monitor errors with Error Reporting

1. In the Google Cloud console, go to theError Reporting page.
   Go to Error Reporting page
   Error Reporting highlights errors and exceptions in your app andlets you set up alerting around them.
2. In your browser, go to the/errors URL in your app.
   

   YOUR_CLOUD_RUN_URL/errors

   This generates a new test exception and sends it to Google Cloud Observability.

3. In the Google Cloud console, return to theError Reporting page, and in a few moments thenew error is visible. ClickAuto Reload so you don'tneed to manually refresh the page.