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 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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  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 Agregar Crear función y selecciona una plantilla.

  3. Navega a la ruta 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 a 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.

    Esta acción descargará la función en tu máquina local y la abrirá 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, se mostrará un indicador de progreso de progress_activity. Cuando se complete, aparecerá una marca de verificación check_circle. Si falla, aparecerá un error.

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

    Resultado 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 la 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 ella, 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.

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 opción rápida Trigger function via HTTP que aparece, selecciona una de 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 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 repetidamente.

¿Qué sigue?

Obtener asistencia

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