summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLauren Perry <lauren.perry@codethink.co.uk>2014-12-17 17:00:53 +0000
committerLauren Perry <lauren.perry@codethink.co.uk>2015-01-08 16:34:24 +0000
commit385137f5b948ddb1899be245034063815881e308 (patch)
tree6d68f2ab65187662cd65cf9247b2cfe21810bff1
parentc9fd8cf3dd449caeafe27b6bef8bda594bcdfc30 (diff)
downloadfirehose-385137f5b948ddb1899be245034063815881e308.tar.gz
:Add instructions for running/setting up Firehose to the README
-rw-r--r--README49
1 files changed, 49 insertions, 0 deletions
diff --git a/README b/README
index d22719b..425a1fd 100644
--- a/README
+++ b/README
@@ -14,6 +14,55 @@ where that holds true, Firehose can provide a valuable service pre-integrating
and running those integrations through a CD pipeline to gain confidence in the
proposed change.
+Presently Required Instructions to Run Firehose
+===============================================
+
+Firehose deployment isn't automated yet. Here are instructions on how to do it
+manually:
+
+In a 'build' machine in the cloud:
+
+ morph build systems/build-system-x86_64.morph
+ morph deploy baserock-firehose/baserock-firehose.morph
+
+Instatiate this image and SSH into it.
+
+ git clone git://git.baserock.org/baserock/baserock/firehose
+ git checkout baserock/lauren/firehose
+ python ./setup.py install
+ adduser firehose -s /bin/false -D
+ sudo -u firehose -- ssh-keygen -C 'firehose@baserock.org' -N ''
+ sudo chown -R firehose:firehose /var/lib/firehose
+
+Create an account on the Gerrit instance where Firehose will be pushing:
+
+ ssh -p 29418 you@gerrit.baserock.org gerrit \
+ create-account --group "'Non-Interactive Users'" \
+ --ssh-key xxxx --full-name "'Firehose integration tool'" \
+ --email='firehose@firehose.baserock.org' \
+ firehose
+
+Test that the Firehose user can connect to Gerrit (this should give you a help
+message if successful, or a 'Permission denied' error otherwise):
+
+ sudo -u firehose -- ssh -p 29418 firehose@gerrit.baserock.org gerrit
+
+Move firehose.service and firehose.timer files to /etc/systemd/system/
+
+Run:
+
+ systemctl enable firehose.timer
+ systemctl start firehose.timer
+ systemctl enable firehose.service
+
+As Firehose, ensure that the git config matches what gerrit expects W.R.T email address, i.e.
+
+ git config --global user.email firehose@firehose.baserock.org
+
+If Firehose fails due to an error in /tmp/morph_tmp/, edit /etc/morph.conf to include the following:
+
+ [config]
+ repo-alias=baserock=git://git.baserock.org/baserock/#ssh://firehose@testgerrit.baserock.org:29418/baserock/,upstream=git://git.baserock.org/delta/#ssh://firehose@testgerrit.baserock.org:29418/delta/
Debian Version Comparison
=========================