diesel mysql example

diesel

1. dockerでrust環境を作成する

rustのimageを利用するrust.dockerfileとdocker-compose.yamlを作成する。

docker-compose.yaml

version: "3"

services:
  rust_container_image:
    container_name: rust_container_image
    build:
     context: .
     dockerfile: rust.dockerfile
    tty: true
    restart: always
    volumes:
      - ".:/usr/src/myapp"

rust.dockerfile

FROM rust:1.67

WORKDIR /usr/src/myapp
COPY . .

上記を作成したら、

% docker compose up --detach
% docker exec -it rust_container_image bash

2. dieselの環境を作成する

% cargo new myapp

(before)Cargo.toml

[package]
name = "myapp"
version = "0.1.0"
edition = "2021"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

[dependencies]

(after)Cargo.toml

[package]
name = "myapp"
version = "0.1.0"
edition = "2021"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

[dependencies]
chrono = { version = "0.4.24", features = ["serde"] }
diesel = { version = "2.0.0", features = ["mysql", "chrono"] }
dotenvy = "0.15"

% cargo update
% cargo install diesel_cli --no-default-features --features mysql

api directoryが作成されたので、rust.dockerfileをapi以下に移動、また、docker-compose.yamlのbuild.contextをmyappに変更します。

rust.dockerfileをimage作成時に依存関係を解決してほしいので、以下のコードを追記します。

RUN cargo install --path .

diesel cliをmigrationで利用したいため、rust.dockerfileを書き換えます。

rust.dockerfile

FROM rust:1.67

WORKDIR /usr/src/myapp
COPY . .

RUN cargo install --path .
RUN cargo install diesel_cli --no-default-features --features mysql

3. mysqlのdocker環境を作成する

docker/mysql.dockerfileを作成していきます。
また、docker-compose.yamlにmysqlの構造体とdockerfileを編集していきます。

docker/mysql.dockerfile

FROM mysql:8

docker-compose.yaml

version: "3"

services:
  rust_container_image:
    container_name: rust_container_image
    build:
     context: ./api
     dockerfile: rust.dockerfile
    tty: true
    restart: always
    volumes:
      - "./myapp:/usr/src/myapp"
    networks:
      - local
      
  mysql_container_image:
    container_name: mysql_container_image
    build:
      context: ./docker
      dockerfile: mysql.dockerfile
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: root_password
      MYSQL_DATABASE: diesel_example
    ports:
      - "3306:3306"
    volumes:
      - "my_db_volume:/var/lib/mysql"
    networks:
      - local

volumes:
  my_db_volume: {}

networks:
  local: {}

4. dieselの環境を整備する

.envを利用してmysqlのurlをやりとりして、migrationを実施する。

.env

DATABASE_URL=mysql://root:root_password@mysql_container_image:3306/diesel_example

次にdieselのsetupを実施します。

% diesel setup

5. migrationの実施

migrationのdirectoryが作成されるので、
up.sqlとdown.sqlを記載していく。

% diesel migration generate create_users

migrations/XXX_create_users/up.sql

CREATE TABLE IF NOT EXISTS users (
  id INTEGER PRIMARY KEY AUTO_INCREMENT,
  name TEXT NOT NULL,
  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
  updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

migrations/XXX_create_users/down.sql

DROP TABLE users;

最後にmigrationを実施してdatabaseを確認します。

% diesel migration run

show columns from users;
+------------+-----------+------+-----+-------------------+-----------------------------------------------+
| Field      | Type      | Null | Key | Default           | Extra                                         |
+------------+-----------+------+-----+-------------------+-----------------------------------------------+
| id         | int       | NO   | PRI | NULL              | auto_increment                                |
| name       | text      | NO   |     | NULL              |                                               |
| created_at | timestamp | NO   |     | CURRENT_TIMESTAMP | DEFAULT_GENERATED                             |
| updated_at | timestamp | NO   |     | CURRENT_TIMESTAMP | DEFAULT_GENERATED on update CURRENT_TIMESTAMP |
+------------+-----------+------+-----+-------------------+-----------------------------------------------+
4 rows in set (0.00 sec)

% tree -L 3
.
├── README.md
├── myapp
│   ├── Cargo.lock
│   ├── Cargo.toml
│   ├── diesel.toml
│   ├── migrations
│   │   └── 2023-06-05-151922_create_users
│   ├── rust.dockerfile
│   └── src
│       ├── main.rs
│       └── schema.rs
├── docker
│   └── mysql.dockerfile
└── docker-compose.yaml