Crea una Cloud Run Function de 2ª gen. con Cloud Code para Cloud Shell

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

Cloud Code es una extensión que lleva muchos servicios de Google Cloud, como Google Kubernetes Engine y Cloud Run, directamente a tu IDE, para que puedas desarrollar tus aplicaciones sin tener que cambiar de contexto. Cloud Code está disponible de forma predeterminada en el editor de Cloud Shell.

Puedes instalar la extensión de Cloud Code en VS Code, que también admite crear e implementar funciones o IntelliJ y otros IDE de JetBrains compatibles, que no son compatibles con las funciones de Cloud Run.

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

GUIARME

Antes de comenzar

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  5. Make sure that billing is enabled for your Google Cloud project.

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.

    Botón para conectarse a Google Cloud en la barra de estado

  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.

    Botón de la barra de estado de 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 las funciones de Cloud Run, 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",
    }
]
}

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. Seleciona Node.js 22.

    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 Resultado (Vista > Resultado) para 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ú de selección rápida Activar función mediante HTTP, 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.

Realiza una limpieza

Si deseas borrar solo la función que creaste para 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.

Para borrar tu proyecto (y los recursos asociados), sigue estos pasos:

  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?