Skip to content

Latest commit

 

History

History
153 lines (96 loc) · 5.12 KB

cf_linux.md

File metadata and controls

153 lines (96 loc) · 5.12 KB

基于 Linux 的安装

最小运行环境:

  • Java 8 (JRE or JDK)
  • 至少 1 G 的内存
  • 1 G 以上的空间

推荐运行环境:

  • Java 8 (JRE or JDK)
  • 4 G 以上的内存
  • 50 G 以上的空间

在 Debian 或者 Ubuntu 上安装

通过源码安装 flow.ci 后端程序

安装前的准备

Java

flowci 是基于 Java 1.8 版本的应用程序，所以需要在机器上安装 Java 1.8 或以上的版本。如果不确定现有的 Java 版本，可以通过 java -version 命令检查当前的 Java 环境。

Git

flowci 目前只支持基于 Git 的版本控制系统，所以需要在机器上安装 Git，可以通过 git --version 命令检查 Git 是否安装。

Tomcat

Tomcat 8.5 以上

MySQL

MySQL 5.6 以上

提示：确保 MySQL 的时区与服务器保持一致

获取源码并编译

提示: flowci 使用 maven 编译，3.0 以上版本， 可以在命令行中输入 mvn -v 检查 maven 是否正确安装。

通过以下命令，编译所需要的 war / jar 包，结果输出在 ./dist 文件夹下

git clone -b master https://github.com/FlowCI/flow-platform.git
cd flow-platform
mvn clean package -DskipTests=true
ls ./dist
配置 flowci
  1. 创建数据库

flow.ci 后端需要两个数据库对应不同的服务，可以执行以下语句在 MySQL 中创建所需要的数据库。

mysql -u user_name -p -e "CREATE DATABASE flow_api_db CHARACTER SET utf8 COLLATE utf8_bin;"

mysql -u user_name -p -e "CREATE DATABASE flow_cc_db CHARACTER SET utf8 COLLATE utf8_bin;"
  1. 导入数据库
mysql -u user_name -p --database=flow_api_db < flow-platform/schema/flow_api_db.sql

mysql -u user_name -p --database=flow_cc_db < flow-platform/schema/flow_cc_db.sql
  1. 更改及设置配置文件

app-api.properties

  • jdbc.url: 配置 MySQL 数据库地址
  • jdbc.username: 配置 MySQL 的用户名
  • jdbc.password: 配置 MySQL 的密码
  • jdbc.pool.size: 配置连接池数量，推荐 50 以上
  • api.workspace: 配置数据存储目录
  • domain.api: 配置 API 的地址
  • domain.web 配置 Web 端的地址
  • domain.cc: 配置 CC 的地址
  • task.job.toggle.execution_timeout: 是否开启 Job 过期检查
  • task.job.toggle.execution_create_session_duration: 设置创建 Job 时的过期时间(秒)
  • task.job.toggle.execution_running_duration: 设置 Job 运行时的过期时间(秒)

app-cc.properties

  • jdbc.url: 配置 MySQL 数据库地址
  • jdbc.username: 配置 MySQL 的用户名
  • jdbc.password: 配置 MySQL 的密码
  • jdbc.pool.size: 配置连接池数量，推荐 50 以上
  • zk.server.embedded: 是否使用 flow.ci 内嵌的 Zookeeper 服务，true or false
  • zk.host: Zookeeper 的地址，需要外网访问权限
  • agent.config.ws: 配置 Websocket 的地址，必须以 ws 开头，和 API 中 domain.api 的域名一致
  • agent.config.cc: 配置 CC 的 地址，需要和 API 中 domain.cc 地址一致

根据用户所设置信息，需要修改 API 配置文件中的 MySQL 设置， 以及对应的 domain 地址的设置。更详细的配置文件说明，请参见 配置文件说明

导入配置文件并启动

安装 dist 目录下的 flow-api-.war 以及 flow-control-center-.war 到 Apache Tomcat 服务器中，并设置上一步配置的 app-api.properties 到 FLOW_API_CONFIG_PATH 环境变量，app-cc.properties 到 FLOW_CC_CONFIG_PATH 环境变量。

启动 Apache Tomcat 后，可通过在浏览器中键入 所配置的路径/index 地址，验证服务是否启动成功。

例如: 所配置的网址为: http://yourhost.com 两个服务在 Tomcat 中配置的路径分别为 flow-api， flow-control-center，则在浏览器中输入 http://yourhost.com/flow-api/index 验证主 API 服务是否启动成功，输入 http://yourhost.com/flow-control-center/index 验证控制中心的服务是否启动成功。

通过源码安装 flowci web 页面

flowci 采用的为前后端分离的结构，所以需要用户在安装后台服务后，安装 web 界面。

安装前的准备

node.js

Node.js v6.6.0 以上版本

npm

npm v3 以上版本

获取源码并编译

通过以下脚本编译 web 项目，编译成功后，请在 dist 文件夹下查看编译好的项目文件。

请根据配置的 API URL 替换 FLOW_WEB_API 环境变量。

git clone -b master https://github.com/FlowCI/flow-web.git
cd flow-web
export NODE_ENV=production
export FLOW_WEB_API="http://your_flow_api_url"
npm run compile
部署

web 可以部署在任意 http 应用服务器上，如 Nginx, Apache Http Server 等。

提示: web 项目使用 react 构建，需要在部署到 http 应用服务器后，配置服务器的路由，否则会无法刷新页面。如在 Nginx 上，需添加配置 try_files $uri /index.html;




下一节：flowci 整体架构 | 下一节：基于 Mac OS 的安装