Hera 项目教程

Hera 项目教程

hera High Efficiency Reliable Access to data stores 项目地址: https://gitcode.com/gh_mirrors/hera1/hera

1. 项目目录结构及介绍

Hera 项目的目录结构如下：

hera/
├── AUTHORS.txt
├── LICENSE.txt
├── README.md
├── go.mod
├── go.sum
├── github/
│   └── workflows/
├── client/
│   └── gosqldriver/
│       └── tls/
│           └── example/
│               └── sample_main.go
├── common/
├── config/
├── docker_build_and_run/
├── docs/
├── lib/
├── mock/
├── mux/
├── sample_hera_based_app/
├── tests/
│   └── devdocker/
├── utility/
├── watchdog/
├── watchdoglib/
└── worker/
    ├── cppworker/
    │   └── worker/
    └── mysqlworker/

目录结构介绍

• AUTHORS.txt: 项目贡献者列表。
• LICENSE.txt: 项目许可证文件，采用 Apache-2.0 许可证。
• README.md: 项目介绍和基本使用说明。
• go.mod: Go 模块文件，定义了项目的依赖关系。
• go.sum: Go 模块的校验和文件。
• github/workflows/: GitHub Actions 的工作流配置文件。
• client/: 客户端代码，包含 Go 语言的 SQL 驱动示例。
• common/: 通用代码库，包含项目共享的通用功能。
• config/: 配置文件相关代码。
• docker_build_and_run/: Docker 构建和运行脚本。
• docs/: 项目文档。
• lib/: 项目使用的库文件。
• mock/: 模拟数据和测试代码。
• mux/: 核心代码，负责数据库连接的多路复用。
• sample_hera_based_app/: 基于 Hera 的示例应用。
• tests/: 测试代码，包含 Docker 环境的测试脚本。
• utility/: 工具类代码。
• watchdog/: 监控和守护进程相关代码。
• watchdoglib/: 监控库代码。
• worker/: 工作线程代码，包含 MySQL、Oracle 和 PostgreSQL 的工作线程。

2. 项目启动文件介绍

Hera 项目的启动文件主要是 mux 和 worker 相关的可执行文件。以下是主要的启动文件：

• mux: 这是 Hera 的核心启动文件，负责数据库连接的多路复用和请求路由。
• mysqlworker: MySQL 工作线程，处理 MySQL 数据库的请求。
• oracleworker: Oracle 工作线程，处理 Oracle 数据库的请求。
• postgresworker: PostgreSQL 工作线程，处理 PostgreSQL 数据库的请求。

启动命令示例

# 启动 mux 和 MySQL 工作线程
./mux --name hera-test
./mysqlworker

3. 项目配置文件介绍

Hera 项目的主要配置文件是 hera.txt，该文件包含了 Hera 服务的基本配置。以下是配置文件的示例内容：

bind_ip=127.0.0.1
bind_port=11111
opscfg.hera.server.max_connections=2
database_type=mysql

配置项说明

• bind_ip: 绑定 IP 地址，通常设置为 127.0.0.1 或服务器的实际 IP 地址。
• bind_port: 绑定端口，Hera 服务监听的端口。
• opscfg.hera.server.max_connections: 最大连接数，设置 Hera 服务允许的最大数据库连接数。
• database_type: 数据库类型，支持 mysql、oracle 和 postgres。

其他配置文件

• cal_client.txt: 用于配置 CAL（Centralized Activity Logging）的客户端配置。
• start.sh: 启动脚本，用于在 Docker 环境中启动 Hera 服务。

通过以上配置文件和启动文件，可以轻松地配置和启动 Hera 服务，实现高效可靠的数据库访问。

hera High Efficiency Reliable Access to data stores 项目地址: https://gitcode.com/gh_mirrors/hera1/hera