La funzione Cloud Run viene eseguita in un ambiente costituito da una versione del sistema operativo con pacchetti aggiuntivi, supporto linguistico e la libreria Node.js Functions Framework che supporta e richiama la funzione. Questo ambiente è identificato dalla versione della lingua ed è noto come ID runtime.
Preparazione della funzione
Puoi preparare una funzione direttamente dalla console Google Cloud o scriverla sulla tua macchina locale e caricarla. Per preparare la tua macchina locale per lo sviluppo Node.js, consulta Configurare un ambiente di sviluppo Node.js.
Runtime Node.js e immagini di base supportati
Runtime | ID runtime | Stack | Immagine di base runtime |
---|---|---|---|
Node.js 24 (solo anteprima) |
nodejs24 |
|
|
Node.js 22 | nodejs22 |
|
|
Node.js 20 | nodejs20 |
|
|
Node.js 18 | nodejs18 |
|
|
Node.js 16 | nodejs16 | google-18-full | google-18-full/nodejs16 |
Node.js 14 | nodejs14 | google-18-full | google-18-full/nodejs14 |
Node.js 12 | nodejs12 | google-18-full | google-18-full/nodejs12 |
Node.js 10 | nodejs10 | google-18-full | google-18-full/nodejs10 |
Node.js 8 | nodejs8 | Dismesso | Dismesso |
Node.js 6 | nodejs6 | Dismesso | Dismesso |
Seleziona il runtime
Puoi selezionare uno dei runtime Node.js supportati per la tua funzione durante il deployment.
Puoi selezionare una versione del runtime utilizzando la console Google Cloud o gcloud CLI. Fai clic sulla scheda per visualizzare le istruzioni sull'utilizzo dello strumento che preferisci:
gcloud
Specifica l'immagine di base Node.js per la tua funzione utilizzando il flag --base-image
durante il deployment della funzione. Ad esempio:
gcloud run deploy FUNCTION \
--source . \
--function FUNCTION_ENTRYPOINT \
--base-image nodejs22
Sostituisci:
FUNCTION con il nome della funzione che stai eseguendo il deployment. Puoi omettere completamente questo parametro, ma ti verrà chiesto il nome se lo ometti.
FUNCTION_ENTRYPOINT con l'entry point della tua funzione nel codice sorgente. Questo è il codice eseguito da Cloud Run quando viene eseguita la funzione. Il valore di questo flag deve essere un nome di funzione o un nome di classe completo che esiste nel codice sorgente.
Per istruzioni dettagliate sul deployment di una funzione utilizzando gcloud CLI, vedi Eseguire il deployment delle funzioni in Cloud Run.
Console
Puoi selezionare una versione del runtime quando crei o aggiorni una funzione Cloud Run nella Google Cloud console. Per istruzioni dettagliate sul deployment di una funzione, consulta Eseguire il deployment di funzioni in Cloud Run.
Per selezionare un runtime nella console Google Cloud quando crei una funzione:
Nella console Google Cloud , vai alla pagina Cloud Run:
Fai clic su Scrivi una funzione.
Nell'elenco Runtime, seleziona una versione del runtime Node.js.
Fai clic su Crea e attendi che Cloud Run crei il servizio utilizzando una revisione segnaposto.
La console ti reindirizzerà alla scheda Origine, dove potrai visualizzare il codice sorgente della tua funzione. Fai clic su Salva e ridistribuisci.
Per istruzioni dettagliate sull'aggiornamento della versione del runtime dopo il deployment della funzione, consulta Eseguire nuovamente il deployment del nuovo codice sorgente.
Struttura del codice sorgente
Affinché le funzioni Cloud Run trovino la definizione della tua funzione, il codice sorgente deve seguire una struttura specifica. Per saperne di più, consulta Scrivi funzioni Cloud Run.
Specifica delle dipendenze
Puoi specificare le dipendenze per le tue funzioni elencandole in un file
package.json
. Per ulteriori informazioni, consulta la sezione
Specificare le dipendenze in Node.js.
Script di build NPM
Per impostazione predefinita, il runtime Node.js esegue npm run build
se viene rilevato uno script build
in package.json
. Se hai bisogno di un maggiore controllo sui passaggi di build prima di avviare l'applicazione, puoi fornire un passaggio di build personalizzato aggiungendo uno script gcp-build
al file package.json
.
Puoi impedire l'esecuzione dello script npm run build
nella build:
Aggiunta di uno script
gcp-build
con un valore vuoto nel filepackage.json
:"gcp-build":""
.Impostando la variabile di ambiente di build
GOOGLE_NODE_RUN_SCRIPTS
sulla stringa vuota per impedire l'esecuzione di tutti gli script.
Completamento della funzione asincrona
Quando lavori con attività asincrone che coinvolgono callback o oggetti Promise
, devi comunicare esplicitamente al runtime che la tua funzione ha terminato l'esecuzione di queste attività. Puoi farlo in diversi modi, come mostrato negli esempi seguenti. Il punto chiave è che il codice deve attendere il completamento dell'attività asincrona o di Promise
prima di essere restituito. In caso contrario, il componente asincrono della funzione potrebbe essere terminato prima del completamento.
Funzioni basate su eventi
Ritorno implicito
exports.implicitlyReturning = async (event, context) => {
return await asyncFunctionThatReturnsAPromise();
};
Ritorno esplicito
exports.explicitlyReturning = function (event, context) {
return asyncFunctionThatReturnsAPromise();
};
Funzioni HTTP
Utilizzare il middleware per gestire le richieste HTTP
Le funzioni HTTP Node.js forniscono oggetti request
e response
compatibili con ExpressJS
per semplificare l'utilizzo delle richieste HTTP. Le funzioni Cloud Run
leggono automaticamente il corpo della richiesta, quindi riceverai sempre il corpo di una
richiesta indipendentemente dal tipo di media. Ciò significa che le richieste HTTP devono essere
considerate completamente lette al momento dell'esecuzione del codice. Il
nesting delle app ExpressJS deve essere utilizzato con questa avvertenza: in particolare,
il middleware che prevede che il corpo di una richiesta non sia letto potrebbe non comportarsi come
previsto.
Utilizzare i moduli ES
I moduli ECMAScript (moduli ES o ESM) sono una funzionalità standard TC39, senza flag,
in Node versione 14+ per il caricamento dei moduli JavaScript. A differenza di CommonJS, ESM
fornisce un'API asincrona per il caricamento dei moduli. Fornisce anche un miglioramento della sintassi
con le istruzioni import
e export
che possono essere utilizzate all'interno
di una funzione Cloud Run (anziché le istruzioni require
).
Per utilizzare ESM all'interno di una funzione Cloud Run, devi
dichiarare "type": "module"
all'interno di package.json
.
{
...
"type": "module",
...
}
Dopodiché puoi utilizzare le istruzioni import
e export
.
Scopri di più sull'utilizzo dei moduli ES.