Cloud Run에서 연결

이 페이지에서는 Google Cloud 콘솔과 클라이언트 애플리케이션을 사용하여 Cloud Run 서비스에 샘플 애플리케이션을 배포하는 과정을 안내합니다. 이 샘플 애플리케이션은 Cloud Run을 PostgreSQL용 AlloyDB에 연결합니다.

시작하기 전에

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

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

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. Cloud Run에서 PostgreSQL용 AlloyDB 샘플 애플리케이션을 실행하는 데 필요한 Cloud API를 사용 설정합니다.

    API 사용 설정

    1. 프로젝트 확인 단계에서 변경할 프로젝트의 이름을 확인하려면 다음을 클릭합니다.

    2. API 사용 설정 단계에서 사용 설정을 클릭하여 다음을 사용 설정합니다.

      • AlloyDB API
      • Cloud Run Admin API
      • Compute Engine API
      • Cloud Build API
      • Container Registry API
      • Service Networking API
      • Cloud Resource Manager API

    7. 클러스터 및 클러스터의 기본 인스턴스 만들기

    1. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

      클러스터로 이동

    2. 클러스터 만들기를 클릭합니다.

      Google Cloud 콘솔에 클러스터 유형 선택사항이 표시됩니다. 고가용성을 선택합니다.

    3. 계속을 클릭합니다.

      클러스터 구성 섹션이 펼쳐집니다.

    4. 기본 정보의 클러스터 ID 필드에 my-cluster를 입력합니다.

    5. 비밀번호 필드에 원하는 비밀번호를 입력합니다. 이 비밀번호를 기록해 둡니다. 이 빠른 시작의 뒷부분에서 다시 사용합니다.

    6. 리전 필드에서 us-central1 (Iowa)을 선택합니다.

    7. 연결의 네트워크 드롭다운에서 default를 선택합니다.

      아직 비공개 서비스 액세스를 설정하지 않은 경우 비공개 서비스 액세스 연결 필요라는 대화상자가 표시됩니다.

      비공개 서비스 액세스 연결 필요 대화상자에서 비공개 서비스 액세스 연결을 만들려면 다음 단계를 완료하세요.

      1. 연결 설정을 클릭합니다.

        Service Networking API 사용 설정이라는 새 창이 표시됩니다.

      2. 창에서 자동으로 할당된 IP 범위 사용을 선택합니다.

      3. 계속을 클릭합니다.

      4. 연결 만들기를 클릭하고 연결 구성이 완료될 때까지 기다립니다.

        창이 삭제됩니다.

    8. 계속을 클릭합니다.

      기본 인스턴스 구성 섹션이 펼쳐집니다.

    9. 기본 정보의 인스턴스 ID 필드에 my-primary를 입력합니다.

    10. 머신 값으로 2 vCPU, 16 GB를 선택합니다.

    11. 클러스터 만들기를 클릭합니다.

      클러스터가 생성될 때까지 기다립니다.

    인스턴스에 연결하고 데이터베이스 만들기

    1. 새로 만든 클러스터의 개요 페이지에 있지 않다면 Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

      클러스터로 이동

    2. 클러스터 개요 페이지를 표시하려면 my-cluster 클러스터 이름을 클릭합니다.

    3. 탐색 메뉴에서 AlloyDB Studio를 클릭합니다.

    4. AlloyDB Studio에 로그인 페이지의 데이터베이스 목록에서 postgres를 선택합니다.

    5. 사용자 드롭다운 목록에서 postgres을 선택합니다.

    6. 비밀번호 필드에 클러스터 및 기본 인스턴스 만들기에서 만든 비밀번호를 입력합니다.

    7. 인증을 클릭합니다. 탐색기 창에 데이터베이스의 객체 목록이 표시됩니다.

    8. 편집기 1 탭에서 데이터베이스를 만듭니다.

      CREATE DATABASE quickstart_db;

    9. 실행을 클릭합니다. 결과 창에 Statement executed successfully 메시지가 표시될 때까지 기다립니다.

    프로젝트 ID 확인

    1. Google Cloud 콘솔의 대시보드 페이지로 이동합니다.

      대시보드로 이동

    2. 프로젝트 정보 카드에서 프로젝트 ID를 찾습니다.

    3. 프로젝트 ID를 기록해 둡니다. 이 빠른 시작의 다음 단계에서 필요합니다.

    샘플 애플리케이션의 이미지로 Artifact Registry 채우기

    1. Google Cloud 콘솔에서 Cloud Shell을 엽니다.

      Cloud Shell 열기

    2. Cloud Shell 편집기에서 다음 명령어를 사용하여 GitHub에서 샘플 애플리케이션 코드가 포함된 저장소를 클론합니다.

      cloudshell_open --repo_url \
"https://github.com/GoogleCloudPlatform/alloydb-auth-proxy" \
--dir \
"examples/go" \
--force_new_clone

    3. Artifact Registry에 Docker 이미지를 저장할 저장소를 만듭니다.

      gcloud artifacts repositories create cloud-run-source-deploy --location us-central1 --repository-format=docker --project PROJECT_ID

      PROJECT_ID를 프로젝트의 ID로 바꿉니다.

    4. Cloud Shell 승인 대화상자에서 승인을 클릭합니다. 이전에 이 단계를 완료한 경우 이 메시지가 표시되지 않습니다.

    5. Docker 컨테이너를 빌드하고 Artifact Registry에 게시하려면 다음 명령어를 사용하세요.

       gcloud builds submit --tag  us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy/run-sql --project PROJECT_ID

      PROJECT_ID를 프로젝트의 ID로 바꿉니다.

    새 인스턴스의 IP 주소 찾기

    1. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

      클러스터로 이동

    2. 표에서 리소스 이름이 my-primary인 행을 찾습니다.

    3. 해당 행의 비공개 IP 주소를 기록해 둡니다. 이 빠른 시작의 다음 단계에서 필요합니다.

      IP 주소의 형식 예시는 172.19.209.2:5432입니다.

    Cloud Run 서비스 만들기

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

      Cloud Run으로 이동

    2. 서비스 탭에서 컨테이너 배포를 클릭합니다.

    3. 서비스 만들기 페이지에서 기존 컨테이너 이미지에서 버전 1개 배포 옵션을 선택합니다.

    4. 컨테이너 이미지 URL 필드에서 선택을 클릭합니다.

    5. 컨테이너 이미지 선택 창에서 다음 단계를 완료합니다.

      1. Artifact Registry 탭을 선택합니다.
      2. us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy를 펼칩니다.
      3. run-sql를 펼칩니다.
      4. 최신 이미지를 선택합니다.
      5. 선택을 클릭합니다.

    6. 서비스 이름 필드에 quickstart-service를 입력합니다.

    7. 리전 목록에서 us-central1 (Iowa)이 기본적으로 선택되어 있는지 확인합니다.

    8. 인증 섹션에서 인증되지 않은 호출 허용을 선택합니다.

    9. CPU 할당 및 가격 책정 섹션에서 CPU가 요청 처리 중에만 할당됨이 선택되어 있는지 확인합니다.

    10. 컨테이너, 볼륨, 네트워킹, 보안 섹션을 펼칩니다.

    11. 컨테이너 탭에서 변수 및 보안 비밀 탭을 선택하고 다음 단계를 완료합니다.

      1. 환경 변수 섹션에서 변수 추가를 클릭합니다.

      2. Name 및 Value 필드에 다음을 입력합니다.

    12. 컨테이너 탭에서 네트워킹 탭으로 전환하고 다음 단계를 완료합니다.

      1. 아웃바운드 트래픽을 위해 VPC에 연결 체크박스를 선택합니다.

      2. 트래픽을 VPC로 직접 전송 옵션을 선택합니다.

      3. 네트워크 드롭다운 목록에서 default 값을 선택합니다.

      4. 서브넷 드롭다운 목록에서 default 값이 선택되어 있는지 확인합니다.

    13. 만들기를 클릭하여 Cloud Run 서비스를 만듭니다.

      Cloud Run 서비스가 배포되면 quickstart-service 페이지의 URL 필드에 샘플 애플리케이션의 URL이 표시됩니다.

      이 애플리케이션은 AlloyDB를 데이터 스토어로 사용합니다.

    샘플 애플리케이션 보기

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

      Cloud Run으로 이동

    2. quickstart-service 페이지에서 클립보드에 복사를 클릭하여 애플리케이션 URL을 복사합니다.

    3. 새 브라우저 탭에 복사한 애플리케이션 URL을 붙여넣고 Enter를 클릭합니다.

      표시되는 샘플 투표 수집 웹 애플리케이션은 다음과 유사합니다.

      탭 및 스페이스 샘플 애플리케이션

    삭제

    이 페이지에서 사용한 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 다음 단계를 수행합니다.

    클러스터 정리

    1. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

      클러스터로 이동

    2. 삭제하려는 my-cluster 클러스터 옆에 있는 작업을 클릭한 다음 삭제를 클릭합니다.

    3. 표시되는 클러스터 삭제 대화상자의 my-cluster 필드에 my-cluster를 입력하여 삭제할 것임을 확인합니다.

    4. 삭제를 클릭합니다.

    서비스 정리

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

      Cloud Run으로 이동

    2. quickstart-service 서비스 이름 옆의 체크박스를 선택합니다.

    3. Cloud Run 페이지 상단에 있는 삭제를 클릭합니다.

    4. 표시되는 quickstart-service 삭제 대화상자에서 삭제를 클릭하여 확인합니다.

    다음 단계