Este instructivo está destinado a aquellos que estén comenzando a compilar aplicaciones en la nube, como ingenieros y desarrolladores web, que quieran aprender conceptos clave del desarrollo de aplicaciones y cómo aprovecharlos en Cloud de Confiance by S3NS.
Objetivos
- Aprender sobre las herramientas básicas de Cloud de Confiance , como la Cloud de Confiance consola y
gcloud. - Implementar tu app en Cloud Run.
- Almacenar tus datos con Firestore
- Almacenar archivos subidos en Cloud Storage.
- Supervisar tu app con Google Cloud Observability
Costos
En este documento, usarás los siguientes componentes facturables de Cloud de Confiance by S3NS:
Las instrucciones de este documento están diseñadas para que el uso de los recursos se mantenga dentro de los límites del nivel Siempre gratuito de Cloud de Confiance's.
Cuando completes las tareas que se describen en este documento, podrás borrar los recursos que creaste para evitar que se te siga facturando. Para obtener más información, consulta Realiza una limpieza.
Antes de comenzar
-
In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Cloud de Confiance project.
-
Para crear una base de datos de Firestore en modo nativo, sigue los pasos a continuación:
-
En la Cloud de Confiance consola, ve a la página Crear base de datos de Firestore.
- Desde la pantalla Selecciona un modo de Cloud Firestore, haz clic en Seleccionar modo nativo.
- Selecciona una ubicación para tu base de datos de Firestore. Esta configuración corresponde a la ubicación Cloud de Confiance de recursos predeterminada para tu Cloud de Confiance proyecto . La configuración de la ubicación se usa en los Cloud de Confiance servicios de tu Cloud de Confiance proyecto de que la requieren; en particular, el bucket predeterminado de Cloud Storage y la aplicación de Cloud Run.
- Haz clic en Crear base de datos.
-
En la Cloud de Confiance consola, ve a la página Crear base de datos de Firestore.
-
Habilita las APIs de Cloud Run Admin, Cloud Storage, Cloud Logging y Error Reporting.
Roles necesarios para habilitar las APIs
Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (
roles/serviceusage.serviceUsageAdmin), que contiene el permisoserviceusage.services.enable. Obtén más información para otorgar roles. -
Clona el repositorio de muestra y abre la aplicación de muestra en Cloud Shell:
Ir a Cloud ShellCloud Shell brinda acceso de línea de comandos a los Cloud de Confiance recursos de tu proyecto directamente desde el navegador.
- En el mensaje para clonar el repositorio, haz clic en Confirmar.
-
En Cloud Shell, configura la herramienta de
gcloudpara que use tu proyecto nuevo Cloud de Confiance de la siguiente manera:# Configure gcloud for your project gcloud config set project PROJECT_ID
Reemplaza PROJECT_ID con el Cloud de Confiance ID del proyecto que creaste con la Cloud de Confiance consola.
La CLI de Google Cloud es la forma principal en la que interactúas con tus Cloud de Confiance recursos de desde la línea de comandos. En este instructivo, usarás la herramienta
gcloudpara implementar y supervisar tu aplicación.
Ejecuta tu app
- Si ya usas Cloud Shell y lo configuraste para usar Java 11, actualiza las alternativas de Java de shell,
JAVA_HOMEy las variables de entornoPATHpara especificar Java 8. -
Cambia al directorio
bookshelf/1-cloud-runy ejecuta la aplicación, con el siguiente comando: ReemplazaGOOGLE_CLOUD_PROJECT=PROJECT_ID mvn -Plocal clean jetty:run-exploded
PROJECT_IDpor el ID del Cloud de Confiance proyecto que creaste. - En Cloud Shell, haz clic en Vista previa en la Web , y selecciona Vista previa en el puerto 8080. Se abrirá una ventana nueva con tu app en ejecución.
Implementa tu app en Cloud Run
Cloud de Confiance ofrece varias opciones para ejecutar tu código. Para este ejemplo, usa Cloud Run a fin de implementar una app escalable en Cloud de Confiance. Cloud Run no requiere que administres servidores ni se escala de forma automática para admitir los aumentos de tráfico.
Sigue las instrucciones en Implementa tu app en Cloud Run.
Cuando la implementación se realiza de forma correcta, se muestra un extremo de la app que se ejecuta en Cloud Run en el siguiente formato:
https://bookshelf-abcdefghij-uc.a.run.app
Tu app ya se puede visualizar en este enlace, que de ahora en más se llamará YOUR_CLOUD_RUN_URL. En tu navegador web, ingresa la URL para ver la app.

Almacenar tus datos con Firestore
No se puede almacenar información en tus instancias de Cloud Run porque se perderá si se reinicia la instancia, además de que no existirá cuando se creen instancias nuevas. En su lugar, usarás una base de datos en la que todas tus instancias puedan leer y escribir.
Cloud de Confiance 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.
- En tu navegador web, ve a YOUR_CLOUD_RUN_URL.
-
Si deseas crear un libro para la app implementada, haz clic en Add book.
- En el campo Title, ingresa
Moby Dick. - En el campo Author, ingresa
Herman Melville. -
Haz clic en Save. Ya tienes una entrada en la aplicación Bookshelf.
-
En la Cloud de Confiance consola, 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:
Para obtener más información sobre el uso de Firestore, consulta cómo agregar datos a Firestore.
Almacenar 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 Cloud de Confiance. Puedes usar Cloud Storage a fin de alojar elementos de aplicaciones que deseas compartir en Cloud de Confiance. Para usar Cloud Storage, debes crear un bucket de Cloud Storage, un contenedor básico en el que se guardan tus datos.
- En la Cloud de Confiance consola, ve a la página Navegador de Cloud Storage.
- Haz clic en Crear bucket.
- En el cuadro de diálogo Crear bucket, adjunta el
Cloud de Confiance ID del proyecto a la cadena
_bucketpara ingresar un nombre del bucket, de manera que sea similar aYOUR_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. - Haz clic en Crear.
- 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.
-
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:
-
Haz clic en Save. Se te redireccionará a la
página principal, en la que encontrarás una entrada a la app Bookshelf.
La app de Bookshelf envía los archivos subidos a Cloud Storage a través de la biblioteca cliente de Cloud Storage.
Si quieres obtener más información para usar Cloud Storage, consulta la introducción a Cloud Storage.
Supervisa tu app con Google Cloud Observability
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
-
En la Cloud de Confiance, ve al Explorador de registros
Ir al Explorador de registrosPuedes supervisar tu app en tiempo real. Si tienes problemas con tu app, este es uno de los primeros lugares que consultar.
- En la lista desplegable Recursos, selecciona Revisión de Cloud Run, bookshelf.
Controla los errores con Error Reporting
-
En la Cloud de Confiance consola, 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. -
En el navegador, ve a la URL
/errorsde la app.
YOUR_CLOUD_RUN_URL/errors
En esta tarea, se genera una nueva excepción a la prueba y se envía a Google Cloud Observability.
-
En la Cloud de Confiance consola, regresa a la página de Error Reporting y podrás 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.
Limpia
Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos usados en este instructivo, borra el proyecto que contiene los recursos o conserva el proyecto y borra los recursos individuales.
Borra el proyecto
- En la Cloud de Confiance consola, ve a la página Administrar recursos.
- En la lista de proyectos, elige el proyecto que tú quieres borrar y haz clic en Borrar.
- En el diálogo, escribe el ID del proyecto y, luego, haz clic en Cerrar para borrar el proyecto.