Crea e implementa una función con Cloud Code para VS Code

En esta página, se muestra cómo crear, descargar, implementar y, luego, invocar una función de HTTP de 2ª gen.. mediante Cloud Functions con Cloud Code.

Antes de comenzar

  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.

    Ir al selector de proyectos

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

  4. Habilita las API de Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub.

    Habilita las API

    5.

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

    Ir al selector de proyectos

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

  7. Habilita las API de Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub.

    Habilita las API

    8.
  8. Instala Git. Se requiere Git para copiar muestras en tu máquina.
  9. Instala el complemento de Cloud Code si aún no lo has hecho.

Crea una función

Si ya creaste una función antes, puedes descargar una función existente en un lugar de trabajo nuevo y editarla de forma local.

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

  1. Haz clic en Cloud Code y, luego, expande la sección Cloud Functions.

  2. Haz clic en add Crear función y selecciona una plantilla.

  3. Navega hasta la ruta en la que deseas crear tu función nueva, ingresa un nombre para la función y selecciona Crear aplicación nueva.

    Si la carpeta de tu aplicación no aparece automáticamente en el Explorador, haz clic en actualizar Actualizar.

    El archivo launch.json 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",
    }
  ]
}

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 VS Code.

Descargar una función existente en un lugar de trabajo nuevo

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

  1. Haz clic en Cloud Code y, luego, expande la sección 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.

    Esto descarga la función en tu máquina local y la abre en un lugar de trabajo nuevo en tu IDE.

Implementa una función

Para implementar una función, sigue estos pasos:

  1. Haz clic con el botón derecho en una función y selecciona Implementar función.

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

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

  4. Selecciona un entorno de ejecución.

    La implementación de la función puede tardar unos minutos. Mientras está en curso, aparece un indicador de progreso progress_activity. Una vez que se completa, aparece una marca de verificación check_circle. Si falla, aparece una marca de error de error.

    Si la implementación falla, consulta la pestaña Resultado para ver el mensaje de error. Si haces clic en el vínculo, accederás a los registros de compilación en la consola de Google Cloud y se proporcionarán más detalles sobre el error.

    Salida del mensaje de error

  5. 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, 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; si se te solicita, selecciona Abrir.

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

Invoca una función

Invocar una función te permite ejecutar la función implementada en la consola de Google Cloud desde la terminal integrada del IDE. 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 la opción Trigger function a través de HTTP Quickpick que aparece, selecciona una de las dos opciones:

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

    • Importar argumentos del archivo JSON: Esta opción toma el contenido del archivo JSON seleccionado, lo convierte en una string y lo pasa con -d '{. Esto es útil cuando tienes una entrada para tus funciones y deseas guardarla, lo que te permite ejecutarla sin tener que volver a escribirla varias veces.

¿Qué sigue?

Obtener asistencia

Si deseas enviar comentarios, informa problemas en GitHub o haz preguntas en Stack Overflow.