安装迅风云梯（QuickWind）步骤指南

安装开发环境

确保你的系统满足以下要求：

• 操作系统：Linux（推荐）或 Windows（可选）
• Java：版本为 JDK 11 或更高
• Python：版本为 3.6 或更高
• 网络：稳定的互联网连接

安装Java Development Kit (JDK)

如果你还没有安装Java,按照以下步骤进行：

• Linux用户：

  • 打开终端。
  • 更新包仓库：

    sudo apt update

  • 安装Java JDK：

    sudo apt install default-jdk-headless java-headless

  • 验证安装：

    java -version

    如果需要更高版本,可以使用：

    sudo apt install --reinstall default-jdk-headless java-headless

• Windows用户：

  从官方网站下载并安装最新的Java JDK。

安装Python

如果你还没有安装Python,按照以下步骤进行：

• Linux用户：

  • 使用包管理器安装Python：

    sudo apt install python3 python3-pip

  • 验证Python版本：

    python3 --version

  • 如果需要更高版本，可以使用：

    sudo apt install --reinstall python3 python3-pip

• Windows用户：

  从官方网站下载并安装Python。

克隆并下载迅风云梯

从GitHub获取最新版本：

• 打开终端，克隆仓库：

  git clone https://github.com/Tencent/quickwind.git

• 进入仓库目录：

  cd quickwind

• 下载二进制文件（选择适合你操作系统的版本）：

  ./download.sh

• 根据提示选择版本和平台,完成下载。

安装环境变量

配置Java和Python的环境变量：

• 打开~/.bashrc（Linux）或PATH（Windows）,添加以下内容：

  export QF_HOME=/path/to/quickwind
  export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-headless
  export PYTHONPATH=/path/to/quickwind/libs/python

  替换/path/to/quickwind为你下载的文件路径。

• Windows用户：

  • 右键点击“开始”按钮，选择“系统” > “高级系统设置” > “环境变量”。
  • 在“系统变量”中，添加：
    • QF_HOME：指向你下载的文件路径。
    • JAVA_HOME：指向你安装的Java JDK路径。
    • PYTHONPATH：指向你下载的文件路径下的libs/python目录。

启动迅风云梯服务

选择以下启动方式：

• 使用启动脚本：

  • 确保脚本可执行：

    chmod +x ./start.sh

  • 启动服务：

    ./start.sh

  • 访问服务：
    • Web界面：http://localhost:808
    • API：http://localhost:808/api

• 使用Docker：

  • 确保Docker已安装：

    docker --version

  • 拉取镜像：

    docker pull tencent/quickwind:latest

  • 启动容器：

    docker run -d --name quickwind tencent/quickwind:latest

  • 访问服务：
    • Web界面：http://localhost:808
    • API：http://localhost:808/api

验证安装

• 启动完成后，访问http://localhost:808,检查欢迎页面。
• 在浏览器中输入http://localhost:808/api,查看API文档。

管理服务

• 登录：
  • Web界面：http://localhost:808/login
  • API：POST http://localhost:808/api/auth/login
• 部署应用：
  • Web界面：上传或选择文件并部署。
  • API：POST http://localhost:808/api/app/deploy
• 查看日志：
  • Web界面：http://localhost:808/logs
  • API：GET http://localhost:808/api/app/log

故障排除

• 端口占用：

  • 检查是否有其他进程占用808或8443端口。
  • 使用netstat -tuln | grep 808查看占用情况。

• 权限问题：

  • 确保QuickWind服务运行在正确的用户下。
  • 使用sudo命令启动脚本或容器。

• 版本兼容性：

  确认Java和Python版本符合要求。

文档和支持

• 官方文档：QuickWind Documentation
• GitHub仓库：https://github.com/Tencent/quickwind
• 社区支持：在GitHub Issues或社区论坛寻求帮助。

注意事项

• 备份数据：安装前确保数据备份。
• 测试环境：建议在测试环境中先安装和测试。
• 权限管理：合理分配权限,确保安全。

通过以上步骤，你应该能够顺利安装并使用迅风云梯，如果遇到问题，请仔细检查每一步是否正确执行,并参考相关文档或社区获取帮助。