Metadata-Version: 1.1
Name: vminute
Version: 0.2.32
Summary: A tool for quick creation and deployment of Openstack machines used for QA testing.
Home-page: https://github.com/SatelliteQE/5minute
Author: Martin Korbel
Author-email: mkorbel@redhat.com
License: GNU General Public License v2 (GPLv2)
Description: 5minute
        =======
        
        Give me an instance of mine image on OpenStack. Hurry!
        
        QuickStart
        ----------
        
        Installation
        ~~~~~~~~~~~~
        
        There are several ways of 5minute installation. You pick one of the
        following.
        
        Fedora
        ^^^^^^
        
        5minute package is available in Fedora repository.
        
        ::
        
            dnf install 5minute
        
        Copr repository
        '''''''''''''''
        
        For the latest builds enable Copr repository
        
        ::
        
            dnf copr enable mkorbel/5minute
        
        and install the 5minute.
        
        ::
        
            dnf install 5minute
        
        Manual Installation
        ^^^^^^^^^^^^^^^^^^^
        
        To run 5minute you need to install following libs:
        
        ::
        
            python3-keystoneclient
            python3-cinderclient
            python3-heatclient
            python3-neutronclient
            python3-novaclient
            python3-glanceclient
            python3-xmltodict
            python3-prettytable
        
        To install them as RPMs (Fedora), run
        ``dnf -y install $( cat requirement-rpms.txt )``.
        
        If you have installed 5minute using ``pip install vminute``, they have
        been installed as dependencies. Otherwise, you have to install them
        manually.
        
        Get config file
        ~~~~~~~~~~~~~~~
        
        1. Login into your OpenStack instance WebUI
        2. Navigate to Project -> API Access
        3. Save file from "Download OpenStack RC File" to ~/.5minute/config
        
        Get started
        -----------
        
        Show help:
        
        ::
        
            5minute help
        
        Upload your SSH public key:
        
        ::
        
            5minute key ~/.ssh/id_rsa.pub
        
        Show images we can work with:
        
        ::
        
            5minute images
        
        Boot your machine (consider adding '--name' or '--flavor' to the
        command):
        
        ::
        
            5minute boot <image_name_or_id>
        
        When the boot is finished, you should be able to ssh to your new machine
        
        ::
        
            ssh root@<machine_ip_address>
        
        You can list your current machines:
        
        ::
        
            5minute list
        
        When you are done, kill the machine (you can do this via OpenStack webUI
        as well):
        
        ::
        
            5minute delete <machine_name_or_id>
        
        To list available OpenStack scenarios:
        
        ::
        
            5minute scenario templates
        
        Run scenario:
        
        ::
        
            5minute scenario boot <scenario_template_name>
        
        When finished with the scenario, you should delete it:
        
        ::
        
            5minute scenario delete <scenario_name_or_id>
        
        
Keywords: openstack testing deployment
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Information Technology
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
