diesel-cli setup

Diesel CLI 설치 및 사용 가이드

1. Diesel CLI 설치

아래 방법 중 선택

a) 미리 빌드된 바이너리 사용:

• Linux/macOS:

  curl --proto '=https' --tlsv1.2 -LsSf https://github.com/diesel-rs/diesel/releases/download/v2.2.1/diesel_cli-installer.sh | sh

• Windows:

  powershell -c "irm https://github.com/diesel-rs/diesel/releases/download/v2.2.1/diesel_cli-installer.ps1 | iex"

b) cargo-binstall 사용:

cargo binstall diesel_cli

c) cargo install 사용:

저희 프로젝트는 postgresql을 사용하므로 아래와 같이 flag값을 둡니다.

cargo install diesel_cli --no-default-features --features postgres

2. Diesel 프로젝트 설정

a) 데이터베이스 URL 설정:

프로젝트 루트에 .env 파일 생성

echo DATABASE_URL=postgres://username:password@localhost/diesel_demo > .env

b) Diesel 설정:

diesel setup

이 명령어는 데이터베이스를 생성(없는 경우)하고, 마이그레이션을 관리할 빈 migrations 디렉토리를 생성합니다.

3. 마이그레이션 생성 및 실행

a) 새 마이그레이션 생성:

diesel migration generate create_posts

이 명령어는 migrations 디렉토리 내에 up.sql과 down.sql 파일을 생성합니다.

b) 마이그레이션 SQL 작성:

• up.sql에는 테이블 생성 등의 스키마 변경 내용을 작성합니다.
• down.sql에는 up.sql의 변경을 되돌리는 내용을 작성합니다.

유용한 Diesel 명령어

• 마이그레이션 실행: diesel migration run
• 마이그레이션 되돌리기 및 재실행: diesel migration redo
• 마이그레이션 상태 확인: diesel migration list
• 마이그레이션 되돌리기: diesel migration revert
• 스키마 파일 재생성: diesel print-schema > src/schema.rs

자세한 내용은 Diesel 공식 문서를 참조하세요.