62 Commits

Author SHA1 Message Date
Andreas Jaeger
1a3aa9a054 Fix doc8 issues
Remove extra whitespace.
Wrap overlong lines.
Remove extra ".." in one place

Change-Id: Ib7280a87ddb663a8ab27308ffd67d19f0b0f7b09
2014-09-04 17:47:35 +02:00
Jenkins
9a29e4ca4d Merge "Update documented local gerrit git replica path" 2014-09-03 22:33:39 +00:00
Jenkins
e72454fbaa Merge "Doc cleanup" 2014-09-03 22:04:05 +00:00
Jeremy Stanley
348c675882 Update documented local gerrit git replica path
* doc/source/gerrit.rst: I7be76082a2c8cda21e33ece5161b4190795eef5c
moved Gerrit's local git replicas from /var/lib/git to /opt/lib/git
so the renaming process now reflects the same.

Change-Id: I1f61eae12d58912c55368cd34e0808690e4740de
2014-08-30 15:35:27 +00:00
Doug Hellmann
fd7789403e Doc cleanup
Turn on warnerrors and fix the errors it reports.

Change-Id: I92a194e47b97dbdeb0e72164a813f41914f4f298
2014-08-27 15:30:56 -04:00
Clark Boylan
1c66994e00 Propose new Code Review -1 text
New Code Review -1 default text has been proposed on a ML thread.
Propose it here so that we can "review" it. If we can agree this should
be updated as in this change a Gerrit admin will have to update
All-Projects directly then this change can be merged.

Fixes-bug: 1258899
Change-Id: I145d393bba6d7ebede7fbcd1f592937a9daadaf9
2014-08-25 22:12:03 +00:00
James E. Blair
78f35ad843 Add instructions to rename gerrit groups
When renaming a project, we frequently need to rename groups

Change-Id: Ia7326150e5e968446c2c931ca8c981abe7854f7a
2014-08-16 09:03:03 -07:00
Sergey Lukjanov
dd2c44a463 Corrections to the project renaming guide
Change-Id: I4ac59ff8e3ddc3f024115cf27f43207e76b43e04
2014-08-14 01:50:48 +04:00
Jenkins
9a15781d5e Merge "Update gerrit project rename instructions" 2014-07-06 13:17:23 +00:00
Monty Taylor
92b29acd0d Add playbook for cleaning workspaces
Sometimes we need to clean the workspaces. While we have a command
documented, go ahead and make a playbook for it.

Change-Id: I1887dec24563811a71157c000b2d8ae9b7850d6a
2014-07-04 10:01:14 -07:00
Thierry Carrez
404ec57fb3 Change ACLs to apply on proposed/* branches
Change ACLs so that they would apply to proposed/* branches instead of
milestone-proposed branches, and adjust documentation to match.

NB: The top-level project.config should also be changed so that its ACLs
apply to proposed/* branches. It's apparently not driven by the config
repository.

Change-Id: Iad6991315b1d526026e0aeb0e968ed85dd317fac
2014-07-01 11:46:51 +02:00
Jeremy Stanley
25a9cc73ad Normalize Gerrit ACL documentation
It turns out that while changes to Gerrit ACLs from the WebUI will
create "Git config" format files which look somewhat like
traditional INI files with hard-tab indentation and other
unpleasantness, Gerrit will interpret more traditional INI files as
ACLs just fine and merge them to refs/meta/config unaltered. Adjust
the examples to look like the sorts of INI files with which our
developers are more familiar, and apply some other helpful
normalization like alphabetizing the section and key orders,
removing redundant default values or other no-ops, et cetera.

Change-Id: I3b9dad7b7beb05427eb4011fa6dad2a6dd4cbe72
2014-06-30 17:22:55 +00:00
James E. Blair
4e84daec86 Update gerrit project rename instructions
To current (hacky) procedure to stop puppet runs from puppetmaster.

Change-Id: I7a76fc4fd020c6dd6e8f05f417ec58a6410fac84
2014-06-28 07:43:19 -07:00
Jeremy Stanley
4d23b04037 Don't deny visibility of ICLA group to its members
We are making this and other CLA enforcement groups public, since
they are not sensitive information (lists of committers are already
public and we used to keep these tracked in a wiki article before
enforcement within Gerrit), and since there is value in being able
to query this status in a read-only manner to aid in building
contributor analyses.

Change-Id: I459a066612fe014790086ac04cbeb5eebd6e062d
2014-06-10 22:18:40 +00:00
Jeremy Stanley
77c193f23d Prevent Draft patchsets from being pushed
Add rule that blocks pushes to refs/drafts/*.

Change-Id: I5cfaf22e17df0458a6769ad4c518feb0f387cee7
2014-06-10 22:07:06 +00:00
Jeremy Stanley
13d36c0f0e Don't copy review scores on commit message updates
This gets us closer to the behavior we had prior to upgrading from
2.4 to 2.8, and is generally considered desirable since we want
people to be able to review and vote on commit message contents.

Change-Id: I7051a606f1d501e5aef6510d42ef928456d07303
2014-06-10 22:02:31 +00:00
Clark Boylan
0be0dc79c3 Update gerrit replication command.
Gerrit 2.8 uses a plugin to do replication and the command to trigger it
is different than the built in command from 2.4. Update the docs to
reflect the correct command.

Change-Id: I4b97a94a932b469a72eb3141ebd340785577465c
2014-05-29 14:32:14 -07:00
Jeremy Stanley
f930531f30 Reindex Gerrit after project move/rename
* doc/source/gerrit.rst: When project names change, Gerrit's lucene
indexes must be rebuilt while the service is still offline. If this
is not done, searches on the new project names will not find
existing changes and Zuul will ignore some events for them.

Change-Id: I99cd657298e05f7c213cf770e92d06016043f547
2014-05-26 22:44:46 +00:00
Jenkins
49e280796f Merge "Fixed several typos in the docs." 2014-05-01 02:27:07 +00:00
Khai Do
e289ed2564 update docs and All-Project configuration for gerrit 2.8
Changes for gerrit 2.8:
- In Gerrit 2.8 labels no longer need to be manually entered into the database.  To create
  custom labels we just need to define them in project.config file.
- There are two new ACLs (pushSignedTags[1] and streamEvents[2]) to configure in
  All-Projects config.
- The Workflow label replaces workInProgress permission (from WIP plugin)
  so removing workInProgress.

The 'Approved' label is replaced by the 'Workflow' label so updating the docs accordingly.

[1] https://gerrit-review.googlesource.com/Documentation/access-control.html#category_push_signed
[2] https://gerrit-review.googlesource.com/Documentation/access-control.html#capability_streamEvents

Change-Id: I8fd11f91fcb729d0d52234fb38da9fc6715b56f4
2014-04-28 17:44:39 -07:00
Alex Gaynor
1c00fe4bb4 Fixed several typos in the docs.
Found using: https://github.com/intgr/topy

Change-Id: I4b6d1258ae0f9e73289c4a72c4e534263de7e665
2014-04-26 08:44:25 -07:00
James E. Blair
c19da4c8a7 Move cinder docs into sysadmin section
And reference them from hosts that use cinder volumes.

Change-Id: I180f13a44d8e45209df8c6a16f275d987d05cbfe
2014-04-24 14:18:18 -07:00
Jenkins
e19f9ed7c3 Merge "Update gerrit project rename instructions" 2014-02-14 05:30:50 +00:00
Jeremy Stanley
a01a33a174 No longer grant third-party voting initially
* doc/source/gerrit.rst: Update documentation to reflect that the
External Testing Tools group has been replaced by two new groups
named Third-Party CI and Voting Third-Party CI. New third-party
continuous integration testing service accounts are initially added
to the first group, which allows them to apply verify votes only on
the openstack-dev/sandbox project. Once they have managed to confirm
some stability, they are moved to the second group, which is also
included by the first, so that they may apply verify votes on any
project.

* .../gerrit/acls/openstack-dev/sandbox.config: Apply verify voting
permissions for Third-Party CI group members, and correct review
activity permissions to use the Registered Users group instead of
the long-defunct openstack-cla group.

Change-Id: Ief3fef44df986d868af148787b3c456a98484091
2014-02-07 22:00:28 +00:00
James E. Blair
c1495cdca4 Update gerrit project rename instructions
We have a git farm now rather than a single git server.

And we can remove workspaces with salt.

Change-Id: If7395db9e3809e6589ce07ceef30e1d942362efe
2014-02-07 09:05:27 -08:00
Monty Taylor
bc794da31e Split config from projects list
The projects list is a common list for devs to interact with. The config
in the list is not, but the config in the list means the file needs to
be in an erb template.

Split the two concerns, similar to zuul. Put the config in a config file
and the project data in a yaml file.

Change-Id: I708b8655b4b1ce377f3b7369e987418c1d72d977
2014-01-28 09:32:09 -08:00
Jeremy Stanley
5fc2dacd00 Flush Gerrit caches after fixing E-mail dupes
* doc/source/gerrit.rst: In the section on clearing duplicate E-mail
addresses, note that a cache flush is needed for immediate effect.

Change-Id: I436dfc85f86683ffe90c099f449466db02844a18
2013-10-22 14:54:53 +00:00
Jenkins
744bfd1417 Merge "Adding a Gerrit third-party testing account" 2013-10-12 20:47:58 +00:00
Jeremy Stanley
7bae8b8f8d Adding a Gerrit third-party testing account
* doc/source/gerrit.rst: Quick documentation added for the method by
which a Gerrit administrator can create the sort of account needed
for third-party testing.

Change-Id: Ia7ec399027ad664a43d6084f988ed84ff572ac00
2013-10-12 19:41:27 +00:00
Robert Collins
6df6213bf8 Document bootstrapping of Gerrit ACLs.
The prior documentation was incomplete and inconsistent. This works (tested in
an IRC session with clarkb's help).

Change-Id: Ic1d5a51176ccba8b922bcf084d11c0bb0c6ac06a
2013-10-02 10:04:27 +13:00
Jenkins
a3871ba0cd Merge "Document push key acceptance." 2013-09-23 21:43:36 +00:00
Jenkins
b5a7cf8378 Merge "Explain API projects a little." 2013-09-23 21:43:28 +00:00
Robert Collins
28e1a2cc3d Document push key acceptance.
Gerrit replication calls out to ssh which requires host keys to be
accepted in the relevant user account. Document this to ease initial
deployment.

Change-Id: I03b8f1c39a4562cc480b3ef612cb3306b1445814
2013-09-23 17:27:22 -04:00
Robert Collins
713468b6d1 Explain API projects a little.
I was thoroughly confused, and suspect others without direct
experience may be too.

Change-Id: I9003eeaefc7734ef360ff893cec8c828fd51f254
2013-09-23 17:27:22 -04:00
Robert Collins
1ac5997a82 Gerrit docs improvements - user and groups.
The user and group docs were a bit opaque, and the needed groups for
the project creator account were not well documented.

Change-Id: Iee6d3ea6dd34a687205412174f78cd44e756c953
2013-09-23 17:25:32 -04:00
Robert Collins
1ba7d02a0e Make gerrit DB setup match actual practice.
sudo su - mysql is the actual mechanism used by -infra folk.

Change-Id: I209f0e9e2cb3f4dd7ad012f39b6e6551c05c5e0e
2013-09-23 17:25:32 -04:00
Jenkins
3735479bf0 Merge "Gerrit sysadmin tips for account repairs/renaming" 2013-09-06 00:10:29 +00:00
Jeremy Stanley
ae0c06c1a8 Preserve change creation time on project renames
* doc/source/gerrit.rst: When renaming projects in the changes
table, set created_on to itself so that it won't get updated to the
current time. This column is a timestamp datatype in MySQL and has
the "on update" property set, probably for no good reason but it's
how Gerrit's installer sets the schema.

Change-Id: I5b99d2869e55ab0f8b036fd08f248f406aff41bb
2013-09-05 01:36:43 +00:00
Jeremy Stanley
31bfd240e0 Gerrit sysadmin tips for account repairs/renaming
* doc/source/gerrit.rst: Add sections to the document about
resetting Gerrit SSH usernames and cleaning up duplicate preferred
E-mail addresses. Also a section demonstrating the dreaded account
merge process for posterity, even though we do not offer to perform
this for our users.

Change-Id: I43883ef9558abbdf5051aa617def36d1fc158100
2013-09-04 20:40:22 +00:00
Elizabeth Krumbach Joseph
9f24ee0df1 Update references to GerritJenkinsGit wiki
We've moved the GerritJenkinsGithub wiki page to instead be
at GerritJenkinsGit, update references to it in our configs.

Change-Id: I88d8140a0e5f6e4051ca78415e0152c9cdcb86f6
2013-08-30 10:58:30 -07:00
Monty Taylor
258abe1a23 Use cgit server instead of github for everything
We have a cgit server now, which means we should replace
all references to github with references to git.openstack.org.

Change-Id: I68ad1ce514fb4326c7d9940b5a84999af5b58562
2013-08-19 10:19:47 -07:00
Monty Taylor
e58b852907 Include instructions for deleting lock file
The zuul lock file needs to be removed as well.

Change-Id: Ice16e07c142026c4df45f21ffae80e6a506dfcdd
2013-08-17 21:56:20 -04:00
James E. Blair
8ba40aff55 Update project rename instructions
We use a thing called Zuul now.

Change-Id: Ie1a81003c37fa598897e31eef84bb8384498a9f8
2013-08-17 21:09:53 -04:00
Jeremy Stanley
d9da9e7835 Release Managers replaces openstack-release.
* doc/source/gerrit.rst: Update documentation to indicate that the
Release Managers group in Gerrit has supplanted the old
openstack-release group.

Change-Id: Id4ac08583ec3723289a1ebffbd1bbed1e591b760
Reviewed-on: https://review.openstack.org/34462
Reviewed-by: Elizabeth Krumbach Joseph <lyz@princessleia.com>
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Approved: James E. Blair <corvus@inaugust.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Tested-by: Jenkins
2013-07-02 16:54:15 +00:00
James E. Blair
9ed2be3098 Refactor project infrastructure docs.
The goal is to re-orient the documentation as an introduction for new
contributors and a reference for all contributors.

Change-Id: I8702a5ace908c7618a6451bbfef7fc79b07429ff
Reviewed-on: https://review.openstack.org/30515
Reviewed-by: Elizabeth Krumbach Joseph <lyz@princessleia.com>
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Approved: Monty Taylor <mordred@inaugust.com>
Reviewed-by: Monty Taylor <mordred@inaugust.com>
Tested-by: Jenkins
2013-05-30 17:27:07 +00:00
Jay Pipes
05aaa0b956 Add gate job configuration for Chef cookbooks
This commit adds the Jenkins job builders and gate
configuration for the Chef cookbooks. Only the
cookbook-openstack-common repo is changed from a
NOOP gate to the lint + unit gate at this time, as
that cookbook is the first that will be going into
the Stackforge repo.

Change-Id: I999a990f15829730495ab0891e4d38f1a5795d60
Reviewed-on: https://review.openstack.org/28640
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Reviewed-by: Khai Do <zaro0508@gmail.com>
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Approved: Jeremy Stanley <fungi@yuggoth.org>
Tested-by: Jenkins
2013-05-09 23:16:08 +00:00
Jeremy Stanley
0dd9f42cd3 Update CI docs for -drivers to -milestone rename.
Change-Id: I6df3c4f6dac6337ab87cabd05dbd94766ad7ef1d
Reviewed-on: https://review.openstack.org/25425
Reviewed-by: Anita Kuno <akuno@lavabit.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Reviewed-by: Monty Taylor <mordred@inaugust.com>
Approved: Jeremy Stanley <fungi@yuggoth.org>
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Tested-by: Jenkins
2013-03-31 13:15:33 +00:00
James E. Blair
d68cb0bcbf Replace acl_config with acl-config in docs.
Change-Id: I8f7c8b0800da37a7e9b97e75571a03ac14214374
Reviewed-on: https://review.openstack.org/23823
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Approved: Clark Boylan <clark.boylan@gmail.com>
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Tested-by: Jenkins
2013-03-07 22:12:00 +00:00
Jeremy Stanley
6b95efed50 Update Gerrit docs for CLA and group changes.
* doc/source/gerrit.rst: Changes to the CLA process and group
management have removed the need for Launchpad synchronization.

* doc/source/stackforge.rst: Rewrite the core group section to refer
to new Gerrit-specific workflow instead of the old Launchpad method.

* doc/source/systems.rst: Remove recommendation for adding core
groups to Launchpad since those are a Gerrit-only concept now (bugs
and drivers groups remain relevant to LP however).

Change-Id: I2532b93a43821848bb48d12fcaf3f1b0b07dd207
Reviewed-on: https://review.openstack.org/17868
Reviewed-by: James E. Blair <corvus@inaugust.com>
Approved: James E. Blair <corvus@inaugust.com>
Tested-by: Jenkins
2013-03-03 18:09:22 +00:00
Elizabeth Krumbach
4df9996990 Docs update: puppet does mysql install for gerrit
Change-Id: If88889554913f8f8dbd91d4455e0a91926e8bd5f
Reviewed-on: https://review.openstack.org/19313
Reviewed-by: Monty Taylor <mordred@inaugust.com>
Reviewed-by: shengjie min
Approved: Jeremy Stanley <fungi@yuggoth.org>
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Tested-by: Jenkins
2013-01-09 17:43:07 +00:00