# gomake

**Repository Path**: lixiang8103/gomake

## Basic Information

- **Project Name**: gomake
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-08-07
- **Last Updated**: 2024-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# gomake使用指南

**gomake** 是基于 mage 构建的一个工具，它提供了跨平台和多架构的编译支持，同时也简化了服务的启动、停止、检测流程。

## 使用指南

### 准备工作

1. 请将以下文件从当前目录复制到项目的根目录，注意除了`README`文件外，共有5个文件需要复制：
    - `bootstrap.bat`
    - `bootstrap.sh`
    - `magefile.go`
    - `magefile_unix.go`
    - `magefile_windows.go`
2. 项目根目录下需要包含三个目录：`cmd`、`tools`和`config`。
    - `cmd` 目录专门用于存放那些作为后台服务运行的应用的启动代码。
    - `tools`目录用于存放那些作为工具应用（不以后台服务形式运行）的启动代码。
    - `config`目录用于存放配置文件。
3. `cmd`和`tools`目录可以包含多层多个子目录。对于包含`main`函数的`main package`文件，需以`main.go`命名。例如：
    - `cmd/microservice-test/main.go`
    -  `tools/helloworld/main.go`
    - 所有代码都应属于同一个项目，子目录不应使用独立的`go.mod`和`go.sum`文件。

### 初始化项目

- 对于Linux/Mac系统，先执行`bootstrap.sh`脚本。
- 对于Windows系统，先执行`bootstrap.bat`脚本。

### 编译项目

- 执行`mage`或`mage build`来编译项目。
- 编译完成后，二进制文件将生成在`_output/bin/platforms/<操作系统>/<架构>`目录下，其中二进制文件的命名规则为对应的`main.go`所在的目录名。例如：
    - `_output/bin/platforms/linux/amd64/microservice-test`
    - `_output/bin/tools/linux/amd64/helloworld`
    - **注意：** Windows平台的二进制文件会自动添加`.exe`扩展名。

### 启动工具和服务

1. 执行完 `mage` 编译后，系统会自动生成 `start-config.yml` 文件，指定服务和工具相关配置，您可以对该文件进行编辑。例如：

    ```yaml
    serviceBinaries:
      microservice-test: 1
    toolBinaries:
      - helloworld
    maxFileDescriptors: 10000
    ```
    
    **注意：**确保服务名和工具名与 `cmd` 和 `tools` 目录下的子目录名称相匹配。服务名后的数字代表该服务启动的实例数量。
    
3. 执行`mage start`来启动服务和工具。
   
    - 工具将以同步方式执行，如果工具执行失败（退出代码非零），则整个启动过程中断。
    - 服务将以异步方式启动。

对于所有工具，将采用以下命令格式启动：`[程序绝对路径] -i 0 -c [配置文件绝对目录]`。

若服务实例数设置为`n`，则服务将启动`n`个实例，每个实例使用的命令格式为：`[程序路径] -i [实例索引] -c [配置文件目录]`，其中实例索引从`0`到`n-1`。

**注意**：本项目仅指定了配置文件的路径，并不负责读取配置文件内容。这样做的目的是为了支持使用多个配置文件的情况。程序和配置文件的路径都自动使用绝对路径。

### 检查和停止服务

- 执行`mage check`来检查服务状态和监听的端口。
- 执行`mage stop`来停止服务，该命令会向服务发送停止信号。

---

### 使用截图

- **Linux** ![Compiling with mage on Linux](docs/images/linux-mages.jpg)

- **Windows**

  ![Compiling with mage on Windows](docs/images/windows-mages.jpg)