Jepsen is a great library that lets you test distributed systems. I’m building a distributed database at the Recurse Center, and eventually want to run Jepsen on it. Here’s how you write a simple Jepsen test that does nothing!
Sign up for AWS
In Services -> EC2, click “Launch Instance”
Choose the 64 bit Debian Jessie image
Hit review and launch
Save your SSH key pair!
SSH into your instance and open /etc/apt/sources.list in your favorite editor. Add jessie-backports to the file:
deb http://ftp.debian.org/debian jessie-backports main
Now run sudo apt-get update, and install the following!
$ sudo apt-get install openjdk-8-jre openjdk-8-jre-headless libjna-java
You need to install docker and docker compose. Then spin up the containers:
$ git clone [https://github.com/aphyr/jepsen](https://github.com/aphyr/jepsen) && cd jepsen/docker $ ./up.sh $ docker exec -it jepsen-control bash
Create a new Leiningen project:
$ lein new foo && cd foo
And edit src/jepsen/foo.clj — your first test! This does nothing!
(ns jepsen.zookeeper (:require [jepsen.tests :as tests])) (defn zk-test [version] tests/noop-test)
Edit test/jepsen/foo_test.clj to look like this:
(ns jepsen.foo-test (:require [clojure.test :refer :all] [jepsen.core :as jepsen] [jepsen.foo :as foo])) (deftest a-test (is (:valid? (:results (jepsen/run! (foo/foo "3.4.5+dfsg-2"))))))
That calls the test you just wrote (and passes it a version number).
Finally! Run your test:
$ lein test
And hopefully you get something that ends with:
Everything looks good! ヽ(‘ー`)ノ
That’s it! Special thanks to James!
Hiring? Get in touch!