From 385137f5b948ddb1899be245034063815881e308 Mon Sep 17 00:00:00 2001 From: Lauren Perry Date: Wed, 17 Dec 2014 17:00:53 +0000 Subject: :Add instructions for running/setting up Firehose to the README --- README | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) 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 ========================= -- cgit v1.2.1