523 lines
16 KiB
Plaintext
523 lines
16 KiB
Plaintext
Release notes for Gerrit 2.8
|
|
============================
|
|
|
|
|
|
Gerrit 2.8 is now available:
|
|
|
|
link:http://code.google.com/p/gerrit/downloads/detail?name=gerrit-2.8.war[
|
|
http://code.google.com/p/gerrit/downloads/detail?name=gerrit-2.8.war]
|
|
|
|
|
|
Schema Change
|
|
-------------
|
|
|
|
|
|
*WARNING:* This release contains schema changes. To upgrade:
|
|
----
|
|
java -jar gerrit.war init -d site_path
|
|
----
|
|
|
|
*WARNING:* Upgrading to 2.8.x requires the server be first upgraded to 2.1.7 (or
|
|
a later 2.1.x version), and then to 2.8.x. If you are upgrading from 2.2.x.x or
|
|
later, you may ignore this warning and upgrade directly to 2.8.x.
|
|
|
|
|
|
Release Highlights
|
|
------------------
|
|
|
|
|
|
* Lots of new link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api.html[
|
|
REST API endpoints].
|
|
|
|
* New link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/js-api.html[
|
|
JavaScript API].
|
|
|
|
* New build system using link:http://facebook.github.io/buck/[Facebook Buck].
|
|
|
|
|
|
New Features
|
|
------------
|
|
|
|
|
|
Configuration
|
|
~~~~~~~~~~~~~
|
|
|
|
* Project owners can define `receive.maxObjectSizeLimit` in the
|
|
link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/config-gerrit.html#receive.maxObjectSizeLimit[
|
|
project configuration] to further reduce the global setting.
|
|
|
|
* Site administrators can define a
|
|
link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/config-mail.html#_footer_vm[
|
|
footer template] that will be appended to the end of all outgoing emails after
|
|
the 'ChangeFooter' and 'CommentFooter'.
|
|
|
|
* New `topic-changed` hook and stream event is fired when a change's topic is
|
|
edited from the Web UI or via a REST API.
|
|
|
|
* New options `--list-plugins` and `--install-plugins` on the
|
|
link:[http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/pgm-init.html[
|
|
site initialization command].
|
|
|
|
* New `auth.httpDisplaynameHeader` and `auth.httpEmailHeader` in the
|
|
link:[http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/config_gerrit.html#_a_id_auth_a_section_auth[
|
|
authentication configuration].
|
|
+
|
|
When using HTTP-based authentication, the SSO can be delegated to check not only
|
|
the user credentials but also to fetch the full user-profile.
|
|
+
|
|
With the config properties `auth.httpDisplaynameHeader` and `auth.httpEmailHeader`
|
|
it is possible to configure the name of the headers used for propagating this extra
|
|
information and enforce them on the user profile during login and beyond.
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/config_gerrit.html#_a_id_httpd_a_section_httpd[
|
|
Customizable registration page for HTTP authentication].
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/config_gerrit.html#_a_id_httpd_a_section_httpd[
|
|
Configurable external `robots.txt` file].
|
|
|
|
* Support for
|
|
link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/database-setup.html#createdb_oracle[
|
|
Oracle database].
|
|
|
|
Web UI
|
|
~~~~~~
|
|
|
|
|
|
Global
|
|
^^^^^^
|
|
|
|
* The change status is shown in a separate column on dashboards and search results.
|
|
|
|
Change Screens
|
|
^^^^^^^^^^^^^^
|
|
|
|
|
|
* New button to cherry-pick the change to another branch.
|
|
|
|
* When issuing a rebase via the Web UI, the committer is now the logged in
|
|
user, rather than "Gerrit Code Review".
|
|
+
|
|
If the user has more than one email address, the preferred email address will
|
|
be used.
|
|
|
|
* Default user's full name to git committer name if user has not configured a
|
|
full name in their profile.
|
|
|
|
* Include comment author attributes in comment panels.
|
|
+
|
|
Comment author's email address and name are included as attributes in comment
|
|
panels. This makes it easier to filter out CI-based comments using user
|
|
scripts.
|
|
|
|
* Copy reviewed flag to new patch sets for identical files.
|
|
+
|
|
If a user has already seen and reviewed a file, the 'reviewed' flag is forwarded
|
|
on to the next patch set when the content of the file in the next patch set is
|
|
identical to the reviewed file.
|
|
|
|
|
|
REST API
|
|
~~~~~~~~
|
|
|
|
* Several new link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api.html[
|
|
REST API endpoints] are added.
|
|
|
|
* REST views can determine how long their response should be cached.
|
|
|
|
* REST views can handle 'HTTP 422 Unprocessable Entity' responses.
|
|
|
|
Access Rights
|
|
^^^^^^^^^^^^^
|
|
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-access.html#list-access[
|
|
List access rights for project(s)]
|
|
|
|
Accounts
|
|
^^^^^^^^
|
|
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#create-account[
|
|
Create account]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#get-account-name[
|
|
Get account full name]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#set-account-name[
|
|
Set account full name]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#delete-account-name[
|
|
Delete account full name]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#list-account-emails[
|
|
List account email addresses]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#get-account-email[
|
|
Get account email address]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#set-preferred-email[
|
|
Set account preferred email address]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#create-account-email[
|
|
Create account email]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#delete-account-email[
|
|
Delete account email]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#get-active[
|
|
Get account state]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#set-active[
|
|
Set account state to active]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#delete-active[
|
|
Set account state to inactive]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#get-http-password[
|
|
Get account HTTP password]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#set-http-password[
|
|
Set or generate account HTTP password]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#delete-http-password[
|
|
Delete account HTTP password]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#list-ssh-keys[
|
|
List account SSH keys]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#get-ssh-key[
|
|
Get account SSH key]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#add-ssh-key[
|
|
Add account SSH key]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#delete-ssh-key[
|
|
Delete account SSH key]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-accounts.html#get-username[
|
|
Get account username]
|
|
|
|
Changes
|
|
^^^^^^^
|
|
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-changes.html#rebase-change[
|
|
Rebase change]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-changes.html#cherry-pick[
|
|
Cherry-pick revision]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-changes.html#get-content[
|
|
Get content of a file in a revision]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-changes.html#get-patch[
|
|
Get revision as a formatted patch]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-changes.html#get-diff[
|
|
Get diff of a file in a revision]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-changes.html#get-commit[
|
|
Get parsed commit of a revision]
|
|
|
|
|
|
Config
|
|
^^^^^^
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-config.html#get-capabilities[
|
|
Get capabilities]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-config.html#get-version[
|
|
Get version] (of the Gerrit server)
|
|
|
|
|
|
Projects
|
|
^^^^^^^^
|
|
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-projects.html#list-branches[
|
|
List branches]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-projects.html#get-branch[
|
|
Get branch]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-projects.html#create-branch[
|
|
Create branch]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-projects.html#delete-branch[
|
|
Delete branch]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-projects.html#list-child-projects[
|
|
List child projects]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-projects.html#get-child-project[
|
|
Get child project]
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/rest-api-projects.html#set-config[
|
|
Set configuration]
|
|
|
|
|
|
Capabilities
|
|
~~~~~~~~~~~~
|
|
|
|
|
|
New global capabilities are added.
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/access_control.html#capability_generateHttpPassword[
|
|
Generate Http Password] allows non-administrator users to generate HTTP
|
|
passwords for users other than themselves.
|
|
+
|
|
This capability would typically be assigned to a non-interactive group
|
|
to be able to generate HTTP passwords for users from a tool or web service
|
|
that uses the Gerrit REST API.
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/access_control.html#capability_runAs[
|
|
Run As] allows users to impersonate other users by setting the `X-Gerrit-RunAs`
|
|
HTTP header on REST API calls.
|
|
+
|
|
Site administrators do not inherit this capability; it must be granted
|
|
explicitly.
|
|
|
|
|
|
Emails
|
|
~~~~~~
|
|
|
|
* The `RebasedPatchSet` template is removed. Email notifications for rebased
|
|
changes are now sent with the `ReplacePatchSet` template.
|
|
|
|
* Comment notification emails now include context of comments that are replied
|
|
to, and links to the file(s) in which comments are made.
|
|
|
|
|
|
Plugins
|
|
~~~~~~~
|
|
|
|
|
|
Global
|
|
^^^^^^
|
|
|
|
|
|
* Plugins may now contribute buttons to various parts of the UI using the
|
|
link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/js-api.html[
|
|
JavaScript API].
|
|
|
|
* Plugins may now provide an 'About' section on their documentation index page.
|
|
|
|
* Plugins may now provide separate sections for REST API and servlet
|
|
documentation on their index page.
|
|
|
|
* Plugins may now provide
|
|
link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/config-validation.html#pre-merge-validation[
|
|
pre-merge validation steps].
|
|
|
|
* Plugins may now provide
|
|
link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/dev-plugins.html#capabilities[
|
|
Global capabilities].
|
|
|
|
* The "hello world" plugin is replaced with the "cookbook plugin" which has more
|
|
examples of the plugin API's usage.
|
|
|
|
|
|
Commit Message Length Checker
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
* Commits whose subject or body length exceeds the limit can be rejected.
|
|
|
|
Replication
|
|
^^^^^^^^^^^
|
|
|
|
* The `{$name}` placeholder is optional when replicating a single project,
|
|
allowing a single project to be replicated under a different name.
|
|
|
|
* Project names can be matched with wildcard or regex patterns in `replication.config`.
|
|
|
|
* The `replication start` command does not exit until replication is finished
|
|
when the `--wait` option is used.
|
|
|
|
* The `replication start` command displays a summary of the replication status.
|
|
|
|
* Retry counts are added to replication task names, so they can be seen in the
|
|
output of the `show-queue` command.
|
|
|
|
* The `remoteNameStyle` option can be set to `basenameOnly` to replicate projects
|
|
using only the basename on the target server.
|
|
|
|
* The `startReplication` global capability is now provided by the plugin.
|
|
|
|
ssh
|
|
~~~
|
|
|
|
|
|
* The `commit-msg` hook installation command is now
|
|
link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/config_gerrit.html#gerrit.installCommitMsgHookCommand[
|
|
configurable].
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/cmd-ls-members.html[
|
|
New `ls-members` command].
|
|
|
|
* link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/cmd-set-members.html[
|
|
New `set-members` command].
|
|
+
|
|
New command to manipulate group membership. Members can be added or removed
|
|
and groups can be included or excluded in one specific group or number of groups.
|
|
|
|
* The full commit message is now included in the data sent by the
|
|
link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/cmd-stream-events.html[
|
|
`stream-events` command].
|
|
|
|
* The link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/cmd-show-queue.html[
|
|
`show-queue` command] now shows the time that a task was added to the queue.
|
|
|
|
|
|
Daemon
|
|
~~~~~~
|
|
|
|
|
|
* Add `--init` option to Daemon to initialize site on daemon start.
|
|
+
|
|
The `--init` option will also upgrade an already existing site and is processed in
|
|
non-interactive (batch) mode.
|
|
|
|
|
|
Bug Fixes
|
|
---------
|
|
|
|
|
|
General
|
|
~~~~~~~
|
|
|
|
|
|
* Use the parent change on the same branch for rebases.
|
|
+
|
|
Since there can be multiple changes with the same commit on different branches,
|
|
use the parent change on the same branch during rebase.
|
|
|
|
* link:https://code.google.com/p/gerrit/issues/detail?id=600[Issue 600]:
|
|
Fix change stuck in SUBMITTED state but actually merged.
|
|
|
|
Configuration
|
|
~~~~~~~~~~~~~
|
|
|
|
|
|
* Do not persist default project state in `project.config`.
|
|
|
|
* Honor the `gerrit.cannonicalWebUrl` setting when opening the browser after init.
|
|
|
|
* Fix 'query disabled' error when Query Limit is set.
|
|
|
|
* Honor the `gerrit.createChangeId` setting from the git config in the
|
|
The link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/cmd-hook-commit-msg.html[
|
|
`commit-msg` hook].
|
|
|
|
* link:https://code.google.com/p/gerrit/issues/detail?id=2045[Issue 2045]:
|
|
Define user scope when parsing server config.
|
|
|
|
* link:https://code.google.com/p/gerrit/issues/detail?id=1990[Issue 1990]:
|
|
Support optional Certificate Revocation List (CRL) with `CLIENT_SSL_CERT_LDAP`.
|
|
|
|
Web UI
|
|
~~~~~~
|
|
|
|
|
|
Global
|
|
^^^^^^
|
|
|
|
|
|
* link:https://code.google.com/p/gerrit/issues/detail?id=1574[Issue 1574]:
|
|
Correctly highlight matches of text in escaped HTML entities in suggestion results.
|
|
|
|
* link:https://code.google.com/p/gerrit/issues/detail?id=1996[Issue 1996]:
|
|
The "Keyboard Shortcuts" help popup can be closed by pressing the Escape key.
|
|
|
|
* link:https://code.google.com/p/gerrit/issues/detail?id=2013[Issue 2013]:
|
|
Correctly populate the list of watched changes when watching more than one project.
|
|
|
|
Change Screens
|
|
^^^^^^^^^^^^^^
|
|
|
|
|
|
* Default review comment visibility is changed to expand all recent.
|
|
+
|
|
By default all comments within the last week are expanded, rather than
|
|
only the most recent.
|
|
|
|
* link:https://code.google.com/p/gerrit/issues/detail?id=1814[Issue 1814]:
|
|
Sort labels alphabetically by name in the approval table.
|
|
|
|
Project Screens
|
|
^^^^^^^^^^^^^^^
|
|
|
|
|
|
* Only enable the delete branch button when branches are selected.
|
|
|
|
* Disable the delete branch button while branch deletion requests are
|
|
still being processed.
|
|
|
|
User Profile Screens
|
|
^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
|
* The preferred email address field is shown as empty if the user has no
|
|
preferred email address.
|
|
|
|
|
|
REST API
|
|
~~~~~~~~
|
|
|
|
|
|
* Support raw input also in POST requests.
|
|
|
|
* Show granted date for labels/all when using `/changes/`.
|
|
|
|
* Return all revisions when `o=ALL_REVISIONS` is set on `/changes/`.
|
|
|
|
ssh
|
|
~~~
|
|
|
|
|
|
* The `--force-message` option is removed from the
|
|
The link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/cmd-review.html[
|
|
`review` command].
|
|
|
|
* link:https://code.google.com/p/gerrit/issues/detail?id=1908[Issue 1908]:
|
|
Provide more informative error messages when rejecting updates.
|
|
|
|
* Remove the limit in the query of patch sets by revision.
|
|
|
|
* Add `isDraft` in the `patchSet` attribute of `stream-events` data.
|
|
+
|
|
This allows consumers of the event stream to determine whether or not
|
|
the event is related to a draft patch set.
|
|
|
|
* Normalize the case of review labels submitted via the
|
|
The link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/cmd-review.html[
|
|
`review` command].
|
|
|
|
* The `@CommandMetaData(descr)` annotation is deprecated in favor of `@CommandMetaData(description)`.
|
|
|
|
|
|
Emails
|
|
~~~~~~
|
|
|
|
* Email notifications are sent for new changes created via actions in the
|
|
Web UI such as cherry-picking or reverting a change.
|
|
|
|
|
|
Tools
|
|
~~~~~
|
|
|
|
|
|
* git-exproll.sh: return non-zero on errors
|
|
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
|
|
* The link:http://gerrit-documentation.googlecode.com/svn/Documentation/2.8/index.html[
|
|
documentation index page] is rewritten in a hierarchical structure.
|
|
|
|
* Various spelling mistakes are corrected in the documentation and previous
|
|
release notes.
|
|
|