Un cluster Kubernetes fornisce risorse di calcolo, archiviazione, networking
e altri servizi per le applicazioni, come un data center virtuale. Le app e i relativi servizi in esecuzione in Kubernetes sono chiamati carichi di lavoro.
Questo tutorial ti consente di visualizzare rapidamente un cluster Google Kubernetes Engine e un carico di lavoro di esempio in esecuzione, il tutto configurato utilizzando la console Google Cloud . Puoi quindi esplorare il workload nella console Google Cloud prima di passare al nostro percorso di apprendimento più approfondito o iniziare a pianificare e creare il tuo cluster pronto per la produzione.
Se preferisci configurare il cluster e il workload di esempio utilizzando Terraform, consulta Crea un cluster con Terraform.
Per seguire le indicazioni dettagliate per questa attività direttamente nella Google Cloud console, fai clic su Procedura guidata:
In the Principal column, find all rows that identify you or a group that
you're included in. To learn which groups you're included in, contact your
administrator.
For all rows that specify or include you, check the Role column to see whether
the list of roles includes the required roles.
Nel campo Nuove entità, inserisci il tuo identificatore dell'utente.
In genere si tratta dell'indirizzo email di un Account Google.
Nell'elenco Seleziona un ruolo, seleziona un ruolo.
Per concedere altri ruoli, fai clic su addAggiungi
un altro ruolo e aggiungi ogni ruolo aggiuntivo.
Fai clic su Salva.
Crea un cluster in modalità GKE Autopilot
In modalità Autopilot, Google gestisce la configurazione del cluster, tra cui scalabilità, sicurezza e altre impostazioni preconfigurate. I cluster in modalità Autopilot sono ottimizzati per eseguire la maggior parte dei carichi di lavoro di produzione e per eseguire il provisioning delle risorse di calcolo in base ai manifest Kubernetes.
Nella console Google Cloud , vai alla pagina
Crea un cluster Autopilot di GKE.
Questa semplice app "hello world" è pacchettizzata in un unico container, ma le app più grandi in genere sono costituite da diversi container correlati di cui è possibile eseguire il deployment e che possono essere eseguiti come un unico carico di lavoro.
Fai clic su Avanti: esponi (facoltativo).
Nella sezione Esponi, crea un servizio Kubernetes di bilanciamento del carico per indirizzare le richieste esterne alla tua app:
Seleziona Esponi il deployment come nuovo servizio.
Lascia Porta 1 impostata su 80.
In Porta di destinazione 1, inserisci 8080.
Fai clic su Esegui il deployment.
GKE assegna automaticamente un indirizzo IP esterno disponibile al servizio.
Questo servizio è considerato come parte del carico di lavoro hello-world-app.
Per i cluster Autopilot, potresti visualizzare un messaggio di errore, come
Does not have minimum availability. Questo accade perché Autopilot
elimina e poi ricrea i nodi. Attendi qualche minuto, quindi fai clic su
refreshAggiorna
per aggiornare la pagina.
Dopo il completamento del deployment, vedrai la pagina Dettagli deployment.
Visualizza una demo dal vivo nel tuo browser
Nella console Google Cloud , vai alla pagina Dettagli deployment di hello-world-app:
Nella Google Cloud console, vai alla pagina Workload di GKE.
Nella colonna Nome, fai clic sul nome del carico di lavoro di cui hai eseguito il deployment, ovvero
hello-world-app.
Nella colonna Endpoint, fai clic sull'indirizzo IP disponibile pubblicamente.
GKE apre una nuova scheda del browser e invia una richiesta alla tua app. Ignora tutti gli avvisi di sito protetto. Dovresti vedere il messaggio Hello, world! nella nuova scheda del browser.
Se gli endpoint sono vuoti, l'organizzazione potrebbe prevedere un criterio che impedisce l'accesso esterno.
Hai creato un cluster GKE in modalità Autopilot e hai eseguito il deployment di un carico di lavoro di esempio.
Eseguire la pulizia per evitare addebiti
Se prevedi di seguire altri tutorial o di esplorare ulteriormente il campione, esegui questo passaggio di pulizia solo al termine. Puoi continuare a utilizzare il cluster Kubernetes di esempio nella maggior parte dei tutorial GKE.
Se hai creato un nuovo progetto per prendere dimestichezza con GKE, ma non ne hai più bisogno, elimina il progetto.
Se hai utilizzato un progetto GKE esistente, elimina le risorse che hai creato per evitare addebiti sul tuo account:
Seleziona la riga contenente hello-world-cluster e fai clic su Elimina.
Nella finestra Elimina hello-world-cluster:
Nel campo hello-world-cluster, inserisci hello-world-cluster.
Fai clic su Elimina.
Se ricevi un messaggio di errore relativo al cluster in fase di riparazione, puoi attendere il completamento del processo, quindi eliminare il cluster. Questa operazione
potrebbe richiedere un po' di tempo.
Se hai creato un sink e un bucket di log quando segui le istruzioni in altri tutorial:
Vai alla pagina Archiviazione dei log di Cloud Logging.
[[["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-01 UTC."],[],[],null,["# Quickstart: Create a cluster and deploy a workload\n\nCreate a cluster and deploy a workload in the Google Cloud console\n==================================================================\n\n[Autopilot](/kubernetes-engine/docs/concepts/autopilot-overview)\n\n*** ** * ** ***\n\n\u003cbr /\u003e\n\nA Kubernetes *cluster* provides compute, storage, networking,\nand other services for applications, similar to a virtual data center. Apps and\ntheir associated services that run in Kubernetes are called *workloads*.\n\nThis tutorial lets you quickly see a running Google Kubernetes Engine cluster and sample workload, all set up using the Google Cloud console. You can then explore the workload in the Google Cloud console before going on to our [more in-depth learning path](/kubernetes-engine/docs/learn/scalable-apps), or to start planning and creating your own production-ready cluster.\n\nIf you'd prefer to set up your sample cluster and workload by using Terraform, see [Create a cluster with Terraform](/kubernetes-engine/docs/quickstarts/create-cluster-using-terraform).\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--create-cluster)\n\n*** ** * ** ***\n\nBefore you begin\n----------------\n\nTake the following steps to enable the Kubernetes Engine API:\n\n1. Visit the [Kubernetes Engine page](https://console.cloud.google.com/projectselector/kubernetes) in the Google Cloud console.\n2. Create or select a project.\n3. Wait for the API and related services to be enabled. This can take several minutes.\n4.\n [Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n### Required roles\n\n-\n\n Make sure that you have the following role or roles on the project:\n\n Compute Admin, Kubernetes Engine Admin, Service Account User\n\n #### Check for the roles\n\n 1.\n In the Google Cloud console, go to the **IAM** page.\n\n [Go to IAM](https://console.cloud.google.com/projectselector/iam-admin/iam?supportedpurview=project)\n 2. Select the project.\n 3.\n In the **Principal** column, find all rows that identify you or a group that\n you're included in. To learn which groups you're included in, contact your\n administrator.\n\n 4. For all rows that specify or include you, check the **Role** column to see whether the list of roles includes the required roles.\n\n #### Grant the roles\n\n 1.\n In the Google Cloud console, go to the **IAM** page.\n\n [Go to IAM](https://console.cloud.google.com/projectselector/iam-admin/iam?supportedpurview=project)\n 2. Select the project.\n 3. Click person_add **Grant access**.\n 4.\n In the **New principals** field, enter your user identifier.\n\n This is typically the email address for a Google Account.\n\n 5. In the **Select a role** list, select a role.\n 6. To grant additional roles, click add **Add\n another role** and add each additional role.\n 7. Click **Save**.\n\nCreate a cluster in GKE Autopilot mode\n--------------------------------------\n\nIn Autopilot mode, Google manages your cluster configuration, including\nscaling, security, and other preconfigured settings. Clusters in\nAutopilot mode are optimized to run most production workloads and\nprovision compute resources based on your Kubernetes manifests.\n\n1. In the Google Cloud console, go to the\n GKE **Create an Autopilot cluster** page.\n\n\n [Go to Create an Autopilot cluster](https://console.cloud.google.com/kubernetes/auto/add)\n\n \u003cbr /\u003e\n\n2. Under **Cluster basics**, do the following:\n\n 1. In the **Name** field, enter the following name:\n\n hello-world-cluster\n\n 2. Keep the default values for the rest of the settings and click\n **Create**\n to start creating the cluster.\n\n3. When you're redirected to the **Kubernetes clusters** page, click\n **hello-world-cluster** in the **Name** column.\n\n You can watch the progress of your cluster as it is being configured,\n deployed, and verified.\n4. Wait until you see a check mark next to the **hello-world-cluster**\n page title.\n\nDeploy a sample app to your cluster\n-----------------------------------\n\nDeploy a sample \"hello world\" web app provided by Google and stored as a\ncontainer in Artifact Registry.\n\n1. In the Google Cloud console, go to the GKE **Workloads**\n page.\n\n\n [Go to Workloads](https://console.cloud.google.com/kubernetes/workload/overview)\n\n \u003cbr /\u003e\n\n2. Click **Deploy**.\n\n3. In **Deployment name**, enter the following name:\n\n hello-world-app\n\n4. In Kubernetes Cluster,\n select **hello-world-cluster**.\n\n5. Click **Next: Container details**\n\n6. Leave **Existing container image** selected, and in **Image path**\n enter the following path:\n\n us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0\n\n This simple \"hello world\" app is packaged into a single container, but larger\n apps typically consist of several related containers that can be deployed\n together and run as a single workload.\n7. Click **Next: Expose (optional)**\n\n8. In the **Expose** section, create a load balancing Kubernetes Service to direct\n external requests to your app:\n\n 1. Select **Expose deployment as a new service**.\n\n 2. Leave **Port 1** set to **80**.\n\n 3. In **Target port 1** , enter **8080**.\n\n 4. Click **Deploy**.\n\n GKE automatically assigns an available external IP address\n to the Service.\n\n This Service is considered to be part of the hello-world-app workload.\n9. For Autopilot clusters, you might see an error message, such as\n `Does not have minimum availability`. This occurs because Autopilot\n deletes and then re-creates the nodes. Wait a few minutes, then click\n refreshRefresh\n to update the page.\n\n10. Wait until the deployment completes and you see the **Deployment details**\n page.\n\nView a live demo in your browser\n--------------------------------\n\n1. In the Google Cloud console, go to\n the **Deployment details** page for **hello-world-app**:\n\n 1. In the Google Cloud console, go to the GKE **Workloads** page.\n\n\n [Go to Workloads](https://console.cloud.google.com/kubernetes/workload/overview)\n\n \u003cbr /\u003e\n\n 2. In the **Name** column, click the name of the workload you deployed,\n **hello-world-app**.\n\n2. In the Endpoints\n column, click the IP address, which is publicly available.\n\n GKE opens a new browser tab and sends a request to your\n app. Dismiss any secure-site warnings, and you should see\n **Hello, world!** in the new browser tab.\n\n If **Endpoints** is empty, your organization might have a policy that\n prevents external access.\n\nYou have successfully created a GKE cluster in\nAutopilot mode and deployed a sample workload.\n\nClean up to avoid billing charges\n---------------------------------\n\nIf you plan to take additional tutorials or to [explore your sample further](/kubernetes-engine/docs/quickstarts/tour-cluster), wait until you're finished to perform this cleanup step. You can continue to use the sample Kubernetes cluster\nin most GKE tutorials.\n\nIf you created a new project to learn about GKE and you no\nlonger need the project, [delete the project](https://console.cloud.google.com/cloud-resource-manager).\n\nIf you used an existing GKE project, delete the resources you\ncreated to avoid incurring charges to your account:\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. Select the row containing **hello-world-cluster** , and click\n **Delete**.\n\n3. In the **Delete hello-world-cluster** window, do the following:\n\n 1. In the **hello-world-cluster** field, enter `hello-world-cluster`.\n\n 2. Click **Delete**.\n\n If you receive an error message about the cluster being repaired, you can\n wait for the process to complete, and then delete the cluster. This operation\n might take some time to complete.\n4. If you created a logs sink and bucket when following instructions in other\n tutorials:\n\n 1. Go to the Cloud Logging **Logs storage** page.\n\n\n [Go to Logs storage](https://console.cloud.google.com/logs/storage)\n\n \u003cbr /\u003e\n\n 2. Select **hello-world-cluster-bucket** and click **Delete**.\n\n 3. Go to the Logging **Log router** page.\n\n\n [Go to Log router](https://console.cloud.google.com/logs/router)\n\n \u003cbr /\u003e\n\n 4. Select **hello-world-cluster-sink** and click **Delete**.\n\nWhat's next\n-----------\n\n- [Explore your cluster and workload](/kubernetes-engine/docs/quickstarts/tour-cluster)\n to learn about the some of the key workload settings and resources that\n you deployed.\n\n- Try our more in-depth [Learning path: Scalable apps](/kubernetes-engine/docs/learn/scalable-apps).\n\n- Learn how to get started with real life cluster administration in our [Cluster administration overview](/kubernetes-engine/docs/how-to/cluster-admin-overview)."]]
