Labs/Jetpack/FlightDeck/Contribution: Difference between revisions

Jump to navigation Jump to search
Line 15: Line 15:
= How to start =
= How to start =


'''Installation process has been changed in the dev version (will change soon in production) please use instructions described here: http://fddoc.zalewa.info/development/installation.html''' I will update this wiki if we will decide to '''not''' use Sphinx as default development documentation system.
''We do work on github, but certainly we don't want to limit the user experience to github only. Feel free to use the server you like the most.''
 
== Installation ==
Based on
[http://erikvold.com/blog/index.cfm/2010/12/13/installing-flightdeck-on-osx Erik's blog]. Aiming to work on any Un*x systems - a few commands may be different - Ubuntu commands are used. I assume if any other distro is used user already knows how to use it.
 
=== Requirements ===
* Python 2.6
* Git
* MySQL
* database `flightdeck-db`, with all privileges granted to `flightdeck-user`
 
=== Prepare the repository ===
* Create github account
* Fork from the official [http://github.com/mozilla/FlightDeck main repository]
 
=== Prepare the system ===
 
'''Install needed dev packages'''
 
sudo apt-get build-dep python-mysqldb libxslt-dev libxml2-dev
sudo easy_install pip
sudo pip install virtualenvwrapper
sudo pip install virtualenv


''We do work on github, but certainly we don't want to limit the user experience to github only. Feel free to use the server you like the most.''
'''Prepare virtual environment'''
 
echo "export WORKON_HOME=~/Envs" > ~/.virtualenvwrapper.sh
echo "source /usr/local/bin/virtualenvwrapper.sh" >> ~/.virtualenvwrapper.sh
# OSX
echo "source ~/.virtualenvwrapper.sh" >> ~/.bash_profile
# Ubuntu
echo "source ~/.virtualenvwrapper.sh" >> ~/.bashrc
source ~/.virtualenvwrapper.sh
mkvirtualenv --no-site-packages flightdeck
 
=== Install repository ===
 
'''Clone'''
git clone https://github.com/{your_github_username}/FlightDeck.git
git remote add main https://github.com/mozilla/FlightDeck.git
git submodule update --init
 
'''Install required software to virtual environment'''
pip install simplejson
pip install mysql-python
cd FlightDeck
pip install -r requirements/development.txt
'''Configure your local settings'''
 
Copy contents of [http://pastebin.mozilla.org/1020232 that file] to ./settings_local.py, change the password to the database.
 
'''Test the configuration'''
 
''The only test which may fail is the authentication against AMO database. To test this bug one needs to be under Mozilla's VPN and have access to AMO database configured in settings_local.py file.''


#Create github account
./manage.py test
#Fork from the official [http://github.com/mozilla/FlightDeck main repository]
#Install FlightDeck on your machine - [http://github.com/mozilla/FlightDeck/blob/master/INSTALL Install instruction] - from your repository, assuming your username is john it is: <pre>git clone git@github.com:john/FlightDeck.git</pre>
#Add main repository to remote repositories <pre>git remote add main git://github.com/mozilla/FlightDeck.git</pre>


= How to commit =
= How to commit =
Confirmed users
514

edits

Navigation menu