安装

安装#

从源码构建 Docker#

如需从源码自行构建镜像：

构建流程#

# 构建 Docker 镜像
docker build -t orchestrator:local .

环境设置#

以下为本地开发环境的设置方法。

Linux 环境设置#

前置要求#

开始之前，请确保：

  • Ubuntu 20.04 或兼容发行版

  • 可访问互联网以下载依赖

步骤 1：安装 Protocol Buffers 编译器#

下载并安装 protoc：

# 创建 protoc 目录
mkdir -p protoc
cd protoc

# 下载 protoc
curl -LjO https://github.com/protocolbuffers/protobuf/releases/download/v31.1/protoc-31.1-linux-x86_64.zip

# 解压并设置权限
unzip protoc-31.1-linux-x86_64.zip
rm -f protoc-31.1-linux-x86_64.zip
chmod +x bin/protoc

# 验证安装
bin/protoc --version

# 返回项目根目录
cd ..

步骤 2：安装 Python#

需要 Python 3.10 及以上。本节以 conda 为例：

使用 Miniconda 安装 Python：

# 下载 Miniconda 安装器
wget -q https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

# 安装 Miniconda
bash Miniconda3-latest-Linux-x86_64.sh

# 清理安装包
rm -f Miniconda3-latest-Linux-x86_64.sh

# 配置 conda 源
conda config --add channels conda-forge
conda tos accept

# 创建 Python 3.10 的环境
conda create -n orchestrator python=3.10 -y

# 激活环境
conda activate orchestrator

步骤 3：安装项目#

安装 orchestrator 包：

# 确认当前在项目根目录
cd /path/to/orchestrator

# 激活 conda 环境
conda activate orchestrator

# 安装包
pip install .

步骤 4：验证安装#

验证一切正常：

# 激活环境
conda activate orchestrator

# 检查 orchestrator.service 可导入
python -c "import orchestrator.service; print('orchestrator.service imported successfully')"

# 检查主程序可运行
python main.py --help

环境激活#

开发 Orchestrator 后端前，请先激活 conda 环境：

# 激活环境
conda activate orchestrator

# 终端提示应出现 (orchestrator)
# 之后可运行 Python 脚本并使用 orchestrator 包

Windows 环境设置#

前置要求#

开始之前，请确保：

  • Windows 10/11 或兼容版本

  • 可访问互联网以下载依赖

步骤 1：安装 Protocol Buffers 编译器#

下载并安装 protoc：

  1. 下载 protoc：

  2. 解压文件：

    • 在项目根目录创建 protoc 文件夹

    • 将 protoc-31.1-win64.zip 解压至 protoc 文件夹

    • 确认可执行文件路径：protoc\bin\protoc.exe

  3. 验证安装：

    # 在项目目录打开命令行
protoc\bin\protoc.exe --version

步骤 2：安装 Python#

需要 Python 3.10 及以上。本节以 conda 为例：

使用 Miniconda 安装 Python：

  1. 下载并安装 Miniconda：

    • 访问 Miniconda 安装指南

    • 从官网下载安装包

    • 按官方说明安装

    • 重要：安装时勾选“Add Miniconda3 to my PATH environment variable”，或手动将 Miniconda3/Scripts 加入 PATH 以便任意终端可用 conda

  2. 创建并激活环境：

    # 创建 Python 3.10 的环境
conda create -n orchestrator python=3.10 -y

# 激活环境
conda activate orchestrator

步骤 3：安装项目#

安装 orchestrator 后端包：

# 确认当前在项目根目录
cd /path/to/orchestrator

# 激活 conda 环境
conda activate orchestrator

# 临时将 protoc 加入 PATH（当前会话）
set PATH=%PATH%;%CD%\protoc\bin

# 安装包
pip install .

步骤 4：验证安装#

验证一切正常：

# 激活环境
conda activate orchestrator

# 检查 orchestrator.service 可导入
python -c "import orchestrator.service; print('orchestrator.service imported successfully')"

# 检查主程序可运行
python main.py --help

环境激活#

进行 Orchestrator 项目开发前，请先激活 conda 环境：

# 激活环境
conda activate orchestrator

# 终端提示应出现 (orchestrator)
# 之后可运行 Python 脚本并使用 orchestrator 包

本地开发#

完成环境设置后，可以在本地启动服务：

# 激活 conda 环境
conda activate orchestrator

# 启动服务
python main.py --config_path configs/local.py
Contents