빠른 시작: Cloud Run for Anthos에 배포

Cloud Run for Anthos에 사용 설정된 클러스터를 만든 후 사전 빌드된 샘플 컨테이너를 클러스터에 배포하는 방법을 알아봅니다.

데모 계정이 있으면 Google Cloud Skills Boost에서 이 빠른 시작을 수행할 수도 있습니다.

시작하기 전에

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  2. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

  3. 최신 버전의 Google Cloud CLI가 있는지 확인하려면 Google Cloud CLI를 설치하거나 업데이트합니다.

명령줄 환경 설정 및 필수 API 사용 설정

다음 단계를 완료하여 Cloud Run for Anthos에 명령줄 환경을 설정하고 필요한 API를 사용 설정합니다.

  1. 기본적으로 Google Cloud 프로젝트의 ID를 사용하도록 Google Cloud CLI를 구성합니다.

    gcloud config set project PROJECT-ID

    PROJECT-ID를 프로젝트 ID로 바꿉니다.

  2. 새 클러스터를 배포할 영역을 설정합니다. GKE가 지원되는 모든 영역을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

    gcloud config set compute/zone ZONE

    ZONE을 원하는 영역으로 바꿉니다.

  3. gcloud services 명령어를 실행하여 Google Cloud 프로젝트에서 다음 API를 사용 설정합니다.

    • Google Kubernetes Engine API: GKE 클러스터를 만듭니다.
    • Cloud Build API: 컨테이너를 빌드합니다.
    • Container Registry API: Container Registry에 컨테이너를 게시합니다.
    gcloud services enable container.googleapis.com containerregistry.googleapis.com cloudbuild.googleapis.com

    완료되는 데 몇 초 정도 걸릴 수 있습니다. API가 사용 설정되면 명령줄에 다음과 유사한 메시지가 표시됩니다.

    Operation "operations/..." finished successfully.

Cloud Run for Anthos가 사용 설정된 GKE 클러스터 만들기

다음 단계를 완료하여 클러스터를 만들고 Cloud Run for Anthos에 사용 설정합니다.

  1. 다음 명령어를 사용하여 새 클러스터를 만듭니다.

    gcloud container clusters create CLUSTER_NAME \
      --addons=HttpLoadBalancing,CloudRun \
      --machine-type=e2-standard-4 \
      --num-nodes=4 \
      --enable-stackdriver-kubernetes

    CLUSTER_NAME을 클러스터에 사용할 이름으로 바꿉니다.

  2. 클러스터 만들기가 완료될 때까지 기다립니다. 클러스터 생성 과정에서 다음과 비슷한 메시지가 표시됩니다.

    Creating cluster my-cluster...done.
    Created [https://container.googleapis.com/v1beta1/ \
    projects/my-project/zones/us-central1-b/clusters/my-cluster].
    

    여기서 my-project는 Google Cloud 프로젝트의 ID이고 my-cluster는 바로 전에 만든 클러스터입니다.

  3. Cloud Run for Anthos 리소스의 gcloud 기본값을 새 클러스터의 이름과 위치로 설정합니다. Google Cloud CLI를 사용할 때마다 이러한 값을 지정하지 않도록 이 기본값을 설정합니다.

    gcloud config set run/platform gke
    gcloud config set run/cluster CLUSTER_NAME
    gcloud config set run/cluster_location ZONE

    CLUSTER_NAMEZONE을 새 클러스터를 만들 때 사용한 값과 동일한 값으로 바꿉니다.

샘플 컨테이너 배포

Google Cloud 콘솔을 사용하여 클러스터에 샘플 컨테이너를 배포하고 서비스를 만듭니다.

  1. Google Cloud 콘솔에서 Cloud Run for Anthos 페이지로 이동합니다.

    Cloud Run for Anthos로 이동

  2. 서비스 만들기를 클릭하여 서비스 만들기 양식을 엽니다.

  3. 사용 가능한 클러스터 드롭다운 메뉴에서 방금 만든 클러스터를 선택합니다.

  4. default네임스페이스의 이름으로 입력합니다.

  5. 서비스 이름을 입력합니다(예: hello).

  6. 다음을 클릭합니다.

  7. 기존 컨테이너 이미지에서 버전 1개 배포를 선택한 다음 데모 컨테이너 드롭다운에서 hello를 선택합니다.

  8. 다음을 클릭합니다.

  9. 연결에서 외부를 선택하여 서비스를 호출할 수 있습니다.

  10. 만들기를 클릭하여 Cloud Run for Anthos에 이미지를 배포하고 배포가 완료될 때까지 기다립니다.

축하합니다 Cloud Run for Anthos 지원 클러스터에 서비스를 배포했습니다.

배포된 서비스에 액세스

이제 서비스가 실행 중이므로 요청을 보낼 수 있습니다. 이 섹션에서는 cURL을 사용하여 서비스에 액세스하는 방법을 보여주고 서비스가 작동 중인지 확인합니다.

  1. Google Cloud 콘솔에서 Cloud Run for Anthos 페이지로 이동합니다.

    Cloud Run for Anthos로 이동

  2. 새 Cloud Run for Anthos 서비스 이름을 클릭하여 해당 서비스 세부정보 페이지로 이동합니다.

  3. 서비스 URL의 오른쪽에 있는 정보 를 클릭합니다.

  4. Cloud Shell에서 호출을 클릭하여 Cloud Shell에서 서비스에 대해 생성된 cURL 명령어를 실행합니다.

cURL 요청은 서비스가 실행 중인 샘플 컨테이너의 소스 코드를 반환합니다. 이제 서비스가 요청을 처리하는 것을 확인했습니다.

삭제

Cloud Run for Anthos를 사용 중지하거나 클러스터 및 Cloud Run for Anthos 서비스를 삭제하여 이러한 리소스의 실행에 따른 비용이 발생하지 않도록 할 수 있습니다.

Cloud Run for Anthos 사용 중지

Cloud Run for Anthos를 사용 중지하고 클러스터를 유지하려면 다음 안내를 따르세요.

  1. Google Cloud 콘솔에서 Google Kubernetes Engine 페이지로 이동합니다.

    Google Kubernetes Engine으로 이동

  2. Cloud Run for Anthos를 사용 중지할 클러스터를 클릭합니다.

  3. 수정을 클릭합니다.

  4. Anthos 기능까지 아래로 스크롤하고 Cloud Run for Anthos 드롭다운에서 사용 중지를 선택합니다.

  5. 저장을 클릭합니다.

Cloud Run for Anthos 삭제

Cloud Run for Anthos 서비스 및 관련 리소스를 포함하여 GKE 클러스터를 영구적으로 삭제하려면 다음 안내를 따르세요.

  1. Google Cloud 콘솔에서 Google Kubernetes Engine 페이지로 이동합니다.

    Google Kubernetes Engine으로 이동

  2. 삭제할 클러스터를 선택합니다.

  3. 삭제를 클릭하고 팝업에서 삭제를 다시 클릭합니다.

다음 단계

코드 소스에서 컨테이너를 빌드한 다음 Container Registry로 푸시하고 배포하는 방법은 다음을 참조하세요.

Google Kubernetes Engine 클러스터의 부가기능으로 설치한 Cloud Run for Anthos의 변경사항을 포함하여 Cloud Run for Anthos의 아키텍처 개요는 다음을 참조하세요.