Se stai creando una nuova funzione, consulta la guida rapida della console su Cloud Run. I contenuti di questa pagina si applicano solo alle funzioni legacy esistenti create con l'API Cloud Functions v1.
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Testare una funzione Cloud Run prima del deployment
Questa guida mostra come testare una funzione Cloud Run nella console Google Cloud prima di eseguirne il deployment. Questa funzionalità è disponibile per le funzioni Node.js e Python.
Preparare una funzione per il test
Per preparare una funzione per il test:
Apri la pagina Panoramica di Functions nella console Google Cloud :
Assicurati che sia selezionato il progetto per il quale hai attivato Cloud Run Functions.
Fai clic su Crea funzione per creare una nuova funzione Node.js o Python oppure
seleziona una funzione Node.js o Python esistente e fai clic su Modifica per modificarla.
Fai clic su Avanti per passare alla pagina di modifica del codice:
Fai clic su Testa funzione per avviare la procedura di test.
Quando richiesto, fai clic su Inizia il test per autorizzare l'utilizzo del
terminale Cloud Shell.
Esegui il test
Quando completi i passaggi precedenti, si apre il riquadro dell'evento di attivazione a destra, a conferma che la funzione è pronta per essere testata. Fai clic su Esegui test:
Questa fase del processo di test include i seguenti componenti:
Riquadro Evento di trigger. Il riquadro dell'evento di trigger è precompilato
con un payload che corrisponde al trigger evento specificato nella
pagina di configurazione. Questo è l'input della funzione.
Finestra di output di Cloud Shell. La finestra di output di Cloud Shell
mostra il codice di stato HTTP e qualsiasi risposta restituita al chiamante.
Esegui test esegue il test.
Puoi osservare l'output del test nella finestra di Cloud Shell:
Terminale Cloud Shell
Puoi visualizzare l'output di logging della tua funzione nel terminale Cloud Shell nella parte inferiore dello schermo. Ad esempio, vedrai l'output del packaging del codice sorgente
quando apri il riquadro di test. Quando esegui un test, vedrai le modifiche al codice sorgente e l'output a livello di esecuzione, inclusi console.log ed errori.
Se il test non riesce, il terminale Cloud Shell visualizza un messaggio di errore
per aiutarti a individuare la causa esatta, ad esempio:
[11:31:47 AM] - Provided module can't be loaded.
Is there a syntax error in your code?
Detailed stack trace: /workspace/index.js:11
: 'World';
^
SyntaxError: Unexpected token ':'
at Object.compileFunction (node:vm:360:18)
at wrapSafe (node:internal/modules/cjs/loader:1048:15)
at Module._compile (node:internal/modules/cjs/loader:1083:27)
at Module._extensions..js (node:internal/modules/cjs/loader:1173:10)
at Module.load (node:internal/modules/cjs/loader:997:32)
at Module._load (node:internal/modules/cjs/loader:838:12)
at Module.require (node:internal/modules/cjs/loader:1021:19)
at require (node:internal/modules/cjs/helpers:103:18)
at getUserFunction (/workspace/node_modules/@google-cloud/functions-framework/build/src/loader.js:98:30)
at async main (/workspace/node_modules/@google-cloud/functions-framework/build/src/main.js:35:32)
[11:31:47 AM] - Could not load the function, shutting down.
Esegui il deployment
Al termine del test, puoi eseguire il deployment della funzione nel solito modo
facendo clic su Esegui il deployment.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-03 UTC."],[[["\u003cp\u003eThis guide demonstrates how to test Node.js and Python Cloud Run functions within the Google Cloud console before deployment, ensuring functionality.\u003c/p\u003e\n"],["\u003cp\u003eThe testing process includes a triggering event panel with pre-populated payload, a Cloud Shell output window for HTTP status and responses, and a "Run test" button to execute the test.\u003c/p\u003e\n"],["\u003cp\u003eCloud Shell terminal logs provide detailed output, showing source code packaging and execution data, including \u003ccode\u003econsole.log\u003c/code\u003e outputs and potential error messages to aid in debugging.\u003c/p\u003e\n"],["\u003cp\u003eIf tests fail, the Cloud Shell terminal displays specific error messages to help pinpoint issues, suggesting code review and test re-runs or a complete restart if the problem persists.\u003c/p\u003e\n"],["\u003cp\u003eThe Cloud Run functions testing is currently under a "Pre-GA Offerings Terms", meaning that the feature is "as-is" with potential limited support.\u003c/p\u003e\n"]]],[],null,["# Test a Cloud Run functions before deployment\n============================================\n\n|\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThis guide shows you how to test a Cloud Run function in Google Cloud console\nbefore deploying it. This feature is available for Node.js and Python functions.\n\nPrepare a function for testing\n------------------------------\n\nTo prepare a function for testing:\n\n1. Open the Functions Overview page in the Google Cloud console:\n\n [Go to the Cloud Run functions Overview page](https://console.cloud.google.com/functions/list)\n\n Make sure that the project for which you enabled Cloud Run functions is\n selected.\n2. Click **Create Function** to create a new Node.js or Python function, or\n select an existing Node.js or Python function and click **Edit** to edit it.\n\n3. Click **Next** to advance to the code editing page:\n\n4. Click **Test Function** to start the testing process.\n\n5. When prompted, click **Start testing** to authorize use of the\n Cloud Shell Terminal.\n\nRun the test\n------------\n\nWhen you complete the preceding steps, the triggering event panel opens on the\nright, confirming that the function is ready to be tested. Click **Run test**:\n\nThis phase of the testing process includes the following components:\n\n- **Triggering event panel**. The triggering event panel is pre-populated with a payload that matches the event trigger you specified on the configuration page. This is the input to your function.\n- **Cloud Shell output window**. The Cloud Shell output window displays the HTTP status code and any response returned to the caller.\n- **Run test** executes the test.\n\nYou can observe the output from the test in the Cloud Shell window:\n\n| **Note:** It can take 1-3 minutes when initializing the testing panel for the first time. Subsequent times should only take a few seconds. If it takes longer than 3 minutes and you don't see any progress indicators, back up your source code, refresh your browser tab, and restart testing from scratch.\n\nCloud Shell terminal\n--------------------\n\nYou can view logging output by your function in the Cloud Shell terminal at\nthe bottom of your screen. For example, you'll see source code packaging output\nwhen you open the testing panel. When you run a test, you'll see your source\ncode changes and execution level output, including `console.log` and errors.\n\nIf your test fails, the Cloud Shell terminal displays an error message\nto help you pinpoint the exact cause, for example: \n\n```\n[11:31:47 AM] - Provided module can't be loaded.\nIs there a syntax error in your code?\nDetailed stack trace: /workspace/index.js:11\n : 'World';\n ^\n\nSyntaxError: Unexpected token ':'\n at Object.compileFunction (node:vm:360:18)\n at wrapSafe (node:internal/modules/cjs/loader:1048:15)\n at Module._compile (node:internal/modules/cjs/loader:1083:27)\n at Module._extensions..js (node:internal/modules/cjs/loader:1173:10)\n at Module.load (node:internal/modules/cjs/loader:997:32)\n at Module._load (node:internal/modules/cjs/loader:838:12)\n at Module.require (node:internal/modules/cjs/loader:1021:19)\n at require (node:internal/modules/cjs/helpers:103:18)\n at getUserFunction (/workspace/node_modules/@google-cloud/functions-framework/build/src/loader.js:98:30)\n at async main (/workspace/node_modules/@google-cloud/functions-framework/build/src/main.js:35:32)\n\n[11:31:47 AM] - Could not load the function, shutting down.\n```\n| **Note:** If the server crashes, you will see a message prompting you to check your source code and re-run the test. If that does not fix the problem, back up your source code, refresh your browser tab, and restart testing from scratch.\n\nDeploy\n------\n\nOnce you're finished testing, you can deploy your function in the usual way\nby clicking **Deploy**."]]