Quality/QA-tools/MeeGo Fast Feedback Testing

Revision as of 13:32, 25 December 2010

MeeGo Fast Feedback Testing

MeeGo Fast Feedback Testing (MeeGo-FFT) intends for getting results of source code changing before it is submitted to be built on OBS or to be tested on target HW (e.g. Handset) on OTS.

MeeGo-FFT represents a specific fast reactions on changes in source code manager (e.g. GIT). Fast in this context refers to 2-10 minutes delay. After source code is committed or/and tagged, such actions can be performed:

• building project locally or/and remotely for Intel or/and ARM architectures and creating RPM packets,
• deploying and/or running application on device through SSH connection,
• running Testrunner-lite locally or in host-based mode for testing.

Commits and tags are different source code manager (SCM) states for MeeGo-FFT. It allows to execute different sets of actions with various parameters depending on new commit or new tag. For example, it's possible to build for Intel architecture when new commit appears and for ARM when sources are tagged. For more details see further information about execute condition.

MeeGo Fast Feedback Testing is realized as Hudson plugin, therefore Hudson is needed to be installed on developer workstation as well as QEMU, OSC and Testrunner-lite.

Below is placed instructions about Fast Feedback Testing environment setup for Ubuntu 10.04 and user manual for MeeGo-FFT Hudson plugin.

MeeGo-FFT environment setup

Adding meego tools repository to sources.list

~$ deb http://repo.meego.com/MeeGo/tools/repos/ubuntu/10.04/ /

Install needed keys:

~$ gpg --keyserver subkeys.pgp.net --recv 0BC7BEC479FC1F8A
~$ gpg --export --armor 0BC7BEC479FC1F8A | sudo apt-key add -

Update repository information:

~$ sudo apt-get update

Installing OSC and other needed packages

Run following command:

~$ sudo apt-get install osc meego-osc-plugins build qemu-arm-static

Setting up OSC

OSC is used for local and remote building by means of MeeGo OBS server using packages from specified OBS repository. So it's needed to create empty package in OBS home project.

After that checkout home project somewhere before using Hudson and choose “trust the server certificate permanently”:

~$ osc co home:<osc_username>

Then edit the ~/.oscrc file:

~$ gedit ~/.oscrc

and do these changes:

• uncomment su-wrapper line and specify it to use sudo

su-wrapper = sudo

• fill the "https://api.meego.com" section

user = <your_osc_username>
pass = <your_osc_password>

• mark Trunk:Testing as trusted by appending the following to the end of file

trusted_prj=Trunk:Testing

Disabling sudo password prompt for build

Append the following to the end of the sudoers config file (/etc/sudoers):

<your_username>    ALL=NOPASSWD: /usr/bin/build

Remember to edit sudoers with root rights.

Installing Hudson

~$ wget -O /tmp/key http://hudson-ci.org/debian/hudson-ci.org.key
~$ sudo apt-key add /tmp/key
~$ wget -O /tmp/hudson.deb http://hudson-ci.org/latest/debian/hudson.deb
~$ sudo dpkg --install /tmp/hudson.deb

If hudson didn't installed because not all depended packages are installed you can use next commannd for resolve dependences.

~$ sudo apt-get -f install

Setting up Hudson

Stop the hudson server:

~$ sudo /etc/init.d/hudson stop

Change user for hudson:

~$ gedit /etc/default/hudson
change line: HUDSON_USER=<your_user_name>

Give access rights of hudson home directory to user. It can be done in two ways:

• By changing owner of hudson home directory (by default /var/lib/hudson)

  ~$ sudo chown <your_user_name> /var/lib/hudson/ -R

or

• By changing hudson home location:

  ~$ gedit /etc/default/hudson
  change line: HUDSON_HOME=/home/<your_user_name>/hudson

Start the hudson server:

~$ sudo /etc/init.d/hudson start

Open Hudson in browser:

http://localhost:8080

Add needed plugins to Hudson:

• GIT
• Meego Fast Feedback Testing
• Chuck Norris (optional)

Create new job, choose free-style software project and configure:

• GIT repository URL

Specify local or remote repository with your project.

• Build triggers -> Poll SCM (Schedule for 1 minute polling interval: *****)

Choose poll SCM only if you want to make Hudson checking repository periodically (minimal interval is 1 minute) for new commits. Note that Hudson doesn't detect tags itself.

• Build steps -> Meego FFT

Meego FFT plugin can recognize commits and tags. But it needs to start building manually in Hudson UI. See more details in MeeGo-FFT Hudson plugin manual.

MeeGo-FFT Hudson plugin

This plugin is made in the form of Hudson build step. It's possible to add several instances of Meego FFT. Description of plugin parameters can be found below.

Execute condition

This condition defines the case when current MeeGo-FFT step is executed. If execute condition isn't matched, this MeeGo-FFT step does nothing. There are three possible conditions:

• Always

Whenever build is started, current FFT step is also executed.

• On new commit

Current MeeGo-FFT step will be executed if only new commit is detected in SCM.

• On new tag

Current MeeGo-FFT step will be executed if only new tag is detected in SCM.

It's possible to add several MeeGo-FFT steps with different execute conditions and various build, deploy and test parameters.

Build parameters

These parameters intend for setup building on MeeGo OBS server. OBS allows to build for different architectures locally or remotely against various contents.

OBS repository

Specify name of repository on OBS server that contains needed content. The default is "Trunk_Testing".

OBS package

Specify name of empty auxiliary package on OBS server that will be used for building.

Tar filename

Specify name of tar archive for putting source files to it. This tarball will be used by OBS for building.

Tar directory name

Specify name of directory that will be created in tar archive. Source files from SCM repository will be put in this directory in tar archive.

Spec file

Specify name of spec-file that will be used by OBS for manage building and creating RPM packages.

Build architecture

Choose target build architecture: Intel (i586) or ARM (armv7el).

Build location

Choose location for building: locally on your desktop or remotely on MeeGo OBS server.

Deploy parameters

Setup of deploying and/or running application on device through SSH connection.

Deploy and run application on the device.

Choose to deploy application and run it on device.

File to deploy

Specify application RPM filename to deploy. This RPM will also be installed.

Run command

Specify command(s) that will be executed after deploying and installing RPM package on device. It's possible to specify several commands separated by semicolons.

Test parameters

Setup of running Testrunner-lite for testing.

Run testing

Choose to perform test cases by means of Testrunner-lite.

Execute Testrunner-lite on the remote device

In this mode Testrunner-lite is executed on the target device.

Execute Testrunner-lite on the host-based mode

In this mode Testrunner-lite is executed on the test control PC (host) side.

Test plan filename (XML)

Specify path to test plan XML file. It's possible to set absolute path (example: "/home/user/plan.xml") or relative to workspace (example "plan.xml") if test plan is in SCM repository with other sources.

Connection parameters

These parameters intend for setting up SSH connection to the remote device or local host where application will be deployed and tested.

Device IP address

Specify IP address of the remote device. Also it can be IP address of local host for deploying and testing locally.

SSH username

Specify user name for SSH authentication.

Use password for SSH authentication

Choose using password if there is no SSH public-key authentication on target host. But in this case there is no possibility to use Testrunner-lite for testing in host-based mode.

Password

Specify password for SSH authentication.