114 lines
3.9 KiB
Markdown
114 lines
3.9 KiB
Markdown
NAILGUN
|
|
=======
|
|
|
|
How to run Nailgun app from fixtures
|
|
------------------------------------
|
|
Install application dependencies (eggs):
|
|
|
|
cd scripts/ci/
|
|
sudo easy_install pip
|
|
sudo chef-solo -c solo.rb -j solo.json
|
|
cd -
|
|
|
|
Remove old DB:
|
|
|
|
cd nailgun
|
|
rm -f nailgun.sqlite
|
|
|
|
Sync DB:
|
|
|
|
./manage.py syncdb --noinput
|
|
|
|
Load data from fixtures:
|
|
|
|
./manage.py loaddata sample_environment
|
|
|
|
Run application:
|
|
|
|
./manage.py runserver
|
|
|
|
Access Web UI at http://localhost:8000/
|
|
|
|
|
|
Deploying virtual environment
|
|
-----------------------------
|
|
|
|
**Using vagrant:**
|
|
|
|
**Note:** uncomment *config.vm.forward_port 8000, 8000* in Vagrantfile for working with django webui.
|
|
|
|
For VM deployment run:
|
|
`vagrant up ubuntu_testbed`
|
|
|
|
The working directory is /vagrant.
|
|
|
|
**W/O vagrant:**
|
|
|
|
**Installing chef** ([source](http://wiki.opscode.com/display/chef/Installing+Chef+Server+on+Debian+or+Ubuntu+using+Packages "Opscode Wiki")):
|
|
|
|
``~$ echo "deb http://apt.opscode.com/ `lsb_release -cs`-0.10 main" | sudo tee /etc/apt/sources.list.d/opscode.list ``
|
|
|
|
``~$ sudo mkdir -p /etc/apt/trusted.gpg.d``
|
|
|
|
``~$ gpg --keyserver keys.gnupg.net --recv-keys 83EF826A``
|
|
|
|
``~$ gpg --export packages@opscode.com | sudo tee /etc/apt/trusted.gpg.d/opscode-keyring.gpg > /dev/null ``
|
|
|
|
``~$ sudo apt-get update && sudo apt-get install opscode-keyring ``
|
|
|
|
``~$ sudo apt-get install chef``
|
|
|
|
**Installing dependencies**
|
|
|
|
``~$ cd scripts/ci && chef-solo -l debug -c solo.rb -j solo.json ``
|
|
|
|
Testing
|
|
-------
|
|
|
|
**Nailgun:**
|
|
|
|
Unit tests: *make test-unit* or *nailgun/run_tests.sh*
|
|
Integration tests: *make test-integration*
|
|
|
|
Layout
|
|
------
|
|
|
|
Makefile - the global product makefile
|
|
Vagrantfile - for the vagrant dev vms
|
|
bin/
|
|
create_release - upload a release json file to nailgun (see e.g. scripts/ci/sample-release.json)
|
|
deploy - invoked on a node to deploy; downloads and executes recipes
|
|
install_cookbook - uploads cookbooks to nailgun admin API
|
|
binaries/ - submodule for binaries such as packages and ISO-files
|
|
bootstrap/ - creating a bootstrap image (aka crowbar sledgehammer) for nodes (initrd, configuration files, packages etc) It needed to be refactored to use clear make without calling additional shell scripts.
|
|
cookbooks/ - chef cookbooks to install Nailgun application
|
|
agent/ - node agent. Sends ohai data to admin node.
|
|
nailgun/ - nailgun server (not slave node!)
|
|
others obvious
|
|
cooks/ - submodule with Cookbooks to be loaded in Nailgun app. OpenStack cookbooks will be here.
|
|
devops/ - Mirantis CI framework, used by integration tests (./test/integration/). Installed on the master, not slave.
|
|
gnupg/
|
|
iso/ - creating a main iso to install admin node
|
|
nailgun/ - server
|
|
manage.py, run_tests.sh - django standard
|
|
monitor.py - restart server when django conf files change
|
|
nailgun/ - django app
|
|
apps: nailgun.api at api/, nailgun.webui (fully static) at /
|
|
models: recipe, role, release, node, cluster
|
|
tasks.py - django-celery tasks submitted from api/handlers.py: deploy cluster [sub: deploy node]
|
|
MOST IMPORTANT TASK: deploy_cluster
|
|
Create databags for nodes
|
|
Provision node with Cobbler
|
|
ssh node and call /opt/nailgun/bin/deploy
|
|
api/ - nailgun.api django app; JSON API
|
|
main entities in REST API: task, recipe/release/role, node, cluster
|
|
|
|
scripts/
|
|
agent/ - development scripts to test agent cookbook
|
|
ci/ - scripts for CI, sample-cook - cookbook for testing
|
|
test/ - integration tests [TODO figure out more]
|
|
vagrant/ - cookbooks for use by the vagrant vm
|
|
requirements-deb.txt - debian packages needed for Ubuntu slave node repository
|
|
requirements-rpm.txt - debian packages needed for CentOS slave node repository
|
|
rules.mk - it is just some make macroses
|