6d501d8f01
The documentation states that the command is used for creating user accounts for batch/role access. However this is not always the case; it is possible to create an account for a real person with an email address and name. Update the documentation to say that if the account is created without an email address, it may only be used for batch/role access. Change-Id: I213708e32f98585632810023afd9eca3e6f3df8e
79 lines
1.9 KiB
Plaintext
79 lines
1.9 KiB
Plaintext
gerrit create-account
|
|
=====================
|
|
|
|
NAME
|
|
----
|
|
gerrit create-account - Create a new batch/role account.
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'ssh' -p <port> <host> 'gerrit create-account'
|
|
[--group <GROUP>]
|
|
[--full-name <FULLNAME>]
|
|
[--email <EMAIL>]
|
|
[--ssh-key - | <KEY>]
|
|
[--http-password <PASSWORD>]
|
|
<USERNAME>
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
Creates a new internal-only user account.
|
|
|
|
If the account is created without an email address, it may only be
|
|
used for batch/role access, such as from an automated build system
|
|
or event monitoring over link:cmd-stream-events.html[gerrit stream-events].
|
|
|
|
If LDAP authentication is being used, the user account is created
|
|
without checking the LDAP directory. Consequently users can be
|
|
created in Gerrit that do not exist in the underlying LDAP directory.
|
|
|
|
ACCESS
|
|
------
|
|
Caller must be a member of the privileged 'Administrators' group,
|
|
or have been granted
|
|
link:access-control.html#capability_createAccount[the 'Create Account' global capability].
|
|
|
|
SCRIPTING
|
|
---------
|
|
This command is intended to be used in scripts.
|
|
|
|
OPTIONS
|
|
-------
|
|
<USERNAME>::
|
|
Required; SSH username of the user account.
|
|
|
|
--ssh-key::
|
|
Content of the public SSH key to load into the account's
|
|
keyring. If `-` the key is read from stdin, rather than
|
|
from the command line.
|
|
|
|
--group::
|
|
Name of the group to put the user into. Multiple --group
|
|
options may be specified to add the user to multiple groups.
|
|
|
|
--full-name::
|
|
Display name of the user account.
|
|
+
|
|
Names containing spaces should be quoted in single quotes (').
|
|
This most likely requires double quoting the value, for example
|
|
`--full-name "'A description string'"`.
|
|
|
|
--email::
|
|
Preferred email address for the user account.
|
|
|
|
--http-password::
|
|
HTTP password for the user account.
|
|
|
|
EXAMPLES
|
|
--------
|
|
Create a new user account called `watcher`:
|
|
|
|
====
|
|
$ cat ~/.ssh/id_watcher.pub | ssh -p 29418 review.example.com gerrit create-account --ssh-key - watcher
|
|
====
|
|
|
|
GERRIT
|
|
------
|
|
Part of link:index.html[Gerrit Code Review]
|