Scrivi una funzione Cloud Functions
Cloud Functions supporta la scrittura di codice sorgente una serie di linguaggi di programmazione. Il runtime del linguaggio scelto e il tipo di funzione che vuoi scrivere determinare come strutturare il codice e implementare la funzione. Questa pagina offre una panoramica dei tipi di funzioni Cloud Functions e delle aspettative codice sorgente.
Tipi di funzioni Cloud Functions
Esistono due tipi di funzioni Cloud Functions:
Funzioni HTTP, che gestiscono le richieste HTTP e utilizzano Trigger HTTP. Consulta: Scrivere funzioni HTTP per informazioni sull'implementazione delle funzioni HTTP.
Funzioni basate su eventi, che gestiscono gli eventi dell'ambiente cloud. e utilizzare gli attivatori di eventi come descritto in Trigger di Cloud Functions. Consulta: Scrivere funzioni basate su eventi per informazioni sull'implementazione delle funzioni basate su eventi.
Utilizza una funzione HTTP quando hai bisogno che la funzione abbia un endpoint URL e rispondere a richieste HTTP, ad esempio per i webhook. Utilizzare una funzione basata su eventi quando la tua funzione deve essere attivata direttamente in risposta agli eventi all'interno di del tuo progetto Google Cloud, ad esempio i messaggi su un argomento Pub/Sub o le modifiche in un bucket Cloud Storage.
Struttura della directory di origine
Per consentire a Cloud Functions di individuare la definizione della tua funzione, ogni del runtime del linguaggio ha requisiti per strutturare il codice sorgente. Le basi di seguito è riportata la struttura di directory per una funzione in ciascun runtime.
Node.js
La struttura di base della directory per le funzioni Node.js è la seguente:
. ├── index.js └── package.json
Per impostazione predefinita, Cloud Functions tenta di caricare il codice sorgente da un file
denominato index.js
nella directory principale della directory delle funzioni. Per specificare un valore diverso
di origine principale, usa il campo main
nel file package.json
.
Il file package.json
deve includere anche i seguenti elementi:
Framework delle funzioni per Node.js
come dipendenza:
{
"main": "index.js",
"dependencies": {
"@google-cloud/functions-framework": "^3.0.0"
}
}
Il codice del file principale deve definire il punto di ingresso della funzione e importare altri moduli di codice e Node.js come di consueto. Il file principale può anche definire più punti di ingresso alle funzioni di cui è possibile eseguire il deployment separatamente.
Python
La struttura di base della directory per le funzioni Python è la seguente:
. ├── main.py └── requirements.txt
Cloud Functions carica il codice sorgente da un file denominato main.py
nel
principale della directory delle funzioni. Il nome del file principale deve essere main.py
.
Il file requirements.txt
deve includere i seguenti elementi:
Framework delle funzioni per Python
come dipendenza:
functions-framework==3.*
Il codice nel file main.py
deve definire
punto di accesso alla funzione e può importare altro codice e
delle dipendenze come di consueto. Il file main.py
può anche definire più funzioni
di punti di contatto di cui è possibile
eseguire il deployment separatamente.
Vai
La struttura di base della directory 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, ad eccezione del fatto 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 i seguenti elementi:
Framework delle funzioni per Go
come dipendenza:
module example.com/my-module
require (
github.com/GoogleCloudPlatform/functions-framework-go v1.5.2
)
Il codice del pacchetto principale deve definire punto di ingresso della funzione e può importare altro codice da sottopacchetti e le dipendenze come di consueto. Il pacchetto può anche definire più funzioni di punti di contatto di cui è possibile eseguire il deployment separatamente.
Java
La struttura di base della directory 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
un nome qualsiasi. Se i tuoi 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 i seguenti elementi:
Framework di funzioni 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 punto di accesso alla funzione e può importare altro codice e delle dipendenze come di consueto. I file di origine possono anche definire più funzioni di punti di contatto di cui è possibile eseguire il deployment separatamente.
C#
La struttura di base della directory per le funzioni .NET è la seguente:
. ├── MyFunction.cs └── MyProject.csproj
Puoi strutturare i progetti come faresti con qualsiasi altro codice sorgente .NET. I file di origine possono avere qualsiasi nome.
Il file di progetto deve includere Framework di funzioni per .NET come dipendenza:
...
<PackageReference Include="Google.Cloud.Functions.Hosting" Version="1.0.0" />
...
Il codice nei file sorgente deve definire punto di accesso alla funzione e può importare altro codice e delle dipendenze come di consueto. I file di origine possono anche definire più funzioni di punti di contatto di cui è possibile eseguire il deployment separatamente.
Puoi anche Usa il pacchetto di modelli Cloud Functions per .NET per generare i file richiesti.
Ruby
La struttura di base della directory per le funzioni Ruby è la seguente:
. ├── app.rb ├── Gemfile └── Gemfile.lock
Cloud Functions carica il codice sorgente da un file denominato app.rb
nel
principale della directory delle funzioni. Il nome del file principale deve essere app.rb
.
Il file Gemfile
deve includere i seguenti elementi:
Framework di funzioni per Ruby
come dipendenza:
source "https://rubygems.org"
gem "functions_framework", "~> 1.0"
Il codice nel file app.rb
deve definire
punto di accesso alla funzione e può importare altro codice e
delle dipendenze come di consueto. Il file app.rb
può anche definire più funzioni
di punti di contatto di cui è possibile
eseguire il deployment separatamente.
PHP
La struttura di base della directory per le funzioni PHP è la seguente:
. ├── index.php └── composer.json
Cloud Functions carica il codice sorgente da un file denominato index.php
nel
principale della directory delle funzioni. Il nome del file principale deve essere index.php
.
Il file composer.json
deve includere i seguenti elementi:
Framework di funzioni per PHP
come dipendenza:
{
"require": {
"google/cloud-functions-framework": "^1.1"
}
}
Il codice nel file index.php
deve definire
punto di accesso alla funzione e può importare altro codice e
delle dipendenze come di consueto. Il file index.php
può anche definire più funzioni
di punti di contatto di cui è possibile
eseguire il deployment separatamente.
Se stai pensando di raggruppare più funzioni in un unico progetto, sapendo che ogni funzione può condividere lo stesso insieme di dipendenze. Tuttavia, alcune funzioni potrebbero non richiedere tutte le dipendenze.
Se possibile, consigliamo di suddividere i codebase multifunzione di grandi dimensioni mettendo ciascuna funzione nella propria directory di primo livello come mostrato sopra, con le di origine e di configurazione del progetto. Questo approccio riduce al minimo il numero di dipendenze richieste per una particolare funzione, che a sua volta riduce il quantità di memoria necessaria per la funzione.
Punto di ingresso della funzione
Il codice sorgente deve definire un punto di ingresso per la funzione, ovvero particolare codice che viene eseguito quando viene richiamata la Cloud Function. Questo punto di ingresso viene specificato al momento del deployment della funzione.
Il modo in cui definisci il punto di ingresso dipende dal runtime del linguaggio utilizzato. Per alcuni lingue, il punto di ingresso è una funzione, mentre per altre per un corso. Per scoprire di più sulla definizione dei punti di ingresso e sull'implementazione di Cloud Functions in diversi linguaggi, consulta Scrivere funzioni HTTP e Scrivere funzioni basate su eventi.
Dipendenze
Puoi gestire le dipendenze utilizzando gli strumenti standard per ogni runtime. Per ulteriori informazioni informazioni, consulta la pagina appropriata:
- Specifica delle dipendenze in Node.js
- Specifica delle dipendenze in Python
- Specificare le dipendenze in Go
- Specifica delle dipendenze in Java
- Specificare le dipendenze in .NET
- Specificare le dipendenze in Ruby
- Specifica delle dipendenze in PHP
Passaggi successivi
- Scopri come scrivere funzioni HTTP.
- Scopri come scrivere funzioni basate su eventi.
- Scopri di più sui trigger di Cloud Functions.