juici 0.0.0.alpha1

data/lib/juici/version.rb

@@ -0,0 +1,8 @@
+module Juici
+  VERSION_MAJOR=0
+  VERSION_MINOR=0
+  VERSION_PATCH=0
+  VERSION_EXTRA=".alpha1"
+
+  VERSION="#{VERSION_MAJOR}.#{VERSION_MINOR}.#{VERSION_PATCH}#{VERSION_EXTRA}"
+end

data/lib/juici/views/README.markdown

@@ -0,0 +1,138 @@
+## JuiCI
+
+JuiCI is a CI server that has a notion of queuing and priority.
+
+It's designed to work well with [agent99](https://github.com/99designs/agent99) but will play nicely with most frontends to CI.
+
+## Features
+
+* callbacks are created as builds are requested
+* Builds are executed sequentially in a series of parallel queues.
+* Queues can be dynamically created
+* Build status visualised
+
+## Important but Miscellaneous
+
+If you create child processes in modules/plugins then you need to register your
+disinterest or JuiCI will think they're builds and that would be bad.
+
+## Setup
+
+JuiCI is deliberately very light on the setup front.
+
+```bash
+bundle install
+bundle exec bin/juici
+```
+
+is all you need to have a working instance (provided that you have mongo installed)
+
+### Gotchas
+
+Make sure you don't do something innocuous like
+
+```bash
+bundle install --path .bundle
+```
+
+this might look sane (and it is, kinda) but owing to a quick in bundler, it
+will break any ruby code you try to build.
+
+I'm working on a workaround, but in the meantime the fix is to not do it!
+
+## Usage
+
+JuiCI is very focused on minimal configuration; meaning that beyond starting
+the server and pointing it at a mongoDB instance, you do not need to do
+anything special to build a new project. Just request a build; however this
+means that on your first build you will need to send the commands to create
+your test environment)
+
+Example:
+
+```bash
+curl --data-ascii @/dev/stdin <<EOF
+payload={"environment":{
+"SHA1":"e8b179f75bbc8717c948af052353424d458af981"},
+"command":"[ -d .git ] || (git init .; git remote add origin git://github.com/richo/twat.git); git fetch; git checkout $SHA1; bundle install; bundle exec rake spec"
+EOF
+```
+
+Using a convention like `script/cibuild` as in janky/hubot etc is advisable,
+although bear in mind that the logic to checkout the repo will need to be
+seperate.
+
+## Priority
+
+JuiCI supports the notion of priority. Builds given without a priority will be
+assigned priority 1 (to allow for marking a build as less important with
+priority 0).
+
+If juici recieves a new build with priority higher than any currently
+unfinished, it will pause whatever it's doing and build the new project. If
+there is a tie for priority, a FIFO queue is assumed.
+
+JuiCI uses `SIGSTOP` and `SIGCONT` internally for job control.
+
+## Hooks
+
+You may specify one or more callbacks when you request a build. They will be
+called with an (as yet unformalised) json body as the body if/when the build
+reaches that state. Alternately you may specify "any" as the callback state and
+it will be called on all state changes.
+
+## Integration
+
+Apps written in ruby wanting to interact with Juici can include the
+`juici-interface` gem, which presently exposes a few constants to line up with
+JuiCI's internal state.
+Over time this will be expanded, but for now they are:
+
+```ruby
+Juici::BuildStatus::PASS
+Juici::BuildStatus::FAIL
+Juici::BuildStatus::START
+Juici::BuildStatus::WAIT
+```
+
+## Security
+
+JuiCI poses some interesting security conecerns. First off, it will allow
+anyone with access to run arbitrary commands on your server. I have
+deliberately not implemented any kind of security inside JuiCI, it plays nicely
+as a Rack application, and middlewares are much better suited to this task.
+
+It should go without saying, but any builds started by JuiCI will inherit its
+environment. This means that if you run it in dev mode and forward your ssh
+agent, builds can ssh to other machines as you!
+
+When running in production you should take steps to ensure that the user JuiCI
+runs as is no more privileged than it needs to be, and sanitise its
+environment before execution.
+
+## A note on subprocesses
+
+JuiCI by default invokes everything in a subshell- indeed this is the only way
+to approach this if you want to execute more than one command.
+
+What this means to you as the user though is that unless you go to lengths to
+specifically implement it, your process won't see any of the signal handling
+madness. The shell(`/bin/sh`) will see everything, and if killed, your
+processes will become orphaned, but carry on.
+
+## Authors
+
+* [Richo Healey](https://github.com/rcho)
+* [Alec Sloman](https://github.com/alecsloman)
+
+## Contact
+
+JuiCI's code lives on [Github](https://github.com/richo/juici)
+and the [author](mailto:richo@psych0tik.net) can be contacted on
+ [Twitter](https://twitter.com/rich0H)
+
+## Legalese
+
+(c) Richo Healey 2012, richo@psych0tik.net
+
+Released under the terms of the MIT license.

data/lib/juici/views/about.erb

@@ -0,0 +1,16 @@
+<div class="row-fluid">
+  <div class="span9">
+    <div>
+      <%= content %>
+    </div>
+  </div>
+  <div class="span2 offset1">
+    <div>
+      <h3 class="block-header builds-header--failure">quick links</h3>
+      <ul>
+        <li>richo on <a href="https://twitter.com/rich0H">twitter</a></li>
+        <li>richo on <a href="https://github.com/richo">github</a></li>
+        <li>JuiCI on <a href="https://github.com/richo/juici">github</a></li>
+    </div>
+  </div>
+</div>

data/lib/juici/views/builds.erb

@@ -0,0 +1,7 @@
+Projects:
+
+<ul>
+<% ::Juici::Project.all.each do |p| %>
+  <li><a href="<%= build_url_for(p['name']) %>"><%= p['name'] %></a></li>
+<% end %>
+</ul>

data/lib/juici/views/builds/edit.erb

@@ -0,0 +1,23 @@
+<h4 class="accordion-toggle ">
+  <%= display_title rescue build.display_title %>&nbsp;<% build[:warnings].each do |warning| %><span class="label label-important"><%= warning %></span><% end %>
+</h4>
+<div class="row-fluid" style="padding-top:20px">
+  <div><p>Note that any changes made here will only take effect when this project starts building. Running builds will not inherit these changes, but you'll likey confuse the hell out of anyone trying to debug it.</p></div>
+  <form action="<%= edit_url_for(build) %>" method="post" class="submit-build">
+    <div class="span4">
+      <h3>Misc</h3>
+      <% ::Juici::Build::EDITABLE_ATTRIBUTES[:string].each do |attr| %>
+        <%# TODO css transform to make this pretty %>
+        <label><%= attr %></label>
+        <input type="text" name="<%= attr %>" value="<%= build[attr] %>">
+      <% end %>
+      <button type="submit" class="btn">Submit</button>
+    </div>
+    <div class="span4">
+      <h3>Environment</h3>
+    </div>
+    <div class="span4">
+      <h3>Callbacks</h3>
+    </div>
+  </form>
+</div>

data/lib/juici/views/builds/list.erb

@@ -0,0 +1,27 @@
+<script>
+  $(function() {
+    $('.accordion-set-url').on('click', '.set-url', function() {
+      history.pushState(null, null, $(this).data('url'));
+    })
+  });
+</script>
+
+<div class="row-fluid">
+  <!-- Pagination -->
+  <div class="span1">
+    <% pages.times.with_index do |page| %>
+      <a href="?page=<%= page %>" class="bloop<%= " active" if page == params[:page] %>"><%= page %></a>
+    <% end %>
+  </div>
+  <!-- Main contents -->
+  <div class="span11">
+    <!-- Create a new build -->
+    <h3 class="project-title"><a href="<%= build_url_for(project) %>"><%= project.name %></a><a class="btn pull-right" href="/builds/new?project=<%= project.name %>">New Build</a></h3>
+    <!-- Build history -->
+    <% builds.each_with_index do |build, idx| %>
+      <div class="accordion accordion-set-url" id="accordion<%= idx %>">
+        <%= erb(:"partials/builds/show", :locals => { :build => build, :idx => idx }) %>
+      </div>
+    <% end %>
+  </div>
+</div>

data/lib/juici/views/builds/new.erb

@@ -0,0 +1,43 @@
+<div class="row-fluid">
+
+  <div class="span4">
+    <%= erb(:"partials/index/recently_built") %>
+  </div>
+
+  <div class="span8">
+
+    <h1 class="block-header">new</h1>
+    <p>From here you can create a new build</p>
+    <p>Name is a unique identifier for the project. It doesn't need to already exist, but builds for a like project need to be named identically</p>
+    <p>Environment is a json hash of KEY - VALUE pairs, to be passed into the child environment</p>
+    <p>Command is where the magic happens. Often they'll be longwinded, but a reasonable boilerplate might look <a href="#">something like this.</a><p>
+    <hr>
+
+    <form action="/builds/new" method="post" class="submit-build">
+
+      <div class="row-fluid">
+
+        <!-- First Column -->
+        <div class="span3">
+          <label>Project Name</label>
+          <input type="text" name="project" value="<%= params[:project] %>" <%= "readonly" if params[:project] %>>
+          <label>Environment</label>
+          <input type="text" name="environment" placeholder="expects a valid json hash" value="">
+          <label>Priority</label>
+          <input type="text" name="priority" value="1">
+        </div><!-- End first column -->
+
+        <div class="span8 offset1">
+          <label>Command</label>
+          <textarea name="command" class="input-xxlarge" rows="4"></textarea>
+          <%# TODO -> When callbacks get implemented %>
+          <%# <label>Callback URL</label> %>
+          <%# <input type="text" name="callback" class="span3"> %>
+          <!-- <label><%# HACK %></label> -->
+          <button type="submit">START BUILD</button>
+        </div>
+
+      </div>
+    </form>
+  </div>
+</div>

data/lib/juici/views/builds/show.erb

@@ -0,0 +1,4 @@
+<h3 class="project-title"><a href="<%= build_url_for(project) %>"><%= project.name %></a><a class="btn pull-right" href="/builds/new?project=<%= project.name %>">New Build</a></h3>
+<div class="accordion" id="accordion0">
+  <%= erb(:"partials/builds/show", :locals => { :build => build, :idx => 0, :show => true }) %>
+</div>

data/lib/juici/views/index.erb

@@ -0,0 +1,30 @@
+<div class="row-fluid">
+  <div class="span8">
+    <h1 class="block-header">JuiCI</h1>
+    <p>
+      JuiCI is a CI server, written at RailsCamp after Jenkins left me feeling a little dead inside. JuiCI aims to solve some of the issues with existing (and outstanding) CI solutions like <a href="http://jenkins-ci.org/">Jenkins</a> and <a href="http://travis-ci.org">Travis</a>, by not trying to be all things to all people.
+    </p>
+    <p>
+      JuiCI has a very thin wrapper around build triggers, is almost entirely API driven, and has a queuing system with a notion of priority, globally shared across all projects.
+    </p>
+    <div>
+      In the past, this instance of Juici has built code for:
+      <ul>
+        <% ::Juici::Project.all.each do |p| %>
+          <li><a href="<%= build_url_for(p) %>"><%= p.name %></a></li>
+        <% end %>
+      </ul>
+    </div>
+  </div>
+  <div class="span4">
+    <h4 class="block-header builds-header">currently building</h4>
+      <ul class="builds">
+        <% $build_queue.currently_building.each do |build| %>
+          <li>
+            <a class="<%= build.heading_color %>" href="<%= build_url_for(build) %>"><%= build.link_title %></a>
+          </li>
+        <% end %>
+      </ul>
+    <%= erb(:"partials/index/recently_built") %>
+  </div>
+</div>

data/lib/juici/views/layout.erb

@@ -0,0 +1,44 @@
+<!doctype html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+  <% if ::Juici.env == "development" %>
+    <link href="/vendor/bootstrap.css" rel="stylesheet">
+    <script src="/vendor/jquery.js"></script>
+    <script src="/vendor/bootstrap.js"></script>
+  <% else %>
+    <link href="//netdna.bootstrapcdn.com/twitter-bootstrap/2.2.1/css/bootstrap.min.css" rel="stylesheet">
+    <script src="//cdnjs.cloudflare.com/ajax/libs/jquery/1.8.2/jquery.min.js"></script>
+    <script src="//netdna.bootstrapcdn.com/twitter-bootstrap/2.2.1/js/bootstrap.min.js"></script>
+  <% end %>
+    <link href="/styles/juici.css" rel="stylesheet">
+    <% styles.each do |style| %>
+      <link href="/styles/<%= style %>.css" rel="stylesheet">
+    <% end rescue nil%>
+    <title>JuiCI</title>
+    <% if @redirect_to %>
+      <meta http-equiv="Refresh" content="0; url=<%= @redirect_to %>" />
+    <% end %>
+  </head>
+  <body>
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container-fluid">
+          <div class="nav-collapse">
+            <ul class="nav">
+              <% active rescue active = nil %>
+              <li class="main <%= "active" if active == :index %>"><a href="/">JuiCI</a></li>
+              <li class="<%= "active" if active == :new_build %>"><a href="/builds/new">New Build</a></li>
+              <li class="<%= "active" if active == :about %>"><a href="/about">About</a></li>
+              <li class="<%= "active" if active == :support %>"><a href="/support">Support</a></li>
+              <li class="<%= "active" if active == :queue %>"><a href="/queue">Build Queue</a></li>
+            </ul>
+          </div><!--/.nav-collapse -->
+        </div>
+      </div>
+    </div>
+    <div class="container-fluid">
+      <%= yield %>
+    </div>
+  </body>
+</html>

data/lib/juici/views/not_found.erb

@@ -0,0 +1,3 @@
+<h3>Page not found!</h3>
+
+<pre>[Insert witty 404 joke]</pre>

data/lib/juici/views/partials/builds/debug.erb

@@ -0,0 +1,22 @@
+<div class="debug-output">
+<% if build[:priority] %>
+  <h3 class="block-header">priority:</h3>
+  <%= build[:priority] %>
+<% end %>
+<% if build[:command] %>
+  <h3 class="block-header">command:</h3>
+  <%= build[:command] %>
+<% end %>
+<% if build[:environment] %>
+  <h3 class="block-header">environment:</h3>
+  <% build[:environment].reject{|k, v| v.nil?}.each do |k, v| %>
+    <p><strong><%="#{k} = " %></strong><%="#{v}" %></p>
+  <% end %>
+<% end %>
+<% if build[:callbacks] %>
+  <h3 class="block-header">callbacks:</h3>
+  <% build[:callbacks].each do |callback| %>
+    <p><%= callback %><p>
+  <% end %>
+<% end %>
+</div>

data/lib/juici/views/partials/builds/output.erb

@@ -0,0 +1 @@
+<div class="build-output"><%= ansi_escaped(escaped(build.output)) if build.respond_to? :output %></div>

data/lib/juici/views/partials/builds/show.erb

@@ -0,0 +1,19 @@
+<div class="row-fluid">
+  <div class="accordion-heading span10">
+    <a class="set-url accordion-toggle <%= build.heading_color %>" data-toggle="collapse" data-parent="#accordion<%= idx+1 %>" href="#collapse_<%= idx %>" data-url="<%= build_url_for(build) %>">
+      <%= display_title rescue build.display_title %>&nbsp;<% build[:warnings].each do |warning| %><span class="label label-important"><%= warning %></span><% end %>
+      <% if build[:status] == :started %>
+        <div class="bowlG pull-right"><div class="bowl_ringG"><div class="ball_holderG"><div class="ballG"></div></div></div></div>
+      <% end %>
+    </a>
+  </div>
+  <a class="btn span2" href="<%= build_url_for(build) %>">Build Link</a>
+</div>
+<div id="collapse_<%= idx %>" class="accordion-body collapse <%= "in" if show rescue nil %>">
+  <div class="row-fluid" style="padding-top:20px">
+    <div class="span8">
+      <%= erb(:"partials/builds/output", :locals => { :build => build }) %>
+    </div>
+    <div class="span4"><%= erb(:"partials/builds/sidebar", :locals => { :build => build }) %><%= erb(:"partials/builds/debug", :locals => { :build => build }) %></div>
+  </div>
+</div>

data/lib/juici/views/partials/builds/sidebar.erb

@@ -0,0 +1,13 @@
+<div class="build-sidebar">
+<span><%= form_at(rebuild_url_for(build), {}, :submit => "Rebuild") %></span>
+<% if build.status == Juici::BuildStatus::START %>
+<span><%= form_at(kill_url_for(build),
+                  {:project => build[:parent], :id => build[:_id]},
+                  :submit => "Kill!") %></span>
+<% elsif build.status == Juici::BuildStatus::WAIT %>
+<span><%= form_at(cancel_url_for(build),
+                  {:project => build[:parent], :id => build[:_id]},
+                  :submit => "Cancel") %></span>
+<% end %>
+<span><a class="btn" href="<%= edit_url_for(build) %>">Edit</a></span>
+</div>

data/lib/juici/views/partials/index/recently_built.erb

@@ -0,0 +1,19 @@
+<h1 class="block-header builds-header builds-header--failure">fail!<span class="pull-right table-flipper">（╯°□°）╯︵ ┻━┻</span></h1>
+    <ul class="builds">
+      <% ::Juici::Build.get_recent(5, :status.in => [::Juici::BuildStatus::FAIL]).each do |build| %>
+      <li>
+        <a class="recently-built--fail" href="<%= build_url_for(build) %>"><%= build.link_title %></a>
+      </li>
+    <% end %>
+    </ul>
+
+  <hr>
+
+  <h1 class="block-header builds-header builds-header--success">pass!<span class="pull-right table-flipper">┬─┬ノ( º _ ºノ)</span></h1>
+  <ul class="builds">
+    <% ::Juici::Build.get_recent(5, :status.in => [::Juici::BuildStatus::PASS]).each do |build| %>
+      <li>
+        <a class="recently-built--pass" href="<%= build_url_for(build) %>"><%= build.link_title %></a>
+      </li>
+    <% end %>
+  </ul>

data/lib/juici/views/queue/list.erb

@@ -0,0 +1,6 @@
+<% builds.each_with_index do |build, idx| %>
+  <div class="accordion" id="accordion<%= idx %>">
+    <%= erb(:"partials/builds/show",
+            :locals => { :build => build, :idx => idx, :display_title => "#{build[:parent]} :: #{build.display_title}"}) %>
+  </div>
+<% end %>