{ "info": { "author": "Kevin Carter", "author_email": "kevin.carter@rackspace.com", "bugtrack_url": null, "classifiers": [ "Intended Audience :: Developers", "Intended Audience :: Information Technology", "Intended Audience :: System Administrators", "Operating System :: OS Independent", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Utilities" ], "description": "Transporter\n###########\n:Date: 2012-03-08 16:22\n:Tags: Openstack, Nova Compute, Nova, Glance, Imaging, XenServer\n:Category: \\*nix\n:Author: Kevin Carter\n\n\nCreate an Image from within an Instance\n=======================================\n\nGeneral Overview\n----------------\n\nThis application has been created to work with Openstack if using the XenServer Hypervisor. At this time the code base supports Openstack as a whole, however the application has only been tested on Rackspace Cloud Servers. \n\nOverview:\n---------\n\n*XenOsImager* will create an image from information obtained from within the instance. The application will look at the \"*xenstore*\" data to determine the UUID of the instance, and the region. The user is only required to input their OpenStack API Credentials into a simple configuration file. These credentials are only used to make API calls for image creation.\n\nSimply the application will allow you to create images of instances as a simple automation task; CRON job, on demand, or anythine else you can think of.\n\n\nPrerequisites :\n * Python => 2.6 but < 3.0\n * python-setuptools\n\n\nInstallation is simple :\n\n from Python.org, IE \"pip\"\n\n\n .. code-block:: bash\n\n pip install xenosimager\n\n\n from Github, which is Trunk.\n\n\n .. code-block:: bash\n\n git clone git://github.com/cloudnull/transporter.git\n cd transporter\n python setup.py install\n\n\nSetup is Simple too edit the file \"/etc/xenosimager/config.cfg\" :\n\n .. code-block:: bash\n\n vi /etc/xenosimager/config.cfg\n\n\nIn the previous file, add your credentials. If you feel so inclined, you can also add your mail relay information and the system will send you a message when the images are created or if there are overall issues. \n\n\nAvailable Options in the config file or on the CLI : \n\n\nRequired Variables from CLI\n---------------------------\n\n - ``system-config`` | Where your config file exists\n - ``image-name`` | the name of the image\n\n\nOpenStack Variables\n-------------------\n\n - ``os_user`` | YOU\n - ``os_apikey`` | SuperSecretInformation\n - ``os_auth_url`` | Authentication URL\n - ``os_rax_auth`` | A-LOCATION\n - ``os_verbose`` | True or False\n - ``os_password`` | SuperSecretInformation\n - ``os_tenant`` | UsernameGenerally\n - ``os_region`` | WhereIsThisInstance\n - ``os_version`` | v2.0\n\n\nMail Variables\n--------------\n\n - ``mail-main-contact`` | WhoReadsEmail\n - ``mail_debug`` | True or False\n - ``mail_url`` | AURL\n - ``mail_user`` | Username\n - ``mail_password`` | Password\n - ``mail_cert`` | /location/cert\n - ``mail_key`` | KeyForCert\n - ``mail_tls`` | True or False\n - ``mail_port`` | Port Number\n\n\nHow to use this tool\n--------------------\n\nApplication is simple to use. Simply follow this command and add your own custom name to the end.\n\n .. code-block:: bash\n\n xenosimager --system-config /etc/xenosimager/config.cfg --image-name $NAME_OF_THE_IMAGE\n\n\nLogs are created for all interaction of the imager, and can be found here :\n\n .. code-block:: bash\n\n /var/log/xenosimager.log\n\n\nFor automated image create please have a look at the example.cron.txt file, which is where you can find cron job examples, but with little to no ingenuity I am sure you could figure out other methods for automated command execution.\n\n\nGet Social\n----------\n\n* Downloadable on PyPi_\n* Downloadable on GitHub_\n* See My `GitHub Issues Page`_ for any and all Issues or Feature requests\n\n.. _PyPi: https://pypi.python.org/pypi/transporter\n.. _GitHub: https://github.com/cloudnull/transporter\n.. _GitHub Issues Page: https://github.com/cloudnull/transporter/issues\n\nSee ``https://github.com/cloudnull/transporter/issues`` for Issues or Feature requests\n\n\nLicense\n_______\n\nCopyright [2013] [Kevin Carter]\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/cloudnull/transporter", "keywords": null, "license": "Apache2.0", "maintainer": null, "maintainer_email": null, "name": "xenosimager", "package_url": "https://pypi.org/project/xenosimager/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/xenosimager/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://github.com/cloudnull/transporter" }, "release_url": "https://pypi.org/project/xenosimager/0.004/", "requires_dist": null, "requires_python": null, "summary": "Create an image of a instance from data obtained from within the instance", "version": "0.004" }, "last_serial": 801818, "releases": { "0.002": [ { "comment_text": "", "digests": { "md5": "26880bce496cae73981a264cdfb8d075", "sha256": "f53d79ddf96774f6316d431973960107830bc11427d9264401eefec4be8671e8" }, "downloads": -1, "filename": "xenosimager-0.002.tar.gz", "has_sig": false, "md5_digest": "26880bce496cae73981a264cdfb8d075", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13592, "upload_time": "2013-05-06T19:05:19", "url": "https://files.pythonhosted.org/packages/32/df/7aa6b053fdb49a7d03663693376488859920344bbb423bfe72014641908d/xenosimager-0.002.tar.gz" } ], "0.003": [ { "comment_text": "", "digests": { "md5": "e8d69daacb249308fe118adb3854cbe4", "sha256": "aa493ac36f560ebe88016622c2ec72fcde01522e14b0ddcbb54f3472633ba284" }, "downloads": -1, "filename": "xenosimager-0.003.tar.gz", "has_sig": false, "md5_digest": "e8d69daacb249308fe118adb3854cbe4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14100, "upload_time": "2013-05-08T03:58:18", "url": "https://files.pythonhosted.org/packages/38/71/57738c39c6e09d14e6ef5899ddb12ce4e46a3ecbedf56bd5671bf46ee4d3/xenosimager-0.003.tar.gz" } ], "0.004": [ { "comment_text": "", "digests": { "md5": "51e83e9f529b858029469429cc93a532", "sha256": "4ea325b542f5c09bbf5adb5a50c8caa11d87c0cf6960b276b8b6f5a59c4d052c" }, "downloads": -1, "filename": "xenosimager-0.004.tar.gz", "has_sig": false, "md5_digest": "51e83e9f529b858029469429cc93a532", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14165, "upload_time": "2013-05-10T13:47:08", "url": "https://files.pythonhosted.org/packages/dd/2c/cbc19a2063930284d3cd1618f71afe73b5776032800fab80a02187b62aa8/xenosimager-0.004.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "51e83e9f529b858029469429cc93a532", "sha256": "4ea325b542f5c09bbf5adb5a50c8caa11d87c0cf6960b276b8b6f5a59c4d052c" }, "downloads": -1, "filename": "xenosimager-0.004.tar.gz", "has_sig": false, "md5_digest": "51e83e9f529b858029469429cc93a532", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14165, "upload_time": "2013-05-10T13:47:08", "url": "https://files.pythonhosted.org/packages/dd/2c/cbc19a2063930284d3cd1618f71afe73b5776032800fab80a02187b62aa8/xenosimager-0.004.tar.gz" } ] }