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

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

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. Enable the Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub APIs.

    Enable the APIs

    5.

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

    Go to project selector

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

  7. Enable the Cloud Functions, Cloud Build, Artifact Registry, Cloud Run, Logging, and Pub/Sub APIs.

    Enable the APIs

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

Crea una función

Si ya creaste una función, 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 agregar Crear función y selecciona una plantilla.

  3. Navega a la ruta de acceso en la que deseas crear tu función nueva, ingresa un nombre para la función y selecciona Create New Application.

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

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

Para obtener más información sobre cómo 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 el 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 tu IDE.

Implementa una función

Sigue estos pasos para implementar una función:

  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 Google Cloud proyecto en el que desees implementar tu función.

  3. Selecciona una 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 se está ejecutando, aparece un indicador de progreso progress_activity. Cuando se complete, aparecerá una marca de verificación check_circle. Si falla, aparecerá una marca de error error.

    Si la implementación falla, consulta la pestaña Resultado 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.

    Salida del mensaje de error

  5. Opcional: Una vez que se implementa la función, puedes realizar las siguientes acciones:

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

Cómo invocar 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 función Trigger function via HTTP que aparece, selecciona una de las siguientes opciones:

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

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

¿Qué sigue?

Obtener asistencia

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