# flow.ci

**Repository Path**: sdsuper/flow.ci

## Basic Information

- **Project Name**: flow.ci
- **Description**: flow.ci 是国内首套开源持续集成(CI) 解决方案，帮助企业团队实现开发流程(build-test-deploy)自动化，快速持续交付高质量软件
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 7
- **Created**: 2017-12-07
- **Last Updated**: 2020-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

flow-platform
============

'flow-platform' is a backend project for flow.ci, it consist three main sub projects:  

- api: 
- control-center: to handle agent status and dispatch task to agent
- agent: running in the any where to receive task from control center


## Getting Start
 
### Build by maven

Using standard maven `mvn clean install -DskipTests=true` to generate packages

####Installation####

In build phase will generate three packages:

| project | package | container |
|---------|---------|-----------|
| api | flow-api.war | tomcat 8.5 |
| control-center | flow-control-center.war | tomcat 8.5 |
| agent | flow-agent-{version}.jar |  |

**flow api**

Dependencies: 

- Mysql 5.6

**flow control center**

Dependencies:

- Apache zookeeper 3.4.10
- Mysql 5.6
- RabbitMQ 3.6.10

**Configuration**

Configuration file can be loaded by sequence:
- System envrionment variable: `FLOW_CONFIG_PATH`
- System property: `-Dconfig.path`
- Default directory: `/etc/flow.ci/config/app.properties`

The sample properites file in : 

`platform-control-center/app-example.properties`

**Agent**

Start agent by following command:

`java -jar flow-platform-agent-{version}.jar {zookeeper address} {zone name} $HOSTNAME`


### Build by docker

Run `./build-docker.sh` will generate required docker images `flow.ci.backend` for back-end and `flow.ci.agent` for agent.

**To start flow.ci backend services**

`docker-compose up`

**To start flow.ci agent** 

`docker run --network=host -e FLOW_ZOOKEEPER_HOST=127.0.0.1:2181 -e FLOW_AGENT_ZONE=default -e FLOW_AGENT_NAME={agent name you want} flow.ci.agent`



## License
flow-platform is an open source project, sponsored by [fir.im](https://www.fir.im) 
under the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0).