Added launchpad sync docs, and linked in tarmac.

Change-Id: Ib1af24af2b347babe4a5555008c9b5a192763d85

doc/gerrit.rst

@@ -364,3 +364,39 @@ Set permissions as follows::
     label code review -2/+2: foo-core
     submit: foo-core
 
+Launchpad Sync
+**************
+
+The launchpad user sync process consists of two scripts which are in
+openstack/openstack-ci on github: sync_launchpad_users.py and
+insert_gerrit.py.
+
+Both scripts should be run as gerrit2 on review.openstack.org
+
+sync_launchpad_users.py runs and creates a python pickle file, users.pickle,
+with all of the user and group information. This is a long process. (12
+minutes)
+
+insert_gerrit.py reads the pickle file and applies it to the MySQL database.
+The gerrit caches must then be flushed.
+
+Depends
+-------
+::
+
+  apt-get install python-mysqldb python-openid python-launchpadlib
+
+Keys
+----
+
+The key for the launchpad sync user is in ~/.ssh/launchpad_rsa.
+
+Running
+-------
+::
+
+  cd openstack-ci
+  git pull
+  python sync_launchpad_users.py
+  python insert_gerrit.py
+  ssh -i /home/gerrit2/.ssh/launchpadsync_rsa -p29418 review.openstack.org gerrit flush-caches

doc/index.rst

@@ -24,6 +24,7 @@ Contents:
 
    jenkins
    gerrit
+   tarmac
 
 Indices and tables
 ==================