Crea e implementa una función con Cloud Shell

Aprende a crear, implementar, invocar y descargar una función de HTTP de 2ª gen.. mediante Cloud Functions con Cloud Code en el editor de Cloud Shell.

---

Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

Guiarme

---

1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

2. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

3. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

4. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

5. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

Conéctate a Google Cloud

En esta sección, iniciarás el editor de Cloud Shell, te conectarás a Google Cloud y seleccionarás un proyecto de Google Cloud.

Para conectarte a Google Cloud, sigue estos pasos:

1. Inicia el editor de Cloud Shell.

2. Si se te solicita que autorices a Cloud Code a usar tus credenciales para realizar una llamada a la API de Google Cloud, haz clic en Autorizar si aceptas las condiciones.

3. Si aún no estás conectado a Google Cloud, en la barra de estado de Cloud Code, haz clic en Conectar a Google Cloud.

   

4. Si se te solicita que autorices a Cloud Code a usar tus credenciales para realizar llamadas a la API de Google Cloud, haz clic en Autorizar si aceptas estas condiciones.

5. Si aun no tienes un proyecto de Google Cloud seleccionado, en la barra de estado de Cloud Code, haz clic en Seleccionar un proyecto de Google Cloud.

   Si ya tienes un proyecto de Google Cloud seleccionado, verás el nombre del proyecto en la barra de estado de Cloud Code y podrás continuar con la creación de tu función.

6. En el menú Seleccionar rápido del proyecto de Google Cloud que aparece, elige tu proyecto de Google Cloud.

   El proyecto se carga y se convierte en el proyecto activo en el editor de Cloud Shell. Puedes cambiar este proyecto en cualquier momento si haces clic en el nombre del proyecto activo en la barra de estado de Cloud Code y seleccionas un proyecto diferente.

Crea tu función

Usa el editor de Cloud Shell como entorno para implementar y crear tu función. El editor está precargado con las herramientas para el desarrollo en Cloud.

Para crear una función nueva con una muestra, sigue estos pasos:

1. En la barra de estado de Cloud Code, haz clic en Cloud Code.

   

2. En el menú Selección rápida que aparece, selecciona Nueva aplicación.

3. Selecciona Aplicación de Cloud Functions como el tipo de aplicación de ejemplo.

4. En la lista de apps de muestra de Cloud Functions, selecciona Node.js: Hello World.

5. Selecciona una carpeta para la ubicación de tu app y, luego, haz clic en Create New Application.

   El Editor de Cloud Shell cargará la app en un nuevo lugar de trabajo. Una vez que se vuelva a cargar la app, podrás acceder a ella con la vista del explorador.

   El archivo launch.json, ubicado en la carpeta .vscode, contiene los parámetros de configuración necesarios para tu función:

   {
   "configurations": [
       {
       "name": "Deploy Cloud Function",
       "type": "cloudcode.cloudfunctions",
       "request": "launch",
       "functionName": "function-hello-world",
       "gen": "GEN_2",
       "entryPoint": "helloHttp",
       }
   ]
   }
   

Si quieres obtener más información para crear varias funciones en un solo lugar de trabajo, consulta Administra funciones en el lugar de trabajo de Shell.

Implementa tu función

Ahora que ya creaste tu función, puedes implementarla en Cloud Shell mediante los siguientes pasos:

1. Haz clic en Cloud Code y, luego, expande el explorador de Cloud Functions.

2. Haz clic en una función y, luego, en Implementar función.

3. En el menú de Selección rápida, selecciona un proyecto de Google Cloud en el que desees implementar tu función.

4. Selecciona la región en la que se implementará la función.

5. Selecciona Node.js 20.

   La implementación de la función puede tardar unos minutos. Si aún está en curso, verás un ícono de progreso . Cuando termine, verás el ícono de éxito si lo logra, el ícono de error si falla o el ícono de advertencia si la implementación falla y se revierte a una correcta.

   Si la implementación falla, consulta la vista Salida (Vista > Salida) para ver el mensaje de error. Cuando haces clic en el vínculo, se te dirige a los registros de compilación en la consola de Google Cloud y se proporcionan más detalles sobre el error.

6. Una vez que se implementa la función, puedes realizar las siguientes acciones (opcional):

   • Para ver los archivos de solo lectura de tu función implementada, expande la función y, luego, expande la carpeta Código fuente. Aquí puedes ver launch.json en .vscode, el código implementado y package.json.

   • Para ver la función en la consola de Google Cloud, haz clic con el botón derecho en la función y selecciona Abrir en la consola de Cloud y, si se te solicita, selecciona Abrir.

   • Para editar los metadatos de la función, haz clic con el botón derecho en la función y selecciona Editar metadatos en la consola de Cloud.

   • Para ver los registros de la función implementada, haz clic con el botón derecho en la función y selecciona Ver registros.

Invoca tu función

Invocar una función te permite ejecutar la función implementada en la consola de Google Cloud desde la terminal del Editor de Cloud Shell. Para invocar una función, sigue estos pasos:

1. Haz clic con el botón derecho en la función y selecciona Invoke function via HTTP.

2. En el menú Quickpick de Trigger function a través de HTTP que aparece, selecciona Invocar sin argumentos.

   Se abrirá una terminal en el IDE y se ejecutará un comando para ejecutar la función en Google Cloud.

(Opcional) Descarga una función existente en un lugar de trabajo nuevo

Para descargar una función existente en un lugar de trabajo nuevo, sigue estos pasos:

1. Haz clic en Cloud Code y, luego, expande el explorador de Cloud Functions.

2. Expande tu fragmento de proyecto de Google Cloud, haz clic con el botón derecho en la función que deseas descargar y selecciona Download to new workspace.

3. Cuando se te solicite, ingresa un nombre para la aplicación nueva y haz clic en Create New Application.

   Esta acción descarga la función a tu máquina local y la abre en un lugar de trabajo nuevo en el Editor de Cloud Shell.

Limpia

Para borrar solo la función que creaste en esta guía de inicio rápido, haz lo siguiente:

1. En el explorador de Cloud Functions, haz clic derecho en el nombre de la función y, luego, selecciona Abrir en Cloud Console.

2. Haz clic en Borrar y, luego, en Borrar.

Sigue estos pasos para borrar el proyecto (y los recursos asociados):

1. Ve a la página Proyectos en la consola de Google Cloud.

   Ir a la página Proyectos

2. Selecciona el proyecto que creaste para esta guía de inicio rápido y haz clic en Borrar.

3. Escribe el ID del proyecto para confirmar y, luego, haz clic en Cerrar.

   Esta acción cierra el proyecto y programa su eliminación.

¿Qué sigue?

• Consulta la descripción general de Trabaja con Cloud Functions para obtener más información sobre cómo administrar tu lugar de trabajo o configurar un entorno de desarrollo local.