Comienza a usar Python

Implementa la app en App Engine

Google Cloud ofrece varias opciones para ejecutar tu código. Para este ejemplo, usa App Engine a fin de implementar una aplicación escalable en Google Cloud. Debido a que App Engine te libera de la necesidad de configurar implementaciones y administrar servidores, puedes enfocarte en escribir código. Además, App Engine cuenta con el ajuste de escala automático para admitir incrementos de tráfico repentinos.

runtime: python37

1. En la ventana de la terminal, implementa la app en App Engine con la CLI de gcloud:

   # on the command-line
   gcloud app deploy

2. En el navegador web, ingresa la siguiente URL:

   https://PROJECT_ID.REGION_ID.r.appspot.com

   Reemplaza lo siguiente:

   • PROJECT_ID: el ID del proyecto de Google Cloud
   • REGION_ID: un código que App Engine asigna a la app
   

Para obtener más información sobre la implementación en App Engine, consulta el entorno de ejecución de Python 3.

Almacena los datos con Firestore

No se puede almacenar información en tus instancias de App Engine porque se perderá si se reinicia la instancia, además de que no existirá cuando se creen instancias nuevas. En su lugar, debes usar una base de datos en la que todas tus instancias puedan realizar operaciones de lectura y escritura.

Google Cloud ofrece varias opciones para almacenar tus datos. En este ejemplo, usarás Firestore para almacenar los datos de cada libro. Firestore es una base de datos de documentos NoSQL, completamente administrada y sin servidores que te permite almacenar y consultar datos. Firestore escala de manera automática para cumplir las necesidades de tu aplicación y escala a cero cuando no la estás usando. Agrega el primer libro.

1. En el navegador web, ingresa la siguiente URL:

   https://PROJECT_ID.REGION_ID.r.appspot.com

   Reemplaza lo siguiente:

   • PROJECT_ID: el ID del proyecto de Google Cloud
   • REGION_ID: un código que App Engine asigna a la app

2. Para crear un libro en tu aplicación implementada, haz clic en Add book (Agregar libro).

   
3. En el campo Title, ingresa Moby Dick.
4. En el campo Author, ingresa Herman Melville.

5. Haz clic en Guardar. Ya tienes una entrada en la aplicación Bookshelf.

   
6. En Cloud Console, haz clic en Actualizar refresh para actualizar la página de Firestore. Los datos aparecen en Firestore. La aplicación Bookshelf almacena cada libro como un documento de Firestore con un ID único, y todos estos documentos se almacenan en una colección de Firestore. Para los propósitos de este instructivo, la colección se llama “books”.

Firestore almacena los libros mediante la biblioteca cliente de Firestore. Aquí hay un ejemplo de recuperación de un documento de Firestore:

from google.cloud import firestore

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

Para obtener más información sobre el uso de Firestore, consulta cómo agregar datos a Firestore.

Almacena archivos subidos en Cloud Storage

Ahora que agregaste un libro, es momento de agregar su imagen de portada. No puedes almacenar archivos en tus instancias. Una base de datos no es la opción correcta para archivos de imagen. En cambio, debes usar Cloud Storage.

Cloud Storage es el almacenamiento de BLOB principal de Google Cloud. Puedes usar Cloud Storage a fin de alojar elementos de aplicaciones que deseas compartir en Google Cloud. Para usar Cloud Storage, debes crear un bucket de Cloud Storage, un contenedor básico en el que se guardan tus datos.

1. En Cloud Console, ve a la página Navegador de Cloud Storage.

   Ir a la página Navegador de Cloud Storage

2. Haga clic en Crear bucket.
3. En el cuadro de diálogo Crear bucket, adjunta el ID del proyecto de Google Cloud a la string _bucket para ingresar un nombre del bucket, de manera que sea similar a YOUR_PROJECT_ID_bucket. Este nombre está sujeto a los requisitos de nombres de los buckets. En el resto de los campos, se pueden conservar los valores predeterminados.
4. Haga clic en Crear.
5. Una vez que se haya creado el bucket, debe permitirse el acceso público a los objetos para que puedan consultarlos los usuarios. Si quieres permitir el acceso público a tus objetos, consulta el artículo Haz públicos los datos.
6. Haz clic en Edit book y selecciona una imagen para subirla como la portada del libro. Por ejemplo, puedes usar esta imagen de dominio público:
   
7. Haz clic en Save. Se te redireccionará a la página principal, en la que encontrarás una entrada a la app de Bookshelf.
   

La aplicación de Bookshelf envía los archivos subidos a Cloud Storage a través de la biblioteca cliente de Cloud Storage.

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

Para obtener más información sobre cómo usar Cloud Storage, consulta la lista de guías prácticas.

Supervisa la app con Google Cloud's operations suite

Ya implementaste la app y creaste y modificaste libros. A fin de supervisar estos eventos para los usuarios, usa la administración del rendimiento de las aplicaciones.

Supervisa los registros con Cloud Logging

Supervisa los errores con Error Reporting

1. En Cloud Console, ve a la página Error Reporting.
   Ir a la página Error Reporting
   Error Reporting destaca los errores y las excepciones de la app y te permite configurar alertas basadas en ellos.
2. En el navegador, ve a la URL /errors de tu aplicación.
   

   https://PROJECT_ID.REGION_ID.r.appspot.com/errors

   Esto genera una nueva excepción de prueba y la envía al paquete de operaciones de Google Cloud.

3. En Cloud Console, regrese a la página de Error Reporting y podrá ver el error nuevo en unos instantes. Haz clic en Volver a cargar automáticamente para no tener que actualizar la página de forma manual.