Kubernetes 클러스터는 가상 데이터 센터와 비슷하게 컴퓨팅, 스토리지, 네트워킹 및 기타 애플리케이션 서비스를 제공합니다. Kubernetes에서 실행되는 앱과 관련 서비스를 워크로드라고 합니다.
이 튜토리얼에서는 Google Cloud 콘솔을 사용하여 설정되어 실행 중인 Google Kubernetes Engine 클러스터와 샘플 워크로드를 빠르게 확인할 수 있습니다. 그런 후 Google Cloud 콘솔에서 워크로드를 살펴본 후 심화 학습 과정으로 이동하거나 자체 프로덕션 레디 클러스터를 계획하고 만들 수 있습니다.
Autopilot 모드에서 Google은 확장, 보안, 기타 사전 구성된 설정을 포함하여 클러스터 구성을 관리합니다. Autopilot 모드의 클러스터는 대부분의 프로덕션 워크로드를 실행하고Kubernetes 매니페스트에 따라 컴퓨팅 리소스를 프로비저닝하도록 최적화되어 있습니다.
Google Cloud 콘솔에서 GKE Autopilot 클러스터 만들기 페이지로 이동합니다.
이 간단한 'hello world' 앱은 단일 컨테이너에 패키징되지만 더 큰 앱은 일반적으로 함께 배포하고 단일 워크로드로 실행할 수 있는 여러 개의 관련 컨테이너로 구성됩니다.
다음: 노출 (선택사항)을 클릭합니다.
노출 섹션에서 외부 요청을 앱에 전달하도록 부하 분산 Kubernetes 서비스를 만듭니다.
새 서비스로 배포 노출을 선택합니다.
포트 1을 80으로 둡니다.
대상 포트 1에 8080을 입력합니다.
배포를 클릭합니다.
GKE는 사용 가능한 외부 IP 주소를 서비스에 자동으로 할당합니다.
이 서비스는 hello-world-app 워크로드의 일부로 고려됩니다.
Autopilot 클러스터의 경우 Does not have minimum availability와 같은 오류 메시지가 표시될 수 있습니다. 이는 Autopilot이 노드를 삭제한 다음 다시 만들기 때문입니다 몇 분 정도 기다린 후 refresh새로고침을 클릭하여 페이지를 업데이트합니다.
배포가 완료되고 배포 세부정보 페이지가 표시될 때까지 기다립니다.
브라우저에서 실시간 데모 보기
Google Cloud 콘솔에서 hello-world-app의 배포 세부정보 페이지로 이동합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-06-25(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)."]]
