OCI MySQL 가이드-03.MySQL Workbench 구성

OCI MySQL 가이드-03.MySQL Workbench 구성

OCI MySQL Database(이하 OMD)는 Oracle Cloud Infrastructure(이하 OCI)가 제공하는 완전 관리형 MySQL 서비스입니다. OMD는 MySQL 배포, 백업, 패치 등 관리 작업 자동화 및 OCI 최적화 구성을 제공합니다. 또한, 이 서비스는 오라클 MySQL 팀의 엔터프라이즈 서포트를 포함합니다. 이번 문서에서는 MySQL의 대표적인 툴인 MySQL Workbench를 로컬 컴퓨터에 설치합니다. 그리고 MySQL Workbench에 Bastion VM을 통해서 OMD 인스턴스에 접속하는 설정을 진행합니다.

이 문서에서 다루는 내용은 OCI Free Trial에서 실습 가능합니다.

MySQL Workbench는 SQL 개발, 데이터베이스 설계, 생성 및 관리 통합 환경을 제공하는 대표적인 MySQL 도구입니다. 이번 문서에서는 OCI MySQL Database에 접근 가능한 Bastion 서버에 MySQL Workbench를 설치하고 구성하는 과정을 정리합니다.


MySQL Database Service 기본 가이드

이번 문서는 OMD 기본 가이드 3번째 문서입니다. OMD 기본 가이드는 다음과 같이 구성됩니다.

OMD 프로비저닝 사전 준비

이번 튜토리얼은 OCI Free Trial 계정에서 진행됩니다. 다음과 같은 계정 및 자원을 사용합니다.

환경 유형 자원 역할
OCI IAM 계정 developer01 MySQL 사용지&관리자
Compartment demo
VCN demovcn MySQL 인스턴스가 배포되는 VCN
MySQL mysql_demo_01 demovcn의 private subnet에 위치
Bastion VM bastion(IP:158.101.149.108) Public IP를 실습 과정에서 달라질 수 있음

위 OCI 기본 환경이 준비 안 된 상태라면 다음 문서를 참조하여 구성하시기 바랍니다.

OCI MySQL 인스턴스를 위한 Workbench 설치

OMD 인스턴스는 private subnet에 위치합니다. 로컬 컴퓨터에 설치되는 MySQL Workbench는 다음 이미지와 같이 Private Subnet에 배포되는 OMD 인스턴스에 접근하기 위해서 Bastion VM을 이용합니다.

이 문서의 모든 작업은 OCI Console에 OCI IAM 사용자 developer01로 로그인하여 진행합니다.

  1. Local PC에 SSH Key Pair 설치
  2. Bastion 서버에 공개키 등록
  3. 로컬 컴퓨터 Bastion 서버 접근 테스트
  4. MySQL Workbench 설치(@Local Computer)
  5. MySQL Workbench 설정

1. Local PC에 SSH Key Pair 설치

로컬 컴퓨터(Mac OS, Linux, Window)에 위치하는 MySQL Workbench는 Bastion 서버를 경유하여 OMD에 접근합니다. 따라서 로컬 컴퓨터에 SSH Key Pair를 만들어야 합니다.

SSH Key Pair를 만드는 방식은 Mac OS와 Linux는 같습니다. 그러나 Window10의 경우는 약간 다릅니다. 이 문서는 Mac OS와 Linux를 기준으로 작성했습니다. Window 10을 사용할 경우에 PEM 포맷으로 Key Pair를 만들어야 합니다. 이와 관련해서는 다음 문서를 참조하시기 바랍니다.

Linux와 Mac OS에서는 다음 명령으로 SSH Key Pair를 만듭니다.

ssh-keygen -t rsa -f ./bastion_id_rsa -P '' #명령 1
ls -al ~/.ssh                               #명령 2
cat ./bastion_id_rsa.pub | pbcopy           #명령 3 - public key 내용 복사                        

위 명령은 다음과 같은 의미가 있습니다.

#명령 설명
명령 1 ssh key pair인 public key(bastion_id_rsa.pub)와 private key(bastion_id_rsa) 파일 생성
명령 2 ssh key pair 생성 결과 확인
명령 3 public key(bastion_id_rsa.pub) 파일 내용을 클립보드에 복사, 메모장에 Ctrl+V하면 다음과 같은 결과를 확인할 수 있음

위 명령을 실행하여 ssh Key Pair를 만들고, 공개키 내용을 복사합니다. 데모에서 만들어진 공개키는 다음과 같습니다.

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQCtVyBwC2gYfQ8Wlz2kHt5Ntaf
ox0WUVBZYCInLBkltrTH25nTKc/uMb8/QGGks8WRboBl6ttahlx+F2fYdPXe1
THzpyOuvoVKCF7OoEEcTApuwh2XqgiftjU0VTjYw3HjRqVxVTXpJeIkh/
PYEMpZn2CXCDhmz+y1seFYIhsYKbjZ5KgElMGQg8wcXtzdBanC528KnTKX
02aSrEBxKStjq/A87O+RUEX0d5OUH5TNXIr7GXcSzIMJ6SrXti4xq11ma
YcxTmDZMblZ9pxN3/PezoGW2td50fN+wiQ81TWJAZtHacYCYWgQ/HxhMI1kx
fpmE1QzQ1ig//uCJqUfhsvQkT11hSRybiyA/rUEocqjtBI2ilDoLpFlIWo8H
gN1Ljq6Q4gVbm9fJpwc3D0clzK2CvI7XF3NH1uQfa+sPOXpxsHXFOpgPBjrWMlG
fMr0c8ygcjzChmp1emEIhBNaB0sF19z+M426HmAZZBY1kg1x/RlWPo52EIl
Yr/hLIZ5AtBk= taewan@taewanui-MacBook-Pro.local

위 공개키는 문서화를 위해서 일부 편집했습니다. 공개키는 한 줄로 생성됩니다.

2. Bastion 서버에 공개키 등록

Bastion 서버에 공개키를 등록하기 위해서, OCI Cloud Shell로 Bastion VM에 SSH 접근해야 합니다.

현재 데모에서 Bastion 서버에 접근 가능한 곳은 Cloud Shell 뿐입니다. 이전 가이드 문서에서 Bastion 서버를 생성할 때, 공개키를 Cloud Shell에서 생성해서 등록했습니다.

OCI Console에 developer01로 로그인하고 다음과 같이 Cloud Shell을 오픈합니다.

Cloud Shell에서 bastion VM의 공개 IP(158.101.149.108)로 ssh 접근합니다.

ssh opc@158.101.149.108

처음 로그인할 때 Are you sure you want to continue connecting (yes/no)? yes 메시지가 출력됩니다. 이때 yes를 입력합니다. bastion VM에 로그인하면 다음 이미지와 같은 상태가 됩니다.

Bastion VM에 ssh 접근한 다음에, 아래 명령을 실행하여 로컬 컴퓨터의 공개키를 Bastion VM의 ~/.ssh/authrized_key 파일에 추가합니다.

echo '[공캐키]' >> ~/.ssh/authrized_key

다음 이미지는 공개키를 ~/.ssh/authrized_key 파일에 추가하는 과정입니다. ~/.ssh/authrized_key 파일 마지막에 로컬 컴퓨터에서 생성한 공개키가 추가된 것을 확인할 수 있습니다.

3. 로컬 컴퓨터 Bastion 서버 접근 테스트

로컬 컴퓨터에서 Bastion 서버 접근을 테스트합니다. 앞에서 ssh key pair를 생성한 디렉터리에서 다음 명령을 실행합니다.

ssh -i [Private_Key_File_Name] opc@[Bastion_Public_IP]

현재 private key file의 위치와 Bastion VM의 Public IP는 다음과 같습니다.

  • Private_Key_File_Name: ./bastion_id_rsa
  • Bastion_Public_IP: 158.101.149.108

위 정보를 이용하여 로컬 컴퓨터에서 Bastion VM으로 다음과 같이 접근할 수 있습니다.

5. MySQL Workbench 설치(@Local Computer)

이제 로컬 컴퓨터에서 Bastion VM에 접근 가능한 상태가 되었습니다. 이제 MySQL Workbench를 설치합니다.

다음 URL에서 MySQL Workbench 설치 파일을 다운로드 받습니다.

다음 이미지와 같이 운영체제별 설치 파일을 제공합니다. 로컬 컴퓨터에 맞는 설치 파일을 선택하고 다운로드 버튼을 클릭합니다.

다음 로드 페이지에서 다음 링크를 클릭하면 설치 파일이 다운로드됩니다.


설치 파일을 더블 클릭하면 설치 과정이 진행합니다. Mac OS에서는 다음과 같은 설치 화면이 출력됩니다. MySQL Workbench 로고를 Applications로 이동 시키면 설치면 완료됩니다.


설치된 MySQL Workbench를 실행하면 다음과 같은 윈도우가 실행됩니다.

4. MySQL Workbench 설정

MySQL Workbench의 메인 화면에서 MySQL Connection을 클릭하고 데이터베이스 연결 설정을 합니다.


Bastion VM을 경유하여 ODM 인스턴스에 접근하는 설정을 할 때, 다음 정보를 이용합니다.

  • Bastion VM 공개 IP: 158.101.148.108
  • Bastion VM의 OS User: opc
  • ODM 인스턴스의 HostName: demomysql.sub11270510191.demovcn.oraclevcn.com
  • ODM 인스턴스의 Private IP: 10.0.1.5
  • ODM User: admin


설정을 완료하고 Test Connection을 클릭하면 설정 결과를 확인할 수 있습니다. 다음 이미지에서 설정이 정상적으로 이뤄진 것을 확인할 수 있습니다. 테스트 결과를 확인하고 설정 윈도우에 OK 버튼을 클릭하면 설정 정보가 저장됩니다.


메인 페이지에서 커넥션 정보를 클릭하면 ODM 인스턴스에 접속합니다.


정상적으로 연결되면 다음과 같은 쿼리를 수행할 수 있습니다.

요약 & Next..

MySQL Workbench를 로컬 컴퓨터에 설치하고 ODM 인스턴스에 접근 설정을 진행했습니다. ODM 인스턴스는 Private Network에 위치하기 때문에 Bastion 서버에 로컬 컴퓨터의 ssh key를 Bastion VM의 OPC 계정에 등록했습니다. 그리고 Bastion VM을 경유하여 ODM 인스턴스에 접근 설정을 MySQL Workbench에 등록하고 ODM 인스턴스 접근을 시도했습니다.

다음 문서에서는 OMD 인스터스에 데이터를 로딩하는 방법을 소개합니다.

참고 문서

김태완 avatar
작성자: 김태완
1999년 부터 Java, Framework, Middleware, SOA, DB Replication, Cache, CEP, NoSQL, Big Data, Cloud를 키워드로 살아왔습니다. 현재는 빅데이터와 Machine Learning을 중점에 두고 있습니다.
E-mail: taewanme@gmail.com

이 저작물은 Oracle과 관계없이 개인으로서 개인의 시간을 할애하여 작성된 글 입니다. 본 글의 내용, 입장, 예측은 Oracle을 공식적으로 절대 대변하지 않습니다.