Mac에서 Docker와 Colima를 이용한 Oracle Database 설치 및 SQL Developer 연결 실습 가이드

Mac(M1/M2/Intel) 환경에서 Docker와 Colima를 활용해 Oracle Database를 설치하고, SQL Developer로 접속하는 단계별 실습 가이드입니다. Colima VM 시작 시 발생할 수 있는 에러와 해결법도 포함해 누구나 따라 할 수 있도록 구성했습니다.

1. Homebrew 설치 (이미 설치된 경우 생략)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Colima 및 Docker CLI 설치

brew install colima docker

3. Colima x86_64 VM 시작 및 lima-additional-guestagents 설치 (중요)

Colima VM 시작 중 에러가 발생할 수 있습니다. 이를 해결하려면 다음 절차를 따르세요:

colima stop
colima delete

brew install lima-additional-guestagents

colima start --arch x86_64 --memory 4

colima status 명령어로 VM이 정상적으로 실행되는지 확인하세요.

4. Docker 컨텍스트를 Colima로 전환

docker context use colima

5. Oracle XE Docker 이미지 다운로드

docker pull gvenzl/oracle-xe:21.3.0-slim

6. Oracle 컨테이너 실행

docker run -d \
  --name oracle-xe \
  -p 1521:1521 -p 5500:5500 \
  -e ORACLE_PASSWORD=oraclepw \
  gvenzl/oracle-xe:21.3.0-slim

oraclepw는 원하는 비밀번호로 변경 가능합니다.

7. SQL Developer 설치 및 접속

• Oracle 공식 사이트에서 SQL Developer 최신 버전을 다운로드하여 설치합니다.
• SQL Developer 실행 후 새 접속을 생성합니다.
• 접속 정보는 다음과 같습니다:
  • 호스트: localhost
  • 포트: 1521
  • 사용자명: SYSTEM
  • 비밀번호: oraclepw (컨테이너 실행 시 설정한 값)
  • 서비스명: XEPDB1 (기본값)

8. 실습용 사용자 생성 (선택사항)

SQL Developer 또는 sqlplus에서 SYSTEM 계정으로 접속 후 다음 SQL 명령어를 실행합니다:

CREATE USER appuser IDENTIFIED BY apppassword;
GRANT CONNECT, RESOURCE TO appuser;
ALTER USER appuser QUOTA UNLIMITED ON USERS;

9. 컨테이너 관리

• 컨테이너 정지:

  docker stop oracle-xe

• 컨테이너 시작:

  docker start oracle-xe

• 컨테이너 삭제:

  docker rm -f oracle-xe

10. 문제 해결 팁

• Colima VM 관련 에러 발생 시, 다음 명령으로 환경을 초기화하고 guestagents를 설치 후 다시 시작하세요:

  colima stop
  colima delete
  brew install lima-additional-guestagents
  colima start --arch x86_64 --memory 4
  

• Docker, Colima, Lima, QEMU 등 관련 도구를 항상 최신 버전으로 유지하는 것이 안정성에 도움이 됩니다.

위 가이드를 따라하면 Mac 환경에서 Docker를 기반으로 Oracle Database 설치부터 SQL Developer를 통한 접속 및 실습 환경 구축이 가능합니다. 진행 중 문제가 발생하면 에러 로그와 함께 문의해 주세요.