GSP288

Descripción general

El Explorador de APIs de Google es una herramienta que te ayuda a explorar varias APIs de Google de manera interactiva. Con el Explorador de APIs, puedes hacer lo siguiente:

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

El Explorador de APIs utiliza su propia clave de API cada vez que realiza una solicitud. Cuando lo usas para realizar una solicitud, muestra la sintaxis de esa solicitud, que incluye un marcador de posición con la etiqueta {YOUR_API_KEY}. Si deseas realizar la misma solicitud en tu aplicación, debes reemplazar este marcador de posición por tu propia clave de API.

En este lab, aprenderás a usar una plantilla intercalada del Explorador de APIs de Google para llamar a la API de Cloud Dataproc y crear un clúster y, luego, ejecutar un trabajo simple de Spark en él. Además, aprenderás a usar la plantilla del Explorador de APIs para llamar a la API de Cloud Dataproc con el objetivo de actualizar un clúster.

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 tu 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 Cloud
   • El tiempo restante
   • Las credenciales temporales que debe usar para el lab
   • Otra información para completar el lab, si es necesaria

2. Haz clic en Abrir la consola de Google Cloud (o haz clic con el botón derecho y selecciona Abrir el vínculo en una ventana de incógnito si ejecutas el navegador Chrome).

   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 ves el diálogo Elegir una cuenta, haz clic en Usar otra cuenta.

3. De ser necesario, copia el nombre de usuario a continuación y pégalo en el diálogo Acceder.

   {{{user_0.username | "Username"}}}

   También puedes encontrar el nombre de usuario en el panel Detalles del lab.

4. Haz clic en Siguiente.

5. Copia la contraseña que aparece a continuación y pégala en el diálogo Te damos la bienvenida.

   {{{user_0.password | "Password"}}}

   También puedes encontrar la contraseña en el panel Detalles del lab.

6. Haz clic en Siguiente.

   Importante: Debes usar las credenciales que te proporciona el lab. No uses las credenciales de tu cuenta de Google Cloud. Nota: Usar tu propia Cuenta de Google podría generar cargos adicionales.

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

   • Acepta los Términos y Condiciones.
   • No agregues opciones de recuperación o autenticación de dos factores (esta es una cuenta temporal).
   • No te registres para obtener pruebas gratuitas.

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

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

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. Abre el Explorador de APIs

1. Ve al menú de navegación > APIs y servicios.

2. Desplázate por la lista hasta encontrar la API de Cloud Dataproc y haz clic en ella.

3. Asegúrate de que la API esté habilitada; si no lo está, haz clic en Habilitar.

4. Ahora que verificaste que la API estuviera habilitada, abre Referencia de la API de REST. Esta acción abrirá una nueva pestaña con la página Referencia de la API de Rest para la API de Cloud Dataproc.

Tarea 2. Crea un clúster

Para crear un clúster, en la sección APIs y referencias de la izquierda, navega a Referencia de REST > v1 > projects.regions.clusters > create para el método projects.regions.clusters.create, o bien usa la referencia Método: projects.regions.clusters.create.

Ahora completa el formulario y ejecuta la plantilla del Explorador de APIs, como se indica a continuación:

1. Ingresa el ID de tu proyecto de Qwiklabs en el campo projectId.
2. Establece el campo de la región en .
3. En Cuerpo de la solicitud, haz clic entre las llaves y agrega la propiedad clusterName. Ingresa el nombre del clúster que elijas. Ten en cuenta que el valor de "clusterName" no debe contener letras mayúsculas ni espacios.
4. En el menú desplegable Agregar una propiedad, selecciona config.
5. En el menú desplegable Agregar una propiedad, selecciona gceClusterConfig.
6. En el mismo menú desplegable, selecciona el campo zoneUri y agrega lo siguiente, pero reemplaza my-project-id por el ID del proyecto de este lab:

https://www.googleapis.com/compute/v1/projects/my-project-id/zones/{{{ project_0.default_zone | "ZONE" }}}

7. En la llave que aparece abajo de config, selecciona softwareConfig.
8. En la llave que aparece abajo de softwareConfig, selecciona imageVersion y establécelo en 2.0-debian10.
9. En la llave que aparece abajo de softwareConfig, selecciona optionalComponents. En optionalComponents, haz clic en AGREGAR ELEMENTO y, en el menú desplegable, selecciona JUPYTER.

Cuando finalices, el cuerpo de la solicitud se verá de la siguiente manera:

10. 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.

11. Asegúrate de que no haya espacios finales en los campos.

12. Ahora desplázate hacia abajo y haz clic en Ejecutar.

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

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

15. Los resultados de la API de Dataproc aparecerán debajo de la solicitud y se verán de la siguiente manera:

16. Para ver el clúster que se creó, puedes ir al menú de navegación > Dataproc > Clústeres.

Prueba la tarea completada

Haz clic en Revisar mi progreso para verificar la tarea realizada. Si creaste correctamente el clúster de Dataproc en la región , verás una puntuación de evaluación.

Crear un clúster de Dataproc (región: )

Tarea 3. Ejecuta un trabajo de Spark

A continuación, ejecutarás un trabajo simple de Apache Spark que calcula un valor aproximado de pi en un clúster existente de Cloud Dataproc.

• En la sección APIs y referencias de la izquierda, navega a Referencia de REST > v1 > projects.regions.jobs > submit para el método projects.regions.jobs.submit o usa este vínculo para enviar un trabajo a un clúster.

Ahora completa el formulario y ejecuta la plantilla del Explorador de APIs, como se indica a continuación:

1. Ingresa el ID de tu proyecto en el campo projectId.
2. Establece el campo de la región en .
3. En Cuerpo de la solicitud, haz clic entre las llaves y selecciona job.
4. Haz clic en las llaves y selecciona placement.
5. Haz clic en las llaves y selecciona clusterName; luego, ingresa el nombre de tu clúster.
6. En la llave debajo del trabajo, seleccione sparkJob.
7. Ahora, debes agregar 3 elementos en sparkJob:

• En la llave que aparece debajo de sparkjob, selecciona args. En args, haz clic en AGREGAR ELEMENTO y escribe 1000.
• En el menú desplegable Agregar una propiedad, selecciona jarFileUris. En jarFileUris, haz clic en AGREGAR ELEMENTO y escribe file:///usr/lib/spark/examples/jars/spark-examples.jar.
• En el menú desplegable Agregar una propiedad, selecciona mainClass y escribe org.apache.spark.examples.SparkPi.

Cuando finalices, el cuerpo de la solicitud se verá de la siguiente manera:

8. 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.

9. Asegúrate de que no haya espacios finales en los campos. Haz clic en EJECUTAR.

Los resultados de la API de Dataproc aparecerán debajo de la solicitud y se verán de la siguiente manera:

10. Puedes encontrar los resultados en Dataproc > Clústeres. Haz clic en el nombre de tu clúster y, luego, en la pestaña Trabajos.

11. Haz clic en el ID del trabajo y establece Ajustar líneas en ACTIVADO para que se vean las líneas que sobrepasan el margen derecho.

Prueba la tarea completada

Haz clic en Revisar mi progreso para verificar la tarea realizada. Si enviaste correctamente un trabajo de Spark a un clúster, verás una puntuación de evaluación.

Enviar un trabajo de Spark

Tarea 4. Actualiza un clúster

• En la sección APIs y referencias de la izquierda, navega a Referencia de REST > v1 > projects.regions.clusters > patch para el método projects.regions.clusters.patch o usa este vínculo para actualizar un clúster.

Ahora completa el formulario y ejecuta la plantilla del Explorador de APIs, como se indica a continuación:

1. projectID = el ID del proyecto
2. Región =
3. clusterName = ingresa el nombre del clúster
4. updateMask = config.worker_config.num_instances
5. En el cuerpo del parche, ingresa lo siguiente:

• Primera llave = config
• Haz clic en la llave que aparece debajo de esto y selecciona workerConfig
• Haz clic en la llave que aparece debajo de esto y selecciona numInstances; luego, ingresa 3.

Tu formulario debería verse así:

5. 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. Asegúrate de que no haya espacios finales en los campos. Haz clic en EJECUTAR.

Los resultados de la API de Dataproc aparecerán debajo de la solicitud y se verán de la siguiente manera:

7. Para verificar esta actualización, regresa a la página Clústeres de Dataproc. Verás que ahora tienes 3 nodos trabajadores en total.

Prueba la tarea completada

Haz clic en Revisar mi progreso para verificar la tarea realizada. Si actualizaste correctamente una configuración del trabajador para 3 nodos trabajadores, verás una puntuación de evaluación.

Actualizar un clúster para 3 nodos trabajadores

Tarea 5. Pon a prueba tus conocimientos

A continuación, se presentan algunas preguntas de opción múltiple para reforzar tus conocimientos de los conceptos de este lab. Trata de responderlas lo mejor posible.

¡Felicitaciones!

Usaste la API de Cloud Dataproc con el Explorador de APIs para crear un clúster, ejecutaste un trabajo de Spark y actualizaste un clúster.

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 y obtén un crédito inmediato de realización. Consulta el catálogo de Google Cloud Skills Boost para ver todas las Quests disponibles.

Próximos pasos y más información

• Lee la página Preguntas frecuentes sobre el Explorador de APIs.
• Obtén más información acerca de la API de Cloud Dataproc.

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: 18 de octubre de 2023

Prueba más reciente del lab: 20 de octubre 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.