Crear una función de Cloud Run con Cloud Code para Cloud Shell

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

Cloud Code es una extensión que incorpora muchos Google Cloud servicios, como Google Kubernetes Engine y Cloud Run, directamente en tu IDE, de modo que puedes 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 Cloud Code en VS Code, que también permite crear y desplegar funciones, o en IntelliJ y otros IDEs de JetBrains compatibles, que no admiten funciones de Cloud Run.

Para seguir las instrucciones paso a paso de esta tarea directamente en el editor de Cloud Shell, haz clic en Ayúdame:

Guíame

Antes de empezar

  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.

    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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify 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.

    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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

    6. Conectar con Google Cloud

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

    Para conectarte a Google Cloud, sigue estos pasos:

    1. Abre el editor de Cloud Shell.

    2. Si se te pide que autorices a Cloud Code para que use tus credenciales y haga una llamada a la API, haz clic en Autorizar si aceptas los términos. Google Cloud

    3. Si aún no te has conectado a Google Cloud, en la barra de estado de Cloud Code, haz clic en Conectar con Google Cloud.

      Conectar con el botón Google Cloud de la barra de estado

    4. Si se te pide que autorices a Cloud Code para que use tus credenciales para hacer llamadas a la API, haz clic en Autorizar si aceptas estos términos. Google Cloud

    5. Si aún no has seleccionado un proyecto, en la barra de estado de Cloud Code, haz clic en Seleccionar un proyecto de Google Cloud. Google Cloud

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

    6. En el menú de selección rápida Seleccionar un proyecto de Google Cloud que aparece, selecciona tu Google Cloud proyecto.

      El proyecto se carga y se convierte en el proyecto activo en el editor de Cloud Shell. Puedes cambiar de proyecto en cualquier momento haciendo clic en el nombre del proyecto activo en la barra de estado de Cloud Code y seleccionando otro proyecto.

    Crea tu función

    Usa el editor de Cloud Shell como entorno para crear y desplegar tu función. El editor ya tiene cargadas las herramientas necesarias para el desarrollo en Cloud.

    Para crear una función con un ejemplo, 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ú de selección rápida que aparece, selecciona Nueva aplicación.

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

    4. En la lista de aplicaciones de ejemplo de Cloud Run Functions, selecciona Node.js: Hello World (Node.js: Hola, mundo).

    5. Selecciona la carpeta donde se ubicará tu aplicación y haz clic en Crear aplicación.

      El editor de Cloud Shell carga la aplicación en un nuevo espacio de trabajo. Una vez que se haya recargado, podrás acceder a tu aplicación con la vista Explorador.

      El archivo launch.json, que se encuentra en la carpeta .vscode, contiene las configuraciones necesarias para tu función:

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

    Desplegar una función

    Ahora que has creado la función, puedes desplegarla en Cloud Shell siguiendo estos pasos:

    1. Haz clic en Cloud Code y, a continuación, expande el explorador Cloud Functions.

    2. Haz clic en una función y, a continuación, en Desplegar función.

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

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

    5. Selecciona Node.js 22.

      El despliegue de la función puede tardar unos minutos. Si el proceso sigue en curso, verás un icono de progreso . Una vez completado, verás el icono de éxito si se completa correctamente, el icono de error si falla o el icono de advertencia si la implementación falla y se revierte a una implementación anterior que se haya completado correctamente.

      Si la implementación falla, consulta el mensaje de error en la vista Salida (Ver > Salida). Al hacer clic en el enlace, se te redirigirá a los registros de compilación de laGoogle Cloud consola y se te proporcionarán más detalles sobre el error.

    6. (Opcional) Una vez que se haya implementado la función, puedes realizar las siguientes acciones:

      • Para ver los archivos de solo lectura de la función implementada, despliega la función y, a continuación, la carpeta Source Code (Código fuente). Aquí puedes ver launch.json en .vscode, el código desplegado y package.json.

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

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

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

    Invocar la función

    Al invocar una función, puedes ejecutarla en laGoogle Cloud consola desde el 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 Invocar función mediante HTTP.

    2. En el menú de selección rápida Activar función mediante HTTP que aparece, selecciona Invocar sin argumentos.

      Se abre una terminal en el IDE y ejecuta un comando para ejecutar la función en Google Cloud.

    Opcional: Descargar una función en un espacio de trabajo nuevo

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

    1. Haz clic en Cloud Code y, a continuación, expande el explorador Cloud Functions.

    2. Despliega el fragmento de tu Google Cloud proyecto, haz clic con el botón derecho en la función que quieras descargar y selecciona Descargar en un nuevo espacio de trabajo.

    3. Cuando se te pida, introduce un nombre para la nueva aplicación y haz clic en Crear nueva aplicación.

      De esta forma, la función se descarga en tu máquina local y se abre en un nuevo espacio de trabajo en el editor de Cloud Shell.

    Limpieza

    Para eliminar solo la función que has creado en esta guía de inicio rápido, sigue estos pasos:

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

    2. Haz clic en Eliminar y, a continuación, en Eliminar.

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

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

      Ir a la página Proyectos

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

    3. Escribe el ID del proyecto para confirmar la acción y, a continuación, haz clic en Cerrar.

      De esta forma, se cierra el proyecto y se programa su eliminación.

    Siguientes pasos