Project:WikiProject Extensions/MediaWiki Workshops/Git / Gerrit Tutorial/Workshop

From mediawiki.org

SIP Audio Conference[edit]

Use SIP client to connect to the audio conference at:

studio@saper.info
PIN 987654

No SIP account or username/password is really necessary!

Keys that work during the conference:

  • 0 - mute/unmute
  • * - deaf mute
  • 3 - increase talk volume
  • 2 - set talk volume to zero
  • 1 - decrease talk volume
  • 6 - increase listening volume
  • 5 - set listening volume to zero
  • 4 - decrease listening volume
  • # - hang up

Sometimes you have to dial SIP addresses by typing sip: before, for example sip:studio@saper.info

It is advisable to use a wideband client like Blink (Mac, Windows, Unix) or w:CSipSimple for Android. Your client is wideband ("high definition") if it supports w:G.722 codec.

Please learn how to mute/unmute your phone and please be muted most of the time (unless you are speaking).

Please connect to the conference before start and test your connection. It is possible that you can connect but you cannot hear anything (or cannot be heard) because of your network settings (mostly you are behind w:NAT and you are not using any of the firewall traversal methods w:STUN, ICE.

  • You can call echo@iptel.org to check if your audio works (it's an echo service)
  • You can test your connection by dialing wbdemo@conf.zipdx.com. It will tell you if you are connecting in wideband or narrowband.

If there is nobody on the conference, you should hear a nice Spanish music.

IRC[edit]

IRC used as fallback in case something does not work and for the initial setup.

We are on:

Server irc.freenode.net
Channel #git-gerrit

http://webchat.freenode.net/

Gerrit[edit]

Test Gerrit instance

http://l.saper.info:8888/

Checkout MediaWiki Core (not necessary on t.saper.info):

git clone http://l.saper.info:8888/p/mediawiki-core
git clone ssh://username@l.saper.info:29418/mediawiki-core.git

First steps on t.saper.info[edit]

A cloned copy of MediaWiki Core is already provided on your account to save time.

T #1: Review your ~/.gitconfig[edit]

Your account comes with preconfigured FREE mailinator.com email address.

Mailinator.com is the leading edge premium enterprise email provider so we outsource to them.

Example file:

 [user]
   name = Comrade Quebec
   email = quebec@mailinator.com

Feel free to user yours but it has to be configured consequently here and in Gerrit.


T #3: Get your public SSH key from ~/.ssh/id_rsa.pub[edit]

It should look like this:

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAYQDKNgESmISrEDXDQY4pl37N7QxU1XsBmBq76cpGlviArH0gXk3GpPYbCfTAY7N65XDkSzqqCrCkVp/s33qhSI+H6x4ANaV50HwG1hXgs+cpN71SY+hySpKXBEcIkyrkgTc= quebec

Register in Gerrit[edit]

Gerrit #1: Register to Gerrit using OpenID URL provided[edit]

OpenID URL is provided for your account http://saper.info/i/username

  1. Use Comrade username as the Full name (just for fun).
  2. Click on Register New Email... and provide username@mailinator.com
  3. Provide your t.saper.info username on the registration screen (for example alfa).
  4. Add your public SSH key to Gerrit (using the key from step T #3)

Gerrit #2: Logon to http://mailinator.com and confirm email addres[edit]

Be careful to copy a whole URL because their web interface is so-so.

T #4: Test your SSH connection[edit]

From t.saper.info shell account do:

ssh l

It should respond with

  ****    Welcome to Gerrit Code Review    ****

  Hi Comrade Quebec, you have successfully connected over SSH.

  Unfortunately, interactive shells are disabled.
  To clone a hosted Git repository, use:

  git clone ssh://quebec@l.saper.info:29418/REPOSITORY_NAME.git

  Connection to l.saper.info closed.

If you get this, you are almost there.

Setting up access to MediaWiki repository on Gerrit[edit]

T #5: Get the hook[edit]

 cd mediawiki-core
 scp l:hooks/commit-msg .ssh/commit-msg

T #6: Add another remote to Git repository[edit]

 git remote add review ssh://username@l/mediawiki-core.git
 git remote update

You should be fully setup now.

SSH agent and keys[edit]

Please check if your SSH agent (ssh-agent, Pageant on Windows) is running and your private keys are loaded. Please check how to configure your client to allow agent forwarding to host t.saper.info.

For OpenSSH this can be done by updating ~/.ssh/config:

Host t.saper.info
ForwardAgent yes

or it can be enabled one time only when using the commandline:

ssh -A username@t.saper.info

SSH and OpenID[edit]

Below please find the list of usernames for connecting via SSH.

Training host instance: t.saper.info

User the provided OpenID URL to login into the training Gerrit instance at http://l.saper.info:8888/

alfa
http://saper.info/i/alfa Zeljko.filipin(WMF)
beta
http://saper.info/i/beta
charlie
http://saper.info/i/charlie Chris
delta
http://saper.info/i/delta
echo
http://saper.info/i/echo (Edokter)
foxtrot
http://saper.info/i/foxtrot
golf
http://saper.info/i/golf (Stefan)
hotel
http://saper.info/i/hotel
india
http://saper.info/i/india
juliet
http://saper.info/i/juliet
kilo
http://saper.info/i/kilo
lima
http://saper.info/i/lima
mike
http://saper.info/i/mike
november
http://saper.info/i/november Matma Rex (talk) 18:01, 3 October 2012 (UTC)[reply]
oscar
http://saper.info/i/oscar
papa
http://saper.info/i/papa
quebec
http://saper.info/i/quebec  « Saper // talk »  11:43, 3 October 2012 (UTC)[reply]
romeo
http://saper.info/i/romeo
sierra
http://saper.info/i/sierra Silke
tango
http://saper.info/i/tango Erik Zachte (talk) 17:58, 3 October 2012 (UTC)[reply]
uniform
http://saper.info/i/uniform
victor
http://saper.info/i/victor
whiskey
http://saper.info/i/whiskey
xray
http://saper.info/i/xray
yankee
http://saper.info/i/yankee
zulu
http://saper.info/i/zulu  « DAndreescu // talk »  17:36, 3 October 2012 (UTC)[reply]