2016-02-01 00:16:35 +00:00
|
|
|
|
|
|
|
|
# nci
|
|
|
|
|
|
2016-02-01 18:14:36 +00:00
|
|
|
Flexible, open source continuous integration server written in node.js
|
2016-02-01 00:16:35 +00:00
|
|
|
|
2016-02-04 19:19:00 +00:00
|
|
|
|
|
|
|
|
It's good for those who prefer modular things to build system for specific
|
|
|
|
|
requirements by blocks, starting from small core then extend functionality
|
|
|
|
|
by plugins.
|
|
|
|
|
|
|
|
|
|
|
2016-02-01 00:16:35 +00:00
|
|
|
[](https://travis-ci.org/node-ci/nci)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Features
|
|
|
|
|
|
|
|
|
|
* modular approach, small core a lot of plugins (e.g. rest api, web interface -
|
|
|
|
|
plugins, not core)
|
2016-02-04 19:19:00 +00:00
|
|
|
* modest system requirements (only node and scm clients are required, no
|
2016-02-01 00:16:35 +00:00
|
|
|
external db)
|
|
|
|
|
* pluginnable db storage (any [levelup](https://github.com/Level/levelup)
|
|
|
|
|
backend could be used)
|
|
|
|
|
* using on-the-fly snappy compression for all stored data (builds, build logs)
|
|
|
|
|
when leveldb (via leveldown backend) is used
|
|
|
|
|
* working with any mercurial, git repositories (no matter is it service like
|
|
|
|
|
github, bitbucket or private server, all you need is authenticate user from
|
|
|
|
|
which nci server is running without password e.g. by ssh key)
|
|
|
|
|
* damn fast single page web application interface
|
|
|
|
|
([classic ui plugin](https://github.com/node-ci/nci-classic-ui))
|
|
|
|
|
* server and projects could be configured with yaml
|
|
|
|
|
([yaml reader plugin](https://github.com/node-ci/nci-yaml-reader)) - provides
|
|
|
|
|
pretty shell scripting (strings without quotes, nice multiline strings, etc)
|
|
|
|
|
* provides agile project relations out of the box (see `blocks`, `blockedBy`,
|
|
|
|
|
`trigger` at [sample project config](./docs/sample-project-config.yaml))
|
|
|
|
|
* could catch every or specific commits (see `catchRev` at
|
|
|
|
|
[sample project config](./docs/sample-project-config.yaml))
|
|
|
|
|
|
|
|
|
|
|
2016-02-07 07:09:34 +00:00
|
|
|
Online demo is [here](http://classicui-ncidemo.rhcloud.com/).
|
2016-02-01 00:16:35 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
## System requirements
|
|
|
|
|
|
2016-02-02 19:41:37 +00:00
|
|
|
* unix-like operating system, not tested on windows
|
2016-02-01 00:16:35 +00:00
|
|
|
* node.js >= 0.10
|
2016-02-04 19:19:00 +00:00
|
|
|
* git client >= 1.9 (only for building git projects)
|
|
|
|
|
* mercurial client >= 2.8 (only for building mercurial projects)
|
2016-02-01 00:16:35 +00:00
|
|
|
|
|
|
|
|
|
2016-02-07 07:09:34 +00:00
|
|
|
## Quick setup
|
|
|
|
|
|
|
|
|
|
Clone quick setup repo, go into it and install dependencies:
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
|
|
|
|
|
git clone https://github.com/node-ci/nci-quick-setup && cd nci-quick-setup && npm install
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
run nci:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
```sh
|
|
|
|
|
|
|
|
|
|
node_modules/.bin/nci
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
that's all, now you can experiment with it by adding/changing projects,
|
|
|
|
|
use web interface (on http://127.0.0.1:3000 by default) for run project builds,
|
|
|
|
|
etc.
|
|
|
|
|
|
|
|
|
|
Currently web interface doesn't support adding new projects or editing of
|
|
|
|
|
existing projects. You have to do that by adding/editing project config
|
|
|
|
|
file.
|
|
|
|
|
|
|
|
|
|
See [basic tutorial](https://github.com/node-ci/nci/blob/master/docs/tutorials/standalone-web-ui.md)
|
|
|
|
|
for setup and usage details.
|
|
|
|
|
|
|
|
|
|
|
2016-02-01 00:16:35 +00:00
|
|
|
## Resources
|
|
|
|
|
|
|
|
|
|
* [basic tutorial](./docs/tutorials/standalone-web-ui.md)
|
|
|
|
|
* [online demo](http://classicui-ncidemo.rhcloud.com/)
|
|
|
|
|
* [sample project config](./docs/sample-project-config.yaml)
|
|
|
|
|
* [developing plugins doc](./docs/developing-plugins)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Roadmap
|
|
|
|
|
|
|
|
|
|
* preserve output colors when spawn commands
|
|
|
|
|
* expose node/executors api, implement plugin for remote and isolated build
|
|
|
|
|
running (docker or similar). Only local executor currently available.
|
|
|
|
|
* extend web interface functionality
|
|
|
|
|
* allow store project config inside repository of this project
|
2016-02-04 19:19:00 +00:00
|
|
|
* provide integration with external systems (e.g. gogs)
|
2016-02-01 00:16:35 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
## Plugins
|
|
|
|
|
|
|
|
|
|
* [yaml reader plugin](https://github.com/node-ci/nci-yaml-reader)
|
|
|
|
|
* [classic ui plugin](https://github.com/node-ci/nci-classic-ui)
|
|
|
|
|
* [static server plugin](https://github.com/node-ci/nci-static-server)
|
|
|
|
|
* [mail notification plugin](https://github.com/node-ci/nci-mail-notification)
|
|
|
|
|
* [jabber notification plugin](https://github.com/node-ci/nci-jabber-notification)
|
|
|
|
|
* [projects reloader plugin](https://github.com/node-ci/nci-projects-reloader)
|
|
|
|
|
* [rest api server plugin](https://github.com/node-ci/nci-rest-api-server)
|
|
|
|
|
* [scheduler plugin](https://github.com/node-ci/nci-scheduler)
|
