Compute Engine에서 SQL Server용 Cloud SQL에 연결

Compute Engine에서 SQL Server용 Cloud SQL에 연결

MySQL   |  PostgreSQL   |  SQL Server

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

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

시작하기 전에

참고: 프로젝트 이름은 4~30자(영문 기준)여야 합니다. 이름을 입력하면 추천 프로젝트 ID가 양식에 표시됩니다. 이 ID는 수정 가능합니다. 프로젝트 ID는 6~30자(영문 기준)여야 하고, 첫 번째 문자는 소문자여야 합니다. 첫 번째 문자를 제외하고는 대시, 소문자 또는 숫자를 사용할 수 있지만 마지막 문자에는 대시를 사용할 수 없습니다.

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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure 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.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

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 인스턴스 만들기

공개 IP

콘솔

공개 IP 주소로 인스턴스 만들기

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

   Cloud SQL 인스턴스로 이동

2. 인스턴스 만들기를 클릭합니다.
3. SQL Server를 클릭합니다.
4. 인스턴스 ID 필드에 quickstart-instance를 입력합니다.
5. 비밀번호 필드에 sqlserver 사용자의 비밀번호를 입력합니다. 나중에 사용할 수 있도록 이 비밀번호를 기록해 둡니다.
6. 리전 및 영역 가용성 선택 섹션에서 단일 영역을 선택합니다.
7. 구성 표시 섹션을 확장합니다.
8. 머신 유형 드롭다운 목록에서 경량형을 선택합니다.
9. 인스턴스 만들기를 클릭한 후 인스턴스가 초기화되고 시작될 때까지 기다립니다.

gcloud

공개 IP 주소로 인스턴스 만들기

다음과 같이 gcloud sql instances create 명령어를 실행하기 전에 DB_ROOT_PASSWORD를 데이터베이스 사용자의 비밀번호로 바꿉니다.

선택적으로 다음 매개변수에 대해 값을 수정합니다.

• --database_version: 데이터베이스 엔진 유형 및 버전입니다. 지정하지 않으면 API 기본값이 사용됩니다. 현재 사용 가능한 버전을 보려면 gcloud 데이터베이스 버전 문서를 참조하세요.
• --cpu: 머신에 사용하려는 코어 수입니다.
• --memory: 머신에 사용하려는 메모리 양을 나타내는 정수 숫자 값입니다. 크기 단위를 제공해야 합니다(예: 3072MB 또는 9GB). 단위를 지정하지 않으면 GB로 간주됩니다.
• --region: 인스턴스의 리전 위치입니다(예: asia-east1, us-east1). 지정하지 않으면 기본값 us-central이 사용됩니다. 리전의 전체 목록을 참조하세요.

gcloud sql instances create 명령어를 사용하여 Cloud SQL 인스턴스를 만듭니다.

gcloud sql instances create quickstart-instance --database-version=SQLSERVER_2019_STANDARD --cpu=1 --memory=4GB --region=us-central --root-password=DB_ROOT_PASSWORD

비공개 IP

콘솔

IP 주소 범위를 할당하고 비공개 연결을 만들어 Cloud SQL의 비공개 서비스 액세스 구성

1. Google Cloud 콘솔에서 VPC 네트워크 페이지로 이동합니다.

   VPC 네트워크로 이동

2. default VPC 네트워크를 선택합니다.
3. 비공개 서비스 연결 탭을 선택합니다.
4. 서비스에 할당된 IP 범위 탭을 선택합니다.
5. IP 범위 할당을 클릭합니다.
6. 할당된 범위의 이름에 google-managed-services-default를 지정합니다.
7. IP 범위에 자동 옵션을 선택하고 프리픽스 길이를 16으로 지정합니다.
8. 할당을 클릭하여 할당된 범위를 만듭니다.
9. default VPC 네트워크의 서비스에 대한 비공개 연결 탭을 선택합니다.
10. 연결 만들기를 클릭하여 네트워크와 서비스 프로듀서 간에 비공개 연결을 만듭니다.
11. 지정된 할당으로 google-managed-services-default를 선택합니다.
12. 연결을 클릭하여 연결을 만듭니다.

비공개 IP 주소 및 SSL을 사용 설정하여 인스턴스 만들기

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

   Cloud SQL 인스턴스로 이동

2. 인스턴스 만들기를 클릭합니다.
3. SQL Server를 클릭합니다.
4. 인스턴스 ID에 quickstart-instance를 입력합니다.
5. sqlserver 사용자의 비밀번호를 입력합니다. 나중에 사용할 수 있도록 이 비밀번호를 기록해 둡니다.
6. 리전 및 영역 가용성 선택에 대해 단일 영역 옵션을 클릭합니다.
7. 구성 옵션 표시를 클릭하여 펼칩니다.
8. 머신 유형으로 경량을 선택합니다.
9. 연결에서 비공개 IP를 선택합니다.
10. 네트워크 드롭다운 메뉴에서 기본값을 선택합니다.
11. 비공개 IP만 있는 인스턴스를 만들려면 공개 IP 체크박스를 선택 해제합니다.
12. 인스턴스 만들기를 클릭한 후 인스턴스가 초기화 및 시작될 때까지 기다립니다.
13. 연결을 클릭합니다.
14. 보안 섹션에서 SSL 연결만 허용을 선택하여 SSL 연결을 사용 설정합니다.
15. SSL 연결만 허용 대화상자에서 저장 및 다시 시작을 클릭하고 인스턴스가 다시 시작될 때까지 기다립니다.

gcloud

IP 주소 범위를 할당하고 비공개 연결을 만들어 Cloud SQL의 비공개 서비스 액세스 구성

1. gcloud compute addresses create 명령어를 실행하여 IP 주소 범위를 할당합니다.

   gcloud compute addresses create google-managed-services-default --global --purpose=VPC_PEERING --prefix-length=16 --description="peering range for Google" --network=default

2. gcloud services vpc-peerings connect 명령어를 실행하여 할당된 IP 주소 범위에 대한 비공개 연결을 만듭니다. YOUR_PROJECT_ID를 프로젝트의 프로젝트 ID로 바꿉니다.

   gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com --ranges=google-managed-services-default --network=default --project=YOUR_PROJECT_ID

비공개 IP 주소 및 SSL을 사용 설정하여 인스턴스 만들기

1. 다음과 같이 명령어를 실행하기 전에 DB_ROOT_PASSWORD를 데이터베이스 사용자의 비밀번호로 바꿉니다.

선택적으로 다음 매개변수에 대해 값을 수정합니다.

• --database_version: 데이터베이스 엔진 유형 및 버전입니다. 지정하지 않으면 API 기본값이 사용됩니다. 현재 사용 가능한 버전을 보려면 gcloud 데이터베이스 버전 문서를 참조하세요.
• --cpu: 머신의 코어 수입니다.
• --memory: 머신에 포함하려는 메모리 양을 나타내는 정수 숫자 값입니다. 크기 단위를 제공할 수 있습니다(예: 3072MB 또는 9GB). 단위를 지정하지 않으면 GB로 간주됩니다.
• --region: 인스턴스의 리전 위치입니다(예: asia-east1, us-east1). 지정하지 않으면 기본값 us-central1이 사용됩니다. 리전의 전체 목록을 참조하세요.

gcloud sql instances create 명령어를 실행하여 비공개 IP 주소로 Cloud SQL 인스턴스를 만듭니다.

gcloud beta sql instances create quickstart-instance --database-version=SQLSERVER_2017_STANDARD --cpu=1 --memory=4GB --region=us-central --root-password=DB_ROOT_PASSWORD --no-assign-ip --network=default

2. gcloud sql instances patch 명령어를 실행하여 인스턴스에 대해 SSL 연결만 허용합니다.

gcloud sql instances patch quickstart-instance --require-ssl

데이터베이스 만들기

콘솔

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

Compute Engine 서비스 계정 구성

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

콘솔

서비스 계정 만들기

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

서비스 계정 만들기로 이동

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

gcloud

서비스 계정 만들기

1. 서비스 계정을 만들려면 gcloud iam service-accounts create 명령어를 실행합니다.

gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

다음 값을 바꿉니다.

• DESCRIPTION: 서비스 계정에 대한 선택적인 설명입니다
2. 서비스 계정에 프로젝트에 대한 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 인스턴스를 만듭니다.

Linux VM 인스턴스 만들기

콘솔

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

   VM 인스턴스로 이동

2. 인스턴스 만들기 버튼을 클릭합니다.
3. VM 인스턴스 이름에 quickstart-vm-instance를 입력합니다.
4. 서비스 계정에 대해 quickstart-service-account를 선택합니다.
5. 방화벽에 대해 HTTP 트래픽 허용 옵션을 선택합니다.
6. 만들기를 클릭하여 VM 인스턴스를 만듭니다.

gcloud

다음 명령어를 실행하기 전에 YOUR_PROJECT_ID를 프로젝트 ID로 바꿉니다.

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

gcloud compute instances create quickstart-vm-instance --image-family=debian-10 --image-project=debian-cloud  --machine-type=e2-medium --service-account=quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com --scopes=https://www.googleapis.com/auth/cloud-platform --tags=http-server --zone=us-central1-a

Windows VM 인스턴스 만들기

콘솔

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

   VM 인스턴스로 이동

2. 인스턴스 만들기 버튼을 클릭합니다.
3. VM 인스턴스 이름에 quickstart-vm-instance를 입력합니다.
4. 부팅 디스크에서 변경 버튼을 클릭합니다.
1. 운영체제에 대해 Windows Server를 선택합니다.
2. 버전에 대해 Windows Server 2022 Datacenter를 선택합니다.
3. 선택 버튼을 클릭합니다.
5. 서비스 계정에 대해 quickstart-service-account를 선택합니다.
6. 방화벽에 대해 HTTP 트래픽 허용 옵션을 선택합니다.
7. 만들기를 클릭하여 VM 인스턴스를 만듭니다.
8. VM 인스턴스가 시작되고 2~3분 후 VM 인스턴스 세부정보 페이지에서 Windows 비밀번호 설정 버튼을 클릭합니다.
9. 이 빠른 시작의 다음 단계에서 VM 인스턴스에 액세스하는 데 사용되므로 이 비밀번호를 복사하여 안전한 위치에 저장합니다.

gcloud

다음 명령어를 실행하기 전에 YOUR_PROJECT_ID를 프로젝트 ID로 바꿉니다.

터미널 창에서 다음 gcloud compute instances create 명령어를 실행합니다.

gcloud compute instances create quickstart-vm-instance --image-project=windows-cloud --image-family=windows-2022 --machine-type=e2-medium --service-account=quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com --scopes=https://www.googleapis.com/auth/cloud-platform --tags=http-server --zone=us-central1-a

VM 인스턴스가 시작되고 2~3분 후 다음 명령어를 실행하여 VM 인스턴스에서 Windows 비밀번호를 설정합니다.

gcloud compute reset-windows-password quickstart-vm-instance

이 빠른 시작의 다음 단계에서 VM 인스턴스에 액세스하는 데 사용되므로 이 비밀번호를 복사하여 안전한 위치에 저장합니다.

Compute Engine VM 인스턴스 액세스

Linux VM 인스턴스 액세스

콘솔

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

VM 인스턴스로 이동

가상 머신 인스턴스 목록에서 연결할 인스턴스 행의 SSH를 클릭합니다.

참고: Google Cloud 콘솔을 사용하여 VM에 연결할 때 Compute Engine은 일시적인 SSH 키를 자동으로 만듭니다. SSH 키에 대한 자세한 내용은 Linux VM에 대한 SSH 연결을 참조하세요.

gcloud

gcloud compute ssh 명령어를 사용하여 Linux VM 인스턴스에 연결합니다. YOUR_PROJECT_ID를 프로젝트 ID로 바꿉니다.

gcloud compute ssh --project=YOUR_PROJECT_ID --zone=us-central1-a quickstart-vm-instance

Windows VM 인스턴스 액세스

Chrome RDP 플러그인

Google Cloud용 Chrome RDP는 Chrome 브라우저를 사용하여 Windows 인스턴스에 연결할 수 있는 타사 플러그인입니다. 플러그인은 Google Cloud 콘솔과 통합됩니다. 플러그인을 설치한 후 Google Cloud 콘솔의 RDP 버튼을 사용하여 모든 Windows Server 인스턴스에 연결합니다.

Chrome RDP 플러그인을 사용하여 연결하려면 다음을 수행하세요.

1. Google Cloud용 Chrome RDP 확장 프로그램을 설치합니다.
2. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동하여 연결할 Windows 인스턴스를 찾습니다.

VM 인스턴스 페이지로 이동

3. 연결하려는 인스턴스의 RDP 버튼을 클릭합니다. Chrome RDP 확장 프로그램이 열립니다.
4. VM 인스턴스에 구성된 도메인이 없으므로 도메인 필드를 비워 둘 수 있습니다.
5. 사용자 이름과 비밀번호를 입력하고 확인을 클릭하여 연결합니다.

6. 메시지가 표시되면 계속을 눌러서 인증서를 수락합니다.

기타

Compute Engine Windows VM 인스턴스에 액세스하기 위한 추가 옵션은 RDP를 사용하여 Windows VM에 연결을 참조하세요.

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

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

Linux VM 인스턴스 개발 환경 설정

Go

다음 단계에 따라 Go 샘플 앱을 실행하도록 Compute Engine VM 인스턴스의 개발 환경을 설정합니다.

1. Go 개발 환경 설정 가이드로 이동합니다.
2. Go 설치 섹션의 안내를 완료합니다.

자바

다음 단계에 따라 자바 샘플 앱을 실행하도록 Compute Engine VM 인스턴스의 개발 환경을 설정합니다.

1. 자바 개발 환경 설정 가이드로 이동합니다.
2. JDK(자바 개발 키트) 설치 섹션의 안내를 완료합니다.
3. 빌드 자동화 도구 설치의 안내에 따라 Apache Maven을 설정하세요.

Node.js

다음 단계에 따라 Node.js 샘플 앱을 실행하도록 Compute Engine VM 인스턴스 개발 환경을 설정합니다.

1. Node.js 개발 환경 설정 가이드로 이동합니다.
2. Node.js 및 npm 설치 섹션의 안내를 완료합니다.

Python

다음 단계에 따라 Python 샘플 앱을 실행하도록 Compute Engine VM 인스턴스의 개발 환경을 설정합니다.

1. Python 개발 환경 설정 가이드로 이동합니다.
2. Python 설치 섹션의 안내를 완료합니다.

Windows VM 인스턴스 개발 환경 설정

Go

다음 단계에 따라 Go 샘플 앱을 실행하도록 Compute Engine VM 인스턴스의 개발 환경을 설정합니다.

1. Go 개발 환경 설정 가이드로 이동합니다.
2. Go 설치 섹션의 안내를 완료합니다.

자바

다음 단계에 따라 자바 샘플 앱을 실행하도록 Compute Engine VM 인스턴스의 개발 환경을 설정합니다.

1. 자바 개발 환경 설정 가이드로 이동합니다.
2. JDK(자바 개발 키트) 설치 섹션의 안내를 완료합니다.
3. 빌드 자동화 도구 설치 섹션의 안내에 따라 Apache Maven을 설정합니다.

Node.js

다음 단계에 따라 Node.js 샘플 앱을 실행하도록 Compute Engine VM 인스턴스 개발 환경을 설정합니다.

1. Node.js 개발 환경 설정 가이드로 이동합니다.
2. Node.js 및 npm 설치 섹션의 안내를 완료합니다.

Python

다음 단계에 따라 Python 샘플 앱을 실행하도록 Compute Engine VM 인스턴스의 개발 환경을 설정합니다.

1. Python과 Python용 PIP 패키지 관리자를 설치합니다.
1. Python 개발 환경 설정 가이드로 이동합니다.
2. Python 설치 섹션의 안내를 완료합니다.
1. 위 안내에 따라 Windows용 Python 출시 다운로드 페이지로 이동합니다. 이 페이지에서 최신 Python 3 출시 버전 링크를 클릭합니다.
2. Python 3.X.X페이지에서 Windows 64비트 설치 프로그램 링크를 클릭하여 Windows Compute Engine VM 인스턴스에 설치 프로그램 파일을 다운로드합니다.
3. Python 설치 프로그램을 VM 인스턴스에 다운로드한 후 다운로드한 파일이 포함된 폴더를 엽니다. 그런 후 설치 프로그램 파일을 오른쪽 버튼으로 클릭하고 관리자로 실행을 선택합니다.
4. Python 설치 대화상자가 나타나면 Python 3.X.X를 경로에 추가 옵션을 선택하고 → 지금 설치를 클릭합니다.
2. PIP를 사용해서 virtualenv를 설치합니다.
1. Windows Compute Engine VM 인스턴스에서 Powershell을 열고 다음 pip install 명령어를 실행합니다.

pip install virtualenv

Git 설치

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

Compute Engine Linux VM 인스턴스

Compute Engine Linux VM 인스턴스에서 공식 Linux용 Git 설치 문서를 따르세요.

• sudo 명령어 프리픽스로 제안된 Debian/Ubuntu install git 명령어를 실행하여 명령어를 관리자로 실행합니다. 터미널에서 실행할 전체 설치 명령어는 다음과 같은 형식이어야 합니다.

sudo apt-get install git

Compute Engine Windows VM 인스턴스

Compute Engine Windows VM 인스턴스에서 공식 Windows용 Git 설치 문서에 따라 64비트 독립형 설치 프로그램을 다운로드하고 실행하여 Git을 설치합니다.

샘플 앱 클론

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/sqlserver/database-sql

자바

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

1. 샘플 앱을 클론합니다.

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples

2. 디렉터리를 샘플 앱이 있는 디렉터리로 변경합니다.

   cd java-docs-samples/cloud-sql/sqlserver/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/sqlserver/mssql

Python

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

1. 샘플 앱을 클론합니다.

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples

2. 디렉터리를 샘플 앱이 있는 디렉터리로 변경합니다.

   cd python-docs-samples/cloud-sql/sql-server/sqlalchemy

Cloud SQL 샘플 앱 구성 및 실행

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

공개 IP Cloud SQL 인스턴스 및 Linux 기반 Compute Engine VM

Go

Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

• INSTANCE_CONNECTION_NAME을 Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지에 표시되는 인스턴스의 연결 이름으로 바꿉니다.
• YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.

export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'

Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 Go 샘플 앱의 종속 항목을 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

1. 샘플 앱을 실행하는 데 필요한 종속 항목을 가져옵니다.

   go get ./...
   

2. 샘플 앱을 실행합니다.

   go run cmd/app/main.go
   

로컬 컴퓨터에서 샘플 앱이 실행되는 Compute Engine VM 인스턴스의 외부 IP 주소를 가져오고 이를 브라우저에서 확인합니다.

참고: 이 빠른 시작 단계에서는 gcloud CLI 명령어를 사용하여 Google Cloud 리소스에 대한 명령줄 액세스를 제공하는 gcloud CLI가 필요합니다. 로컬 컴퓨터에 gcloud CLI가 설치되어 있지 않은 경우 gcloud CLI를 설치하여 계속 진행합니다.

1. 로컬 컴퓨터의 터미널 또는 Powershell에서 다음 gcloud compute instances describe 명령어를 실행하여 Compute Engine VM 인스턴스의 외부 IP 주소를 가져옵니다.

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. 실행 중인 샘플 앱을 확인합니다. 로컬 컴퓨터에서 브라우저를 열고 Compute Engine VM 인스턴스의 외부 IP 주소 및 포트 8080으로 이동합니다.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 터미널에서 Control+C를 누릅니다.

자바

Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

• INSTANCE_CONNECTION_NAME을 Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지에 표시되는 인스턴스의 연결 이름으로 바꿉니다.
• YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.

export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'

Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 자바 샘플 앱의 종속 항목을 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

mvn jetty:run

로컬 컴퓨터에서 샘플 앱이 실행되는 Compute Engine VM 인스턴스의 외부 IP 주소를 가져오고 이를 브라우저에서 확인합니다.

참고: 이 빠른 시작 단계에서는 gcloud CLI 명령어를 사용하여 Google Cloud 리소스에 대한 명령줄 액세스를 제공하는 gcloud CLI가 필요합니다. 로컬 컴퓨터에 gcloud CLI가 설치되어 있지 않은 경우 gcloud CLI를 설치하여 계속 진행합니다.

1. 로컬 컴퓨터의 터미널 또는 Powershell에서 다음 gcloud compute instances describe 명령어를 실행하여 Compute Engine VM 인스턴스의 외부 IP 주소를 가져옵니다.

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. 실행 중인 샘플 앱을 확인합니다. 로컬 컴퓨터에서 브라우저를 열고 Compute Engine VM 인스턴스의 외부 IP 주소 및 포트 8080으로 이동합니다.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 터미널에서 Control+C를 누릅니다.

Node.js

1. Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

   • YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.

   export INSTANCE_HOST='127.0.0.1'
   export DB_PORT='1433'
   export DB_NAME='quickstart_db'
   export DB_USER='sqlserver'
   export DB_PASS='YOUR_DB_PASSWORD'
   

2. Cloud SQL 인증 프록시를 다운로드합니다.

   curl -o cloud-sql-proxy \
   https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.linux.amd64

3. Cloud SQL 인증 프록시 파일을 실행 가능하게 만드는 권한을 설정합니다.

   chmod +x cloud-sql-proxy

4. Cloud SQL 인증 프록시를 백그라운드 프로세스로 실행합니다. INSTANCE_CONNECTION_NAME을 Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지에 표시되는 인스턴스의 연결 이름으로 바꿉니다.

   ./cloud-sql-proxy INSTANCE_CONNECTION_NAME &

참고: 샘플 앱을 시작한 위치의 터미널 창에서 fg 명령어를 사용하여 백그라운드에서 Cloud SQL 인증 프록시를 실행하는 프로세스를 중지할 수 있습니다. 이렇게 하면 실행 중인 Cloud SQL 인증 프록시 작업이 터미널 포그라운드로 전환됩니다. 그런 다음 Ctrl + C 키를 눌러 프록시 작업을 중지합니다.

Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 필요한 Node.js 패키지를 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

1. 앱을 로컬에서 실행하는 데 필요한 Node.js 패키지를 설치합니다.

   npm install
   

2. 샘플 앱을 실행합니다.

   npm start
   

로컬 컴퓨터에서 샘플 앱이 실행되는 Compute Engine VM 인스턴스의 외부 IP 주소를 가져오고 이를 브라우저에서 확인합니다.

참고: 이 빠른 시작 단계에서는 gcloud CLI 명령어를 사용하여 Google Cloud 리소스에 대한 명령줄 액세스를 제공하는 gcloud CLI가 필요합니다. 로컬 컴퓨터에 gcloud CLI가 설치되어 있지 않은 경우 gcloud CLI를 설치하여 계속 진행합니다.

1. 로컬 컴퓨터의 터미널 또는 Powershell에서 다음 gcloud compute instances describe 명령어를 실행하여 Compute Engine VM 인스턴스의 외부 IP 주소를 가져옵니다.

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. 실행 중인 샘플 앱을 확인합니다. 로컬 컴퓨터에서 브라우저를 열고 Compute Engine VM 인스턴스의 외부 IP 주소 및 포트 8080으로 이동합니다.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 터미널에서 Control+C를 누릅니다.

Python

Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

• INSTANCE_CONNECTION_NAME을 Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지에 표시되는 인스턴스의 연결 이름으로 바꿉니다.
• YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.

export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'

Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 Python 샘플 앱의 요구 사항을 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

1. 가상 환경을 초기화하고 샘플 앱을 실행하기 위한 요구사항을 설치하세요.

   python3 -m venv env
   source env/bin/activate
   pip install -r requirements.txt
   

2. 샘플 앱을 실행합니다.

   python app.py
   

로컬 컴퓨터에서 다음 빠른 시작 단계의 안내에 따라 SSH를 통한 포트 전달을 설정합니다. 이렇게 하면 로컬 컴퓨터의 브라우저를 사용하여 Compute Engine VM 인스턴스에서 실행 중인 앱을 볼 수 있습니다.

참고: 이 빠른 시작 단계에서는 gcloud CLI 명령어를 사용하여 Google Cloud 리소스에 명령줄 액세스를 제공하는 gcloud CLI가 필요합니다. 로컬 컴퓨터에 gcloud CLI가 설치되어 있지 않은 경우 gcloud CLI를 설치하여 계속 진행합니다.

1. 터미널 또는 로컬 컴퓨터의 Powershell에서 다음 gcloud compute ssh 명령어를 실행하여 SSH를 통한 포트 전달을 설정합니다. 명령어를 실행하기 전에 YOUR_PROJECT_ID를 프로젝트 ID로 바꿉니다.

gcloud compute ssh quickstart-vm-instance --project=YOUR_PROJECT_ID --zone=us-central1-a --ssh-flag='-L 8000:127.0.0.1:8080'

2. 실행 중인 샘플 앱을 봅니다. 포트 전달이 실행 중인 경우 로컬 컴퓨터에서 브라우저를 열고 브라우저의 주소 표시줄에 http://127.0.0.1:8000을 입력합니다.

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 터미널에서 Control+C를 누릅니다.

공개 IP Cloud SQL 인스턴스 및 Windows 기반 Compute Engine VM

Go

Compute Engine VM 인스턴스의 열린 Powershell 창에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

• INSTANCE_CONNECTION_NAME을 Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지에 표시되는 인스턴스의 연결 이름으로 바꿉니다.
• YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.

$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"

Compute Engine VM 인스턴스의 열린 Powershell 창에서 다음 명령어를 실행하여 Go 샘플 앱의 종속 항목을 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

1. 샘플 앱을 실행하는 데 필요한 종속 항목을 가져옵니다.

   go get ./...
   

2. 샘플 앱을 실행합니다.

   go run cmd\app\main.go
   

3. 실행 중인 샘플 앱을 봅니다. Compute Engine VM 인스턴스에서 브라우저를 열고 http://127.0.0.1:8080으로 이동합니다.

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 Powershell 창에서 Control+C를 누릅니다.

자바

Compute Engine VM 인스턴스의 열린 Powershell 창에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

• INSTANCE_CONNECTION_NAME을 Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지에 표시되는 인스턴스의 연결 이름으로 바꿉니다.
• YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.

$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"

1. Compute Engine VM 인스턴스의 열린 Powershell 창에서 다음 명령어를 실행하여 자바 샘플 앱의 종속 항목을 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

   mvn jetty:run
   

2. 실행 중인 샘플 앱을 봅니다. Compute Engine VM 인스턴스에서 브라우저를 열고 http://127.0.0.1:8080으로 이동합니다.

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 Powershell 창에서 Control+C를 누릅니다.

Node.js

1. Compute Engine VM 인스턴스의 열린 Powershell 창에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

   • YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.

   $env:INSTANCE_HOST="127.0.0.1"
   $env:DB_PORT="1433"
   $env:DB_NAME="quickstart_db"
   $env:DB_USER="sqlserver"
   $env:DB_PASS="YOUR_DB_PASSWORD"
   
   

2. Cloud SQL 인증 프록시를 다운로드합니다.

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.x64.exe `
   -O cloud-sql-proxy.exe

3. Cloud SQL 인증 프록시를 백그라운드 프로세스로 실행합니다. INSTANCE_CONNECTION_NAME을 Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지에 표시되는 인스턴스의 연결 이름으로 바꿉니다.

   Start-Process -filepath  ".\cloud-sql-proxy.exe" -ArgumentList `
   "INSTANCE_CONNECTION_NAME"

참고: 백그라운드에서 Cloud SQL 인증 프록시를 실행하는 프로세스를 중지하려면 Start-Process 명령어로 실행된 cmd.exe 창을 선택하면 됩니다. 그런 다음 프록시 작업을 중지하려면 창을 닫습니다.

Compute Engine VM 인스턴스의 열린 Powershell 창에서 다음 명령어를 실행하여 필요한 Node.js 패키지를 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

1. 앱을 로컬에서 실행하는 데 필요한 Node.js 패키지를 설치합니다.

   npm install
   

2. 샘플 앱을 실행합니다.

   npm start
   

3. 실행 중인 샘플 앱을 봅니다. Compute Engine VM 인스턴스에서 브라우저를 열고 http://127.0.0.1:8080으로 이동합니다.

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 Powershell 창에서 Control+C를 누릅니다.

Python

Compute Engine VM 인스턴스의 열린 Powershell 창에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

• INSTANCE_CONNECTION_NAME을 Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지에 표시되는 인스턴스의 연결 이름으로 바꿉니다.
• YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.

$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"

Compute Engine VM 인스턴스의 열린 Powershell 창에서 다음 명령어를 실행하여 Python 샘플 앱의 요구 사항을 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

1. 가상 환경을 초기화하고 샘플 앱을 실행하기 위한 요구사항을 설치하세요.

   virtualenv --python python3 env
   .\env\Scripts\activate
   pip install -r requirements.txt
   
   

2. 샘플 앱을 실행합니다.

   python app.py
   

3. 실행 중인 샘플 앱을 봅니다. Compute Engine VM 인스턴스에서 브라우저를 열고 http://127.0.0.1:8080으로 이동합니다.

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 Powershell 창에서 Control+C를 누릅니다.

비공개 IP Cloud SQL 인스턴스 및 Linux 기반 Compute Engine VM

로컬 컴퓨터에서 SSL 서버 인증서 만들기 및 다운로드

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

   Cloud SQL 인스턴스로 이동

2. quickstart-instance를 클릭하여 해당 개요 페이지를 참조하세요.
3. 연결 탭을 클릭합니다.
4. 보안 섹션에서 인증서 다운로드를 클릭하여 SSL 서버 인증서를 다운로드합니다.

Cloud Storage 버킷에 SSL 인증서 업로드

콘솔

로컬 컴퓨터의 브라우저에서 Cloud Storage 버킷을 만들고 Compute Engine VM 인스턴스에서 액세스할 수 있는 버킷에 SSL 인증서를 업로드합니다.

1. Cloud Storage 버킷 생성
1. 버킷 이름에 다음 이름을 입력합니다. YOUR_PROJECT_ID를 프로젝트 ID로 바꿉니다.

   YOUR_PROJECT_ID-quickstart-certs

2. 만들기 버튼을 클릭하여 버킷을 만듭니다.
2. 파일 업로드 버튼을 클릭하여 새로 만든 Cloud Storage 버킷에 파일을 업로드합니다.
3. 로컬 컴퓨터에서 Cloud Storage로 업로드할 다음 파일을 선택합니다.
• server-ca.pem

gcloud

SSL 인증서를 다운로드한 디렉터리로 열려 있는 로컬 컴퓨터의 터미널 또는 Powershell 창에서 Cloud Storage 버킷을 만들고 Compute Engine VM 인스턴스에서 액세스할 수 있는 버킷에 SSL 인증서를 업로드합니다. gcloud CLI에 포함된 Cloud Storage 명령줄 유틸리티 gsutil이 파일 업로드에 사용됩니다.

1. 다음 gsutil mb 명령어를 실행하여 새 Cloud Storage 버킷을 만듭니다.

gsutil mb -l us-central1 gs://YOUR_PROJECT_ID-quickstart-certs

2. 로컬 컴퓨터에 인증서를 다운로드한 디렉터리에서 다음 gsutil cp 명령어를 실행하여 SSL 인증서를 새로 만든 Cloud Storage 버킷에 복사합니다.

gsutil cp server-ca.pem gs://YOUR_PROJECT_ID-quickstart-certs/

Go

Compute Engine VM 인스턴스에서 gsutil을 사용하여 SSL 인증서 다운로드

golang-samples/cloudsql/sqlserver/database-sql 디렉터리로 열려 있는 Compute Engine VM 인스턴스의 터미널에서 다음 gsutil cp 명령어를 실행하여 Cloud Storage에서 certs 디렉터리로 SSL 인증서를 다운로드합니다.

gsutil cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.

Compute Engine VM 인스턴스에서 환경 변수 설정

Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

• 설정된 INSTANCE_HOST를 Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지에 표시된 인스턴스의 비공개 IP 주소로 바꿉니다.
참고: 비공개 IP 주소를 사용하는 Cloud SQL 인스턴스 연결은 RFC 1918 주소 범위에 대해 자동으로 승인됩니다. 비RFC 1918 주소 범위의 경우 비공개 IP 사용 알아보기를 참조하세요.
• YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'
export DB_ROOT_CERT='certs/server-ca.pem'
export PRIVATE_IP='TRUE'

Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 Go 샘플 앱의 종속 항목을 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

1. 샘플 앱을 실행하는 데 필요한 종속 항목을 가져옵니다.

   go get ./...
   

2. 샘플 앱을 실행합니다.

   go run cmd/app/main.go
   

로컬 컴퓨터에서 샘플 앱이 실행되는 Compute Engine VM 인스턴스의 외부 IP 주소를 가져오고 이를 브라우저에서 확인합니다.

참고: 이 빠른 시작 단계에서는 gcloud CLI 명령어를 사용하여 Google Cloud 리소스에 명령줄 액세스를 제공하는 gcloud CLI가 필요합니다. 로컬 컴퓨터에 gcloud CLI가 설치되어 있지 않은 경우 gcloud CLI를 설치하여 계속 진행합니다.

1. 로컬 컴퓨터의 터미널 또는 Powershell에서 다음 gcloud compute instances describe 명령어를 실행하여 Compute Engine VM 인스턴스의 외부 IP 주소를 가져옵니다.

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. 실행 중인 샘플 앱을 확인합니다. 로컬 컴퓨터에서 브라우저를 열고 Compute Engine VM 인스턴스의 외부 IP 주소 및 포트 8080으로 이동합니다.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 터미널에서 Control+C를 누릅니다.

자바

Compute Engine VM 인스턴스에서 gsutil을 사용하여 SSL 인증서 다운로드

java-docs-samples/cloud-sql/sqlserver/servlet/ 디렉터리로 열려 있는 Compute Engine VM 인스턴스의 터미널에서 다음 gsutil cp 명령어를 실행하여 Cloud Storage에서 현재 디렉터리로 SSL 인증서를 다운로드합니다.

gsutil cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem .

Compute Engine VM 인스턴스에서 자바에 사용할 SSL 인증서 구성

Compute Engine VM 인스턴스의 터미널에서 keytool을 사용해서 다음 명령어를 실행하여 서버 인증서를 커스텀 자바 트러스트 저장소로 가져옵니다. 다음 명령어를 실행하기 전에 TRUST_CERT_KEYSTORE_PASSWD를 자바 트러스트 저장소를 만드는 데 사용할 자체 커스텀 키 저장소 비밀번호로 바꿉니다.

keytool -importcert -alias MySQLCACert -file server-ca.pem \
-keystore quickstart-truststore -storepass TRUST_CERT_KEYSTORE_PASSWD

Compute Engine VM 인스턴스에서 환경 변수 설정

Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

• 설정된 INSTANCE_HOST를 Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지에 표시된 인스턴스의 비공개 IP 주소로 바꿉니다.
참고: 비공개 IP 주소를 사용하는 Cloud SQL 인스턴스 연결은 RFC 1918 주소 범위에 대해 자동으로 승인됩니다. 비RFC 1918 주소 범위의 경우 비공개 IP 사용 알아보기를 참조하세요.
• YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'
export TRUST_CERT_KEYSTORE_PATH='quickstart-truststore'
export TRUST_CERT_KEYSTORE_PASSWD='TRUST_CERT_KEYSTORE_PASSWD'
export PRIVATE_IP='TRUE'

Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 자바 샘플 앱의 종속 항목을 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

mvn jetty:run

로컬 컴퓨터에서 샘플 앱이 실행되는 Compute Engine VM 인스턴스의 외부 IP 주소를 가져오고 이를 브라우저에서 확인합니다.

참고: 이 빠른 시작 단계에서는 gcloud CLI 명령어를 사용하여 Google Cloud 리소스에 명령줄 액세스를 제공하는 gcloud CLI가 필요합니다. 로컬 컴퓨터에 gcloud CLI가 설치되어 있지 않은 경우 gcloud CLI를 설치하여 계속 진행합니다.

1. 로컬 컴퓨터의 터미널 또는 Powershell에서 다음 gcloud compute instances describe 명령어를 실행하여 Compute Engine VM 인스턴스의 외부 IP 주소를 가져옵니다.

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. 실행 중인 샘플 앱을 확인합니다. 로컬 컴퓨터에서 브라우저를 열고 Compute Engine VM 인스턴스의 외부 IP 주소 및 포트 8080으로 이동합니다.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 터미널에서 Control+C를 누릅니다.

Python

Compute Engine VM 인스턴스에서 gsutil을 사용하여 SSL 인증서 다운로드

python-docs-samples/cloud-sql/sql-server/sqlalchemy 디렉터리로 열려 있는 Compute Engine VM 인스턴스의 터미널에서 다음 gsutil cp 명령어를 실행하여 Cloud Storage에서 certs 디렉터리로 SSL 인증서를 다운로드합니다.

gsutil cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.

Compute Engine VM 인스턴스에서 환경 변수 설정

Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

• 설정된 INSTANCE_HOST를 Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지에 표시된 인스턴스의 비공개 IP 주소로 바꿉니다.
참고: 비공개 IP 주소를 사용하는 Cloud SQL 인스턴스 연결은 RFC 1918 주소 범위에 대해 자동으로 승인됩니다. 비RFC 1918 주소 범위의 경우 비공개 IP 사용 알아보기를 참조하세요.
• YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'
export DB_ROOT_CERT='certs/server-ca.pem'
export PRIVATE_IP='TRUE'

Compute Engine VM 인스턴스의 열린 터미널에서 다음 명령어를 실행하여 Python 샘플 앱의 요구 사항을 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

1. 가상 환경을 초기화하고 샘플 앱을 실행하기 위한 요구사항을 설치하세요.

   python3 -m venv env
   source env/bin/activate
   pip install -r requirements.txt
   

2. 샘플 앱을 실행합니다.

   python app.py
   

로컬 컴퓨터에서 다음 빠른 시작 단계의 안내에 따라 SSH를 통한 포트 전달을 설정합니다. 이렇게 하면 로컬 컴퓨터의 브라우저를 사용하여 Compute Engine VM 인스턴스에서 실행 중인 앱을 볼 수 있습니다.

참고: 이 빠른 시작 단계에서는 gcloud CLI 명령어를 사용하여 Google Cloud 리소스에 명령줄 액세스를 제공하는 gcloud CLI가 필요합니다. 로컬 컴퓨터에 gcloud CLI가 설치되어 있지 않은 경우 gcloud CLI를 설치하여 계속 진행합니다.

1. 터미널 또는 로컬 컴퓨터의 Powershell에서 다음 gcloud compute ssh 명령어를 실행하여 SSH를 통한 포트 전달을 설정합니다. 명령어를 실행하기 전에 YOUR_PROJECT_ID를 프로젝트 ID로 바꿉니다.

gcloud compute ssh quickstart-vm-instance --project=YOUR_PROJECT_ID --zone=us-central1-a --ssh-flag='-L 8000:127.0.0.1:8080'

2. 실행 중인 샘플 앱을 봅니다. 포트 전달이 실행 중인 경우 로컬 컴퓨터에서 브라우저를 열고 브라우저의 주소 표시줄에 http://127.0.0.1:8000을 입력합니다.

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 터미널에서 Control+C를 누릅니다.

비공개 IP Cloud SQL 인스턴스 및 Windows 기반 Compute Engine VM

로컬 컴퓨터에서 SSL 서버 인증서 만들기 및 다운로드

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

   Cloud SQL 인스턴스로 이동

2. quickstart-instance를 클릭하여 해당 개요 페이지를 참조하세요.
3. 연결 탭을 클릭합니다.
4. 보안 섹션에서 인증서 다운로드를 클릭하여 SSL 서버 인증서를 다운로드합니다.

Cloud Storage 버킷에 SSL 인증서 업로드

콘솔

로컬 컴퓨터의 브라우저에서 Cloud Storage 버킷을 만들고 Compute Engine VM 인스턴스에서 액세스할 수 있는 버킷에 SSL 인증서를 업로드합니다.

1. Cloud Storage 버킷 생성
1. 버킷 이름에 다음 이름을 입력합니다. YOUR_PROJECT_ID를 프로젝트 ID로 바꿉니다.

   YOUR_PROJECT_ID-quickstart-certs

2. 만들기 버튼을 클릭하여 버킷을 만듭니다.
2. 파일 업로드 버튼을 클릭하여 새로 만든 Cloud Storage 버킷에 파일을 업로드합니다.
3. 로컬 컴퓨터에서 Cloud Storage로 업로드할 다음 파일을 선택합니다.
• server-ca.pem

gcloud

SSL 인증서를 다운로드한 디렉터리로 열려 있는 로컬 컴퓨터의 터미널 또는 Powershell 창에서 Cloud Storage 버킷을 만들고 Compute Engine VM 인스턴스에서 액세스할 수 있는 버킷에 SSL 인증서를 업로드합니다. gcloud CLI에 포함된 Cloud Storage 명령줄 유틸리티 gsutil이 파일 업로드에 사용됩니다.

1. 다음 gsutil mb 명령어를 실행하여 새 Cloud Storage 버킷을 만듭니다.

gsutil mb -l us-central1 gs://YOUR_PROJECT_ID-quickstart-certs

2. 로컬 컴퓨터에 인증서를 다운로드한 디렉터리에서 다음 gsutil cp 명령어를 실행하여 SSL 인증서를 새로 만든 Cloud Storage 버킷에 복사합니다.

gsutil cp server-ca.pem gs://YOUR_PROJECT_ID-quickstart-certs/

Go

Compute Engine VM 인스턴스에서 gsutil을 사용하여 SSL 인증서 다운로드

golang-samples/cloudsql/sqlserver/database-sql 디렉터리로 열려 있는 Compute Engine VM 인스턴스의 Powershell 창에서 다음 gsutil cp 명령어를 실행하여 Cloud Storage에서 certs 디렉터리로 SSL 인증서를 다운로드합니다.

gsutil cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.

Compute Engine VM 인스턴스에서 환경 변수 설정

Compute Engine VM 인스턴스의 Powershell 창에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

• 설정된 INSTANCE_HOST를 Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지에 표시된 인스턴스의 비공개 IP 주소로 바꿉니다.
참고: 비공개 IP 주소를 사용하는 Cloud SQL 인스턴스 연결은 RFC 1918 주소 범위에 대해 자동으로 승인됩니다. 비RFC 1918 주소 범위의 경우 비공개 IP 사용 알아보기를 참조하세요.
• YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:DB_ROOT_CERT="certs/server-ca.pem"
$env:PRIVATE_IP="TRUE"

Compute Engine VM 인스턴스의 열린 Powershell 창에서 다음 명령어를 실행하여 Go 샘플 앱의 종속 항목을 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

1. 샘플 앱을 실행하는 데 필요한 종속 항목을 가져옵니다.

   go get ./...
   

2. 샘플 앱을 실행합니다.

   go run cmd\app\main.go
   

3. 실행 중인 샘플 앱을 봅니다. Compute Engine VM 인스턴스에서 브라우저를 열고 http://127.0.0.1:8080으로 이동합니다.

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 Powershell 창에서 Control+C를 누릅니다.

자바

Compute Engine VM 인스턴스에서 gsutil을 사용하여 SSL 인증서 다운로드

java-docs-samples/cloud-sql/sqlserver/servlet/ 디렉터리로 열려 있는 Compute Engine VM 인스턴스의 Powershell 창에서 다음 gsutil cp 명령어를 실행하여 Cloud Storage에서 현재 디렉터리로 SSL 인증서를 다운로드합니다.

gsutil cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem .

Compute Engine VM 인스턴스에서 자바에 사용할 SSL 인증서 구성

Compute Engine VM 인스턴스의 터미널에서 keytool을 사용해서 다음 명령어를 실행하여 서버 인증서를 커스텀 자바 트러스트 저장소로 가져옵니다. 다음 명령어를 실행하기 전에 TRUST_CERT_KEYSTORE_PASSWD를 자바 트러스트 저장소를 만드는 데 사용할 자체 커스텀 키 저장소 비밀번호로 바꿉니다.

keytool -importcert -alias SQLServerCACert -file server-ca.pem `
-keystore quickstart-truststore -storepass TRUST_CERT_KEYSTORE_PASSWD

Compute Engine VM 인스턴스에서 환경 변수 설정

Compute Engine VM 인스턴스의 Powershell 창에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

• 설정된 INSTANCE_HOST를 Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지에 표시된 인스턴스의 비공개 IP 주소로 바꿉니다.
참고: 비공개 IP 주소를 사용하는 Cloud SQL 인스턴스 연결은 RFC 1918 주소 범위에 대해 자동으로 승인됩니다. 비RFC 1918 주소 범위의 경우 비공개 IP 사용 알아보기를 참조하세요.
• YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.
• TRUST_CERT_KEYSTORE_PASSWD를 이전 단계에서 --storepass에 지정한 비밀번호로 바꿉니다.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:TRUST_CERT_KEYSTORE_PATH="quickstart-truststore"
$env:TRUST_CERT_KEYSTORE_PASSWD="TRUST_CERT_KEYSTORE_PASSWD"
$env:PRIVATE_IP="TRUE"

1. Compute Engine VM 인스턴스의 열린 Powershell 창에서 다음 명령어를 실행하여 자바 샘플 앱의 종속 항목을 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

   mvn jetty:run
   

2. 실행 중인 샘플 앱을 봅니다. Compute Engine VM 인스턴스에서 브라우저를 열고 http://127.0.0.1:8080으로 이동합니다.

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 Powershell 창에서 Control+C를 누릅니다.

Python

Compute Engine VM 인스턴스에서 gsutil을 사용하여 SSL 인증서 다운로드

python-docs-samples/cloud-sql/sql-server/sqlalchemy 디렉터리로 열려 있는 Compute Engine VM 인스턴스의 Powershell 창에서 다음 gsutil cp 명령어를 실행하여 Cloud Storage에서 certs 디렉터리로 SSL 인증서를 다운로드합니다.

gsutil cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.

Compute Engine VM 인스턴스에서 환경 변수 설정

Compute Engine VM 인스턴스의 Powershell 창에서 다음 명령어를 실행하여 샘플 앱을 실행하는 데 필요한 환경 변수를 초기화합니다. 명령어를 실행하기 전 다음을 바꿉니다.

• 설정된 INSTANCE_HOST를 Google Cloud 콘솔의 Cloud SQL 인스턴스 페이지에 표시된 인스턴스의 비공개 IP 주소로 바꿉니다.
참고: 비공개 IP 주소를 사용하는 Cloud SQL 인스턴스 연결은 RFC 1918 주소 범위에 대해 자동으로 승인됩니다. 비RFC 1918 주소 범위의 경우 비공개 IP 사용 알아보기를 참조하세요.
• YOUR_DB_PASSWORD를 이전 사용자 만들기 빠른 시작 단계에서 만든 quickstart-user의 비밀번호로 바꿉니다.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:DB_ROOT_CERT="certs/server-ca.pem"
$env:PRIVATE_IP="TRUE"

Compute Engine VM 인스턴스의 열린 Powershell 창에서 다음 명령어를 실행하여 Python 샘플 앱의 요구 사항을 Compute Engine VM 인스턴스로 가져오고 샘플 앱을 실행합니다.

1. 가상 환경을 초기화하고 샘플 앱을 실행하기 위한 요구사항을 설치하세요.

   virtualenv --python python3 env
   .\env\Scripts\activate
   pip install -r requirements.txt
   

2. 샘플 앱을 실행합니다.

   python app.py
   

3. 실행 중인 샘플 앱을 봅니다. Compute Engine VM 인스턴스에서 브라우저를 열고 http://127.0.0.1:8080으로 이동합니다.

   

샘플 앱을 중지하려면 샘플 앱을 시작한 Compute Engine VM 인스턴스 Powershell 창에서 Control+C를 누릅니다.

삭제

이 페이지에서 사용한 리소스 비용이 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 인스턴스의 SQL Server 사용자 및 데이터베이스를 만드는 방법 알아보기

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

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

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

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

• App Engine 표준 환경에서 실행되는 애플리케이션에서 연결
• Compute Engine에서 실행되는 애플리케이션에서 연결
• GKE에서 실행되는 애플리케이션에서 연결
• Cloud Functions에서 연결
• Cloud Run에서 연결