AutoQA Development

This page will help you set up an environment for AutoQA development. This guide documents approaches that we have found convenient, but of course you can do anything differently, as you like.

Introduction
When developing tests for AutoQA (or AutoQA itself), there are a few things to consider:
 * some tests may be potentially harmful, you don't want to execute it on your local machine
 * even though most of the tests may be executed manually (without server scheduling), it is often helpful to try them out on the client-server architecture

This guide will therefore help you dive into AutoQA development while using three machines:
 * Local machine
 * the bare metal machine you have in front of you, used for coding (i.e. you have all your favorite IDEs and environment variables)


 * AutoQA server
 * (virtual) machine that will serve as a server or a standalone test execution machine (if something gets broken your local machine is not influenced)


 * AutoQA client
 * (virtual) machine that will serve as a client for your server (useful for testing the scheduler, etc)

Checkout the code
On your local machine, checkout the source code:

$ git clone git://git.fedorahosted.org/autoqa.git

You will do all the coding here, with your favorite tools.

Share the code
In order to have your latest code available also on the AutoQA server and the AutoQA client, you will export your development directory over NFS and mount it on those machines.


 * Install NFS service:
 * 1) yum install nfs-utils
 * 2) chkconfig nfs on

/home/joe/autoqa   *(rw,all_squash,anonuid=500,anongid=500) Replace the path with the correct one, replace UID and GID numbers with your UID and GID numbers, and optionally replace the star with a network subset definition for better security (e.g.  if your server and client are on that network subset).
 * Put the following into :


 * Restart NFS service:
 * 1) service nfs restart

Install AutoQA server

 * Install a machine that you want to use as an AutoQA server. It may be a virtual machine. Then execute all the steps below on that new machine.
 * Install Autotest server according to the guide Install and configure autotest.
 * Mount your shared AutoQA checkout to this machine (adjust the IP address of your local machine and the path):
 * 1) yum install nfs-utils
 * 2) mkdir /autoqa
 * 3) echo "192.168.1.1:/home/joe/autoqa  /autoqa  nfs  defaults,soft,intr  0 0" >> /etc/fstab
 * 4) mount -a
 * Install AutoQA dependencies:
 * 1) cd /autoqa
 * 2) make install-requires
 * Install AutoQA:
 * 1) make clean install
 * 2) service autotestd restart
 * (Optional) Install mock_fedorainfra according to the installation guide (as WSGI application). This will allow you to use fake Bodhi server to send AutoQA results to. Then edit and set   (external URL) and  . Provide some fake FAS credentials in.
 * (Optional) Install and configure Squid for AutoQA

Install AutoQA client

 * Install a machine that you want to use as an AutoQA client. It may be a virtual machine.
 * Register the client with the Autotest server according to the guide How to add autotest clients.

The workflow

 * You do all the coding on your local machine. Nothing is executed there, so you don't have to be afraid about losing your data or anything like that.
 * Any time you want to test some changes on your AutoQA server, you have to log in there and perform the following:
 * 1) cd /autoqa
 * 2) make clean install && service autotestd restart
 * You can use your AutoQA server for local execution of your tests. Just append  to the command (see Writing AutoQA Tests). Don't forget to run   after you do some changes in your code.
 * If you don't append the  option, the test will be scheduled on the AutoQA client.