Commit Graph

76 Commits

Author SHA1 Message Date
Brian Hunter
cce292cfbb grammar updates for gerrit documentation
Pedantic grammar updates to this documentation.
-adds a couple commas here and there
-fixes case on certain propper nouns.
-fixes a couple minor miswordings

Also serves as proof for those skeptical that I've actually RTFM :)

Change-Id: Ia8e357d2460be2750349244ae70a4f0e16db4a8a
2015-03-06 11:02:44 -05:00
Jeremy Stanley
1fd0831335 A rebase button for all registered users
The nova project core reviewers have had this enabled for them for
several months without incident, and it's already something anyone
can do locally and push to a change. Also it's convenient when
people are editing commit messages via the WebUI and need to rebase
dependent changes after doing so.

Change-Id: Iefff52be4d12390be372429d6ebc48704c379630
2015-02-13 16:26:08 +00:00
Jenkins
8bf2783324 Merge "Documentation reflects new stable-maint workflow" 2015-02-11 00:53:09 +00:00
Jenkins
6cb4a2635c Merge "Add StoryBoard update step to gerrit project renaming guide" 2015-02-04 21:26:20 +00:00
James E. Blair
83f7024700 Update gerrit rename instructions
* Use the transfer ownership function in github.
* Move the github step to within the gerrit downtime.
* Indicate that github and git0X steps should be run during the
  lucene reindexing (for time efficiency).
* Remove the replication step which is not needed when using the
  github transfer ownership function.

Change-Id: I1ac209eecaa60573b7d885c7feea3be4b9a64af8
2015-01-30 11:35:27 -08:00
Elizabeth K. Joseph
11a9b7ccce Update documentation with new Puppet modules
Location of our Puppet modules has changed now that they are split
from system-config, update documentation accordingly.

Change-Id: I4d4adc5d41f50dd92fbd642ac30f95c327a416b2
2015-01-28 19:48:10 -08:00
Jenkins
84eefdc30a Merge "Put playbooks in a directory" 2015-01-24 20:39:19 +00:00
Sergey Lukjanov
0fd8d87700 Add StoryBoard update step to gerrit project renaming guide
Change-Id: I6b51a4dbe09b0302f7479800ab94a1534abc5293
2015-01-20 16:57:54 +03:00
Jeremy Stanley
28f659944e Workflow documentation is now in infra-manual
Replace URLs for workflow documentation to appropriate parts of the
OpenStack Project Infrastructure Manual.

Change-Id: I8aa32f5617a0331c116a703c45ae7f644f5b409a
2015-01-08 20:31:20 +00:00
Jeremy Stanley
96b0a4c2cd Documentation reflects new stable-maint workflow
Equivalent cleanup has already been performed in the All-Projects
ACL, in the wake of Id127d24e4428be8b450de277dc55df20349aab13
merging.

Change-Id: Ie89810c728e9cc39e6b3e05d312c9c1818e7d984
2014-12-12 20:12:36 +00:00
Monty Taylor
75c068f767 Put playbooks in a directory
Listing each of them individually in the puppetmaster.pp file is just
plain crazypants.

Change-Id: Ice621be7d62ec8ff5bc680cf24c237c38f8f30e5
2014-11-28 11:13:41 -05:00
Michael Krotscheck
bdd6abcac8 Switched documentation to point to storyboard.
We've migrated this project to storyboard, I'm updating the
documentation links.

Change-Id: Id92552b7be7cd43ca6a3ec91c2c4f330078490b6
2014-11-12 14:48:02 -08:00
Anita Kuno
8549f5d29e Rename config => system-config in docs
We are renaming the openstack-infra/config repo to
openstack-infra/system-config. This patch edits the docs files.

Change-Id: Ic594f1b5438a400fb6c1071c3045adb7a0b7e441
2014-10-17 15:05:29 -04:00
James E. Blair
f605d6e6ce Doc updates for project-config
Change-Id: Idffa13d5d1990f47e46fc5b711563949da78b6f8
2014-09-25 11:03:04 -07:00
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