Compute Engine에서 PostgreSQL용 Cloud SQL에 연결

Google Cloud 콘솔 및 클라이언트 애플리케이션을 사용하여 PostgreSQL에 연결된 Linux 또는 Windows 기반 Compute Engine VM 인스턴스에 샘플 앱을 배포하는 방법을 알아봅니다.

모든 단계를 적시에 완료한다면 이 빠른 시작에서 만든 리소스의 비용은 일반적으로 1달러(USD) 미만입니다.

시작하기 전에

  1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

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

    Go to project selector

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

  6. Compute Engine VM 인스턴스에서 Cloud SQL 샘플 앱을 실행하는 데 필요한 Cloud API를 사용 설정합니다.

    콘솔

    API 사용 설정 버튼을 클릭하여 이 빠른 시작에 필요한 API를 사용 설정합니다.

    API 사용 설정

    다음 API가 사용 설정됩니다.

    • Cloud SQL Admin API

    gcloud

    Google Cloud 리소스에 대한 명령줄 액세스를 제공하는 gcloud CLI설치합니다. gcloud CLI는 이 빠른 시작에 나온 gcloud CLI 명령어를 실행하는 데 사용됩니다. 모든 명령어는 터미널 또는 Powershell 창에서 실행되도록 형식이 지정됩니다.

    다음 gcloud 명령어를 실행합니다.

    gcloud services enable sqladmin.googleapis.com

    이 명령어는 다음 API를 사용 설정합니다.

    • Cloud SQL Admin API

Cloud SQL 설정

Cloud SQL 인스턴스 만들기

데이터베이스 만들기

콘솔

  1. Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

    Cloud SQL 인스턴스로 이동

  2. quickstart-instance을 선택합니다.
  3. 데이터베이스 탭을 엽니다.
  4. 데이터베이스 만들기를 클릭합니다.
    1. 새 데이터베이스 대화상자에서 데이터베이스 이름으로 quickstart_db를 입력합니다.
    2. 만들기를 클릭합니다.

gcloud

gcloud sql databases create 명령어를 실행하여 데이터베이스를 만듭니다.

gcloud sql databases create quickstart_db --instance=quickstart-instance

사용자 만들기

콘솔

  1. Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

    Cloud SQL 인스턴스로 이동

  2. 인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
  3. SQL 탐색 메뉴에서 사용자를 선택합니다.
  4. 사용자 계정 추가를 클릭합니다.
  5. instance_name 페이지에 새로운 사용자 계정 추가 페이지에서 다음 정보를 추가합니다.
    • 사용자 이름 필드에 quickstart-user를 입력합니다.
    • 비밀번호 필드에 데이터베이스 사용자의 비밀번호를 지정합니다. 이 빠른 시작의 이후 단계에서 사용할 수 있도록 기록해 둡니다.
  6. 추가를 클릭합니다.

gcloud

다음 명령어를 실행하기 전에 다음을 바꿉니다.

  1. PASSWORD를 데이터베이스 사용자의 비밀번호로 바꿉니다. 이 빠른 시작의 이후 단계에서 사용할 수 있도록 기록해 둡니다.

gcloud sql users create 명령어를 실행하여 사용자를 만듭니다.

gcloud sql users create quickstart-user --instance=quickstart-instance --password=PASSWORD

Cloud SQL와 온프레미스 PostgreSQL의 사용자 이름 길이 한도는 동일합니다.

Compute Engine 서비스 계정 구성

Cloud SQL에 연결할 권한이 있는 Cloud SQL 클라이언트 역할을 가지는 Google Cloud 서비스 계정을 만들고 구성합니다. 서비스 계정을 만든 후 60초 이상 기다려야 서비스 계정을 사용할 수 있습니다.

콘솔

서비스 계정 만들기

  1. Google Cloud 콘솔에서 서비스 계정 만들기 페이지로 이동합니다.
  2. 서비스 계정 만들기로 이동

  3. Google Cloud 프로젝트를 선택합니다.
  4. 서비스 계정 이름으로 quickstart-service-account를 입력합니다.
  5. 선택사항: 서비스 계정에 대한 설명을 입력합니다.
  6. 만들고 계속하기를 클릭하고 다음 단계로 진행합니다.
  7. 프로젝트의 서비스 계정에 부여할 Cloud SQL 클라이언트 역할을 선택합니다.
  8. 다른 역할 추가를 클릭하고 스토리지 객체 뷰어 역할을 선택하여 프로젝트의 서비스 계정에 부여합니다.
  9. 계속을 클릭합니다.
  10. 완료를 클릭하여 서비스 계정 만들기를 마칩니다.

gcloud

서비스 계정 만들기

  1. 서비스 계정을 만들려면 gcloud iam service-accounts create 명령어를 실행합니다.
  2. gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

    다음 값을 바꿉니다.

    • DESCRIPTION: 서비스 계정에 대한 선택적인 설명입니다
  3. 서비스 계정에 프로젝트에 대한 Cloud SQL 클라이언트 역할 및 스토리지 객체 뷰어 역할을 부여하려면 gcloud projects add-iam-policy-binding 명령어를 실행합니다. PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.
    gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client" --role="roles/storage.objectViewer"

Compute Engine VM 인스턴스 만들기

Cloud SQL에 연결되는 샘플 웹 앱을 호스팅할 Compute Engine VM 인스턴스를 만듭니다.

Compute Engine VM 인스턴스 액세스

프로그래밍 언어를 위한 개발 환경 설정

Compute Engine VM 인스턴스의 개발 환경을 원하는 프로그래밍 언어로 설정합니다.

Git 설치

오픈소스 버전 제어 시스템인 Git을 Compute Engine VM 인스턴스에 설치합니다.

샘플 앱 클론

git clone 명령어를 사용하여 샘플 앱을 Compute Engine VM 인스턴스에 클론합니다.

Go

Compute Engine VM 인스턴스에서 새 터미널 또는 Powershell 창을 엽니다. 다음 명령어를 실행하여 Go 샘플 앱을 클론하고 디렉터리를 샘플 앱이 있는 디렉터리로 변경합니다.

  1. 샘플 앱을 클론합니다.
    git clone https://github.com/GoogleCloudPlatform/golang-samples
  2. 디렉터리를 샘플 앱이 있는 디렉터리로 변경합니다.
    cd golang-samples/cloudsql/postgres/database-sql

자바

Compute Engine VM 인스턴스에서 새 터미널 또는 Powershell 창을 엽니다. 다음 명령어를 실행하여 Java 샘플 앱을 클론하고 디렉터리를 샘플 앱이 있는 디렉터리로 변경합니다.

  1. 샘플 앱을 클론합니다.
    git clone https://github.com/GoogleCloudPlatform/java-docs-samples
  2. 디렉터리를 샘플 앱이 있는 디렉터리로 변경합니다.
    cd java-docs-samples/cloud-sql/postgres/servlet

Node.js

Compute Engine VM 인스턴스에서 새 터미널 또는 Powershell 창을 엽니다. 다음 명령어를 실행하여 Node.js 샘플 앱을 클론하고 디렉터리를 샘플 앱이 있는 디렉터리로 변경합니다.

  1. 샘플 앱을 클론합니다.
    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
  2. 디렉터리를 샘플 앱이 있는 디렉터리로 변경합니다.
    cd nodejs-docs-samples/cloud-sql/postgres/knex

Python

Compute Engine VM 인스턴스에서 새 터미널 또는 Powershell 창을 엽니다. 다음 명령어를 실행하여 Python 샘플 앱을 클론하고 디렉터리를 샘플 앱이 있는 디렉터리로 변경합니다.

  1. 샘플 앱을 클론합니다.
    git clone https://github.com/GoogleCloudPlatform/python-docs-samples
  2. 디렉터리를 샘플 앱이 있는 디렉터리로 변경합니다.
    cd python-docs-samples/cloud-sql/postgres/sqlalchemy

Cloud SQL 샘플 앱 구성 및 실행

Cloud SQL 인스턴스, 데이터베이스, 클라이언트 권한이 있는 서비스 계정이 준비되었으므로 이제 Compute Engine VM 인스턴스에서 실행되는 샘플 애플리케이션이 Cloud SQL 인스턴스에 연결되도록 구성할 수 있습니다.

삭제

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

Cloud SQL 인스턴스 삭제

  1. Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

    Cloud SQL 인스턴스로 이동

  2. quickstart-instance 인스턴스를 선택하여 인스턴스 세부정보 페이지를 엽니다.
  3. 페이지 상단의 아이콘 표시줄에서 삭제를 클릭합니다.
  4. 인스턴스 삭제 대화상자에서 quickstart-instance를 입력한 후 삭제를 클릭하여 인스턴스를 삭제합니다.

Compute Engine VM 인스턴스 삭제

  1. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.

    VM 인스턴스로 이동

  2. quickstart-vm-instance 인스턴스를 선택하여 인스턴스 세부정보 페이지를 엽니다.
  3. 페이지 상단의 아이콘 표시줄에서 삭제를 클릭합니다.
  4. 삭제를 클릭하여 인스턴스를 삭제합니다.

선택적인 삭제 단계

Compute Engine default 서비스 계정에 할당한 Cloud SQL 클라이언트 역할을 사용하지 않을 때는 이를 삭제할 수 있습니다.

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

    IAM으로 이동

  2. Compute Engine 기본 서비스 계정이라는 IAM 계정에 대해 수정 아이콘(연필 모양)을 클릭합니다.
  3. Cloud SQL 클라이언트 역할을 삭제합니다.
  4. 저장을 클릭합니다.

이 빠른 시작 중 사용 설정된 API를 사용하지 않는 경우 이를 사용 중지할 수 있습니다.

  • 이 빠른 시작에서 사용 설정된 API:
    • Cloud SQL Admin API
  1. Google Cloud 콘솔에서 API 페이지로 이동합니다.

    API로 이동

  2. 사용 중지하려는 API를 선택한 후 API 사용 중지 버튼을 클릭합니다.

다음 단계

Cloud SQL 인스턴스 만들기 자세히 알아보기(필요한 경우)

Cloud SQL 인스턴스의 PostgreSQL 사용자데이터베이스를 만드는 방법 알아보기

가격 책정에 대한 자세한 내용은 PostgreSQL용 Cloud SQL 가격 책정을 참조하세요.

다음에 대해 자세히 알아보기

  • 공개 IP 주소로 Cloud SQL 인스턴스 구성하기
  • 비공개 IP 주소로 Cloud SQL 인스턴스 구성하기

또한 다른 Google Cloud 애플리케이션에서 Cloud SQL 인스턴스에 연결하는 방법을 알아보세요.