Escribe funciones de Cloud Run

Node.js

A continuación, se muestra la estructura básica de directorios para las funciones de Node.js:

.
├── index.js
└── package.json

De forma predeterminada, las funciones de Cloud Run intentan cargar el código fuente desde un archivo llamado index.js en la raíz del directorio de tu función. Para especificar un archivo de origen principal diferente, usa el campo main en el archivo package.json.

Tu archivo package.json también debe incluir Functions Framework para Node.js como una dependencia:

{
  "main": "index.js",
  "dependencies": {
    "@google-cloud/functions-framework": "^3.0.0"
  }
}

El código de tu archivo principal debe definir el punto de entrada de la función y puede importar otros códigos y módulos de Node.js como de costumbre. El archivo principal también puede definir varios puntos de entrada de funciones que se pueden implementar por separado.

Python

A continuación, se muestra la estructura básica de directorios para las funciones de Python:

.
├── main.py
└── requirements.txt

Las funciones de Cloud Run cargan el código fuente de un archivo llamado main.py en la raíz del directorio de tu función. Tu archivo principal debe llamarse main.py.

El archivo requirements.txt debe incluir Functions Framework para Python como una dependencia:

functions-framework==3.*

El código de tu archivo main.py debe definir el punto de entrada de la función y puede importar otro código y dependencias externas con normalidad. El archivo main.py también puede definir varios puntos de entrada de funciones que se pueden implementar por separado.

Go

La estructura básica de directorios para las funciones de Go es la siguiente:

.
├── myfunction.go
└── go.mod

Tu función debe estar en un paquete de Go en la raíz de tu proyecto. El paquete y sus archivos de origen pueden tener cualquier nombre, excepto que la función no puede estar en package main. Si necesitas un paquete main, por ejemplo, para realizar pruebas locales, puedes crear uno en un subdirectorio:

.
├── myfunction.go
├── go.mod
└── cmd/
    └── main.go

El archivo go.mod debe incluir Functions Framework para Go como una dependencia:

module example.com/my-module

require (
  github.com/GoogleCloudPlatform/functions-framework-go v1.5.2
)

El código de tu paquete raíz debe definir el punto de entrada de tu función y puede importar otro código de subpaquetes y dependencias con normalidad. El paquete también puede definir varios puntos de entrada de funciones que pueden implementarse por separado.

Java

La estructura de directorios básica de las funciones de Java es la siguiente:

.
├── pom.xml
└── src/
    └── main/
        └── java/
            └── MyFunction.java

Los archivos de origen de Java deben estar en el directorio src/main/java/ y pueden tener cualquier nombre. Si tus archivos de origen declaran un paquete, agrega un directorio adicional en src/main/java con el nombre del paquete:

.
├── pom.xml
└── src/
    └── main/
        └── java/
            └── mypackage/
                └── MyFunction.java

Recomendamos colocar pruebas asociadas en un subdirectorio src/test/java/.

El archivo pom.xml debe incluir Functions Framework para Java como una dependencia:

...
    <dependency>
      <groupId>com.google.cloud.functions</groupId>
      <artifactId>functions-framework-api</artifactId>
      <version>1.0.4</version>
    </dependency>
...

El código de tus archivos de origen debe definir el punto de entrada de la función y puede importar otro código y dependencias externas con normalidad. Los archivos de origen también pueden definir varios puntos de entrada de funciones que pueden implementarse por separado.

C#

La estructura básica de directorios para las funciones de .NET es la siguiente:

.
├── MyFunction.cs
└── MyProject.csproj

Puedes estructurar los proyectos como lo harías con cualquier otro código fuente .NET. Los archivos de origen pueden tener cualquier nombre.

El archivo de tu proyecto debe incluir Functions Framework para .NET como una dependencia:

...
    <PackageReference Include="Google.Cloud.Functions.Hosting" Version="1.0.0" />
...

El código de tus archivos de origen debe definir el punto de entrada de la función y puede importar otro código y dependencias externas con normalidad. Los archivos de origen también pueden definir varios puntos de entrada de funciones que pueden implementarse por separado.

También puedes usar el paquete de plantillas de funciones de Cloud Run para .NET a fin de generar los archivos necesarios.

Ruby

La estructura de directorios básica de las funciones de Ruby es la siguiente:

.
├── app.rb
├── Gemfile
└── Gemfile.lock

Las funciones de Cloud Run cargan el código fuente de un archivo llamado app.rb en la raíz del directorio de tu función. Tu archivo principal debe llamarse app.rb.

El archivo Gemfile debe incluir Functions Framework para Ruby como una dependencia:

source "https://rubygems.org"
gem "functions_framework", "~> 1.0"

El código de tu archivo app.rb debe definir el punto de entrada de la función y puede importar otro código y dependencias externas con normalidad. El archivo app.rb también puede definir varios puntos de entrada de funciones que se pueden implementar por separado.

PHP

La estructura básica de directorios para las funciones de PHP es la siguiente:

.
├── index.php
└── composer.json

Las funciones de Cloud Run cargan el código fuente de un archivo llamado index.php en la raíz del directorio de tu función. Tu archivo principal debe llamarse index.php.

El archivo composer.json debe incluir Functions Framework para PHP como una dependencia:

{
  "require": {
    "google/cloud-functions-framework": "^1.1"
  }
}

El código de tu archivo index.php debe definir el punto de entrada de la función y puede importar otro código y dependencias externas con normalidad. El archivo index.php también puede definir varios puntos de entrada de funciones que se pueden implementar por separado.