summaryrefslogtreecommitdiff
path: root/examples/docker-minimal/README
diff options
context:
space:
mode:
authorLinus Nordberg <linus@nordberg.se>2015-02-24 19:26:21 +0100
committerLinus Nordberg <linus@nordberg.se>2015-02-24 22:31:42 +0100
commit307071e1b0d536abbec277764b427d145d4f42b7 (patch)
treea23013c9ce6c21af2752118d46d0200c230a38bd /examples/docker-minimal/README
parent81a35a696d813ac5803afe602e549b56a9dfd9c4 (diff)
Add packaging and examples.
Diffstat (limited to 'examples/docker-minimal/README')
-rw-r--r--examples/docker-minimal/README25
1 files changed, 25 insertions, 0 deletions
diff --git a/examples/docker-minimal/README b/examples/docker-minimal/README
new file mode 100644
index 0000000..1bb2287
--- /dev/null
+++ b/examples/docker-minimal/README
@@ -0,0 +1,25 @@
+Given a docker image 'catlfish' as defined in
+catlfish/packaging/docker, here is an example of a minimal catlfish
+log using one docker container to run one single Erlang beam instance
+for both a frontend and a storage node and an example of how to start
+a shell script in the host system performing merge periodically.
+
+Create the docker image
+
+ $ docker build -t my-single-image-catlfish docker
+
+Run the newly created image in a docker container
+
+ $ docker run --name=my-catlfish --detach=true --publish 127.0.0.1:8080-8082:8080-8082/tcp my-single-image-catlfish
+
+This will create and start one container listening for cert chain
+submissions on https://127.0.0.1:8080/.
+
+FIXME FIXME start shell script doing merge (i.e. generate a new STH)
+with an interval of 20 minutes, with the first merge occuring five
+minutes after startup.
+
+To submit a cert chain and verify the resulting SCT, try the
+submitcert tool:
+
+ $ tools/submitcert.py --store tools/testcerts/cert1.txt --check-sct --sct-file=/tmp/cert1-sct https://127.0.0.1:8080/