Skip to content
This repository has been archived by the owner. It is now read-only.
Openstack workload migration tool
Python Other
  1. Python 99.0%
  2. Other 1.0%
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
artifacts/alpine_image
cloudferry
cloudferry_devlab
configs
docs
punky_gibbon
scenario
tests
.coveragerc
.gitignore
.pylintrc
.travis.yml
CONTRIBUTING.md
Dockerfile
LICENSE
QUICKSTART.md
README.md
requirements.txt
setup.cfg
setup.py
test-requirements.txt
tox.ini

README.md

CloudFerry

Build Status Coverage Status PyPI version

Overview

CloudFerry is a tool for resources and workloads migration between two OpenStack clouds.

Supported OpenStack Releases

  • Grizzly
  • Icehouse
  • Juno

Objects Supported for Migration

Keystone

  • Tenants
  • User roles

Neutron

  • Networks
    • Private
    • Public
    • Shared
  • Subnets
  • Ports
  • Floating IPs
  • Security groups
  • Routers
  • LBaaS objects
  • Quotas

Glance

  • Images

Cinder

  • Volumes
  • Quotas

Nova

  • VMs
  • VM's ephemeral storage
  • Flavors
  • User quotas
  • Tenant quotas
  • Key pairs

User documentation

End-user documentation is available in docs folder, to compile in HTML run:

sphinx-build docs/ sphinx-build

Requirements

  • Connection to source and destination clouds through external (public) network from host with CloudFerry.
  • Valid private ssh-key for both clouds which will be using by CloudFerry for data transferring.
  • Admin keystone access (typically admin access point lives on 35357 port).
  • sudo/root access on compute and controller nodes.
  • Openstack MySQL DB write access.
  • Credentials of global cloud admin for both clouds.
  • All the Python requirements are listed in requirements.txt.

Installation

CloudFerry can be installed as docker container or it can be installed as a python package by pip.

Installation with pip

  1. Make sure you have non-python packages installed in your system (following for Ubuntu):

    sudo apt-get install libffi-dev libssl-dev libxml2-dev \
        libxslt1-dev python-pip python-dev git -y
    
  2. Install virtualenv version 15.0.3

    sudo pip install virtualenv==15.0.3
    
  3. Install cloudferry with pip:

    virtualenv .venv
    source .venv/bin/activate
    pip install git+git://github.com/Mirantis/CloudFerry.git
    

Installation with docker

Building the docker container

docker build --build-arg cf_commit_or_branch=origin/master -t <username>/cf-in-docker .

Start container

docker run -it <username>/cf-in-docker

Saving and loading the container files

docker save --output=/path/to/save/CloudFerry.img <username>/cf-in-docker
docker load --input=/path/to/save/CloudFerry.img

Usage

Overview

CloudFerry tool is used by running python cloudferry executable from the command line.

All available commands can be viewed with:

# see list of available commands
cloudferry list

Configuration

Sample config can be generated with

oslo-config-generator --namespace cloudferry

Configuration process is quite complex and mostly manual try-and-see-if-works process.

Whole cloud migration

Make sure you have migrate_whole_cloud option in migrate section of config is set to True.

Use migrate command with config file specified:

cloudferry migrate <config file>

Migrating specific instances

In order to migrate specific VMs, one should use filters. This is done through modifying filters file (configs/filter.yaml by default).

Edit configs/filter.yaml:

instances:
    id:
        - 7c53a6ab-0149-4232-80b3-b2d7ce02995a
        - f0fea76a-0a7d-4c25-ab9e-f048dbc7365d

Run migration as usual:

cloudferry migrate configuration.ini --debug

Playground

See QUICKSTART.md for the quickest way of running your first successful migration.

You can’t perform that action at this time.