Clojure Shell CSS Other
Clone or download
Permalink
Failed to load latest commit information.
doc Remove calls to deprecated functions Mar 26, 2017
env Add API doc for event-bus Feb 2, 2017
example/clj/todopipeline Use httpkit in development since this is the server that's used in th… Jun 10, 2018
resources A new favicon (in black and white) with "the new logo" Sep 17, 2015
scripts Fix cljs tests and test runner May 31, 2018
src Fix typos Jun 7, 2018
test Use httpkit in development since this is the server that's used in th… Jun 10, 2018
visual-styleguide/src/cljs/lambdacd move visual styleguide to own directory for better clarity and fix au… Dec 6, 2015
.gitignore Fix cljs tests and test runner May 31, 2018
.travis.yml Add dependency checker to travis build Jun 10, 2018
CHANGELOG.md Give credit for improvements in this release Jun 9, 2018
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md Jul 9, 2017
CONTRIBUTING.md Improve wording in contribution guide Jul 3, 2016
LICENSE changed license from default generated EPL to Apache 2.0 Sep 6, 2014
README.md Update readme: warning about state of development is no longer necess… May 21, 2017
Vagrantfile adding vagrantfile and script to automatically set up the deployment … Sep 8, 2014
ansiparse-externs.js add basic support for ansi escape sequences in UI (#91) Mar 26, 2016
ansiparse.js add basic support for ansi escape sequences in UI (#91) Mar 26, 2016
go Add check-dependencies goal to go-script help message Jun 10, 2018
package-lock.json Force more recent hoek version in npm tools dependencies since the cu… Jun 9, 2018
package.json Force more recent hoek version in npm tools dependencies since the cu… Jun 9, 2018
project.clj Exclude dependency of fs as it contains a vulnerability and isn't used Jun 10, 2018
suppression.xml Suppress another wrong cpe mapping in vulnerability checker Jun 10, 2018

README.md

LambdaCD

  • it's a continuous delivery pipeline, in code
  • it's your own custom built Jenkins/Go/TeamCity/..., in clojure

Status

Clojars Project

Build Status

Getting started

  • Make sure you have Leiningen and a recent version of JDK installed
  • lein new lambdacd <NAME> will create a new pipeline-project
  • cd <NAME>
  • lein run downloads all dependencies and starts the server; the UI is then served on on http://localhost:8080
  • your pipeline is defined in src/<NAME>/. Have a look around, change some steps or add some steps on your own
  • For more details, check out the resources and related projects below

Example

;; buildsteps
(def some-repo "git@github.com:flosell/somerepo")

(defn wait-for-repo [_ ctx]
  (git/wait-for-git ctx some-repo "master"))

(defn ^{:display-type :container} with-repo [& steps]
  (git/with-git some-repo steps))

(defn run-tests [{cwd :cwd} ctx]
  (shell/bash ctx cwd
    "lein test"))

(defn compile-and-deploy [{cwd :cwd} ctx]
  (shell/bash ctx cwd
    "./buildscripts/compile-and-deploy.sh"))

;; the pipeline
(def pipeline
  `(
     (either
       wait-for-manual-trigger
       wait-for-repo)
     (with-repo
       run-tests
       compile-and-deploy)))

Screenshot

Screenshot

Chat

Resources

Related projects

  • lambda-ui: Opinionated alternative user-interface with improved usability
  • lambdacd-git: Next generation of Git support for LambdaCD. Will replace the functionality in the core lambdacd.steps.git namespace in the future
  • lambdacd-cctray: Support for cctray.xml to integrate LambdaCD with build monitoring tools such as nevergreen or CCMenu
  • lambdacd-artifacts: Makes arbitrary build-artifacts (test-results, binaries, ...) available on LambdaCD
  • lambdacd-junit: Makes JUnit test reports available in LambdaCD
  • lambdacd-cron: A cron trigger for your LambdaCD
  • lambdacd-mongodb: Alternative persistence backend for LambdaCD, saving the pipeline state into MongoDB instead of the filesystem
  • machroput: LambdaCD-aware library simplifying deployments into a Mesos Cluster running Marathon or Chronos

Contribute

I'd love to hear from you! If you have a question, a bug report or feature request please reach out.

For details, refer to the contribution guide

Development

LambdaCD is built in Clojure and ClojureScript with Leiningen as a build-tool. The ./go script is your main entry-point that wraps all important development tasks. Call it without arguments to see all the options.

General Setup

  • Call ./go setup to install necessary dependencies and build everything once.

Core Development

  • Sources for the core of LambdaCD can be found in src/clj, tests in test/clj.
  • Run tests with ./go test-clj
  • To run a sample-pipeline (see example/clj), run ./go serve. You may have to run ./go serve-cljs occasionally to generate the frontend JS code from ClojureScript.
  • If you want the example pipeline to be green (which is not necessary for all development), you first need to setup a mock-deployment environment on your machine (two VMs where we deploy a TodoMVC client and server):
    • install Vagrant
    • have github-access set up (you need to be able to clone with ssh)
    • ./go setupTodopipelineEnv starts up two VMs in vagrant where we deploy to and exports the ssh-config for them so that it can be used by the deployment scripts

Frontend Development

  • The frontend is written in ClojureScript using Reagent and re-frame
  • Frontend resources can be found in resources/public, ClojureScript code in src/cljs, tests in test/cljs
  • Stylesheets are written in are in Less and can be found in src/less
  • ClojureScript code needs to be compiled into JS before being useful
  • In three terminals, run ./go serve to start an example pipeline (if you want it to be green, follow the environment setup above), ./go serve-cljs to start a ClojureScript REPL and automatic code-reloading using Figwheel and ./go serve-css to run the css autoprefixer watch
  • Run ./go test-cljs to run frontend-tests or ./go test-cljs-auto to start autotest

License

Copyright © 2014 Florian Sellmayr

Distributed under the Apache License 2.0