martin/nci
1
0
Fork 0
mirror of https://gitlab.silvrtree.co.uk/martind2000/nci.git synced 2025-01-10 21:05:09 +00:00
Code Issues Projects Releases Wiki Activity
419 Commits 5 Branches 0 Tags 1.3 MiB
JavaScript 100%
340ee53b51
Go to file
oleg 340ee53b51 0.9.4
2016-03-08 22:43:48 +03:00
bin set production env at nci bin 2015-07-28 20:14:15 +03:00
data remove unavailable project and improve nodemon.json 2016-02-28 23:02:21 +03:00
docs add public readme + doc fixes 2016-02-01 03:16:35 +03:00
lib catch cmd errors at spawn + detail error message 2016-03-02 19:37:36 +03:00
test catch cmd errors at spawn + detail error message 2016-03-02 19:37:36 +03:00
.gitignore ui is plugin now 2016-01-10 02:46:13 +03:00
.npmignore ui is plugin now 2016-01-10 02:46:13 +03:00
.travis.yml disable testing against node 0.8 2016-01-10 14:19:32 +03:00
app.js add not found route to the very end at development 2016-02-25 23:00:14 +03:00
db.js fix id generation on builds update - new hope to fix builds loss 2015-12-15 23:26:59 +03:00
distributor.js new notifiers api - involve transports + distributor test helpers refactoring 2016-01-10 19:38:02 +03:00
LICENSE.txt add public readme + doc fixes 2016-02-01 03:16:35 +03:00
nodemon.json remove unavailable project and improve nodemon.json 2016-02-28 23:02:21 +03:00
package.json 0.9.4 2016-03-08 22:43:48 +03:00
README.md add quick setup section to readme 2016-02-07 10:09:34 +03:00
TODO.md README.md -> TODO.md 2016-02-01 00:30:08 +03:00

README.md

nci

Flexible, open source continuous integration server written in node.js

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.

Build Status

Features

  • modular approach, small core a lot of plugins (e.g. rest api, web interface - plugins, not core)
  • modest system requirements (only node and scm clients are required, no external db)
  • pluginnable db storage (any 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)
  • server and projects could be configured with yaml (yaml reader plugin) - 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)
  • could catch every or specific commits (see catchRev at sample project config)

Online demo is here.

System requirements

  • unix-like operating system, not tested on windows
  • node.js >= 0.10
  • git client >= 1.9 (only for building git projects)
  • mercurial client >= 2.8 (only for building mercurial projects)

Quick setup

Clone quick setup repo, go into it and install dependencies:


git clone https://github.com/node-ci/nci-quick-setup && cd nci-quick-setup && npm install

run nci:


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 for setup and usage details.

Resources

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
  • provide integration with external systems (e.g. gogs)

Plugins