기술블로그-Fastapi편

📌 WSL 기반 Gel(EdgeDB) 설치 및 실습 정리

Chansman 2025. 5. 28. 11:35

📌 WSL 기반 Gel(EdgeDB) 설치 및 실습 정리


✅ 1. 설치 환경 확인

uname -sm
  • 출력 예시: Linux x86_64 → WSL 64bit 환경임을 확인

✅ 2. Gel CLI 설치

curl --proto '=https' --tlsv1.2 -sSf https://www.geldata.com/sh | sh
  • 설치 위치: /home/사용자/.local/bin
  • 환경 변수 PATH 자동 포함 (추가 설정 불필요)

✅ 3. zsh 자동완성 설정 (선택)

nano ~/.zshrc

맨 위에 추가:

fpath+=~/.zfunc

※ 반드시 oh-my-zsh 설정 이전에 위치해야 자동완성 적용됨


✅ 4. 설치 확인

gel --version
  • 정상적으로 버전 출력되면 설치 완료

✅ 5. Gel 서버 설치

gel server install
  • 버전 선택 가능 (예: 6.7, 5.8, =5.7 등)
  • 내부적으로 EdgeDB 서버 환경을 자동 구성함

✅ 6. 프로젝트 초기화

gel project init
  • .gel/ 폴더 생성
  • 연결된 데이터베이스 정보 자동 구성됨

✅ 7. 명령어 변화 비교 (edgedb → gel)

목적 이전 명령어 현재 명령어

CLI 실행 edgedb gel
프로젝트 초기화 edgedb project init gel project init
쿼리 실행 edgedb query gel query
서버 설치 edgedb server install gel server install
서버 시작 edgedb server start gel server start

✅ 8. 자주 사용하는 명령어 정리

# 💻 쿼리 실행
gel query "select User {name};"

# 📁 마이그레이션 생성
gel migration create

# 🔄 마이그레이션 적용
gel migrate

# 📊 현재 DB 스키마 보기
gel show schema

# 🚦 서버 상태 확인
gel status

# ⚙️ 프로젝트 정보 보기
gel project info

# 📂 서버 설치 가능한 버전 목록
gel server list-versions

💡 팁과 주의사항

  • gel 명령어는 현재 프로젝트에 자동 연결됩니다. 별도 DB URL 지정 없이 사용 가능
  • repl 명령어는 사라졌고, 대신 gel query로 직접 실행
  • Python 연동은 edgedb-python 라이브러리를 통해 가능하며, 별도 설정 필요

Gel은 ORM 없이도 객체지향 쿼리 작성이 가능한 차세대 EdgeDB 인터페이스입니다.
EdgeQL 문법과 프로젝트 기반 워크플로우를 익히면 생산성이 크게 향상됩니다 🚀