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

이 페이지에서는 Cloud Run for Anthos on Google Cloud에 사용 설정된 클러스터를 만든 다음 사전 빌드된 샘플 컨테이너를 클러스터에 배포하는 방법을 보여줍니다.

Qwiklabs의 데모 계정으로 이 빠른 시작을 수행 할 수도 있습니다.

시작하기 전에

  1. Google 계정으로 로그인합니다.

    아직 계정이 없으면 새 계정을 등록하세요.

  2. Cloud Console의 프로젝트 선택기 페이지에서 Cloud 프로젝트를 선택하거나 만듭니다.

    프로젝트 선택기 페이지로 이동

  3. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

  4. 배포된 샘플 서비스에 요청을 보내려면 cURL을 설치합니다.
  5. gcloud 명령줄을 설정합니다. 자세한 내용은 아래에 설명되어 있습니다.

gcloud 명령줄 설정

Cloud Run for Anthos on Google Cloud에 gcloud 명령줄을 설정하려면 다음 안내를 따르세요.

  1. Cloud SDK를 설치하고 초기화합니다.

  2. 플랫폼을 gke로 설정하고 gcloud의 기본 프로젝트 설정을 방금 만든 설정으로 지정합니다.

    gcloud config set run/platform gke
    gcloud config set project PROJECT-ID

    PROJECT-ID를 생성된 프로젝트의 프로젝트 ID로 바꿉니다.

  3. 새 클러스터에 원하는 영역을 설정합니다. 예를 들어 GKE가 지원되는 모든 영역을 사용할 수 있습니다.

    gcloud config set compute/zone ZONE

    ZONE을 현재 영역으로 바꿉니다.

  4. 클러스터를 만들고 컨테이너를 빌드하여 Google Container Registry에 게시하는 데 필요한 프로젝트에 다음 API를 사용 설정합니다.

    gcloud services enable container.googleapis.com containerregistry.googleapis.com cloudbuild.googleapis.com
  5. 설치된 gcloud 구성요소를 업데이트합니다.

    gcloud components update

Cloud Run이 사용 설정된 GKE 클러스터 만들기

Cloud Run for Anthos on Google Cloud에 클러스터를 만들고 사용 설정하려면 다음 안내를 따르세요.

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

    gcloud container clusters create CLUSTER_NAME \
      --addons=HttpLoadBalancing,CloudRun \
      --machine-type=n1-standard-2 \
      --enable-stackdriver-kubernetes \
      --zone=ZONE

    다음과 같이 바꿉니다.

    • CLUSTER_NAME을 클러스터에 사용할 이름으로 바꿉니다.
    • ZONE을 클러스터의 현재 영역으로 바꿉니다(예: us-central1-a). GKE가 지원되는 모든 영역을 사용할 수 있습니다.

    이 안내에서는 수요에 따라 클러스터 크기를 조정하는 클러스터 자동 확장을 사용 설정하지 않습니다. Cloud Run for Anthos on Google Cloud가 클러스터 내에서 인스턴스를 자동으로 확장합니다.

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

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

    여기서 my-project는 프로젝트 ID입니다. my-project 프로젝트에 my-cluster라는 새 Google Kubernetes Engine 클러스터가 생성되었습니다.

  3. 새 클러스터 및 클러스터 위치를 사용하도록 gcloud 기본값을 설정하면 이후 gcloud 명령줄을 사용할 때 이 두 값을 지정하지 않아도 됩니다.

    gcloud config set run/cluster CLUSTER_NAME
    gcloud config set run/cluster_location us-central1-a

    CLUSTER_NAME을 클러스터에 사용한 이름으로 바꾸고, 필요한 경우 us-central1-a를 지원되는 클러스터 위치 중 원하는 위치로 바꿉니다.

샘플 컨테이너 배포

방금 만든 클러스터에 컨테이너를 배포하려면 다음 안내를 따르세요.

  1. Cloud Run으로 이동

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

    이미지

    다음 안내를 따라 양식을 작성하세요.

    1. 개발 플랫폼으로 Cloud Run for Anthos on Google Cloud를 선택합니다.

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

    3. hello라는 이름을 서비스 이름으로 사용합니다. 다른 이름을 사용해도 되지만, 이 경우 나중에 cURL 명령어를 사용하여 서비스에 액세스 할 때도 이 이름을 사용해야합니다. 이 안내에서는 hello를 사용한다고 가정합니다.

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

    5. 서비스 만들기 양식의 두 번째 페이지로 이동하려면 다음을 클릭합니다.

      이미지

      다음 안내를 따라 양식을 작성하세요.

      1. gcr.io/cloudrun/hello를 컨테이너 이미지로 사용합니다.

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

수고하셨습니다. Cloud Run for Anthos on Google Cloud 지원 클러스터에 서비스를 배포했습니다.

배포된 서비스에 액세스

서비스를 배포한 후에는 cURL을 사용하여 Istio 인그레스 컨트롤러용으로 만든 부하 분산기 서비스의 외부 IP 주소를 사용하여 요청을 보내고 서비스가 작동하는지 확인할 수 있습니다.

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

    Google Kubernetes Engine으로 이동

  2. 왼쪽 탐색 패널에서 서비스 및 인그레스를 클릭하여 서비스 목록을 표시합니다.

  3. 클러스터 버전이 1.15.3-gke.19 이상, 1.14.3-gke.12 이상, 1.13.10-gke.8 이상인 경우 istio-ingress 서비스까지 아래로 스크롤합니다. 다른 모든 클러스터 버전의 경우 istio-ingressgateway 서비스까지 아래로 스크롤합니다.

  4. 포트 설정 없이 부하 분산기 옆에 표시된 외부 IP 주소(하나만 있는 경우)를 복사합니다. 예를 들어 IP가 XX.XXX.XX.XXX:15020이면 :15020를 생략합니다. 다른 IP 주소가 표시된 경우 무시합니다.

  5. hello 이외의 서비스 이름을 사용한 경우 cURL을 호출하여 Host 문자열의 hello를 서비스 이름으로 바꿉니다.

    curl -v -H "Host: hello.default.example.com" YOUR-IP

    YOUR-IP를 이전 단계에서 가져온 IP 주소로 바꿉니다.

삭제

Cloud Run for Anthos on Google Cloud 사용 중지

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

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

    Google Kubernetes Engine으로 이동

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

  3. 수정을 클릭합니다.

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

  5. 저장을 클릭합니다.

다음 단계

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

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