开源项目 `local-docker-db` 使用教程

1. 项目的目录结构及介绍

local-docker-db/
├── docker-compose.yml
├── README.md
├── .env
└── scripts/
    └── init.sql

• docker-compose.yml: 定义了Docker容器的配置，包括数据库服务和相关配置。
• README.md: 项目的说明文档，包含项目的简介、使用方法和注意事项。
• .env: 环境变量文件，用于存储数据库的配置信息，如用户名、密码等。
• scripts/: 包含数据库初始化脚本，init.sql 文件用于在数据库启动时执行初始化操作。

2. 项目的启动文件介绍

docker-compose.yml

version: '3.8'
services:
  db:
    image: mysql:latest
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ${MYSQL_DATABASE}
    ports:
      - "3306:3306"
    volumes:
      - db-data:/var/lib/mysql
      - ./scripts:/docker-entrypoint-initdb.d

volumes:
  db-data:

• version: 指定Docker Compose文件的版本。
• services: 定义了项目中使用的服务，这里只有一个服务 db，使用的是MySQL的最新镜像。
• environment: 定义了环境变量，包括数据库的根密码和数据库名称，这些变量从 .env 文件中读取。
• ports: 将主机的3306端口映射到容器的3306端口，以便外部访问数据库。
• volumes: 定义了数据卷，db-data 用于持久化数据库数据，./scripts 用于挂载初始化脚本。

3. 项目的配置文件介绍

.env

MYSQL_ROOT_PASSWORD=my-secret-pw
MYSQL_DATABASE=mydb

• MYSQL_ROOT_PASSWORD: 设置MySQL的根用户密码。
• MYSQL_DATABASE: 设置默认创建的数据库名称。

scripts/init.sql

CREATE DATABASE IF NOT EXISTS mydb;
USE mydb;

CREATE TABLE IF NOT EXISTS mytable (
  id INT AUTO_INCREMENT PRIMARY KEY,
  name VARCHAR(255) NOT NULL
);

INSERT INTO mytable (name) VALUES ('example');

• CREATE DATABASE: 如果数据库不存在，则创建数据库 mydb。
• USE mydb: 切换到 mydb 数据库。
• CREATE TABLE: 如果表 mytable 不存在，则创建该表。
• INSERT INTO: 向 mytable 表中插入一条示例数据。

通过以上配置和脚本，项目可以快速启动一个本地的MySQL数据库，并进行初始化操作。