| [[usersetup]] | |
| Initial Login | |
| ------------- | |
| It's time to exit the gerrit2 account as you now have Gerrit running on your | |
| host and setup your first workspace. | |
| Start a shell with the credentials of the account you will perform | |
| development under. | |
| Check whether there are any ssh keys already. You're looking for two files, | |
| id_rsa and id_rsa.pub. | |
| ---- | |
| user@host:~$ ls .ssh | |
| authorized_keys config id_rsa id_rsa.pub known_hosts | |
| user@host:~$ | |
| ---- | |
| If you have the files, you may skip the key generating step. | |
| If you don't see the files in your listing, your will have to generate rsa | |
| keys for your ssh sessions: | |
| SSH key generation | |
| ~~~~~~~~~~~~~~~~~~ | |
| *Please don't generate new keys if you already have a valid keypair!* | |
| *They will be overwritten!* | |
| ---- | |
| user@host:~$ ssh-keygen -t rsa | |
| Generating public/private rsa key pair. | |
| Enter file in which to save the key (/home/user/.ssh/id_rsa): | |
| Created directory '/home/user/.ssh'. | |
| Enter passphrase (empty for no passphrase): | |
| Enter same passphrase again: | |
| Your identification has been saved in /home/user/.ssh/id_rsa. | |
| Your public key has been saved in /home/user/.ssh/id_rsa.pub. | |
| The key fingerprint is: | |
| 00:11:22:00:11:22:00:11:44:00:11:22:00:11:22:99 user@host | |
| The key's randomart image is: | |
| +--[ RSA 2048]----+ | |
| | ..+.*=+oo.*E| | |
| | u.OoB.. . +| | |
| | ..*. | | |
| | o | | |
| | . S .. | | |
| | | | |
| | | | |
| | .. | | |
| | | | |
| +-----------------+ | |
| user@host:~$ | |
| ---- | |
| Registering your key in Gerrit | |
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
| Open a browser and enter the canonical url of your Gerrit server. You can | |
| find the url in the settings file. | |
| ---- | |
| gerrit2@host:~$ git config -f ~/gerrit_testsite/etc/gerrit.config gerrit.canonicalWebUrl | |
| http://localhost:8080/ | |
| gerrit2@host:~$ | |
| ---- | |
| Register a new account in Gerrit through the web interface with the | |
| email address of your choice. | |
| The default authentication type is OpenID. If your Gerrit server is behind a | |
| proxy, and you are using an external OpenID provider, you will need to add the | |
| proxy settings in the configuration file. | |
| ---- | |
| gerrit2@host:~$ git config -f ~/gerrit_testsite/etc/gerrit.config --add http.proxy http://proxy:8080 | |
| gerrit2@host:~$ git config -f ~/gerrit_testsite/etc/gerrit.config --add http.proxyUsername username | |
| gerrit2@host:~$ git config -f ~/gerrit_testsite/etc/gerrit.config --add http.proxyPassword password | |
| ---- | |
| Refer to the Gerrit configuration guide for more detailed information about | |
| link:config-gerrit.html#auth[authentication] and | |
| link:config-gerrit.html#http.proxy[proxy] settings. | |
| The first user to sign-in and register an account will be | |
| automatically placed into the fully privileged Administrators group, | |
| permitting server management over the web and over SSH. Subsequent | |
| users will be automatically registered as unprivileged users. | |
| Once signed in as your user, you find a little wizard to get you started. | |
| The wizard helps you fill out: | |
| * Real name (visible name in Gerrit) | |
| * Register your email (it must be confirmed later) | |
| * Select a username with which to communicate with Gerrit over ssh+git | |
| * The server will ask you for an RSA public key. | |
| That's the key we generated above, and it's time to make sure that Gerrit knows | |
| about our new key and can identify us by it. | |
| ---- | |
| user@host:~$ cat .ssh/id_rsa.pub | |
| ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1bidOd8LAp7Vp95M1b9z+LGO96OEWzdAgBPfZPq05jUh | |
| jw0mIdUuvg5lhwswnNsvmnFhGbsUoXZui6jdXj7xPUWOD8feX2NNEjTAEeX7DXOhnozNAkk/Z98WUV2B | |
| xUBqhRi8vhVmaCM8E+JkHzAc+7/HVYBTuPUS7lYPby5w95gs3zVxrX8d1++IXg/u/F/47zUxhdaELMw2 | |
| deD8XLhrNPx2FQ83FxrjnVvEKQJyD2OoqxbC2KcUGYJ/3fhiupn/YpnZsl5+6mfQuZRJEoZ/FH2n4DEH | |
| wzgBBBagBr0ZZCEkl74s4KFZp6JJw/ZSjMRXsXXXWvwcTpaUEDii708HGw== John Doe@MACHINE | |
| user@host:~$ | |
| ---- | |
| IMPORTANT: Please take note of the extra line-breaks introduced in the key above | |
| for formatting purposes. Please be sure to copy and paste your key without | |
| line-breaks. | |
| Copy the string starting with ssh-rsa to your clipboard and then paste it | |
| into the box for RSA keys. Make *absolutely sure* no extra spaces or line feeds | |
| are entered in the middle of the RSA string. | |
| Verify that the ssh connection works for you. | |
| ---- | |
| user@host:~$ ssh user@localhost -p 29418 | |
| The authenticity of host '[localhost]:29418 ([127.0.0.1]:29418)' can't be established. | |
| RSA key fingerprint is db:07:3d:c2:94:25:b5:8d:ac:bc:b5:9e:2f:95:5f:4a. | |
| Are you sure you want to continue connecting (yes/no)? yes | |
| Warning: Permanently added '[localhost]:29418' (RSA) to the list of known hosts. | |
| **** Welcome to Gerrit Code Review **** | |
| Hi user, you have successfully connected over SSH. | |
| Unfortunately, interactive shells are disabled. | |
| To clone a hosted Git repository, use: | |
| git clone ssh://user@localhost:29418/REPOSITORY_NAME.git | |
| user@host:~$ | |
| ---- | |
| GERRIT | |
| ------ | |
| Part of link:index.html[Gerrit Code Review] |