Reading/Browser tests/Setting up a browser test instance

If you prefer you follow instructions to manually setup a browser test bot but we;ve created a bash script, Barry-the-Browser-Test-Bot-Installer in effort to reduce the amount of heavy lifting.

To setup a browser test bot labs-vagrant instance, please follow these instructions:

• Create a Labs / Gerrit account by signing up at wikitech (eg: Barrythebrowsertestbot). Please note [bot policy].
• Request a labs project if a project doesn't already exist. Currently we already have a project called reading-smoketest.
• Create a labs instance Choose ubuntu-14.04-trusty and configure with role::labs::vagrant checked. You must have Project Admin rights in a project to create and manage its instances. You can ask an existing Project Admin in a project to grant you the role.
• ssh into your instance e.g. ssh reading-smoketest.wmflabs.org
  • If you cannot access your labs project. Try ssh -A username@bastion.wmflabs.org then ssh into your instance from there. ssh instance-name
• Following instructions from Help:Labs-vagrant Run an initial provision and enable the project roles needed for your testing instance.
• Setup a Web Proxy and link to the instance.
  • Example:

    sudo puppet agent -tv
    labs-vagrant provision
    labs-vagrant list-roles
    labs-vagrant enable-role mobilefrontend
    labs-vagrant provision
    

• Checkout the Barry installer script and run it as sudo.

  • cd ~/
    git clone https://github.com/rmoen/Barry-the-Browser-Test-Bot-Installer install-barry
    cd install-barry
    sudo ./install.sh
    

• The script does the following.
  • Installs npm, nodejs-legacy, phantomjs, ruby, ruby-dev, updates gems, bundler, git-review/
  • Creates a system user account for the testbot and does the following for the new user:
  • Installs Barry-the-Browser-Test-Bot at ~/barrybot and adds to $PATH by editing bashrc
  • Creates a new ssh key for the test bot user. This is required to command Gerrit.
  • Asks for the mediawiki server url (eg: http://reading-smoketest.wmflabs.org)
  • Wwill create the MediaWiki account Mr_Selenium with sysop and bureaucrat
  • Writes the bot configuration in ~/.bashrc
  • Asks for a project name and dependency and creates a run script. Currently configures an extension with a dependency. (eg: Gather and MobileFrontend)
    • Writes the run script to /home/$username/barrybot/run.sh
  • Installs and configures Arcanist for phabricator commands
  • To setup Arcanist, it will ask for your phabricator api token which can be found https://phabricator.wikimedia.org/conduit/login
  • Prints your newly created public key and asks you to add it to https://gerrit.wikimedia.org/r/#/settings/ssh-keys

• Verify the setup completed correctly. If prompted for a username when running `git review` provide the name of the bot. arc command should print a url.

• > echo 'foo' |arc paste
  sudo su username
  > cd /vagrant/mediawiki/extensions/MobileFrontend
  > git review
  

• Run the bot once

• sudo su username
  cd ~/barrybot && ./run.sh
  

• Run the bot indefinitely

• > sudo su localusername
  > script /dev/null
  > screen
  > cd ~/barrybot && ./run.sh &
  > [ctrl + a + d to detach ]