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 antes, puedes descargar una función existente a un nuevo lugar de trabajo y editarlo a nivel 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 seleccionar 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 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",
    }
  ]
}

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 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 Crear aplicación nueva.

    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 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 se está ejecutando, aparece un indicador de progreso progress_activity. Una vez completado, se marca de verificación check_circle . Si falla, aparecerá 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. proporciona 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 y selecciona Abrir en la consola de Cloud y, si se te solicita, elige 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.

Invocar una función

Invocar una función te permite ejecutar la función implementada 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 de activación rápida Activar la función a través de HTTP que aparece, selecciona una de las siguientes opciones: entre las dos opciones:

    • Predeterminada: Se abre una terminal en el IDE y 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.