노트북에서 연결

PostgreSQL용 AlloyDB를 살펴보거나 로컬 개발 환경에서 작업하려면 공개 IP 주소를 통해 AlloyDB 인증 프록시를 사용하여 노트북 또는 로컬 워크스테이션에서 AlloyDB 인스턴스로 보안 연결을 설정하면 됩니다.

시작하기 전에

노트북에서 연결하기 전에 다음 기본 요건을 완료하세요.

필요한 역할

노트북에서 연결하려면 Identity and Access Management (IAM) 주 구성원(사용자 계정 또는 서비스 계정)에 다음 사전 정의된 역할을 부여합니다.

  • AlloyDB 클라이언트 (roles/alloydb.client)
  • 서비스 사용량 소비자(roles/serviceusage.serviceUsageConsumer)

AlloyDB 인스턴스에서 공개 IP 사용 설정

노트북에서 연결하는 가장 간단한 방법은 AlloyDB 인스턴스에서 공개 IP를 사용 설정하는 것입니다. 인스턴스를 만들 때 공개 IP를 사용 설정하거나 기존 인스턴스를 업데이트하여 사용 설정할 수 있습니다.

콘솔

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

    클러스터로 이동

  2. 클러스터 세부정보를 보려면 리소스 이름에서 클러스터를 클릭합니다.

  3. 클러스터의 인스턴스에서 연결할 인스턴스를 찾습니다.

  4. 인스턴스 작업을 클릭한 다음 수정을 클릭합니다.

  5. 연결에서 공개 IP 사용 설정을 선택합니다.

  6. 변경사항을 저장하려면 인스턴스 업데이트를 클릭합니다.

gcloud

gcloud alloydb instances update 명령어를 사용하여 인스턴스에서 공개 IP를 사용 설정합니다.

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --assign-inbound-public-ip=ASSIGN_IPV4

다음을 바꿉니다.

  • INSTANCE_ID: AlloyDB 인스턴스의 ID입니다.
  • CLUSTER_ID: 클러스터의 ID입니다.
  • REGION_ID: 클러스터가 있는 리전입니다.

인스턴스 연결 URI 가져오기

인증 프록시 클라이언트를 시작할 때 고유한 연결 URI를 사용하여 인스턴스를 식별해야 합니다. 노트북 터미널에서 gcloud CLI alloydb instances describe 명령어를 사용하여 연결 URI를 검색합니다.

gcloud alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --format="value(name)"

이 명령어는 다음과 유사한 형식의 연결 URI를 반환합니다.

projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary

공개 IP로 AlloyDB 인증 프록시 시작

이제 인스턴스 연결 URI가 있으므로 노트북 터미널을 사용하여 인증 프록시 클라이언트를 시작합니다. --public-ip 플래그를 사용하여 AlloyDB 인증 프록시가 공개 IP 네트워크 경로를 통해 연결하도록 지시합니다.

./alloydb-auth-proxy CONNECTION_URI --public-ip

CONNECTION_URI을 인스턴스 연결 URI 검색에서 가져온 인스턴스 연결 URI로 바꿉니다.

AlloyDB 인증 프록시가 성공적으로 시작되면 터미널에 AlloyDB 인증 프록시가 포트 5432에서 로컬 TCP 연결을 수신 대기 중인 것으로 표시됩니다.

Authorizing with Application Default Credentials
Listening on 127.0.0.1:5432
The proxy has started successfully and is ready for new connections!

psql을 사용하여 데이터베이스에 연결

AlloyDB 인증 프록시가 실행되는 동안 노트북에서 별도의 터미널 창을 열어 데이터베이스에 연결합니다.

로컬 리스너 주소 127.0.0.1 및 포트 5432를 타겟팅하여 psql 클라이언트 도구를 실행합니다.

psql -h 127.0.0.1 -U postgres -d postgres

메시지가 표시되면 postgres 데이터베이스 사용자의 비밀번호를 입력합니다.

psql 명령어는 인증 프록시 클라이언트에 연결되며, 이 클라이언트는 보안 터널을 통해 AlloyDB 인스턴스로 연결을 전달합니다. psql 명령어는 노트북이 AlloyDB 인스턴스에 안전하게 연결되었음을 확인하는 프롬프트를 표시합니다.

psql (18.2 (Debian 18.2-1), server 16.11)
Type "help" for help.

postgres=>

다음 단계