이 페이지에서는 공개 IP 주소를 통해 AlloyDB 인증 프록시를 사용하여 노트북 또는 로컬 머신에서 PostgreSQL용 AlloyDB 인스턴스로 보안 연결을 설정하는 방법을 설명합니다.
노트북에서 연결하는 것은 AlloyDB를 탐색하거나 개발 환경을 설정하려는 경우에 유용합니다.
시작하기 전에
노트북에서 연결하기 전에 다음을 수행해야 합니다.
- gcloud CLI를 설치하고 초기화합니다. gcloud CLI를 사용하여 명령어를 인증하고 인스턴스 세부정보를 검색합니다.
psql명령줄 도구를 설치합니다.psql클라이언트 도구를 PostgreSQL 터미널 데이터베이스 클라이언트로 사용합니다.- 인증 프록시 클라이언트를 다운로드합니다. 인증 프록시 클라이언트를 사용하여 AlloyDB 인스턴스로의 보안 터널을 만듭니다.
- 필요한 역할을 구성합니다.
필요한 역할
노트북에서 연결하려면 Identity and Access Management (IAM) 주 구성원(사용자 계정 또는 서비스 계정)에 필요한 사전 정의된 역할이 있어야 합니다.
- AlloyDB 클라이언트 (
roles/alloydb.client) - 서비스 사용량 소비자 (
roles/serviceusage.serviceUsageConsumer)
AlloyDB 인스턴스에서 공개 IP 사용 설정
노트북에서 연결하는 가장 간단한 방법은 AlloyDB 인스턴스에서 공개 IP를 사용 설정하는 것입니다. 인스턴스를 만들 때 공개 IP를 사용 설정하거나 기존 인스턴스를 업데이트하여 사용 설정할 수 있습니다.
콘솔
콘솔에서 클러스터 페이지로 이동합니다. Google Cloud
클러스터 세부정보를 보려면 리소스 이름 에서 클러스터를 클릭합니다.
클러스터의 인스턴스에서 연결할 인스턴스 를 찾습니다.
인스턴스 작업 을 클릭한 다음 수정을 클릭합니다.
연결에서 공개 IP 사용 설정을 선택합니다.
변경사항을 저장하려면 인스턴스 업데이트 를 클릭합니다.
gcloud
gcloud alloydb instances
update 명령어를 사용하여 인스턴스에서 공개 IP를 사용 설정합니다.
gcloud alloydb instances update INSTANCE_ID \
--cluster=