Un clúster de Kubernetes, que proporciona procesamiento, almacenamiento, herramientas de redes y otros servicios para aplicaciones, de manera similar a un centro de datos virtual. Las apps y sus servicios asociados que se ejecutan en Kubernetes se denominan cargas de trabajo.
En este instructivo, podrás ver rápidamente un clúster de Google Kubernetes Engine en ejecución y una carga de trabajo de muestra, todo configurado con la Google Cloud consola. Luego, puedes explorar la carga de trabajo en la consola de Google Cloud antes de continuar con nuestra ruta de aprendizaje más detallada o comenzar a planificar y crear tu propio clúster listo para la producción.
Si prefieres configurar tu clúster y carga de trabajo de muestra con Terraform, consulta Crea un clúster con Terraform.
Para seguir la guía paso a paso sobre esta tarea directamente en la consola Google Cloud , haz clic en Guiarme:
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.
En el campo Principales nuevas, ingresa tu identificador de usuario.
Esta suele ser la dirección de correo electrónico de una Cuenta de Google.
En la lista Seleccionar un rol, elige uno.
Para otorgar roles adicionales, haz clic en addAgregar
otro rol y agrega uno más.
Haz clic en Guardar.
Crea un clúster en modo Autopilot de GKE
En el modo Autopilot, Google administra la configuración de tu clúster, incluido
el escalamiento, la seguridad y otros parámetros de configuración ya establecidos. Los clústeres en modo Autopilot están optimizados para ejecutar la mayoría de las cargas de trabajo de producción y aprovisionar recursos de procesamiento según tus manifiestos de Kubernetes.
En la consola de Google Cloud , ve a la página Crea un clúster de Autopilot de GKE.
Esta app “hello world” simple se empaqueta en un solo contenedor, pero las apps más grandes, por lo general, constan de varios contenedores relacionados que se pueden implementar y ejecutar como una sola carga de trabajo.
Haz clic en Siguiente: Exposición (opcional).
En la sección Exponer, crea un Servicio de Kubernetes de balanceo de cargas para dirigir las solicitudes externas a la app:
Selecciona Exponer la implementación como un servicio nuevo.
Deja el Puerto 1 en 80.
En Puerto de destino 1, ingresa 8080.
Haz clic en Implementar.
GKE asigna de forma automática una dirección IP externa disponible al Service.
Este Service se considera parte de la carga de trabajo hello-world-app.
Para los clústeres Autopilot, es posible que veas un mensaje de error, como Does not have minimum availability. Esto ocurre porque Autopilot borra y, luego, vuelve a crear los nodos. Espera unos minutos y, luego, haz clic en refreshActualizar para actualizar la página.
Espera hasta que se complete la implementación y veas la página Detalles de la implementación.
Mira una demostración en vivo en tu navegador
En la consola de Google Cloud , ve a la página Detalles de la implementación de hello-world-app:
En la consola de Google Cloud , ve a la página Cargas de trabajo de GKE.
En la columna Nombre, haz clic en el nombre de la carga de trabajo que implementaste, hello-world-app.
En la columna Extremos, haz clic en la dirección IP, que está disponible públicamente.
GKE abre una nueva pestaña del navegador y envía una solicitud a la app. Descarta las advertencias de sitios seguros. Deberías ver Hello, world! en la pestaña del navegador nueva.
Si Extremos está vacío, es posible que tu organización tenga una política que impide el acceso externo.
Creaste correctamente un clúster de GKE en el modo Autopilot e implementaste una carga de trabajo de muestra.
Realiza una limpieza para evitar cargos de facturación
Si planeas realizar instructivos adicionales o explorar más tu muestra, espera hasta terminar para realizar este paso de limpieza. Puedes seguir usando el clúster de Kubernetes de muestra en la mayoría de los instructivos de GKE.
Si creaste un proyecto nuevo para aprender sobre GKE y ya no lo necesitas, bórralo.
Si usaste un proyecto de GKE existente, borra los recursos que creaste para evitar que se generen cargos en tu cuenta:
Selecciona la fila que contiene hello-world-cluster y haz clic en Borrar.
En la ventana Borrar hello-world-cluster, haz lo siguiente:
En el campo hello-world-cluster, ingresa hello-world-cluster.
Haz clic en Borrar.
Si recibes un mensaje de error sobre el clúster que se está reparando, puedes esperar a que se complete el proceso y, luego, borrarlo. Es posible que esta operación tarde un tiempo en completarse.
Si creaste un receptor de registros y un bucket cuando seguiste las instrucciones de otros instructivos, haz lo siguiente:
Ve a la página Almacenamiento de registros de Cloud Logging.
Selecciona hello-world-cluster-sink y haz clic en Borrar.
¿Qué sigue?
Explora el clúster y la carga de trabajo
para obtener información acerca de algunos de los parámetros de configuración y los recursos clave de la carga de trabajo que
implementaste.
[[["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-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)."]]
