Scrivi funzioni Cloud Run

Node.js

La struttura di directory di base per le funzioni Node.js è la seguente:

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

Per impostazione predefinita, le funzioni Cloud Run tentano di caricare il codice sorgente da un file chiamato index.js nella directory principale della funzione. Per specificare un file di origine principale diverso, utilizza il campo main nel file package.json.

Il file package.json deve includere anche il Functions Framework per Node.js come dipendenza:

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

Il codice nel file principale deve definire l'entry point della funzione e può importare altro codice e moduli Node.js come di consueto. Il file principale può anche definire più entry point di funzione che possono essere implementati separatamente.

Python

La struttura di directory di base per le funzioni Python è la seguente:

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

Le funzioni Cloud Run caricano il codice sorgente da un file denominato main.py nella directory principale della funzione. Il file principale deve avere il nome main.py.

Il file requirements.txt deve includere il Functions Framework per Python come dipendenza:

functions-framework==3.*

Il codice nel file main.py deve definire il punto di ingresso della funzione e può importare altro codice e dipendenze esterne come di consueto. Il file main.py può anche definire più punti di accesso alle funzioni che possono essere implementati separatamente.

Vai

La struttura di directory di base per le funzioni Go è la seguente:

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

La funzione deve trovarsi in un pacchetto Go nella directory principale del progetto. Il pacchetto e i relativi file di origine possono avere qualsiasi nome, tranne che la funzione non può essere in package main. Se hai bisogno di un pacchetto main, ad esempio per i test locali, puoi crearne uno in una sottodirectory:

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

Il file go.mod deve includere il Functions Framework per Go come dipendenza:

module example.com/my-module

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

Il codice nel pacchetto principale deve definire il punto di contatto della funzione e può importare altro codice dai sottopacchetti e dalle dipendenze come di consueto. Il pacchetto può anche definire più punti di accesso alle funzioni che possono essere implementati separatamente.

Java

La struttura di directory di base per le funzioni Java è la seguente:

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

I file di origine Java devono trovarsi nella directory src/main/java/ e possono avere qualsiasi nome. Se i file di origine dichiarano un pacchetto, aggiungi un'altra directory in src/main/java con il nome del pacchetto:

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

Ti consigliamo di inserire i test associati in una sottodirectory src/test/java/.

Il file pom.xml deve includere il Functions Framework per Java come dipendenza:

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

Il codice nei file sorgente deve definire il punto di ingresso della funzione e può importare altro codice e dipendenze esterne come di consueto. I file di origine possono anche definire più punti di accesso alle funzioni che possono essere implementati separatamente.

C#

La struttura di directory di base per le funzioni .NET è la seguente:

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

Puoi strutturare i tuoi progetti come faresti con qualsiasi altro codice sorgente .NET. I file di origine possono avere qualsiasi nome.

Il file del progetto deve includere il Functions Framework per .NET come dipendenza:

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

Il codice nei file sorgente deve definire il punto di ingresso della funzione e può importare altro codice e dipendenze esterne come di consueto. I file di origine possono anche definire più punti di accesso alle funzioni che possono essere implementati separatamente.

Puoi anche utilizzare il pacchetto di modelli di funzioni Cloud Run per .NET per generare i file richiesti.

Ruby

La struttura di directory di base per le funzioni Ruby è la seguente:

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

Le funzioni Cloud Run caricano il codice sorgente da un file denominato app.rb nella directory principale della funzione. Il file principale deve avere il nome app.rb.

Il file Gemfile deve includere il Functions Framework per Ruby come dipendenza:

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

Il codice nel file app.rb deve definire il punto di ingresso della funzione e può importare altro codice e dipendenze esterne come di consueto. Il file app.rb può anche definire più punti di accesso alle funzioni che possono essere implementati separatamente.

PHP

La struttura di directory di base per le funzioni PHP è la seguente:

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

Le funzioni Cloud Run caricano il codice sorgente da un file denominato index.php nella directory principale della funzione. Il file principale deve avere il nome index.php.

Il file composer.json deve includere il Framework di Functions per PHP come dipendenza:

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

Il codice nel file index.php deve definire il punto di ingresso della funzione e può importare altro codice e dipendenze esterne come di consueto. Il file index.php può anche definire più punti di accesso alle funzioni che possono essere implementati separatamente.