Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina descrive alcune informazioni di base per iniziare a sviluppare
un servizio per Cloud Run.
Requisiti di codice
Quando sviluppi un servizio, devi soddisfare i seguenti requisiti:
Il servizio deve ascoltare le richieste.
Puoi configurare la porta
su cui vengono inviate le richieste.
All'interno delle istanze Cloud Run, il valore della variabile di ambiente PORT
riflette sempre la porta a cui vengono inviate le richieste.
Il codice deve verificare l'esistenza di questa variabile di ambiente PORT e, se presente, deve eseguire le operazioni di ascolto per massimizzare la portabilità.
Il servizio deve essere stateless. Non può basarsi su uno stato locale persistente.
Se il servizio esegue attività in background al di fuori dell'ambito della gestione delle richieste, deve utilizzare l'impostazione fatturazione basata sull'istanza per allocare la CPU al di fuori del ciclo di richiesta standard.
Il deployment dell'origine Cloud Run supporta comodamente più runtime di linguaggio, ognuno dei quali è disponibile tramite le immagini di base dei container fornite dai buildpack di Google Cloud. Puoi anche utilizzare altri linguaggi di programmazione o
framework, a condizione che il codice sorgente si trovi in un'immagine conforme a OCI.
Puoi utilizzare un server web per rimanere in ascolto sulla porta richiesta ed elaborare e
instradare le richieste in entrata. Ad esempio, gli sviluppatori Node.js possono utilizzare
Express.js, gli sviluppatori Python possono utilizzare
Flask, gli sviluppatori Ruby possono utilizzare
Sinatra e così via.
Puoi ricevere assistenza basata sull'AI dalla chat di Gemini Cloud Assist per progettare le applicazioni in modo ottimale. Con Gemini Cloud Assist, puoi
scoprire le configurazioni e le strategie più adatte per il deployment delle tue
applicazioni su Cloud Run, garantendo un utilizzo efficiente delle risorse
e un funzionamento ottimale.
Per utilizzare Gemini Cloud Assist dalla console Google Cloud , segui questi passaggi:
Nella barra degli strumenti della console, seleziona un Google Cloud progetto. Utilizza un progetto
associato a un ID progetto che hai inviato dopo aver ottenuto l'accesso a
Gemini Cloud Assist.
Fai clic su sparkApri o chiudi la chat dell'AI di Gemini.
Si apre il riquadro di Gemini.
Se necessario, fai clic su Accetta se accetti i termini.
Se hai una domanda su un'applicazione specifica, fornisci il contesto
andando alla pagina che mostra la risorsa prima di porre la domanda. Quando
genera una risposta, Gemini include informazioni sulla
pagina e sul progetto della console corrente.
Inserisci un prompt nel riquadro Gemini.
La seguente tabella fornisce alcuni prompt di esempio per l'utilizzo di Gemini Cloud Assist con Cloud Run.
Prompt
Tipo di risposta
"Voglio progettare un'app Node.js su Cloud Run. Qual è l'approccio consigliato e cosa devo sapere?"
Riepilogo della containerizzazione dell'app, della strutturazione dell'app Node.js e della procedura di deployment.
"Quale autorizzazione mi serve per eseguire il deployment di un'app Cloud Run?"
Elenco delle autorizzazioni e dei ruoli richiesti.
"Voglio eseguire il deployment di un'applicazione web a tre livelli utilizzando Cloud Run"
Descrizione generale dei passaggi per progettare un'app web a tre livelli.
"Come faccio a eseguire la migrazione della mia app App Engine a Cloud Run?"
Panoramica di alto livello dei passaggi chiave per preparare l'ambiente di sviluppo Cloud Run e alcune differenze chiave tra i due prodotti. Link a un tutorial di esempio che può essere utilizzato per personalizzare la soluzione in base alle tue esigenze specifiche.
"Qual è il comando gcloud CLI per aggiornare l'impostazione del numero minimo di istanze a 2 per il mio servizio Cloud Run "example-service"?"
Comando gcloud CLI suggerito per aggiornare l'impostazione del numero minimo di istanze.
"Come faccio ad aggiornare il mio account di servizio per il mio servizio Cloud Run hello-world?"
Comando gcloud CLI suggerito per l'aggiornamento del account di servizio.
"Mostrami un esempio di creazione di un'app di AI generativa su Cloud Run con LangChain"
Passaggi per creare un'app di esempio utilizzando Cloud Run con LangChain.
"Genera una configurazione Terraform utilizzando la risorsa google_cloud_run_v2_service per un servizio Cloud Run che imposta l'impostazione di fatturazione sulla fatturazione basata sulle istanze"
Configurazione Terraform suggerita per l'aggiornamento dell'impostazione di fatturazione.
Per maggiori dettagli, consulta le risorse seguenti:
Per le best practice per la progettazione, l'implementazione, il test e il deployment di un
servizio Cloud Run, consulta i suggerimenti per lo sviluppo.
[[["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-04 UTC."],[],[],null,["# Developing your service\n\nThis page describes a few things you need to know to get started in developing\na service for Cloud Run.\n\nCode requirements\n-----------------\n\nYou must meet the following requirements when you develop a service:\n\n- The service must listen for requests. You can [configure the port](/run/docs/configuring/services/containers#configure-port) on which requests are sent. Inside Cloud Run instances, the value of the `PORT` environment variable always reflects the port to which requests are sent. Your code should check for the existence of this `PORT` environment variable and if it is present, should listen on it to maximize portability.\n- The service must be *stateless* . It cannot rely on a persistent **local** state.\n- If the service performs background activities outside the scope of request handling it must use the [instance-based billing](/run/docs/configuring/billing-settings#choosing-background-execution) setting in order to have CPU allocated outside of the standard request cycle.\n- If your service uses NFS, it must use the [second generation execution environment](/run/docs/about-execution-environments).\n\nYou can find more details about these constraints in the [Container runtime contract](/run/docs/reference/container-contract).\n\nProgramming language support\n----------------------------\n\nCloud Run source deployment conveniently supports multiple\n[language runtimes](/run/docs/configuring/services/runtime-base-images), each of\nwhich is available through container base images provided by\nGoogle Cloud's buildpacks. You can also use other programming languages or\nframeworks, as long as the source code is in an OCI-compliant image.\n\nThe [build and deploy quickstarts](/run/docs/quickstarts#build-and-deploy-a-web-service)\nprovides samples in many popular languages.\n\nUsing a web server\n------------------\n\nYou can use a web server to listen on the required port, and to process and\nroute incoming requests. For example, Node.js developers can use\n[Express.js](https://expressjs.com/), Python developers can use\n[Flask](http://flask.pocoo.org/), Ruby developers can use\n[Sinatra](http://sinatrarb.com/), and so forth.\n\nContainerizing your code\n------------------------\n\nSee [Containerize your code](/run/docs/building/containerize-your-code) for\ndetails.\n\nDesign Cloud Run apps with Gemini assistance\n--------------------------------------------\n\n\u003cbr /\u003e\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\nYou can get AI-powered help from\n[Gemini Cloud Assist](/gemini/docs/cloud-assist/overview) chat to\ndesign applications optimally. With Gemini Cloud Assist, you can\ndiscover the most suitable configurations and strategies for deploying your\napplications on Cloud Run, ensuring efficient resource\nutilization and seamless operation.\n\nTo use Gemini Cloud Assist from the Google Cloud console, do\nthe following:\n\n1. [Ensure that Gemini Cloud Assist is set up for your Google Cloud user account and project](/gemini/docs/cloud-assist/set-up-gemini).\n\n2. [Set up your Cloud Run development environment](/run/docs/setup)\n in your Google Cloud project and ensure you have the appropriate\n [deployment permissions](/run/docs/reference/iam/roles#additional-configuration).\n\n3. Go to the Cloud Run page in the Google Cloud console.\n\n [Go to Cloud Run](https://console.cloud.google.com/run)\n4. In the console toolbar, select a Google Cloud project. Use a project\n associated with a project ID you submitted after you were granted access to\n Gemini Cloud Assist.\n\n5. Click spark\n **Open or close Gemini AI chat**.\n\n The Gemini panel opens.\n6. If necessary, click **Accept** if you agree to the terms.\n\n7. If you have a question about a specific application, provide context by\n going to the page that shows your resource before asking your question. When\n generating a response, Gemini includes information about the\n current console page and project.\n\n8. Enter a prompt in the **Gemini** panel.\n\n The following table provide some example prompts for using\n Gemini Cloud Assist with Cloud Run.\n\nFor more details, see the following resources:\n\n- Learn how to [write better prompts](/gemini/docs/discover/write-prompts).\n- Learn how to use the [Gemini Cloud Assist panel](/gemini/docs/cloud-assist-panel).\n- Read [Use Gemini for AI assistance and development](/gemini/docs/overview).\n- Learn [how Gemini for Google Cloud uses your data](/gemini/docs/discover/data-governance).\n\nWhat's next\n-----------\n\n- Once you have your service code and Dockerfile, you should [build a container image](/run/docs/building/containers) then continue iterating in [local testing](/run/docs/testing/local).\n- If you are migrating an existing web application, see [Migrating Your Service to Cloud Run](/run/docs/migrating).\n- For best practices for designing, implementing, testing, and deploying a Cloud Run service, see the [Development tips](/run/docs/tips)."]]