Desarrolla un servicio de forma local en Cloud Code para IntelliJ
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Con Cloud Code, puedes desarrollar tus servicios de Cloud Run de forma local en un entorno similar a Cloud Run. Cloud Code busca cambios en tu fuente y actualiza rápidamente el servicio en ejecución para reflejar estos cambios.
Define la configuración de ejecución
Antes de ejecutar la aplicación, debes seguir estos pasos para crear la configuración de ejecución:
Navega al selector de configuración Run/Debug en la barra de navegación y haz clic en Edit Configurations.
En Cloud Code: Cloud Run, elige Cloud Run: Ejecutar de manera local.
Si deseas que Cloud Code vuelva a implementar tu aplicación automáticamente después de guardar los cambios, en Modo de observación: volver a compilar y volver a implementar, selecciona Al guardar el archivo. Los servicios nuevos de Cloud Run tienen seleccionada la opción On demand de forma predeterminada. Para obtener más información sobre los modos del reloj, consulta Modos del reloj.
Especifica la opción de compilador y las opciones de configuración relevantes.
Cuando desarrollas de forma local, puedes especificar opciones de configuración adicionales, como una cuenta de servicio, variables de entorno y conexiones de SQL (cuando usas Cloud Run (completamente administrado)) mediante la sección Configuración de revisión avanzada cuando eliges Edit Configurations.
Variables de entorno
Las siguientes variables de entorno se agregan de forma automática a los contenedores en ejecución:
Name
Descripción
Ejemplo
PORT
El puerto en el que debe escuchar el servidor HTTP.
8080
K_SERVICE
El nombre del servicio de Cloud Run que se ejecuta.
hello-world
K_REVISION
El nombre de la revisión de Cloud Run que se ejecuta.
hello-world.1
K_CONFIGURATION
El nombre de la configuración de Cloud Run que creó la revisión.
hello-world
Almacenar secretos
Si el código incluye datos potencialmente sensibles, como claves de API, contraseñas y certificados, se recomienda almacenarlos como secretos. Con Cloud Code, puedes almacenar estos secretos de forma segura en Secret Manager y recuperarlos de manera programática cuando los necesites. Para obtener información detallada sobre cómo crear y administrar secretos con Cloud Code, consulta la guía de Secret Manager.
Ejecuta tu servicio
Para ejecutar tu servicio, sigue estos pasos:
Elige el destino de ejecución Cloud Run: Run Locally en el selector de configuración Run/Debug en la barra de navegación.
Haz clic en Cloud Run: Run Locally.
Visualiza los registros de tu servicio en ejecución, transmitido directamente a la ventana de resultados.
Una vez que se complete la implementación, puedes ver el servicio en ejecución si sigues la URL que se muestra en el panel Event Log. En el ejemplo a continuación, esta URL es http://localhost:8080.
Obtenga asistencia
Para enviar comentarios o informar un problema en tu IDE de IntelliJ, ve a Tools > Cloud Code > Help / About > Submit feedback or report an issue para informar un problema en GitHub.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[[["\u003cp\u003eCloud Code enables local development of Cloud Run services in a simulated environment, with real-time updates reflecting code changes.\u003c/p\u003e\n"],["\u003cp\u003eBefore running a service, users must define a run configuration in the "Edit Configurations" section, specifying options like the builder type and watch mode preference.\u003c/p\u003e\n"],["\u003cp\u003eDuring local development, users can customize configurations by adding settings such as service accounts, environment variables, and SQL connections.\u003c/p\u003e\n"],["\u003cp\u003eCloud Code automatically adds environment variables like PORT, K_SERVICE, K_REVISION, and K_CONFIGURATION to running containers.\u003c/p\u003e\n"],["\u003cp\u003eSecrets, such as API keys and passwords, can be securely stored in Secret Manager and accessed programmatically using Cloud Code.\u003c/p\u003e\n"]]],[],null,["# Develop a service locally in Cloud Code for IntelliJ\n\nWith Cloud Code, you can develop your Cloud Run services\nlocally in a Cloud Run-like environment. Cloud Code watches\nfor changes in your source and quickly updates the running service to\nreflect these changes.\n\nDefining your run configuration\n-------------------------------\n\nBefore you run your service, you must create your run configuration:\n\n1. Navigate to Run/Debug configurations selector in the Navigation bar and click **Edit Configurations**.\n2. Under Cloud Code: Cloud Run, choose **Cloud Run: Run Locally**.\n3. If you want Cloud Code to redeploy your application automatically after your changes are saved, under **Watch mode - rebuild and\n redeploy** , select **On file save** . New Cloud Run services have **On demand** selected by default. For more information about watch modes, see [Watch modes](/code/docs/intellij/watch-modes).\n4. Specify your builder option and its relevant settings.\n\n Cloud Code supports Docker, Jib, and Buildpacks\n [artifact types](https://skaffold.dev/docs/builders/).\n5. Click **OK**.\n\n### Optional: Customizing your configuration\n\nWhen developing locally, you can specify additional settings like a service\naccount, environment variables, and SQL connections (when using\nCloud Run (fully managed)), using the Advanced revision settings section when\nyou choose **Edit Configurations**.\n\n#### Environment variables\n\nThe following environment variables are automatically added to the\nrunning containers:\n\nStoring secrets\n---------------\n\nIf your code includes potentially sensitive data like API keys, passwords, and\ncertificates, it is recommended you store them as secrets. With\nCloud Code, you can securely store these secrets in Secret Manager\nand programmatically fetch them when you need them. For a detailed look at\nhow you can create and manage secrets with Cloud Code, refer to\nthe [Secret Manager guide](/code/docs/intellij/secret-manager).\n\nRunning your service\n--------------------\n\nTo run your service, follow these steps:\n\n1. Choose the **Cloud Run: Run Locally** run target from the Run/Debug configurations selector in the Navigation bar.\n2. Click **Cloud Run: Run Locally**.\n3. View the logs from your running service, streamed directly to the **output window**.\n4. Once deployment is complete, you can view your running service by following the\n URL displayed in your Event Log panel. In the example below, this URL is\n http://localhost:8080.\n\nGet support\n-----------\n\nTo submit feedback or report an issue in your IntelliJ IDE, go to **Tools** \\\u003e **Cloud Code** \\\u003e **Help / About** \\\u003e **Submit\nfeedback or report an issue** to report an issue on [GitHub](https://github.com/GoogleCloudPlatform/cloud-code-intellij/issues)."]]
Cloud Run: Run Locally.