Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Esegui il deployment di un'app Kubernetes con Cloud Code for IntelliJ
Questa pagina mostra come iniziare a utilizzare Cloud Code.
In questa guida rapida, configurerai una nuova applicazione Kubernetes utilizzando un modello di partenza Hello World, eseguirai l'app su un cluster a tua scelta, avvierai la ricostruzione continua per sviluppare l'app in modo iterativo, eseguirai il debug del codice in esecuzione e potrai rilassarti e visualizzare i log in streaming dall'applicazione in produzione.
In alternativa, puoi utilizzare un cluster ospitato su qualsiasi altra piattaforma cloud o un
cluster Kubernetes locale con strumenti come
minikube e
Docker Desktop.
Installa Git in modo che Cloud Code possa eseguire operazioni Git, come la clonazione di un esempio.
Cloud Code include una raccolta di modelli di
codice campione
per iniziare rapidamente. Per creare una nuova applicazione utilizzando un
esempio esistente:
Nell'IDE, apri File > Nuovo progetto e seleziona
Cloud Code: Kubernetes.
Seleziona un modello Hello World dall'elenco delle applicazioni iniziali.
Scegli un nome per il progetto.
Dopo aver fatto clic su Fine, Cloud Code clona il modello scelto e apre il progetto appena creato per l'utilizzo.
Per i modelli Java, ti viene chiesto di importare i progetti Maven richiesti per sincronizzare il file pom.xml. Fai clic su Aggiungi come progetto Maven e poi su Importa modifiche.
Scelta di un cluster
Per sviluppare l'applicazione, devi avere un cluster Kubernetes associato
(in hosting locale con minikube o utilizzando una piattaforma cloud, come un
cluster Google Kubernetes Engine).
Cluster locale
Se non hai già un cluster da utilizzare per questa guida rapida, puoi scegliere di eseguire la tua applicazione con un cluster minikube locale gestito da Cloud Code.
Cloud Code avvia un cluster minikube per eseguire l'applicazione e lo interrompe al termine del deployment. Se è già in esecuzione un cluster minikube, Cloud Code riutilizza il cluster minikube esistente per il deployment.
Puoi scegliere di utilizzare questo cluster minikube gestito da Cloud Code nel
passaggio successivo, sviluppando l'applicazione, impostandolo come preferenza di deployment.
Cluster basato su piattaforma cloud
Se hai già un cluster configurato per funzionare con gli strumenti Kubernetes (come
kubectl) che puoi utilizzare per questa guida introduttiva, Cloud Code lo esegue automaticamente. Puoi passare allo sviluppo dell'applicazione, dove puoi verificare che il cluster preferito sia impostato come contesto corrente.
In caso contrario, puoi crearne uno seguendo le istruzioni specifiche della tua piattaforma cloud. Per GKE, puoi seguire la guida sulla creazione di un cluster.
Sviluppo dell'applicazione
Per avviare lo sviluppo dell'applicazione su Kubernetes:
Se hai eseguito l'accesso Google Cloud all'IDE e hai definito un progetto predefinito, Cloud Code utilizza automaticamente il tuo repository di immagini contenitore predefinito (gcr.io/{project_id} dove {project_id} fa riferimento al tuo progetto predefinito).
Assicurati che sia impostato il contesto Kubernetes che preferisci. Questo valore può essere specificato nella configurazione Sviluppa su Kubernetes (accessibile tramite Esegui > Modifica configurazioni > Sviluppa su Kubernetes), nella scheda Esegui e nella sezione Preferenze di deployment.
Puoi scegliere di eseguire il deployment in un contesto corrente (predefinito), localmente in un cluster minikube o in un altro contesto disponibile.
Per impostazione predefinita, l'applicazione Kubernetes verrà eseguita in modalità On demand con l'opzione On demand selezionata. Se preferisci, puoi selezionare l'opzione Al salvataggio del file.
Scegli il target di esecuzione Sviluppa su Kubernetes dal selettore di configurazione di Esecuzione/Debug nella barra di navigazione.
In questo modo, tutte le modifiche al codice vengono create, inviate e implementate automaticamente in una nuova versione dell'applicazione.
Per avviare il ciclo di sviluppo sul cluster Kubernetes, fai clic sull'azione di esecuzione per Sviluppa su Kubernetes.
Nella finestra di output, nella scheda Log, visualizza i log delle applicazioni in entrata.
Una volta avviato il deployment, viene visualizzato l'elenco delle porte inoltrate per
l'applicazione di cui è stato eseguito il deployment.
Quando il deployment è riuscito, ti viene comunicato che sono disponibili nuovi URL dei servizi. Fai clic sulla scheda URL servizio per visualizzare gli URL, quindi fai clic sul link dell'URL per aprire il browser con l'applicazione in esecuzione.
In alternativa, puoi aprire il Log eventi e fare clic sul link per aprire il browser con l'applicazione in esecuzione.
Il riquadro Risorse di cui è stato eseguito il deployment mostra ciò che è stato eseguito durante la sessione di sviluppo.
Fai clic sull'azione di debug
per Sviluppa su Kubernetes per avviare il ciclo di sviluppo in modalità di debug sul tuo cluster Kubernetes.
Cloud Code collegherà una sessione di debug. In caso di esito positivo, si apre la finestra dello strumento di debug, che conferma la connessione (nella scheda Console).
Ora puoi eseguire il debug nel cluster Kubernetes in produzione.
Fai clic sul riquadro nella riga eseguibile del codice in cui vuoi aggiungere un breakpoint.
I cerchi pieni rossi indicano i punti di interruzione attivi, mentre i cerchi vuoti con contorno rosso indicano i punti di interruzione disattivati.
Quando invii una nuova richiesta all'applicazione, questa verrà messa in pausa nella riga indicata.
Per terminare la sessione di debug, fai clic sull'icona di interruzione nella configurazione di esecuzione Develop on Kubernetes.
Visualizzazione dei log
Oltre a visualizzare un live streaming dei log dei pod in esecuzione nell'output del terminale durante lo sviluppo e l'esecuzione dell'applicazione, puoi visualizzare i log di un pod specifico passando a Kubernetes Explorer.
Per visualizzare i log di un pod specifico:
Vai a Kubernetes Explorer. Puoi accedervi dal riquadro laterale a destra o utilizzando Strumenti > Cloud Code > Kubernetes > Visualizza Cluster Explorer.
Seleziona il pod di cui vuoi visualizzare i log.
Fai clic con il tasto destro del mouse sul pod e seleziona Stream log. In alternativa, puoi eseguire lo streaming dei log per i singoli container in esecuzione nei pod.
I log vengono visualizzati nella console di Kubernetes Explorer.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.
Vai alla pagina Progetti nella Google Cloud console:
Seleziona il progetto che hai creato per questa guida rapida e fai clic sull'icona del cestino accanto per eliminarlo.
Il progetto viene chiuso e pianificato per l'eliminazione.
Passaggi successivi
Valuta la possibilità di importare un'applicazione esistente, che si tratti di un'app Kubernetes o App Engine, nell'IDE e di eseguire la configurazione con Cloud Code.
Scopri di più sullo sviluppo di applicazioni Kubernetes:
[[["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-05 UTC."],[[["\u003cp\u003eThis guide provides instructions on how to deploy a Kubernetes application using Cloud Code for IntelliJ, covering setup, creating a new application, choosing a cluster, and developing.\u003c/p\u003e\n"],["\u003cp\u003eYou can use either a local minikube cluster managed by Cloud Code or a cluster hosted on a cloud platform like Google Kubernetes Engine (GKE) to deploy and run your application.\u003c/p\u003e\n"],["\u003cp\u003eCloud Code facilitates iterative development with continuous rebuilding, allowing you to automatically build, push, and deploy code changes to your Kubernetes cluster.\u003c/p\u003e\n"],["\u003cp\u003eThe guide demonstrates how to debug your application directly on your Kubernetes cluster using Cloud Code's debugging features, including setting breakpoints and viewing logs.\u003c/p\u003e\n"],["\u003cp\u003eYou can monitor your application's performance by streaming logs from individual pods via the Kubernetes Explorer, and can clean up the resources that are used to avoid incurring any charges.\u003c/p\u003e\n"]]],[],null,["# Quickstart: Deploy a Kubernetes app with Cloud Code for IntelliJ\n\nDeploy a Kubernetes app with Cloud Code for IntelliJ\n====================================================\n\nThis page shows you how to get started with Cloud Code.\n\nIn this quickstart, you'll set up a new Kubernetes application using a starter\nHello World template, run your app on a cluster of your choosing, kickstart\ncontinuous rebuilding to iteratively develop your app, debug your\nrunning code, and sit back and view logs streaming from your live application.\n\nBefore you begin\n----------------\n\n1. If you'd like to use Google Cloud, you'll need to\n [create or select a Google Cloud project](https://console.cloud.google.com/projectcreate)\n and [enable billing on your project](/billing/docs/how-to/modify-project).\n\n | **Note:** To get the most out of this quickstart, creating a Google Cloud project is recommended. This will allow you to easily create and work with a live GKE cluster, leverage Cloud Code's continuous delivery offering, and utilize its live debugging capabilities.\n\n Alternatively, you can use a cluster hosted on any other cloud platform or a\n local Kubernetes cluster with tools such as\n [minikube](https://kubernetes.io/docs/tasks/tools/install-minikube) and\n [Docker Desktop](https://www.docker.com/products/docker-desktop).\n2. Install [Git](https://git-scm.com/downloads) so that Cloud Code\n can perform Git operations, like cloning a sample.\n\n3. Install the [Cloud Code plugin](/code/docs/intellij/install#installing)\n if you haven't already.\n\nCreating an application\n-----------------------\n\nCloud Code comes with a collection of\n[code sample](https://github.com/GoogleCloudPlatform/cloud-code-samples#readme)\ntemplates to get you started quickly. To create a new application using an\nexisting sample:\n\n1. In your IDE, open **File** \\\u003e **New Project** and select\n **Cloud Code: Kubernetes**.\n\n2. Select a **Hello World** template from the list of starter applications.\n\n3. Pick a name for your project.\n\n After you click **Finish**, Cloud Code clones your chosen\n template and opens your newly created project for use.\n\n For **Java** templates, you're prompted to import required Maven projects to\n sync your pom.xml. Click **Add as Maven project** and then click **Import\n Changes**.\n\nChoosing a cluster\n------------------\n\nIn order to develop your application, you'll need an associated Kubernetes cluster\n(hosted either locally with minikube or using a cloud platform, like a\nGoogle Kubernetes Engine cluster).\n\n### Local cluster\n\nIf you don't already have a cluster to use for this quickstart, you can choose\nto run your application with a Cloud Code-managed local minikube cluster.\nCloud Code starts a minikube cluster to run your application and\nstops the cluster when deployment stops. If a minikube cluster is already\nrunning, Cloud Code reuses the existing minikube cluster for deployment.\n\nYou can choose to use this Cloud Code-managed minikube cluster in the\nnext step, [developing your application](#developing_your_application), by\nsetting it as your deployment preference.\n\n### Cloud platform-based cluster\n\nIf you already have a cluster configured to work with Kubernetes tools (like\nkubectl) that you can use for this quickstart, Cloud Code deploys\nto it automatically. You can move on to [developing your application](#developing_your_application)\nwhere you can confirm your preferred cluster is set as your current context.\n\nIf you don't, you can create one using your cloud platform-specific\ninstructions. For GKE, you can follow the\n[Creating a cluster](https://cloud.google.com/kubernetes-engine/docs/how-to/creating-a-cluster) guide.\n\nDeveloping your application\n---------------------------\n\nTo initiate development of your application on Kubernetes:\n\n1. If you're running on a cluster hosted on a cloud platform, ensure you have\n [defined where your container images are stored](/code/docs/intellij/configuring-container-image-settings#specifying_where_container_images_are_stored)\n for **Develop on Kubernetes**.\n\n If you're logged into Google Cloud in your IDE and you have a\n default project defined, Cloud Code automatically uses your\n default container image repository (gcr.io/{project_id} where {project_id}\n references your default project).\n2. Ensure your preferred Kubernetes context is set. This can be specified in\n your Develop on Kubernetes configuration (accessible through\n **Run** \\\u003e **Edit Configurations** \\\u003e **Develop on Kubernetes**), on the Run\n tab and in the Deployment preferences section.\n\n You can choose to deploy to a current context (default), locally to a\n minikube cluster, or to another available context.\n\n By default, your Kubernetes application will run in [On-demand mode](/code/docs/intellij/watch-modes)\n with **On demand** selected. If preferred, you can select the **On file save** option instead.\n3. Choose the **Develop on Kubernetes** run target from the Run/Debug\n configuration selector in the Navigation bar.\n\n This ensures any code changes to be automatically built, pushed, and deployed\n to a new version of your application.\n4. To start the development cycle on your Kubernetes cluster, click the run\n action for **Develop on Kubernetes**.\n\n5. In the **output window** , on the **Logs** tab, view incoming application\n logs.\n\n After the deployment has started, you'll see the list of forwarded ports for\n the deployed application.\n6. When the deployment is successful, you're notified that new service URLs are\n available. Click the **Service URLs** tab to view the URL(s), then click the\n URL link to open your browser with your running application.\n\n Alternatively, you can open the **Event Log** and then click the link to open\n your browser with your running application.\n\n The **Deployed Resources** pane shows what you deployed during the\n development session.\n\nDebugging your application\n--------------------------\n\n| **Note:** Debugging support is available for Java, Kotlin, Node.js, Go, and Python.\n\nCloud Code supports [applying changes while debugging](/code/docs/intellij/watch-modes#applying-changes-while-debugging).\n\nTo debug your application:\n\n1. Click the debug action\n for **Develop on Kubernetes** to start the development cycle in debug mode\n on your Kubernetes cluster.\n\n | **Note:** For Node.js apps, you will be prompted to help the debugger map your local sources to the remote sources in the container for each artifact you are debugging. This enables the Node debugger to correctly process your breakpoints. For more on how to configure this setting, refer to the [Debugging an app guide](/static/code/docs/intellij/debug#node.js).\n2. Cloud Code will attach a debug session. When successful, the\n Debug Tool window opens, confirming connection (on the Console tab).\n\n You can now debug against your live Kubernetes cluster.\n3. Click the gutter at the executable line of the code where you want to add\n a breakpoint.\n\n Red filled circles denote active breakpoints, while red-outlined hollow\n circles signify disabled breakpoints.\n4. When you send a new request to your application, it will pause at that\n desired line.\n\n5. To end the debugging session, click the stop icon on the\n `Develop on Kubernetes` run configuration.\n\nViewing logs\n------------\n\nIn addition to seeing a livestream of the logs from running pods in the terminal\noutput as you're developing and running your application, you can view logs from\na specific pod by navigating to the Kubernetes Explorer.\n\nTo view logs from a specific pod, follow these steps:\n\n1. Navigate to the Kubernetes Explorer. It can be\n accessed either from the side panel on the right or\n using **Tools** \\\u003e **Cloud Code** \\\u003e **Kubernetes** \\\u003e **View Cluster Explorer**.\n\n2. Select the pod you'd like to see logs from.\n\n3. Right-click the pod and then select **Stream Logs**. Alternatively, you can stream logs for individual containers running in pods.\n\n This outputs logs to the Kubernetes Explorer Console.\n\nClean up\n--------\n\n\nTo avoid incurring charges to your Google Cloud account for\nthe resources used on this page, follow these steps.\n\n1. Go to the Projects page in the Google Cloud console:\n\n [Go to the Projects page](https://console.cloud.google.com/project)\n2. Select the project you created for this Quickstart and click the trash can\n icon next to delete it.\n\n This shuts down the project and schedules it for deletion.\n\nWhat's next\n-----------\n\n- Consider importing an existing application, either a [Kubernetes](/code/docs/intellij/use-k8s-existing-app) or [App Engine](/code/docs/intellij/migrate) app, into your IDE and getting set up with Cloud Code.\n- Dive deeper into developing Kubernetes applications:\n - Tackle more advanced Google Cloud and Kubernetes configuration with Cloud Code's [YAML editing support](/code/docs/intellij/yaml-editing).\n - For better insight into and management of your Kubernetes resources, use [the Kubernetes Explorer](/code/docs/intellij/use-kubernetes-explorer).\n - [Deploy your applications to ARM64, AMD64, or mixed-architecture GKE clusters](/code/docs/intellij/deploy-to-arm-amd-mixed-arch).\n- Create, run, debug, and deploy an [App Engine app with Cloud Code](/code/docs/intellij/create-standard).\n- [Manage Cloud APIs and client libraries](/code/docs/intellij/client-libraries) from the comfort of your IDE.\n- [Explore your Cloud Storage content](/code/docs/intellij/gcs) within your IDE.\n- Add new projects to and check out existing ones from [Cloud Source Repositories\n with Cloud Code](/code/docs/intellij/vcs)."]]
per Sviluppa su Kubernetes per avviare il ciclo di sviluppo in modalità di debug sul tuo cluster Kubernetes.
