기술블로그-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 문법과 프로젝트 기반 워크플로우를 익히면 생산성이 크게 향상됩니다 🚀