Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Saiba como criar um app da Web conteinerizado usando o editor do Cloud Shell, fazer testes locais dele e o implantar em um cluster do Google Kubernetes Engine (GKE).
Para seguir as instruções da tarefa diretamente no editor do
Cloud Shell, clique em Orientação:
Se for preciso autorizar o Cloud Code a usar suas credenciais para fazer uma chamada de API do Google Cloud, clique em Autorizar.
Abra o menu Cloud Code na barra de status.
Selecione Novo aplicativo.
Selecione Aplicativo do Kubernetes como o tipo de app de exemplo.
Na lista de apps de exemplo do Kubernetes, selecione Go:Hello World.
Selecione uma pasta para ser o local do app e clique em Criar novo
aplicativo.
O editor do Cloud Shell vai carregar seu app em um novo espaço de trabalho. Após a atualização, seu app
pode ser acessado pela
visualização
de explorador.
Testar seu app em um cluster local
Agora que você criou seu app, é possível executá-lo em um cluster local do Kubernetes
no Cloud Shell:
Para abrir um terminal do Cloud Shell, selecione Terminal > Novo terminal.
Para iniciar o cluster do minikube local, no prompt de comando do
terminal,
execute o seguinte:
minikubestart
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, vai ser exibida uma mensagem semelhante a esta:
Done! kubectl is now configured touse "minikube" cluster...
Depois de configurar o cluster local, crie e execute este app:
Abra o menu
Cloud
Code na barra de status.
Selecione
Executar no
Kubernetes.
Se solicitado, confirme que quer usar o contexto atual do minikube.
Esse processo demora uns minutos, e é possível consultar o status da implantação na
visualização das
Sessões
de desenvolvimento.
Clique em nós diferentes na visualização das Sessões de desenvolvimento para mostrar trechos de
registro relacionados à fase de implantação selecionada.
Depois que o app for criado e implantado, encontre o nó de encaminhamento de portas
do seu serviço: na visualização Sessões de desenvolvimento, expanda
URLs de encaminhamento de portas > serviço >
go-hello-world-external.
Para iniciar o app, mantenha o ponteiro sobre
go-hello-world-external
e clique em open_in_newAbrir URL.
Editar seu app
Para entender os componentes do app Hello World, consulte o diagrama no arquivo
readme.md. No geral, o app consiste em:
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.
Um serviço de go-hello-world-external do balanceador de carga,
hello.service.yaml,
que expõe o app descrevendo um
Serviço do Kubernetes.
Para modificar o aplicativo:
Modifique o arquivo
main.go
para mostrar "Está reimplantado!". O arquivo será salvo automaticamente.
Aguarde um minuto até que o app conclua a criação e a implantação e monitore
o progresso do aplicativo à medida que é recriado. Para isso, use a visualização das
Sessões
de desenvolvimento.
Depois que o app for criado e implantado, encontre o nó de encaminhamento de portas
do seu serviço em: Sessões de desenvolvimento > URLs de encaminhamento de porta > serviço >
go-hello-world-external.
Para iniciar o app, mantenha o ponteiro sobre
go-hello-world-external
e clique em open_in_new Abrir URL.
Explorar os registros do app
Para analisar o app durante a execução, use o visualizador de registros para monitorar os registros do app:
Inicie o visualizador de registros abrindo a Palette de comandos (acessível com
Ctrl/Cmd+Shift+P ou Visualizar > Palette de comandos) e execute
Cloud Code: visualizar registros.
Essa visualização permite que você filtre e navegue pelos registros do seu app.
Especifique os filtros de
Implantação
para explorar os registros do seu app, 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.
Criar um cluster do Google Kubernetes Engine
Para criar um novo cluster do Google Kubernetes Engine e implantar o app, siga estas instruções:
Clique em Cloud
Code e expanda a seção Kubernetes.
Clique em addAdicionar um cluster ao KubeConfig e em Google Kubernetes
Engine no menu Seleção rápida.
Quando for solicitado que você ative container.googleapis.com, clique em Sim.
Clique em + Criar um cluster do GKE.
Escolha Padrão como o tipo de cluster.
Clique em Abrir para permitir que o Cloud Code abra o
consoleGoogle Cloud .
No console Google Cloud , use o projeto que você criou, defina a zona como
us-central1-a e defina o nome do cluster como my-first-cluster.
Clique em Criar. A criação do cluster leva alguns minutos.
Depois que o cluster for criado, no menu Seleção rápida, clique em
Atualizar.
Depois que o nome do novo cluster aparecer na lista, clique no nome dele. Seu novo cluster é adicionado à configuração e configurado para ser o
contexto ativo.
Implantar seu app em um cluster do GKE
Implante seu app no cluster novo:
No menu
Cloud Code, que pode ser acessado pela barra de status,
selecione
Executar no
Kubernetes.
Confirme o cluster recém-criado como o contexto do seu app.
Confirme a opção padrão para seu registro de imagem.
Aguarde um minuto até que o app conclua a criação e a implantação e monitore
o progresso do aplicativo à medida que é recriado. Para isso, use a visualização das
Sessões
de desenvolvimento.
Depois que o app for criado e implantado, encontre o nó de encaminhamento de portas
do seu serviço: na visualização Sessões de desenvolvimento, expanda
URLs de encaminhamento de portas > serviço >
go-hello-world-external.
Para iniciar o app, mantenha o ponteiro sobre
go-hello-world-external
e clique em open_in_newAbrir URL.
Limpar
Para excluir apenas o cluster criado para este guia de início rápido:
Mantenha o cursor sobre o nome do cluster e clique em
Abrir no console do Google Cloud .
Clique em Excluir e em Excluir.
Para excluir o projeto (e os recursos associados, incluindo os clusters):
Acesse a página "Projetos" no console Google Cloud :
[[["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-04 UTC."],[[["\u003cp\u003eThis guide walks you through creating a containerized web app using the Cloud Shell Editor, which comes preloaded with necessary tools for cloud development.\u003c/p\u003e\n"],["\u003cp\u003eYou'll learn how to test your web app locally using a minikube cluster within Cloud Shell, ensuring it functions correctly before deployment.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves creating a new Google Kubernetes Engine (GKE) cluster, adding it to the configuration, and then deploying your containerized web app to this cluster.\u003c/p\u003e\n"],["\u003cp\u003eYou can modify the app, view logs using the Log Viewer, and monitor the progress of your app during the build and deployment phases in the Development sessions view.\u003c/p\u003e\n"],["\u003cp\u003eThe guide also provides instructions on cleaning up resources by deleting the created cluster or the entire project when you're finished.\u003c/p\u003e\n"]]],[],null,["Learn how to create a containerized web app using the Cloud Shell Editor, test\nit locally, and then deploy it to a Google Kubernetes Engine (GKE) cluster.\n\n*** ** * ** ***\n\nTo follow step-by-step guidance for this task directly in the\nCloud Shell Editor, click **Guide me**:\n\n[Guide me](https://console.cloud.google.com/freetrial?redirectPath=/?walkthrough_id=shell__gke_cloud_code)\n\n*** ** * ** ***\n\nBefore you begin\n\n1. In the Google Cloud console, go to the project selector page.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n2. Select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\nCreate your web app\n\nUse the Cloud Shell Editor as your environment for creating your app. The\neditor comes preloaded with the tools needed for Cloud development.\n\nTo create your app:\n\n\n1. Launch the [Cloud Shell Editor](https://ide.cloud.google.com).\n\n2. If prompted to authorize Cloud Code to use your credentials to\n make a Google Cloud API call, click **Authorize**.\n\n3. Launch the **Cloud Code** menu from the status bar.\n\n4. Select **New Application**.\n\n5. Select **Kubernetes application** as the type of sample app.\n\n6. From the list of sample Kubernetes apps, select **Go:Hello World**.\n\n7. Select a folder for your app location and then click **Create New\n Application**.\n\nCloud Shell Editor loads your app in a new workspace. After it reloads, your\napp is accessible with the\nexplorer view.\n\nTest your app in a local cluster\n\nNow that you've created your app, you can run it in a local Kubernetes cluster\nin Cloud Shell:\n\n1. To open a Cloud Shell terminal, click **Terminal** \\\u003e **New Terminal**.\n2. To start your local minikube cluster, from the\n terminal\n command prompt, run the following command:\n\n minikube start\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 cluster is set up, a message similar to the following appears: \n\n Done! kubectl is now configured to\n use \"minikube\" cluster...\n\nAfter the local cluster is configured, build and run this app:\n\n1. Launch the **Cloud\n Code** menu from the status bar.\n2. Select **Run on\n Kubernetes**.\n3. If prompted, confirm that you want to use the current minikube context.\n\n This process takes a few minutes and you can view the deployment status in\n the\n **Development\n sessions** view.\n\n Clicking different nodes in the Development sessions view displays log\n excerpts pertaining to the selected deployment phase.\n4. After your app finishes building and deploying, find the port forward node\n for your service: In the Development sessions view, expand\n **Port Forward URLs** \\\u003e **service** \\\u003e\n **go-hello-world-external**.\n\n5. To launch your app, hold the pointer over\n **go-hello-world-external**\n and then click open_in_new **Open URL**.\n\nEdit your app\n\nTo understand the Hello World app's components, see the diagram in the app's\n`readme.md`\nfile. At a high level, the app consists of:\n\n- A basic `go-hello-world` web app, `main.go`, that returns a templated \"It's running!\" response to all received requests.\n- A load balancer `go-hello-world-external` service, `hello.service.yaml`, that exposes the app by describing a [Kubernetes Service](https://kubernetes.io/docs/concepts/services-networking/service/).\n\nTo modify the app:\n\n1. Modify your `main.go` file to print \"It's redeployed!\". The file saves automatically.\n2. Give your app a minute to finish building and deploying, and monitor your\n app's progress as it's rebuilt using the\n **Development\n sessions** view.\n\n3. After your app finishes building and deploying, find the port forward node\n for your service: Development sessions \\\u003e Port Forward URLs \\\u003e service \\\u003e\n **go-hello-world-external**.\n\n4. To launch your app, hold the pointer over\n **go-hello-world-external**\n and click **open_in_new** Open URL.\n\nView app logs\n\nTo analyze your app while it's running, use the Log Viewer to monitor its logs:\n\n1. Launch the Log Viewer by opening the command palette (accessible with\n `Ctrl`/`Cmd`+`Shift`+`P` or **View** \\\u003e **Command Palette** ) and then running\n **Cloud Code: View Logs**.\n\n This view allows you to filter and navigate the logs for your app.\n2. Specify the\n **Deployment**\n filters to view the logs for your app, `go-hello-world`.\n\n3. 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\n4. To view the newly generated logs in the Log Viewer, click\n refresh\n **Refresh**.\n\nCreate a Google Kubernetes Engine cluster\n\nTo create a new Google Kubernetes Engine cluster to deploy your app to:\n\n\n1. Click **Cloud\n Code** and then expand the **Kubernetes** section.\n\n2. Click add\n **Add a Cluster to the KubeConfig** and then click **Google Kubernetes\n Engine** in the **Quick pick** menu.\n\n3. When prompted to enable `container.googleapis.com`, click **Yes**.\n\n4. Click **+ Create a New GKE Cluster**.\n\n5. Choose **Standard** as the cluster type.\n\n6. Click **Open** to permit Cloud Code to open the\n Google Cloud console.\n\n7. In Google Cloud console, use the project you created, set the zone to\n `us-central1-a`, and set the cluster name to `my-first-cluster`.\n\n8. Click **Create**. Cluster creation takes a few minutes.\n\n9. After the cluster is created, in the **Quick pick** menu, click\n\n **Refresh**.\n\n10. After the name of your new cluster appears in the list, click the cluster\n name. Your new cluster is added to the configuration and configured to be the\n active context.\n\nDeploy your app to a GKE cluster\n\nTo deploy your app to the new cluster:\n\n1. From the\n Cloud Code menu, accessible using the status bar,\n select\n **Run on\n Kubernetes**.\n\n2. Confirm your newly created cluster as the context for your app.\n\n3. Confirm the default option for your image registry.\n\n4. Give your app a minute to finish building and deploying, and monitor your\n app's progress as it's rebuilt using the\n **Development\n sessions** view.\n\n5. After your app finishes building and deploying, find the port forward node\n for your service: In the Development sessions view, expand\n **Port Forward URLs** \\\u003e **service** \\\u003e\n **go-hello-world-external**.\n\n6. To launch your app, hold the pointer over\n **go-hello-world-external**\n and click open_in_new **Open URL**.\n\nCleaning up\n\nTo delete just the cluster you created for this quickstart:\n\n1. Hold the pointer over your cluster name and then click **Open in Google Cloud console**.\n2. Click **Delete** and then click **Delete**.\n\nTo delete your project (and associated resources, including any clusters):\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 that you created for this quickstart and then click\n **Delete**.\n\n3. Type the project ID to confirm and then click **Shut down**.\n\n This shuts down the project and schedules it for deletion.\n\nWhat's next\n\n- Discover the features of the\n [Cloud Shell Editor interface](/shell/docs/editor-overview).\n\n- Read about\n [debugging with the Cloud Shell Editor](/shell/docs/debugging)\n and Cloud Shell Editor's additional support for Kubernetes\n applications.\n\n- [Deploy your applications to ARM64, AMD64, or mixed-architecture GKE clusters](/code/docs/shell/deploy-to-arm-amd-mixed-arch)."]]
Cloud
Code e expanda a seção Kubernetes.
Atualizar.
Abrir no console do Google Cloud .