비공개 IP로 PostgreSQL용 Cloud SQL 인스턴스에 연결

개요

소스 위치에 따라 비공개 IP 주소를 사용하여 Cloud SQL 인스턴스에 연결하는 방법은 여러 가지가 있습니다. 핵심 요소는 소스 머신이 Cloud SQL 인스턴스와 동일한 VPC 네트워크에 있어야 한다는 것입니다. 소스가 Google Cloud 에 없거나 동일한 Google Cloud 프로젝트에 없으면 여기에 표시된 것과 다르게 연결을 구성해야 합니다.

이 빠른 시작에서는 가장 직접적인 경로를 통해 연결을 구성합니다. 소스 및 대상은 동일한 Google Cloud 프로젝트 및 동일한 VPC 네트워크에 있습니다. 비공개 IP 주소(대상) 및 Compute Engine VM(소스)으로 Cloud SQL 인스턴스를 만듭니다. VM을 사용하여 VM에서 Cloud SQL 인스턴스로 연결하는 데 필요한 도구를 설치하고 사용합니다.

다음 작업을 실행합니다.

1. 비공개 IP 주소로 Cloud SQL 인스턴스 만들기

   이후 사용을 위해 인스턴스의 connection name을 찾아서 저장하세요.

2. Compute Engine VM 만들기
3. Compute Engine VM에 대해 2개의 SSH 연결 열기

   첫 번째 창을 사용하여 psql을 설치한 다음 Cloud SQL 인증 프록시를 설치하고 시작합니다. 그런 후 두 번째 창에서는 Cloud SQL 인증 프록시에 연결하여 Cloud SQL 인스턴스에 연결합니다.

4. SSH 창 #1에서 다음을 수행합니다.
   1. psql 클라이언트를 설치합니다.
   2. Cloud SQL 인증 프록시를 설치합니다.

      Cloud SQL 인증 프록시는 psql 클라이언트와 Cloud SQL 인스턴스 사이의 커넥터로 작동합니다.

   3. Cloud SQL 인증 프록시를 시작합니다.

      성공하면 Cloud SQL 인증 프록시가 연결 요청을 리슨합니다.

5. SSH 창 2번에서 psql 클라이언트가 Cloud SQL 인증 프록시에 연결하도록 설정하여 Cloud SQL 인스턴스에 연결합니다.

   성공하면 이 창에서 psql 프롬프트가 표시되고 Cloud SQL 인증 프록시가 실행되는 SSH 창 1번에 연결 성공 메시지가 표시됩니다.

6. 삭제합니다.

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

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

   Cloud SQL 인스턴스로 이동

2. 인스턴스 만들기를 클릭합니다.
3. PostgreSQL 선택을 클릭합니다.
4. Compute API를 사용 설정하라는 메시지가 표시되면 API 사용 설정 버튼을 클릭합니다.
5. 인스턴스 정보 섹션에서 인스턴스 ID의 이름을 입력합니다.
6. postgres 사용자의 비밀번호를 입력합니다. 이후에 필요하므로, 만든 비밀번호를 기록해 둡니다.
7. 리전 및 영역 가용성 선택 섹션에서 단일 영역 옵션을 선택합니다.
8. 구성 옵션 표시를 펼칩니다.
9. 연결을 펼칩니다.
10. 공개 IP를 선택 해제합니다.
11. 비공개 IP를 선택합니다.
12. 네트워크 드롭다운에서 기본값을 선택합니다.
13. 새 프로젝트를 사용하는 경우 비공개 서비스 연결 필요라는 메시지가 표시됩니다. 이어서 다음 단계를 수행합니다.
1. 연결 설정을 클릭합니다.
2. Service Networking API 사용 설정을 클릭합니다.
3. IP 범위 할당 섹션에서 자동 할당된 IP 범위 사용을 선택합니다.
4. 계속을 클릭합니다.
5. 연결 만들기를 클릭하고 연결 만들기가 완료될 때까지 기다립니다.

14. 인스턴스 만들기를 클릭합니다.

인스턴스 개요 페이지가 표시됩니다. 새 인스턴스를 클릭하여 비공개 IP 주소를 포함한 세부정보를 확인합니다.

이 인스턴스에 연결 섹션에서 인스턴스의 연결 이름을 복사하여 저장합니다. connection name은 projectID:region:instanceID 형식입니다.

나중에 Cloud SQL 인증 프록시를 시작할 때 이 connection name을 사용합니다.

데이터베이스 만들기

인스턴스 개요 페이지로 돌아가 데이터베이스 메뉴 항목을 선택합니다.

• 데이터베이스 만들기를 선택합니다.
• 데이터베이스 이름 필드에 DB_NAME을 입력합니다.
• 만들기를 클릭합니다.

나중에 Cloud SQL 인증 프록시를 사용하여 연결할 때 이 db_name을 사용합니다.

Compute Engine VM 만들기

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

   VM 인스턴스로 이동

2. 인스턴스 만들기를 클릭합니다.
3. 인스턴스의 이름을 입력합니다.
4. 액세스 범위에서 모든 Cloud API에 대한 전체 액세스 허용을 선택합니다.
5. 만들기를 클릭하고 VM 만들기가 완료될 때까지 기다립니다.

Compute Engine VM에 대해 2개의 SSH 연결 열기

VM에서 2개의 창을 사용합니다. 첫 번째 창에서는 psql 클라이언트 및 Cloud SQL 인증 프록시를 설치하고, 인스턴스 연결 이름을 가져오고, 이 이름을 사용하여 프록시를 시작합니다. 두 번째 창에서는 프록시를 통해 Cloud SQL 인스턴스에 연결합니다.

1. Compute Engine VM 인스턴스의 SSH 열에서 SSH 메뉴를 펼칩니다.
2. 브라우저 창에서 열기를 선택하여 SSH 창 1번을 엽니다.

   창에서 프롬프트가 표시될 때까지 몇 초 정도 걸릴 수 있습니다.

3. 메시지가 표시되면 pwd를 입력하여 /home/$USER 디렉터리에 있는지 확인합니다.

   psql 클라이언트 및 Cloud SQL 인증 프록시를 설치하고 이 창에서 Cloud SQL 인증 프록시도 시작합니다.

4. 브라우저 창에서 열기를 다시 선택하여 SSH 창 2번을 엽니다.

   이 창을 사용하여 Cloud SQL 인스턴스에 연결합니다.

psql 클라이언트 설치

이 단계에서는 SSH 창 1번을 사용합니다.

패키지 관리자에서 psql 클라이언트를 설치합니다.

sudo apt-get update
sudo apt-get install postgresql-client
  

Cloud SQL 인증 프록시 설치

이 단계에서는 SSH 창 1번을 사용합니다.

1. wget을 설치합니다.

   sudo apt-get install wget
       

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

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.8.2/cloud-sql-proxy.linux.amd64 \
   -O cloud-sql-proxy
     

3. Cloud SQL 인증 프록시 실행 파일을 만듭니다.

   chmod +x cloud-sql-proxy
     

Cloud SQL 인증 프록시 시작

이 단계에서는 SSH 창 1번을 사용합니다.

출력을 모니터링할 수 있도록 Cloud SQL 인증 프록시를 시작합니다. INSTANCE_CONNECTION_NAME을 Cloud SQL 인스턴스를 만들 때 복사한 connection name으로 바꿉니다.

./cloud-sql-proxy --private-ip INSTANCE_CONNECTION_NAME

Cloud SQL 인증 프록시가 성공적으로 시작되면 다음과 비슷한 메시지가 SSH 창에 표시됩니다.

Listening on 127.0.0.1:5432 for myInstance
Ready for new connections

Cloud SQL 인스턴스에 연결

이 단계에서는 SSH 창 2번을 사용합니다.

DB_NAME를 Cloud SQL 데이터베이스 이름으로 바꾼 후 다음 명령어를 실행합니다.

psql "host=127.0.0.1 port=5432 sslmode=disable dbname=DB_NAME user=postgres"

비밀번호 입력 프롬프트에서 PostgreSQL 계정의 비밀번호를 입력합니다.

PostgreSQL 프롬프트가 표시되는지 확인합니다. psql 클라이언트를 사용하여 데이터베이스에 연결했습니다.

Cloud SQL 인증 프록시를 시작한 터미널 창으로 돌아갑니다. 다음과 유사한 메시지가 표시됩니다.

New connection for myInstance