GSP422

Descripción general

El Explorador de APIs de Google es una herramienta que te permite probar diversas APIs de Google de manera interactiva. Con el Explorador de APIs, puedes hacer lo siguiente:

• Explorar rápidamente las API y versiones disponibles
• Ver los métodos disponibles para cada API y los parámetros que admiten, junto con documentación intercalada
• Ejecutar solicitudes para cualquier método y ver las respuestas en tiempo real
• Hacer llamadas autenticadas y autorizadas a la API
• Hacer búsquedas en todos los servicios, los métodos y tus solicitudes recientes para encontrar lo que buscas al instante

App Engine te permite implementar aplicaciones en una plataforma completamente administrada. Puedes escalar tus aplicaciones sin interrupciones ni necesidad de administrar la infraestructura subyacente. Con implementaciones que no requieren configuración y sin tener que administrar servidores, los desarrolladores pueden enfocarse solo en compilar aplicaciones excelentes sin sobrecarga administrativa.

En este lab, implementarás una aplicación simple de Hello World en App Engine y actualizarás tu configuración con la API de App Engine Admin a través del Explorador de APIs.

Objetivos

En este lab, aprenderás a hacer lo siguiente:

• Compilarás una aplicación de App Engine con el Explorador de APIs.
• Implementarás una instancia de App Engine a partir del código de muestra de Hello World.
• Configurarás las reglas de firewall de App Engine con el Explorador de APIs.
• Realizarás cambios en tu base de código y crearás una nueva versión de tu aplicación con el Explorador de APIs.

Requisitos previos

Este es un lab de nivel básico. Debes estar familiarizado con el funcionamiento y la arquitectura básicos de las APIs. Se recomienda tener experiencia con Google Cloud Shell y las herramientas de la interfaz de línea de comandos.

Además, se recomienda tener experiencia con el Explorador de APIs. Antes de iniciar este lab, debes realizar como mínimo los siguientes:

• Introducción a las API en Google
• Explorador de APIs: Qwik Start

Si no estás familiarizado con App Engine, en el lab App Engine: Qwik Start - Python encontrarás información valiosa que te ayudará con el contenido de este lab. Cuando esté todo listo, desplázate hacia abajo y sigue los pasos que se muestran a continuación para configurar el entorno de tu lab.

Configuración y requisitos

Antes de hacer clic en el botón Comenzar lab

Lee estas instrucciones. Los labs son cronometrados y no se pueden pausar. El cronómetro, que comienza a funcionar cuando haces clic en Comenzar lab, indica por cuánto tiempo tendrás a tu disposición los recursos de Google Cloud.

Este lab práctico te permitirá realizar las actividades correspondientes en un entorno de nube real, no en uno de simulación o demostración. Para ello, se te proporcionan credenciales temporales nuevas que utilizarás para acceder a Google Cloud durante todo el lab.

Para completar este lab, necesitarás lo siguiente:

• Acceso a un navegador de Internet estándar (se recomienda el navegador Chrome)

Nota: Usa una ventana de navegador privada o de Incógnito para ejecutar este lab. Así evitarás cualquier conflicto entre tu cuenta personal y la cuenta de estudiante, lo que podría generar cargos adicionales en tu cuenta personal.

• Tiempo para completar el lab: Recuerda que, una vez que comienzas un lab, no puedes pausarlo.

Nota: Si ya tienes un proyecto o una cuenta personal de Google Cloud, no los uses en este lab para evitar cargos adicionales en tu cuenta.

Cómo iniciar su lab y acceder a la consola de Google Cloud

1. Haga clic en el botón Comenzar lab. Si debe pagar por el lab, se abrirá una ventana emergente para que seleccione su forma de pago. A la izquierda, se encuentra el panel Detalles del lab que tiene estos elementos:

   • El botón Abrir la consola de Google
   • Tiempo restante
   • Las credenciales temporales que debe usar para el lab
   • Otra información para completar el lab, si es necesaria

2. Haga clic en Abrir la consola de Google. El lab inicia recursos y abre otra pestaña en la que se muestra la página de acceso.

   Sugerencia: Ordene las pestañas en ventanas separadas, una junto a la otra.

   Nota: Si ve el diálogo Elegir una cuenta, haga clic en Usar otra cuenta.

3. Si es necesario, copie el nombre de usuario del panel Detalles del lab y péguelo en el cuadro de diálogo Acceder. Haga clic en Siguiente.

4. Copie la contraseña del panel Detalles del lab y péguela en el cuadro de diálogo de bienvenida. Haga clic en Siguiente.

   Importante: Debe usar las credenciales del panel de la izquierda. No use sus credenciales de Google Cloud Skills Boost. Nota: Usar su propia Cuenta de Google podría generar cargos adicionales.

5. Haga clic para avanzar por las páginas siguientes:

   • Acepte los términos y condiciones.
   • No agregue opciones de recuperación o autenticación de dos factores (esta es una cuenta temporal).
   • No se registre para obtener pruebas gratuitas.

Después de un momento, se abrirá la consola de Cloud en esta pestaña.

Nota: Para ver el menú con una lista de los productos y servicios de Google Cloud, haga clic en el Menú de navegación que se encuentra en la parte superior izquierda de la pantalla.

Activa Cloud Shell

Cloud Shell es una máquina virtual que cuenta con herramientas para desarrolladores. Ofrece un directorio principal persistente de 5 GB y se ejecuta en Google Cloud. Cloud Shell proporciona acceso de línea de comandos a tus recursos de Google Cloud.

1. Haz clic en Activar Cloud Shell en la parte superior de la consola de Google Cloud.

Cuando te conectes, habrás completado la autenticación, y el proyecto estará configurado con tu PROJECT_ID. El resultado contiene una línea que declara el PROJECT_ID para esta sesión:

Your Cloud Platform project in this session is set to YOUR_PROJECT_ID

gcloud es la herramienta de línea de comandos de Google Cloud. Viene preinstalada en Cloud Shell y es compatible con la función de autocompletado con tabulador.

2. Puedes solicitar el nombre de la cuenta activa con este comando (opcional):

gcloud auth list

3. Haz clic en Autorizar.

4. Ahora, el resultado debería verse de la siguiente manera:

Resultado:

ACTIVE: * ACCOUNT: student-01-xxxxxxxxxxxx@qwiklabs.net To set the active account, run: $ gcloud config set account `ACCOUNT`

5. Puedes solicitar el ID del proyecto con este comando (opcional):

gcloud config list project

Resultado:

[core] project = <project_ID>

Resultado de ejemplo:

[core] project = qwiklabs-gcp-44776a13dea667a6 Nota: Para obtener toda la documentación de gcloud, consulta la guía con la descripción general de gcloud CLI en Google Cloud.

Tarea 1. Compila una aplicación de App Engine con apps.create

A continuación, compilarás una aplicación de App Engine con uno de los métodos disponibles en el Explorador de APIs.

1. Para acceder al Explorador de APIs de App Engine, abre Menú de navegación y selecciona API y servicios > Biblioteca.

2. En la barra de búsqueda, ingresa App Engine y selecciona App Engine Admin API en la lista de resultados. Asegúrate de que la API esté habilitada; si no lo está, haz clic en Habilitar.

3. Ahora que comprobaste que se habilitó la API, abre el Método: apps.create reference. Esta acción te llevará al método apps create.

4. En la sección Try this method, ubicada en el panel derecho, haz clic en el campo Cuerpo de la solicitud y escribe lo siguiente:

• La propiedad ID. Establece el ID de tu proyecto como su valor.
• La propiedad locationId. Establece su valor como . Este campo obligatorio le indica a Google Cloud dónde se ubicarán tus recursos de App Engine.

5. Asegúrate de que no haya espacios finales en los campos. Además, en la sección Credenciales, asegúrate de que estén seleccionadas las casillas de verificación Google OAuth 2.0 y Clave de API.

Nota: Para ver las Preguntas frecuentes sobre las credenciales, haz clic en el ícono de signo de interrogación junto al título Credenciales.

6. Haz clic en el botón EJECUTAR.

7. Selecciona la cuenta de estudiante con la que iniciaste el lab.

8. En la siguiente pantalla, haz clic en Allow para conceder acceso al Explorador de APIs.

Tu respuesta debería verse de esta manera:

{ "name": "apps/qwiklabs-gcp-da84962e277c92a7/operations/193f576c-8791-4638-920e-b1ccb6305ae1", "metadata": { "@type": "type.googleapis.com/google.appengine.v1.OperationMetadataV1", "method": "google.appengine.v1.Applications.CreateApplication", "insertTime": "2019-10-16T12:37:36.743Z", "user": "gcpstaging92860_student@qwiklabs.net", "target": "apps/qwiklabs-gcp-da84962e277c92a7" } }

Compilaste correctamente una aplicación de App Engine para un proyecto de Google Cloud.

Tarea 2. Obtén información de la aplicación con apps.get

A continuación, recuperarás información sobre tu aplicación de App Engine para verificar que se haya creado correctamente.

1. Desde la sección Todas las APIs y referencias ubicada a la izquierda, navega a API de REST > v1 > apps > get. O bien, puedes usar este vínculo directo hacia el método apps.get.

2. En el campo appsId, ingresa el <PROJECT_ID> que se encuentra en la sección Detalles de la conexión del lab.

3. En la sección Credenciales, asegúrate de que estén seleccionadas las casillas de verificación Google OAuth 2.0 y Clave de API.

4. Haz clic en el botón EJECUTAR. Es posible que debas seleccionar la cuenta de estudiante y hacer clic en Permitir nuevamente.

Tu respuesta debería verse de esta manera:

{ "name": "apps/qwiklabs-gcp-da84962e277c92a7", "id": "qwiklabs-gcp-da84962e277c92a7", "authDomain": "gmail.com", "locationId": "{{{ project_0.startup_script.app_region | REGION }}}", "codeBucket": "staging.qwiklabs-gcp-da84962e277c92a7.appspot.com", "servingStatus": "SERVING", "defaultHostname": "qwiklabs-gcp-da84962e277c92a7.appspot.com", "defaultBucket": "qwiklabs-gcp-da84962e277c92a7.appspot.com", "gcrDomain": "us.gcr.io", "featureSettings": { "splitHealthChecks": true, "useContainerOptimizedOs": true } }

Este método funciona como una verificación de estado y te brinda información útil sobre tu aplicación de App Engine, como el nombre de host predeterminado, la ubicación y la información sobre el estado.

Tarea 3. Descarga el código de partida

Antes de implementar una aplicación de App Engine, deberás descargar el código de partida para poder comenzar.

1. Regresa a la consola de Cloud y, en Cloud Shell, ejecuta el siguiente comando para clonar un repositorio que contenga la base de código para una aplicación simple de Hello World:

git clone https://github.com/GoogleCloudPlatform/python-docs-samples

2. Ahora, cambia tu directorio de trabajo actual:

cd ~/python-docs-samples/appengine/standard_python3/hello_world

La carpeta hello_world contiene una aplicación simple de Python que usa el framework web de Flask. Esta app de Python responde a una solicitud con un encabezado HTTP y el mensaje “Hello World!”.

Tarea 4. Implementa tu aplicación de App Engine

1. Para realizar este paso, debes permanecer en tu sesión de Cloud Shell. Ejecuta el siguiente comando para establecer tu ID de proyecto como una variable de entorno, así, se reemplaza [YOUR_PROJECT_ID] con tu ID del proyecto:

export PROJECT_ID=[YOUR_PROJECT_ID]

2. Ahora, ejecuta el siguiente comando de gcloud para implementar tu aplicación de Hello World:

gcloud app deploy app.yaml --project $PROJECT_ID

3. Ingresa Y cuando se te consulte lo siguiente:

Do you want to continue (Y/n)?

La implementación tardará unos minutos en completarse. Una vez que haya finalizado, deberías recibir un resultado similar al siguiente:

File upload done. Updating service [default]...done. Setting traffic split for service [default]...done. Deployed service [default] to [https://qwiklabs-gcp-b5d5fa242d334941.appspot.com]

4. Copia el vínculo del servicio implementado, que es similar a https://qwiklabs-gcp-b5d5fa242d334941.appspot.com, y pégalo en una pestaña nueva. Esta acción abrirá la aplicación de Hello World. La página debería verse de la manera siguiente:

Ahora que ya se implementó tu aplicación, podrás realizar cambios en tu configuración de App Engine con el Explorador de APIs.

Mantén abierta la página de Hello World!.

Prueba la tarea completada

Haz clic en Revisar mi progreso para verificar la tarea realizada. Si implementaste correctamente una aplicación de App Engine, verás una puntuación de evaluación.

Implementar una aplicación de App Engine

Tarea 5. Configura las reglas de firewall de entrada con apps.firewall.ingressRules

A continuación, crearás, enumerarás y borrarás las reglas de firewall que otorgan acceso a tu aplicación de Hello World.

Crea una regla de firewall de entrada

1. Desde la sección Todas las APIs y referencias, navega a API de REST > v1 > apps.firewall.ingressRules > create. O bien, puedes usar este vínculo directo hacia el método apps.firewall.ingressRules.create.

2. En el campo appsId, ingresa el ID de tu proyecto.

3. Ahora, haz clic en el campo Cuerpo de la solicitud e ingresa lo siguiente:

• La propiedad sourceRange. Establece su valor como *.
• La propiedad action. Establece su valor como DENY.
• La propiedad priority. Establece su valor como 1.

Tu método debería verse de esta manera:

4. Verifica que tus campos no tengan espacios finales. Además, en la sección Credenciales, asegúrate de que estén seleccionadas las casillas de verificación Google OAuth 2.0 y Clave de API.

5. Haz clic en el botón EJECUTAR. Tu respuesta debería verse de esta manera:

{ "priority": 1, "action": "DENY", "sourceRange": "*" }

Esta regla de firewall rechaza todas las solicitudes a tu aplicación de Hello World.

6. Para ver cómo funciona, actualiza la página de Hello World en tu navegador. Ahora, deberías ver que el acceso está prohibido:
   

7. Regresa a la página del Explorador de APIs para realizar el siguiente paso.

Enumera las reglas de firewall de entrada

1. Desde la sección Todas las APIs y referencias ubicada a la izquierda, navega a API de REST > v1 > apps.firewall.ingressRules > list. O bien puedes usar este vínculo directo hacia el método apps.firewall.ingressRules.list.

2. En el campo appsId, ingresa el ID de tu proyecto.

3. Verifica que el campo appsId no tenga espacios finales. Además, en la sección Credenciales, asegúrate de que estén seleccionadas las casillas de verificación Google OAuth 2.0 y Clave de API.

4. Haz clic en el botón EJECUTAR.

Tu respuesta debería verse de esta manera:

{ "ingressRules": [ { "priority": 1, "action": "DENY", "sourceRange": "*" }, { "priority": 2147483647, "action": "ALLOW", "sourceRange": "*", "description": "The default action." } ] }

Ahora podrás ver las dos reglas de firewall: una que permite el tráfico a tu aplicación y otra que lo rechaza. Ten en cuenta que los valores de priority de cada regla de entrada también actúan como ID de las reglas de firewall.

Borra una regla de firewall de entrada

1. Desde la sección Todas las APIs y referencias ubicada a la izquierda, navega a API de REST > v1 > apps.firewall.ingressRules > delete. O bien puedes usar este vínculo directo hacia el método apps.firewall.ingressRules.delete.

2. En el campo appsId, ingresa el ID de tu proyecto. En el campo ingressRulesId, ingresa 1. Tu método debería verse de esta manera:

3. Verifica que tus campos no tengan espacios finales. Además, en la sección Credenciales, asegúrate de que estén seleccionadas las casillas de verificación Google OAuth 2.0 y Clave de API.

4. Haz clic en el botón EJECUTAR.

Tu respuesta debería verse de esta manera:

{}

5. A continuación, actualiza la página de Hello World en tu navegador. Ahora, deberías ver que el acceso se restableció:

Ahora que ya adquiriste práctica con la configuración de reglas de firewall de entrada, pasarás al siguiente nivel: crearás versiones nuevas de la aplicación y las implementarás.

Tarea 6. Actualiza los archivos de tu aplicación

Ahora, realizarás un pequeño cambio en el código fuente de tu aplicación.

1. Para este paso, regresa a Cloud Shell. Deberías seguir en el directorio de hello_world. De lo contrario, ejecuta el siguiente comando:

cd ~/python-docs-samples/appengine/standard_python3/hello_world

2. Ahora, abre el archivo main.py con el editor de texto nano:

nano main.py

3. Desplázate hacia abajo hasta la función hello y edítala para que diga “Goodbye World!”:

@app.route('/') def hello(): """Return a friendly HTTP greeting.""" return 'Goodbye World!'

4. Presiona las teclas CTRL + x y, luego, Y > INTRO para guardar tus cambios y salir del editor nano.

Tarea 7. Crea una versión nueva de tu aplicación con apps.services.versions.create

Ahora, crearás una versión nueva de tu aplicación que utilice tu base de código “Goodbye World!” actualizada.

1. En la consola de Cloud, desde el menú de navegación (), selecciona Cloud Storage > Buckets. La lista de buckets debería verse de esta manera:

2. Copia el nombre del bucket staging.qwiklabs-gcp-xxxx.appspot.com y guárdalo.

3. Ahora, haz clic en dicho bucket para ver los archivos que contiene.

4. Copia el nombre del archivo application/json y guárdalo.

Ahora, ya tienes la información necesaria para crear una versión nueva de tu aplicación de Hello World.

1. Regresa al Explorador de APIs para realizar el siguiente paso.

2. Desde la sección Todas las APIs y referencias ubicada a la izquierda, navega a API de REST > v1 > apps.services.versions > create. O bien, puedes usar este vínculo directo hacia el método apps.services.versions.create.

3. En el campo appsId, ingresa el ID de tu proyecto. En el campo servicesId, ingresa default.

4. Ahora, haz clic en el campo Cuerpo de la solicitud e ingresa lo siguiente:

• La propiedad id. Establece su valor como v1.
• La propiedad runtime. Establece su valor como python39.
• Agrega la propiedad entrypoint. A continuación, dentro de esta, agrega la propiedad shell, pero deja este valor vacío.

Tu método debería ser similar al siguiente:

5. Agrega la propiedad deployment.

• En "deployment", agrega una propiedad nueva files y haz clic en el vínculo add que se encuentra debajo. Asígnale el nombre latest.
• En latest, agrega la propiedad sourceUrl y configúrala de la siguiente manera. Reemplaza <YOUR_BUCKET_NAME> por el nombre del bucket de almacenamiento en etapa intermedia de Cloud Storage y <YOUR_JSON_FILE_NAME> por el nombre del archivo JSON que copiaste:

https://storage.googleapis.com/<YOUR_BUCKET_NAME>/<YOUR_JSON_FILE_NAME>

Tu método debería ser similar al siguiente:

6. En la sección Credenciales, asegúrate de que estén seleccionadas las casillas de verificación Google OAuth 2.0 y Clave de API.

7. Una vez que esté todo completo, haz clic en el botón EJECUTAR.

Deberías recibir el resultado siguiente:

{ "name": "apps/qwiklabs-gcp-da84962e277c92a7/operations/7ca371a7-3bf6-4215-871e-7f9aac815714", "metadata": { "@type": "type.googleapis.com/google.appengine.v1.OperationMetadataV1", "method": "google.appengine.v1.Versions.CreateVersion", "insertTime": "2019-10-16T14:39:19.231Z", "user": "gcpstaging92860_student@qwiklabs.net", "target": "apps/qwiklabs-gcp-da84962e277c92a7/services/default/versions/v1" } }

Fue necesario completar muchos campos, pero así es como se muestra el potencial del Explorador de APIs. Poder visualizar todos los parámetros y ver cómo se relacionan entre sí es fundamental para poder llamar correctamente a los métodos de una API.

Tarea 8. Implementa la nueva versión de tu aplicación

1. Para este paso, regresa a la consola de Cloud.

2. Abre el menú de navegación y selecciona App Engine > Versiones.

Deberías ver que ahora hay dos versiones disponibles de tu aplicación:

Nota: Si no ves las dos versiones, es posible que aún no se hayan propagado tus actualizaciones. En la esquina superior izquierda, haz clic en el botón Actualizar hasta que tu página se vea como la captura de pantalla anterior.

3. Regresa a tu sesión de Cloud Shell. Deberías seguir en el directorio de hello_world. De lo contrario, ejecuta el siguiente comando:

cd ~/python-docs-samples/appengine/standard_python3/hello_world

Ahora, implementarás la nueva versión de tu aplicación.

4. Ejecuta el siguiente comando para implementar la nueva versión con "Goodbye World!" como mensaje:

gcloud app deploy -v v1

5. Ingresa Y cuando se te consulte lo siguiente:

Do you want to continue (Y/n)?

La implementación tardará unos minutos en completarse.

Una vez que haya finalizado, deberías recibir un resultado similar al siguiente:

File upload done. Updating service [default]...done. Setting traffic split for service [default]...done. Deployed service [default] to [https://qwiklabs-gcp-b5d5fa242d334941.appspot.com]

6. Ahora, copia el vínculo o actualiza la página de la aplicación en tu navegador. Deberías ver lo siguiente:

Si regresas a la consola de Cloud y consultas App Engine > Versiones, verás que se está ejecutando v1:

Creaste correctamente una nueva versión de una aplicación con el Explorador de APIs y, luego, la implementaste en Cloud Shell.

Prueba la tarea completada

Haz clic en Revisar mi progreso para verificar la tarea realizada. Si creaste correctamente una versión nueva de tu app, verás una puntuación de evaluación.

Crear y, luego, implementar una nueva versión de tu app

¡Felicitaciones!

En este lab, adquiriste experiencia práctica con los métodos de la API de App Engine Admin a través del Explorador de APIs. Una vez que compilaste una aplicación de App Engine con el Explorador de APIs, pudiste implementar una instancia a partir del código de muestra de Hello World. Luego, aprendiste a configurar las reglas de firewall de entrada con el Explorador de APIs. Una vez que realizaste los cambios en la base del código, utilizaste el Explorador de APIs para crear una nueva versión de tu aplicación y, luego, la implementaste y pudiste acceder a ella correctamente. Ahora puedes completar más labs de la Quest Exploring APIs.

Finaliza la Quest

Este lab de autoaprendizaje forma parte de la Quest Exploring APIs. Una Quest es una serie de labs relacionados que forman una ruta de aprendizaje. Si completas esta Quest, obtendrás una insignia como reconocimiento por tu logro. Puedes hacer públicas tus insignias y agregar vínculos a ellas en tu currículum en línea o en tus cuentas de redes sociales. Inscríbete en esta Quest o en cualquiera que contenga este lab y obtén un crédito inmediato de finalización. Consulta el catálogo de Google Cloud Skills Boost para ver todas las Quests disponibles.

Realiza tu próximo lab

Asegúrate de revisar los siguientes labs para adquirir más práctica con el Explorador de APIs:

• Explorador de APIs: Cloud SQL

Próximos pasos y más información

• Documentación de la API de App Engine Admin

Capacitación y certificación de Google Cloud

Recibe la formación que necesitas para aprovechar al máximo las tecnologías de Google Cloud. Nuestras clases incluyen habilidades técnicas y recomendaciones para ayudarte a avanzar rápidamente y a seguir aprendiendo. Para que puedas realizar nuestros cursos cuando más te convenga, ofrecemos distintos tipos de capacitación de nivel básico a avanzado: a pedido, presenciales y virtuales. Las certificaciones te ayudan a validar y demostrar tus habilidades y tu conocimiento técnico respecto a las tecnologías de Google Cloud.

Actualización más reciente del manual: 2 de noviembre de 2023

Prueba más reciente del lab: 2 de noviembre de 2023

Copyright 2024 Google LLC. All rights reserved. Google y el logotipo de Google son marcas de Google LLC. Los demás nombres de productos y empresas pueden ser marcas de las respectivas empresas a las que estén asociados.