# ShareBuild

**Repository Path**: cloudbuild888/sharebuild

## Basic Information

- **Project Name**: ShareBuild
- **Description**: CloudBuild mini版，基于共享算力的通用分布式编译技术解决方案
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-03-08
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Sharebuild(P2p分布式编译)

- [Sharebuild(P2p分布式编译)](#sharebuildp2p分布式编译)
  - [介绍](#介绍)
  - [特性](#特性)
  - [快速使用](#快速使用)
  - [基础架构](#基础架构)
    - [系统部署架构](#系统部署架构)
    - [业务流程](#业务流程)
    - [API模型](#api模型)
  - [AOSP 测评](#aosp-测评)

## 介绍

Sharebuild 是一个基于 P2P 技术的分布式编译系统，旨在提高大规模软件项目的编译效率。通过将编译任务分发到多个节点并行处理，Sharebuild 能够显著缩短编译时间。

## 特性

- **P2P 架构**：每个节点既是客户端也是服务器，能够动态发现和连接其他节点。
- **任务抢占调度策略**：网络中的工作节点抢占式执行编译任务，充分利用计算资源。
- **透明性**：结合 NFS 技术，所有工作节点共享客户端同一文件系统，底层分布式编译细节对用户透明。
- **零网络配置**：局域网环境内开箱即用，无需复杂的网络配置。

## 快速使用

1. 安装依赖:
   ```shell
   sudo apt update && sudo apt install redis-server nfs-kernel-server -y
   sudo sed -i 's/^bind 127.0.0.1/bind 0.0.0.0/' /etc/redis/redis.conf
   sudo systemctl restart redis
   echo '/home/ *(rw,root_squash,anonuid=1000,anongid=1000,insecure,async,no_subtree_check)' | sudo tee -a /etc/exports
   sudo exportfs -a && sudo systemctl restart nfs-kernel-server
   ```
2. 服务端：`sudo go run cmd/server/main.go`
3. 客户端：
   - 开启 sharebuild 模式：在项目根目录下创建或编辑 .ninja2.conf 文件，内容如下：
     ```yaml
     sharebuild: true
     ```
   - 编译项目：
     - 通用项目（如 LLVM、OpenCV）：使用通用客户端 [ninja2](https://github.com/ninja-cloudbuild/ninja2/)进行编译。
     - AOSP 项目：使用 [android_ninja](https://gitee.com/cloudbuild888/android_ninja/tree/sharebuild-android-12.0.0_r4/) 客户端进行编译。
      
     参考对应 ninja 项目地址的文档运行客户端即可。

## 基础架构
### 系统部署架构
![系统部署图](doc/系统部署图.svg)

### 业务流程
![业务时序图](doc/业务时序图.svg)

### API模型

![基本API模型](doc/基本API模型.png)

更多细节参考 [Sharebuild-架构-API时序图](doc/Sharebuild-架构-API时序图.svg)

## AOSP 测评

[Sharebuild-AOSP编译测评](doc/Sharebuild-AOSP编译测评.md)