{
    "info": {
        "author": "Inktank Storage, Inc.",
        "author_email": "ceph-qa@ceph.com",
        "bugtrack_url": null,
        "classifiers": [
            "Intended Audience :: Developers",
            "Intended Audience :: Information Technology",
            "License :: OSI Approved :: MIT License",
            "Natural Language :: English",
            "Operating System :: POSIX :: Linux",
            "Programming Language :: Python :: 2.7"
        ],
        "description": "==========================================================\n Downburst -- fast Ubuntu Cloud image creation on libvirt\n==========================================================\n\nDownburst is a tool for quickly creating virtual machines on\nlibvirt. It uses Ubuntu's Cloud Images and qcow2 copy-on-write clones\nto make a VM creation practically instantaneous, customizing them at\nboot time with cloud-init.\n\nFor more information on Ubuntu Cloud Images, please refer to:\n\n- https://cloud.ubuntu.com/\n- https://help.ubuntu.com/community/UEC/Images\n- https://help.ubuntu.com/community/CloudInit\n- https://cloud-images.ubuntu.com/\n\n\nInstallation\n============\n\nYou can install Downburst like any other Python package, but it also\ncomes with a convenient bootstrap script that sets it up in a virtual\nenvironment under the source directory. Just run::\n\n\tgit clone https://github.com/ceph/downburst.git\n\tcd downburst\n\t./bootstrap\n\nAnd from there on, use::\n\n\t./virtualenv/bin/downburst ARGS..\n\nYou can also symlink that to e.g. ``~/bin/``.\n\n\nUsage\n=====\n\nYou need to give a unique name to your vm. This will become the\nhostname of the vm, and the libvirt domain name. Run::\n\n\tdownburst -C URI create NAME\n\nIf this tool is not being used for an Inktank machine or an Inktank employee\nthen you should pass the --nokey option to not install the default inktank\nssh key to the created guest's authorized_hosts file.\n\n        downburst -C URI create NAME --nokey\n\nThe URI is the alias set in uri_aliases in ~/.config/libvirt/libvirt.conf. Example::\n\n    uri_aliases = [\n        'vercoi01=qemu+ssh://ubuntu@vercoi01.front.sepia.ceph.com/system?no_tty=1',\n        'vercoi02=qemu+ssh://ubuntu@vercoi02.front.sepia.ceph.com/system?no_tty=1',\n        'vercoi03=qemu+ssh://ubuntu@vercoi03.front.sepia.ceph.com/system?no_tty=1',\n        'vercoi04=qemu+ssh://ubuntu@vercoi04.front.sepia.ceph.com/system?no_tty=1',\n        'vercoi05=qemu+ssh://ubuntu@vercoi05.front.sepia.ceph.com/system?no_tty=1',\n        'vercoi06=qemu+ssh://ubuntu@vercoi06.front.sepia.ceph.com/system?no_tty=1',\n        'vercoi07=qemu+ssh://ubuntu@vercoi07.front.sepia.ceph.com/system?no_tty=1',\n        'vercoi08=qemu+ssh://ubuntu@vercoi08.front.sepia.ceph.com/system?no_tty=1',\n        'senta01=qemu+ssh://ubuntu@senta01.front.sepia.ceph.com/system?no_tty=1',\n        'senta02=qemu+ssh://ubuntu@senta02.front.sepia.ceph.com/system?no_tty=1',\n        'senta03=qemu+ssh://ubuntu@senta03.front.sepia.ceph.com/system?no_tty=1',\n        'senta04=qemu+ssh://ubuntu@senta04.front.sepia.ceph.com/system?no_tty=1',\n        ]\n\n\nYou can delete a guest with (use caution)::\n\n        downburst -c URI destroy NAME\n\nBy default, your local SSH public key (grabbed from\n``~/.ssh/id_rsa.pub``) is authorized to log in as ``ubuntu``.\n\nYou can also pass in EC2-style ``meta-data`` and ``user-data``\nsnippets; if you repeat the argument, the files will be merged::\n\n\tdownburst create --meta-data=FILE.meta.yaml \\\n\t  --user-data=FILE.user.yaml NAME\n\nSee ``doc/examples/`` for ideas on meta-data and user-data usage, and\nexplore the Ubuntu links above.\n\nValid Downburst options in meta yaml with their defaults if undefined:\n\ndisk-size:      (disk space)\n                Default 10G. Example: 20G\nadditional-disks:   (number of additional drives for the guest)\n                Default 0. Example: 5 (for 5 additional drives)\nadditional-disks-size:  (Size of the additional disks)\n                Default 10G. Example: 100G\nram:           (ram amount)\n                Default 512M. Example: 2G\ncpu:           (cpu/core count)\n                Default 1. Example 4\nnetworks:      (what nics/networks/mac addresses)::\n                Default Nat. Example:\n                    - source: front\n                      mac: 52:54:00:5a:aa:ee\ndistro:        (distro type)\n                Default ubuntu. Example centos\ndistroversion: (distro version)\n                Default (if ubuntu) \"12.04\". Example \"12.10\"\narch:          (Image architecture)\n                Default \"amd64, can be \"i386\" or \"amd64/x86_64\"\n\n\nDistro/distroversion/arch can also be set during command line creation with --distro=value or --distroversion=value or --arch=value\n\nAll available distributions/versions can be listed by running:\n\n        downburst list\n\nStatic SSH key generation\n=========================\n\nDownburst also includes a utility to create static SSH keys, for when\nyou want to delete and recreate the vm repeatedly, but not have SSH\ncomplain all the time.\n\nTo set it up, run this once::\n\n\tdownburst gen-ssh-key >NAME.user.yaml\n\nAnd from there on, recreate the vm (after deleting it) with::\n\n\tdownburst create --user-data=NAME.user.yaml NAME",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "UNKNOWN",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/ceph/downburst",
        "keywords": "libvirt virtualization",
        "license": "MIT",
        "maintainer": null,
        "maintainer_email": null,
        "name": "downburst",
        "package_url": "https://pypi.org/project/downburst/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/downburst/",
        "project_urls": {
            "Download": "UNKNOWN",
            "Homepage": "https://github.com/ceph/downburst"
        },
        "release_url": "https://pypi.org/project/downburst/0.0.1/",
        "requires_dist": null,
        "requires_python": null,
        "summary": "Run Cloud images on libvirt virtual machines",
        "version": "0.0.1"
    },
    "last_serial": 1205794,
    "releases": {
        "0.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "38f18f169f447bc9ca58dc85a2bf8120",
                    "sha256": "5249ac787ab047a0db2572aebe46bbbc71349a32bb9941bb8d2aaea71b68b480"
                },
                "downloads": -1,
                "filename": "downburst-0.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "38f18f169f447bc9ca58dc85a2bf8120",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 17112,
                "upload_time": "2014-08-28T21:42:54",
                "url": "https://files.pythonhosted.org/packages/57/4c/a3e7f995e1604cf9954d1f7148c636db6cb7612dc76ffb6b4878f2444db3/downburst-0.0.1.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "38f18f169f447bc9ca58dc85a2bf8120",
                "sha256": "5249ac787ab047a0db2572aebe46bbbc71349a32bb9941bb8d2aaea71b68b480"
            },
            "downloads": -1,
            "filename": "downburst-0.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "38f18f169f447bc9ca58dc85a2bf8120",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 17112,
            "upload_time": "2014-08-28T21:42:54",
            "url": "https://files.pythonhosted.org/packages/57/4c/a3e7f995e1604cf9954d1f7148c636db6cb7612dc76ffb6b4878f2444db3/downburst-0.0.1.tar.gz"
        }
    ]
}