RETIRED, Fuel DevOps tools for managing virtual environments
Go to file
Jenkins cdcfc40d36 Merge "Bump fuel-devops version up to 2.9.22" into release/2.9 2016-07-22 14:07:15 +00:00
bin Scripts for export and import systest environments 2016-04-28 14:26:29 +03:00
devops Merge "Bump fuel-devops version up to 2.9.22" into release/2.9 2016-07-22 14:07:15 +00:00
docs Bump fuel-devops version up to 2.9.22 2016-07-22 13:44:06 +03:00
samples Replace ipaddr by netaddr 2016-03-31 09:24:20 +00:00
.coveragerc SSHClient rework for SSH Manager integration 2016-07-04 10:09:35 +03:00
.gitignore .gitignore: ignore Vim swp files 2016-06-14 14:31:02 +00:00
.gitreview Update .gitreview for new namespace 2015-10-17 22:13:18 +00:00
LICENSE LICENCE added 2014-06-05 00:40:36 +04:00
MAINTAINERS Fix MAINTAINERS file to proper format 2015-12-31 13:18:54 +03:00
README.md Update Readme.md with usage and install info 2015-12-08 13:11:58 +02:00
run_tests.sh Cleanup in running pep8 tests 2015-06-08 07:57:13 +00:00
setup.py Bump fuel-devops version up to 2.9.22 2016-07-22 13:44:06 +03:00
test-requirements.txt Relax factory-boy requirement to >= 2.4.1 2015-10-01 19:19:23 +00:00
tox.ini SSHClient rework for SSH Manager integration: part 1 2016-07-04 10:09:26 +03:00

README.md

fuel-devops

Fuel-Devops is a sublayer between application and target environment(all of supported by libvirt currently).

This application is used for testing purposes like grouping virtual machines to environments, booting KVM VM's locally from the ISO image and over the network via PXE, creating, snapshotting and resuming back the whole environment in single action, create virtual machines with multiple NICs, multiple hard drives and many other customizations with a few lines of code in system tests.

Installation

The installation procedure can be implemented via PyPI in Python virtual environment (suppose you are using Ubuntu 12.04 or Ubuntu 14.04):

Before using it, please install the following required dependencies:

sudo apt-get install git \
postgresql \
postgresql-server-dev-all \
libyaml-dev \
libffi-dev \
python-dev \
python-libvirt \
python-pip \
qemu-kvm \
qemu-utils \
libvirt-bin \
libvirt-dev \
ubuntu-vm-builder \
bridge-utils

sudo apt-get update && sudo apt-get upgrade -y

Install packages needed for building python eggs

sudo apt-get install python-virtualenv libpq-dev libgmp-dev

In case you are using Ubuntu 12.04 lets update pip and virtualenv, otherwise you can skip this step

sudo pip install pip virtualenv --upgrade
hash -r

Create virtualenv for the devops project

virtualenv --system-site-packages <path>/fuel-devops-venv

Note

Activate virtualenv and install devops package using PyPI.

source  <path>/fuel-devops-venv/bin/activate
pip install git+https://github.com/openstack/fuel-devops.git@<version> --upgrade

Configuration

Basically fuel-devops requires that the following system-wide settings are configured:

  • Default libvirt storage pool is active (called default)
  • Current user must have permission to run KVM VMs with libvirt
  • PostgreSQL server running with appropriate grants and schema for devops
  • [Optional] Nested Paging is enabled
  • [Optional] Network filter for host bridges should be disabled: http://wiki.libvirt.org/page/Net.bridge-nf-call_and_sysctl.conf.

Usage

Run dos.py -h to see full list of supported actions

Operation commands:
list                Show virtual environments
show                Show VMs in environment
erase               Delete environment
start               Start VMs
destroy             Destroy(stop) VMs
suspend             Suspend VMs
resume              Resume VMs
revert              Apply snapshot to environment
snapshot            Make environment snapshot
sync                Synchronization environment and devops
snapshot-list       Show snapshots in environment
snapshot-delete     Delete snapshot from environment
net-list            Show networks in environment
time-sync           Sync time on all env nodes
revert-resume       Revert, resume, sync time on VMs
version             Show devops version
create              Create a new environment
slave-add           Add a node
slave-change        Change node VCPU and memory config
slave-remove        Remove node from environment
admin-setup         Setup admin node
admin-change        Change admin node VCPU and memory config
node-start          Start node in environment
node-destroy        Destroy (power off) node in environment
node-reset          Reset (restart) node in environment

Use dos.py -h to see help for specific command

positional arguments:
ENV_NAME              environment name

optional arguments:
-h, --help            show this help message and exit
--vcpu VCPU_COUNT     Set node VCPU count
--node-count NODE_COUNT, -C NODE_COUNT
                    How many nodes will be created
--ram RAM_SIZE        Set node RAM size
--net-pool NET_POOL, -P NET_POOL
                    Set ip network pool (cidr)
--iso-path ISO_PATH, -I ISO_PATH
                    Set Fuel ISO path
...

Testing

There are next test targets that can be run to validate the code.

tox -e pep8 - style guidelines enforcement
tox -e py27 - unit and integration testing