HMS-Docker 项目启动与配置教程

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

HMS-Docker 项目是一个基于 Docker 的项目，它的目录结构如下：

hms-docker/
├── bin/               # 存放可执行脚本和工具
├── config/            # 配置文件存放目录
│   └── hms.conf       # HMS 配置文件
├── docker-compose.yml # Docker Compose 文件，用于定义和运行多容器 Docker 应用
├── Dockerfile         # Dockerfile 文件，用于构建 Docker 镜像
├── hms/               # HMS 项目源代码目录
│   ├── ...
│   └── ...
├── logs/              # 日志文件存放目录
├── scripts/           # 运行脚本和其他辅助工具
└── README.md         # 项目说明文件

目录说明：

• bin/：存放项目的可执行脚本和工具。
• config/：存放项目的配置文件，如 hms.conf。
• docker-compose.yml：用于定义和运行多容器 Docker 应用，包括服务的配置、网络和卷。
• Dockerfile：用于构建项目的 Docker 镜像。
• hms/：存放 HMS 项目的源代码。
• logs/：用于存放项目的日志文件。
• scripts/：包含运行项目所需的脚本和其他辅助工具。
• README.md：项目的说明文件，通常包含项目信息、安装步骤和使用说明。

2. 项目的启动文件介绍

项目的启动主要通过 docker-compose.yml 文件来管理。以下是启动文件的基本结构和说明：

version: '3'

services:
  hms:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data
    environment:
      - HMS_CONFIG=/config/hms.conf
    depends_on:
      - db
  db:
    image: postgres:latest
    environment:
      - POSTGRES_USER=youruser
      - POSTGRES_PASSWORD=yourpassword
      - POSTGRES_DB=yourdb
    volumes:
      - db_data:/var/lib/postgresql/data

volumes:
  db_data:

启动文件说明：

• version: '3'：指定 Docker Compose 文件的版本。
• services：定义项目中包含的服务，这里是 hms 服务和 db 服务。
• hms：定义 HMS 服务的配置，包括构建镜像、端口映射、卷映射、环境变量和依赖。
• db：定义数据库服务，这里使用的是 postgres 镜像。
• volumes：定义数据卷，用于持久化数据。

3. 项目的配置文件介绍

项目的配置文件为 config/hms.conf。以下是配置文件的基本结构和说明：

[server]
port = 8080
host = 0.0.0.0

[database]
driver = postgres
user = youruser
password = yourpassword
host = db
port = 5432
database = yourdb
sslmode = disable

配置文件说明：

• [server]：服务器配置，包括端口和监听地址。
• [database]：数据库配置，包括数据库驱动、用户名、密码、主机、端口和数据库名称。

启动项目前，请确保修改 config/hms.conf 中的数据库配置，以匹配您的数据库设置。