From 0471bfb40d787afb0e2a4382ea169090f95b5599 Mon Sep 17 00:00:00 2001 From: Yolanda Robla Date: Thu, 18 Feb 2016 10:51:13 +0100 Subject: [PATCH] Add troubleshooting section to github Create a section about how to fix the replication problems to github, when gerrit team member needs to be added to the project. Change-Id: Ic3354b7c1d49ebdd6294698ab32062421f3c5569 --- doc/source/gerrit.rst | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/doc/source/gerrit.rst b/doc/source/gerrit.rst index df07dee49e..e043b41fc5 100644 --- a/doc/source/gerrit.rst +++ b/doc/source/gerrit.rst @@ -131,6 +131,26 @@ keys. e.g.:: sudo su - gerrit2 ssh github.com +Troubleshooting +--------------- +When creating a new project, there can be times where the :ref:`jeepyb` +automation to create the GitHub project can fail, and leave the project +improperly configured. +This can cause replication to GitHub to fail. The project in GitHub will +be created, but will appear empty. When trying replication from Gerrit, +it will show a `Permission denied` error when trying to push content. +To solve that, following steps are needed: + + #. Login into github.com, using openstack-project-creator user. + + #. Navigate to the failed repository, and enter on Settings > Collaborators + & teams option. + + #. Add Gerrit as Team member to that project. + +After the team has been added, project will start replicating successfully +to GitHub. + Auto Review Expiry ==================