Un cluster Kubernetes fournit des ressources de calcul, de stockage, de mise en réseau et d'autres services pour les applications, semblables à un centre de données virtuel. Les applications et les services associés qui s'exécutent dans Kubernetes sont appelés charges de travail.
Ce tutoriel vous permet de voir rapidement un cluster Google Kubernetes Engine en cours d'exécution et un exemple de charge de travail, tous configurés à l'aide de la console Google Cloud . Vous pouvez ensuite explorer la charge de travail dans la console Google Cloud avant de passer à notre parcours de formation plus approfondi ou de commencer à planifier et à créer votre propre cluster prêt pour la production.
Si vous préférez configurer votre cluster et votre charge de travail à l'aide de Terraform, consultez la section Créer un cluster avec Terraform.
Pour obtenir des instructions détaillées sur cette tâche directement dans la console Google Cloud , cliquez sur Visite guidée :
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.
Dans le champ Nouveaux comptes principaux, saisissez votre identifiant utilisateur.
Il s'agit généralement de l'adresse e-mail d'un compte Google.
Dans la liste Sélectionner un rôle, sélectionnez un rôle.
Pour attribuer des rôles supplémentaires, cliquez sur addAjouter un autre rôle et ajoutez tous les rôles supplémentaires.
Cliquez sur Enregistrer.
Créer un cluster en mode GKE Autopilot
En mode Autopilot, Google gère la configuration de votre cluster, y compris le scaling, la sécurité et d'autres paramètres préconfigurés. Les clusters en mode Autopilot sont optimisés pour exécuter la plupart des charges de travail de production et provisionner des ressources de calcul en fonction de vos fichiers manifestes Kubernetes.
Dans la console Google Cloud , accédez à la page Créer un cluster Autopilot de GKE.
Cette application "Hello World" simple est empaquetée dans un seul conteneur, mais les applications plus volumineuses sont généralement constituées de plusieurs conteneurs associés qui peuvent être déployés ensemble et s'exécutent en une seule charge de travail.
Cliquez sur Suivant: Exposer (facultatif).
Dans la section Exposer, créez un service d'équilibrage de charge Kubernetes pour diriger les requêtes externes vers votre application :
Sélectionnez Exposer le déploiement en tant que nouveau service.
Laissez le port 1 défini sur 80.
Dans Port cible 1, saisissez 8080.
Cliquez sur Déployer.
GKE attribue automatiquement une adresse IP externe disponible au service.
Ce service est considéré comme faisant partie de la charge de travail hello-world-app.
Pour les clusters Autopilot, un message d'erreur tel que Does not have minimum availability peut s'afficher. Cela se produit car Autopilot supprime les nœuds, puis les recrée. Attendez quelques minutes, puis cliquez sur refreshActualiser pour mettre à jour la page.
Attendez la fin du déploiement et que la page Détails du déploiement s'affiche.
Consulter une version de démonstration dans votre navigateur
Dans la console Google Cloud , accédez à la page Informations sur le déploiement de hello-world-app :
Dans la console Google Cloud , accédez à la page Charges de travail GKE.
Dans la colonne Nom, cliquez sur le nom de la charge de travail que vous avez déployée, hello-world-app.
Dans la colonne Points de terminaison, cliquez sur l'adresse IP disponible publiquement.
GKE ouvre un nouvel onglet de navigateur et envoie une requête à votre application. Ignorez les avertissements de site sécurisé. Le message Hello, world! doit s'afficher dans le nouvel onglet du navigateur.
Si le champ Points de terminaison est vide, votre organisation peut avoir une règle qui empêche l'accès externe.
Vous avez créé un cluster GKE en mode Autopilot et déployé un exemple de charge de travail.
Effectuer un nettoyage pour éviter que des frais ne vous soient facturés
Si vous prévoyez de suivre d'autres tutoriels ou d'explorer davantage votre exemple, attendez d'avoir terminé avant de procéder à cette étape de nettoyage. Vous pouvez continuer à utiliser l'exemple de cluster Kubernetes dans la plupart des tutoriels GKE.
Si vous avez créé un projet pour apprendre à utiliser GKE et que vous n'en avez plus besoin, supprimez-le.
Si vous avez utilisé un projet GKE existant, supprimez les ressources que vous avez créées pour éviter que des frais ne soient facturés sur votre compte :
Sélectionnez la ligne contenant hello-world-cluster, puis cliquez sur Supprimer.
Dans la fenêtre Supprimer hello-world-cluster, procédez comme suit :
Dans le champ hello-world-cluster, saisissez hello-world-cluster.
Cliquez sur Supprimer.
Si vous recevez un message d'erreur vous indiquant que le cluster est en cours de réparation, attendez la fin du processus, puis supprimez le cluster. Cette opération peut prendre un certain temps.
Si vous avez créé un récepteur de journaux et un bucket en suivant les instructions d'autres tutoriels :
Accédez à la page Stockage des journaux de Cloud Logging.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/01 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)."]]
