Se você desenvolver aplicativos para serem executados no Google Kubernetes Engine, será possível usar um ambiente de desenvolvimento integrado e o plug-in do Cloud Code para simplificar as principais tarefas de desenvolvimento, como testar e depurar localmente e implantar em um cluster de teste.
Objetivos
Saiba como realizar as seguintes tarefas de desenvolvimento no Cloud Shell Editor, um ambiente de desenvolvimento integrado on-line:
Crie um aplicativo de amostra do Kubernetes.
Execute, atualize e veja os registros do aplicativo no ambiente de desenvolvimento.
Implantar o app em um cluster do GKE.
É possível seguir um processo semelhante no seu próprio ambiente de desenvolvimento integrado se você
instalar o Cloud Code.
Para seguir as instruções detalhadas desta tarefa diretamente no console do
Google Cloud , clique em Orientação:
Escolha um projeto que contenha um cluster do GKE.
Anote o nome do projeto e do cluster.
Você precisará dessas informações mais tarde.
Criar um aplicativo no editor do Cloud Shell
No console Google Cloud , abra o Cloud Shell
clicando em terminalCloud Shell
na barra de tarefas.
Clique em Abrir editor.
Aguarde a inicialização do editor do Cloud Shell.
No editor do Cloud Shell, clique em Visualizar > Paleta de comandos.
Pesquise Cloud Code: novo aplicativo e clique nele.
Selecione Aplicativo do Kubernetes e selecione Go: Hello World.
Cada framework de linguagem oferece experiências um pouco diferentes, e este tutorial descreve os recursos disponíveis para o Go.
Na caixa de diálogo "Save", clique em Create new application.
O editor do Cloud Shell é atualizado e mostra os arquivos de origem do aplicativo na visualização do Explorer.
O app contém:
Um app da Web go-hello-world básico,
main.go,
que retorna uma resposta modelo "Em execução" para todas as solicitações recebidas.
Uma especificação de implantação do Kubernetes, hello.deployment.yaml.
Uma especificação de serviço do Kubernetes que define um balanceador de carga para o aplicativo, hello.service.yaml.
Um arquivo Skaffold que processa o fluxo de trabalho para criar e implantar o aplicativo skaffold.yaml.
Executar o aplicativo no ambiente de desenvolvimento
Quando possível, execute aplicativos no seu ambiente de desenvolvimento antes de implantar no GKE. Isso pode ajudar a identificar possíveis problemas sem
usar a cota Google Cloud .
Para executar o aplicativo no ambiente do editor do Cloud Shell:
No editor do Cloud Shell, clique em Terminal > Novo terminal.
Inicie um cluster executando o seguinte comando:
minikubestart
O minikube é uma implementação leve do Kubernetes que cria uma VM no ambiente local e implanta um cluster simples contendo apenas um nó.
A configuração do cluster do minikube pode levar alguns minutos para ser concluída.
Se for preciso autorizar o Cloud Shell a realizar chamadas das APIs do Cloud, clique em Autorizar.
Depois de configurar o cluster minikube, vai ser exibida uma mensagem semelhante a esta:
Done! kubectl is now configured touse "minikube" cluster...
Depois de configurar o minikube, crie e execute o app:
Na barra de status do editor do Cloud Shell, clique em
Cloud
Code.
Selecione Run
on Kubernetes.
Se solicitado, confirme que quer usar o contexto atual do minikube.
O editor do Cloud Shell cria seu app e o implanta no cluster do minikube.
Acesse o status da implantação na visualização Sessões de desenvolvimento.
Quando a implantação estiver concluída, uma marca de seleção verde aparecerá ao lado de URLs de encaminhamento. O ícone giratório aparece ao lado de
Registros de aplicativos de stream.
Para acessar seu aplicativo, vá para baixo no painel Sessões de desenvolvimento e encontre URLs de encaminhamento de portas > serviço.
Mantenha o ponteiro do mouse sobre
go-hello-world-external
e clique em open_in_newAbrir URL.
Editar seu app
Quando você altera um arquivo de origem no aplicativo, o editor do Cloud Shell cria e implanta automaticamente o aplicativo no cluster ao qual você está conectado.
Nesse caso, você está conectado ao cluster do minikube.
Para editar e reimplantar o app no cluster do minikube local:
Modifique o arquivo
main.go
para exibir "Está reimplantado!". O arquivo será salvo automaticamente.
Veja a visualização das Sessões de desenvolvimento enquanto seu app é recriado e implantado.
Acesse o aplicativo reimplantado da mesma maneira que antes:
No painel Sessões de desenvolvimento, localize URLs de encaminhamento de portas > serviço.
Mantenha o ponteiro do mouse sobre
go-hello-world-external
e clique em open_in_newAbrir URL.
Explorar os registros do app
Na barra de menus do editor do Cloud Shell, selecione View > Command Palette.
Pesquise Cloud Code: ver registros e clique nele.
O Visualizador de registros é aberto.
Em
Implantação,
selecione go-hello-world.
Isso filtra o Visualizador de registros para exibir apenas registros do seu aplicativo go-hello-world.
Alterne para a guia com seu app que mostra a mensagem "Está reimplantado!". Atualize a página no navegador e retorne à guia do Cloud Shell.
Para conferir os registros gerados recentemente no visualizador de registros, clique em refreshAtualizar.
Implantar seu app em um cluster do GKE
Adicione o cluster do GKE à lista de clusters em que é possível implantar:
Na visualização Kubernetes, clique em addAdicionar um cluster ao KubeConfig.
Na caixa de diálogo Escolher uma plataforma, clique em Google Kubernetes Engine.
Se for solicitado que você ative a API Google Cloud , clique em Sim.
Aguarde o Cloud Shell Editor encontrar os clusters no seu projeto doGoogle Cloud .
Na caixa de diálogo Criar ou escolher um cluster do GKE, selecione o nome do cluster que você criou, hello-world-cluster.
Na barra de status do editor do Cloud Shell, clique em
Cloud
Code e selecione Executar no Kubernetes.
Quando solicitado a selecionar um contexto para a solicitação de implantação, escolha Usar contexto atual, definido para o cluster do GKE.
Na caixa de diálogo Escolher repositório de imagens, selecione gcr.io/PROJECT_NAME.
O editor do Cloud Shell cria seu aplicativo em um contêiner e o armazena no repositório selecionado.
Veja a visualização das Sessões de desenvolvimento enquanto seu app é recriado e implantado.
Para acessar mensagens de registro detalhadas à medida que o aplicativo é implantado no GKE, clique no nó Implantar no cluster na visualização Sessões de desenvolvimento.
Para acessar seu aplicativo em execução:
Feche a visualização clicando no título Sessões de desenvolvimento.
Faça uma limpeza para evitar cobranças.
Se você planeja conferir outros tutoriais, aguarde até que eles sejam concluídos
antes de fazer a limpeza. É possível usar o cluster de exemplo do Kubernetes na maioria dos
tutoriais do GKE.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-01 UTC."],[],[],null,["# Deploy and update from an IDE\n\n[Autopilot](/kubernetes-engine/docs/concepts/autopilot-overview)\n\n*** ** * ** ***\n\nIf you develop applications to run in Google Kubernetes Engine, you can use an IDE and the Cloud Code plugin to simplify key development tasks, such as testing and debugging locally and deploying to a test cluster.\n\n\u003cbr /\u003e\n\nObjectives\n----------\n\nLearn how to do the following development tasks in Cloud Shell Editor,\nan online demonstration IDE:\n\n1. Create a sample Kubernetes app.\n\n2. Run, update, and view logs for the app in your development environment.\n\n3. Deploy the app to a GKE cluster.\n\nYou can follow a similar process in your own IDE if you\n[install Cloud Code](/code/docs).\n\n*** ** * ** ***\n\nTo follow step-by-step guidance for this task directly in the\nGoogle Cloud console, click **Guide me**:\n\n[Guide me](https://console.cloud.google.com/freetrial?redirectPath=/kubernetes/list/overview?walkthrough_id=kubernetes--developer-workflow)\n\n*** ** * ** ***\n\nCosts\n-----\n\n\nIn this document, you use the following billable components of Google Cloud:\n\n\n- [GKE](/kubernetes-engine/pricing)\n\n\nTo generate a cost estimate based on your projected usage,\nuse the [pricing calculator](/products/calculator). \nNew Google Cloud users might be eligible for a [free trial](/free). \n\n\u003cbr /\u003e\n\nWhen you finish the tasks that are described in this document, you can avoid\ncontinued billing by deleting the resources that you created. For more information, see\n[Clean up](#clean-up).\n\nBefore you begin\n----------------\n\nCreate a Kubernetes cluster.\n[Create a cluster and deploy a workload](/kubernetes-engine/docs/quickstarts/create-cluster)\nshows you how. \n\nChoose a Google Cloud project and cluster\n-----------------------------------------\n\nWhen you deploy your app to GKE later on in this tutorial, you\nwill need to specify a Google Cloud project and a GKE cluster.\n\n1. Go to the GKE **Clusters** page.\n\n\n [Go to Clusters](https://console.cloud.google.com/kubernetes/list/overview)\n\n \u003cbr /\u003e\n\n2. Choose a project that contains a GKE cluster.\n\n \u003cbr /\u003e\n\n3. Note the name of the project and cluster.\n\n You'll need this information later.\n\nCreate an app in Cloud Shell Editor\n-----------------------------------\n\n1. In the Google Cloud console, open Cloud Shell\n by clicking terminal**Cloud Shell**\n in the task bar.\n\n2. Click\n **Open\n Editor**.\n\n3. Wait for Cloud Shell Editor to initialize.\n\n4. In Cloud Shell Editor, click **View** \\\u003e **Command Palette**.\n\n5. Search for **Cloud Code: New Application** and click it.\n\n6. Select **Kubernetes Application** , then select **Go: Hello World**.\n\n Each language framework provides slightly different experiences, and this\n tutorial describes the features available for Go.\n7. In the Save dialog, click **Create new application**.\n\n Cloud Shell Editor reloads and shows your app source files in the Explorer\n view.\n\nThe app consists of:\n\n- A basic `go-hello-world` web app,\n `main.go`,\n that returns a templated \"It's running!\" response to all received requests.\n\n- A Kubernetes Deployment specification,\n `hello.deployment.yaml`.\n\n- A Kubernetes Service specification that defines a load balancer for the app,\n `hello.service.yaml`.\n\n- A [Skaffold](https://skaffold.dev/) file that handles the workflow for\n building and deploying the app, `skaffold.yaml`.\n\nRun the app in your development environment\n-------------------------------------------\n\nWhen possible, run apps in your development environment before deploying\nto GKE. This can help you identify any potential issues without\nusing Google Cloud quota.\n\nTo run the app in your Cloud Shell Editor environment:\n\n1. In Cloud Shell Editor, click **Terminal** \\\u003e **New Terminal**.\n\n2. Start a cluster by running the following command:\n\n minikube start\n\n *minikube* is a lightweight Kubernetes implementation that creates a VM in\n your local environment and deploys a simple cluster containing only one node.\n\n It might take a minute to set up the minikube cluster.\n3. If prompted to authorize Cloud Shell to make Cloud API calls,\n click **Authorize**.\n\n After your minikube cluster is set up, a message similar to the following\n appears: \n\n Done! kubectl is now configured to\n use \"minikube\" cluster...\n\nAfter minikube is set up, build and run your app:\n\n1. In the Cloud Shell Editor status bar, click\n **Cloud\n Code**.\n\n2. Select **Run on Kubernetes**.\n\n3. If prompted, confirm that you want to use the current minikube context.\n\n Cloud Shell Editor builds your app and deploys it to the minikube cluster.\n4. Watch the deployment status in the\n **Development\n sessions** view.\n\n When the deployment is complete, a green check mark appears next to\n **Portforward URLs** . The spinning icon appears next to\n **Stream Application Logs**.\n5. To view your app, look further down the **Development sessions**\n pane and find **Port Forward URLs** \\\u003e **service**.\n\n6. Hold the pointer over\n **go-hello-world-external**\n and click open_in_new **Open URL**.\n\nEdit your app\n-------------\n\nWhen you change a source file in your app, Cloud Shell Editor automatically\nbuilds and deploys your app to the cluster that you're currently connected to.\nIn this case, you're connected to your minikube cluster.\n\nTo edit and redeploy the app to your local minikube cluster:\n\n1. Modify your\n `main.go`\n file to print \"It's redeployed!\". The file saves automatically.\n\n2. Watch the\n **Development\n sessions** view as your app is rebuilt and\n deployed.\n\n3. View your redeployed app as you did before:\n\n 1. In the **Development sessions**\n pane, find **Port Forward URLs** \\\u003e **service**.\n\n 2. Hold the pointer over\n **go-hello-world-external**\n and click open_in_new **Open URL**.\n\nView app logs\n-------------\n\n1. In the Cloud Shell Editor menu bar, select **View** \\\u003e **Command Palette**.\n\n2. Search for **Cloud Code: View Logs** and click it.\n\n The Logs Viewer opens.\n3. In\n **Deployment**,\n select `go-hello-world`.\n\n This filters the Logs Viewer to only display logs for your `go-hello-world` app.\n4. Switch to the tab with your app that shows \"It's redeployed!\" Reload the\n page in the browser and then switch back to the Cloud Shell tab.\n\n5. To view the newly generated logs in the Logs Viewer, click\n refresh\n **Refresh**.\n\nDeploy your app to a GKE cluster\n--------------------------------\n\n1. Add your GKE cluster to the list of clusters you can\n deploy to:\n\n 1. In the Kubernetes\n view, click add\n **Add a Cluster to the KubeConfig**.\n\n 2. In the **Choose a platform** dialog, click **Google Kubernetes Engine**.\n\n 3. If prompted to enable the Google Cloud API, click **Yes**.\n\n 4. Wait for Cloud Shell Editor to find the clusters in your\n Google Cloud project.\n\n 5. In the **Create or choose a GKE cluster** dialog, select\n the name of the cluster you created, **hello-world-cluster**.\n\n2. In the Cloud Shell Editor status bar, click\n **Cloud\n Code** and select **Run on Kubernetes**.\n\n3. When prompted to select a context for your deployment request, choose\n **Use current context**, which is set to your GKE cluster.\n\n4. In the **Choose image repository** dialog, select **gcr.io/\u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e**.\n\n Cloud Shell Editor builds your app into a container and stores the container\n in the repository you selected.\n5. Watch the\n **Development\n sessions** view as your app is rebuilt and\n deployed.\n\n6. To view detailed log messages as your app is being deployed to GKE,\n click the **Deploy to Cluster** node in the **Development sessions** view.\n\n7. To view your running app:\n\n 1. Close the view by clicking the **Development sessions** heading.\n\n 2. Open the Kubernetes\n view.\n\n 3. Expand your GKE cluster.\n\n 4. Go to **Namespaces \\\u003e default \\\u003e Services \\\u003e go-hello-world-external \\\u003e External IPs**.\n\n 5. Hold the pointer over the IP address and click\n open_in_new **Open URL**.\n\nYou have successfully created and deployed a GKE app from an IDE.\n\nWhat's next\n-----------\n\n- [View code samples](/docs/samples) demonstrating the usage of\n Google Cloud products\n\n- [Install Cloud Code](/code/docs) in your IDE\n\n- [Clean up to avoid billing charges](/kubernetes-engine/docs/quickstarts/learning-path-cleanup).\n If you plan to take additional tutorials, wait until you finish those tutorials\n before you clean up. You can use the sample Kubernetes cluster in most\n GKE tutorials."]]
