{
"info": {
"author": "ASI Uniovi",
"author_email": "jldiaz@uniovi.es",
"bugtrack_url": null,
"classifiers": [
"Development Status :: 3 - Alpha",
"Intended Audience :: Science/Research",
"License :: OSI Approved :: MIT License",
"Natural Language :: English",
"Programming Language :: Python :: 3.6",
"Programming Language :: Python :: 3.7"
],
"description": "# Malloovia\n\n[![](\"https://img.shields.io/badge/python-)
=3.6-blue.svg?style=flat-square\">](https://www.python.org/downloads/) [![](\"https://img.shields.io/pypi/v/malloovia.svg\")
](https://pypi.python.org/pypi/malloovia) [![\"Documentation](\"http://readthedocs.org/projects/malloovia/badge/?version=latest\")
](http://malloovia.readthedocs.io/en/latest/?badge=latest) [![\"](\"https://travis-ci.org/asi-uniovi/malloovia.svg?branch=master\")
](https://travis-ci.org/asi-uniovi/malloovia)\n\n\nUse linear programming to allocate applications to cloud infrastructure.\n\n\n* Free software: MIT license\n* Documentation: https://malloovia.readthedocs.io.\n\n\n## Introduction\n\nMalloovia is a Python package to solve virtual machine (VM) allocation problems in Infrastructure as a Service (IaaS) clouds from the point of view of the cloud customer. It was first presented in the paper [\"Cost Minimization of Virtual Machine Allocation in Public Clouds Considering Multiple Applications\"](http://www.atc.uniovi.es/personal/joaquin-entrialgo/pdfs/Entrialgo2017-gecon.pdf) presented at [GECON 2017](http://2017.gecon-conference.org/).\n\nThe problem to solve is: given a cloud infrastructure composed of different virtual machine types, each one with its own hardware characteristics, and prices, some of them with different pricing schemas, such as discounts for reservation over long periods, and given a set of applications to run on that infrastructure, each one with a different performance on each different VM type, and with a different workload over time, find the number of VMs of each type to activate at each timeslot for each application, so that the expected workload is fulfilled for all applications, the cloud provider limits are not exceeded and the total cost is minimized.\n\nIt works in two phases: first, it computes the number of reserved VMs using a Long Term Workload Prediction (LTWP) and then, it computes the number of on-demand for each time slot using a Short Term Workload Prediction (STWP).\n\nMalloovia can be directly used in Python or by a [CLI interface](https://malloovia.readthedocs.io/en/latest/cli.html#cli). The problems and the solutions can be saved using a [YAML format](https://malloovia.readthedocs.io/en/latest/yaml.html).\n\nThis is an example that assumes that the problem definition is in `problems.yaml`, with `problem1` describing the LTWP and `problem2` describing the STWP:\n\n```\n$ malloovia solve problems.yaml --phase-i-id=problem1 --phase-ii-id=problem2\nReading problems.yaml...(0.004s)\nSolving phase I...(0.020s)\nSolving Phase II |\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588| 100.0% - ETA: 0:00:00\n(0.101s)\nWriting solutions in problems-sol.yaml...(0.006s)\n```\n\nThis is an example in Python (explained in more detail in the [Usage section of the documentation](https://malloovia.readthedocs.io/en/latest/usage.html)):\n\n```python\nfrom malloovia import *\n\n# Infrastructure definition\nregion1 = LimitingSet(\"r1\", name=\"us.east\", max_vms=20)\nzone1 = LimitingSet(\"r1_z1\", name=\"us.east_a\", max_vms=20)\nm3large_z1 = InstanceClass(\n \"m3large_r1_z1\", name=\"reserved m3.large in us.east_a\",\n limiting_sets=(zone1,), is_reserved=True,\n price=7, max_vms=20)\nm4xlarge_r1 = InstanceClass(\n \"m4xlarge_r1\", name=\"ondemand m4.xlarge in us.east\",\n limiting_sets=(region1,), is_reserved=False,\n price=10, max_vms=10)\n\n# Performances\napp0 = App(\"a0\", \"Web server\")\napp1 = App(\"a1\", \"Database\")\nperformances = PerformanceSet(\n id=\"example_perfs\",\n values=PerformanceValues({\n m3large_z1: {app0: 12, app1: 500},\n m4xlarge_r1: {app0: 44, app1: 1800}\n })\n)\n\n# Workload\n\n# Long term workload prediction of each app, for Phase I\nltwp_app0 = Workload(\n \"ltwp0\", description=\"rph to the web server\", app=app0,\n values=(201, 203, 180, 220, 190, 211, 199, 204, 500, 200)\n)\nltwp_app1 = Workload(\n \"ltwp1\", description=\"rph to the database\", app=app1,\n values=(2010, 2035, 1807, 2202, 1910, 2110, 1985, 2033, 5050, 1992)\n)\n\n# Building the problem for phase I and solving\nproblem = Problem(\n id=\"example1\",\n name=\"Example problem\",\n workloads=(ltwp_app0, ltwp_app1),\n instance_classes=(m3large_z1, m4xlarge_r1),\n performances=performances\n)\n\nphase_i_solution = PhaseI(problem).solve()\n\n# Building the problem for a timeslot in phase II and solving\nphase_ii = PhaseII(problem, phase_i_solution)\ntimeslot_solution = phase_ii.solve_timeslot(\n workloads=(Workload(\"stwp0\", app=app0, description=None, values=(315,)),\n Workload(\"stwp1\", app=app1, description=None, values=(1950,))\n )\n )\n\n# Showing the cost and the allocation\nprint(\"Cost:\", timeslot_solution.solving_stats.optimal_cost)\nprint(timeslot_solution.allocation._inspect())\n```\n\nYou can find example problems and solutions in YAML format in the [test data directory](https://github.com/asi-uniovi/malloovia/tree/master/tests/test_data/valid) and in the [GECON 2017 data repository](https://github.com/asi-uniovi/malloovia-data-gecon2017), where you can find [a notebook](https://github.com/asi-uniovi/malloovia-data-gecon2017/blob/master/Malloovia-Gecon2017-data.ipynb) that shows how to compute the solutions from the problems.\n\nPlease, refer to [the documentation](https://malloovia.readthedocs.io/) and the he paper [\"Cost Minimization of Virtual Machine Allocation in Public Clouds Considering Multiple Applications\"](http://www.atc.uniovi.es/personal/joaquin-entrialgo/pdfs/Entrialgo2017-gecon.pdf) for more details.\n\nHistory\n=======\n\n0.1.0 (2017-07-24)\n------------------\n\n* First release on PyPI.\n\n0.2.0 (2017-07-27)\n------------------\n\n* `from malloovia import *` imports all relevant classes and methods.\n* `read_problems_from_github()` added.\n* Integration with Travis-CI and ReadTheDocs.\n* Working on the documentation.\n* Modified YAML schema of the Solutions.\n\n0.3.0 (2017-07-31)\n------------------\n\n* Much improved documentation. Windows installation covered.\n* Command-line interface\n* Changed from PyYAML to ruamel.yaml, much faster\n* Read from YAML now accepts gzipped files too\n* Some bugs fixed in the schema\n\n1.0.0 (2017-11-01)\n------------------\n\n* Incompatible API change: it is required to specify ``time_unit`` in\n ``InstanceClass``, ``PerformanceSet`` and ``Workload`` classes, in order to\n clarify the time unit for price, performance and workload timeslots.\n* Added utility function to read solutions from yaml files.\n* Revised documentation and code quality. Improved README for github.\n* Minor bugfixes.\n\n1.0.1 (2018-01-12)\n------------------\n\n* Bugfix to make all malloovia classes pickable, allowing for multiprocessing.\n\n1.1.0 (2018-03-16)\n------------------\n\n* New class ``PhaseIIGuided`` which allows to solve a single timeslot using\n a given allocation which specifies the minimum number of VMs to keep running.\n\n2.1.1 (2019-06-20)\n------------------\n\n* Internal refactorization of Malloovia Model's classes, which are now based\n on ``typing.NamedTuple`` instead of ``collections.namedtuple```, which\n allows for proper type checking and documentation of the fields.\n* Several typing bugs related to YAML export and import fixed.\n* This version introduces backwards incompatibility, since it requires\n python 3.6+ to run. However the API and usage is the same.\n\n\n",
"description_content_type": "text/markdown; charset=UTF-8; variant=GFM",
"docs_url": null,
"download_url": "",
"downloads": {
"last_day": -1,
"last_month": -1,
"last_week": -1
},
"home_page": "https://github.com/asi-uniovi/malloovia",
"keywords": "malloovia",
"license": "MIT license",
"maintainer": "",
"maintainer_email": "",
"name": "malloovia",
"package_url": "https://pypi.org/project/malloovia/",
"platform": "",
"project_url": "https://pypi.org/project/malloovia/",
"project_urls": {
"Homepage": "https://github.com/asi-uniovi/malloovia"
},
"release_url": "https://pypi.org/project/malloovia/2.1.2/",
"requires_dist": [
"ruamel.yaml",
"jsonschema",
"pulp",
"click",
"progress"
],
"requires_python": ">=3.6",
"summary": "Use linear programming to allocate applications to cloud infrastructure",
"version": "2.1.2"
},
"last_serial": 5429919,
"releases": {
"0.1.0": [
{
"comment_text": "",
"digests": {
"md5": "8df528fc71d591375b34112b5dc7f6f7",
"sha256": "aae69dc0fdc28a5eada1eece801f46c1c15a2900e6d2c39b4d06296cf82944ab"
},
"downloads": -1,
"filename": "malloovia-0.1.0-py3-none-any.whl",
"has_sig": true,
"md5_digest": "8df528fc71d591375b34112b5dc7f6f7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 32243,
"upload_time": "2017-07-27T15:01:56",
"url": "https://files.pythonhosted.org/packages/fa/92/85325f2f960e9b127cec24e8e6698549eb3fbc3f2ea6c07887fd60df53ea/malloovia-0.1.0-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "e4902bb0365dda593f4fada4e0b49374",
"sha256": "9131b6ede8b18e49b14d903e24596908af3a3ff09fca4dc86c01566a3a23ca63"
},
"downloads": -1,
"filename": "malloovia-0.1.0.tar.gz",
"has_sig": true,
"md5_digest": "e4902bb0365dda593f4fada4e0b49374",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 152792,
"upload_time": "2017-07-27T15:01:58",
"url": "https://files.pythonhosted.org/packages/b1/76/db12f3e8765706a0cf1ed233164383388b0426caa334a62602cfc954dfc8/malloovia-0.1.0.tar.gz"
}
],
"0.2.0": [
{
"comment_text": "",
"digests": {
"md5": "19345c1366ee6c1ddd3def14ae610f00",
"sha256": "a3321017874b5505a4fc855c4f8ccd30669e6fffb5aa7b6497b7a7325de462e1"
},
"downloads": -1,
"filename": "malloovia-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "19345c1366ee6c1ddd3def14ae610f00",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 31812,
"upload_time": "2017-07-27T20:31:54",
"url": "https://files.pythonhosted.org/packages/f4/3e/bc4a470759e22b8700c85b35cfedde76b16fa51c0fccea34cf313e297446/malloovia-0.2.0-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "9b21ba152ee52c585100043b0388fab4",
"sha256": "e54c3ed02fdbdebb7664f5f93cae41b1ca1e41b255212895eff4a658173f0bc5"
},
"downloads": -1,
"filename": "malloovia-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "9b21ba152ee52c585100043b0388fab4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 153959,
"upload_time": "2017-07-27T20:31:56",
"url": "https://files.pythonhosted.org/packages/5f/47/f8a37a309296bedff98fc55af53f7fad9262ddf98617ae63da7889c86c49/malloovia-0.2.0.tar.gz"
}
],
"0.3.0": [
{
"comment_text": "",
"digests": {
"md5": "ea2c18900e986d93a7e4776001b0350b",
"sha256": "5433eca8b1f9905834dd2de572056f7e70d07aa49136be1b98939c9e4e6b05f5"
},
"downloads": -1,
"filename": "malloovia-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ea2c18900e986d93a7e4776001b0350b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 36301,
"upload_time": "2017-07-31T19:30:41",
"url": "https://files.pythonhosted.org/packages/9b/3b/434fdfa43b27c5ddaf5dc971e5c1026a430b0944a58cf4776afae1c423bf/malloovia-0.3.0-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "87877e1a00202e1d6eeb4b0f34f0d417",
"sha256": "dbf13ab3da0720a3e99b46be3f909a6fb1d358e434aed7cc586fc3ce8b81ae5a"
},
"downloads": -1,
"filename": "malloovia-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "87877e1a00202e1d6eeb4b0f34f0d417",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 169186,
"upload_time": "2017-07-31T19:30:45",
"url": "https://files.pythonhosted.org/packages/79/26/765631083e744c75e5e495ac498db3b588d1e07d3f18f18db7f1f49faf98/malloovia-0.3.0.tar.gz"
}
],
"1.0.0": [
{
"comment_text": "",
"digests": {
"md5": "931f45bdbf15548b7ee89a0af20bac07",
"sha256": "74093acbf72a2bc1414763cde0050f9ca60f7146b1716c96843b48c64f3cedf2"
},
"downloads": -1,
"filename": "malloovia-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "931f45bdbf15548b7ee89a0af20bac07",
"packagetype": "bdist_wheel",
"python_version": "3.5",
"requires_python": null,
"size": 42289,
"upload_time": "2017-10-31T12:32:12",
"url": "https://files.pythonhosted.org/packages/82/5a/a5d57daa0f1ef6e5ea3acb06a28b174613faf0aa52ee3231d183d31e7966/malloovia-1.0.0-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "4d5b4221e85d98ae90aca097e5e3f8a9",
"sha256": "007c81c36b622707a03dcfa2658097923f018de1b86b52aafabc9f5fe9bf592c"
},
"downloads": -1,
"filename": "malloovia-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "4d5b4221e85d98ae90aca097e5e3f8a9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 171467,
"upload_time": "2017-10-31T12:31:27",
"url": "https://files.pythonhosted.org/packages/ee/ac/b3e60f4d5549117b7cfebc41747c482ffafbe0a3fdcccd924ab14abbd08f/malloovia-1.0.0.tar.gz"
}
],
"1.0.1": [
{
"comment_text": "",
"digests": {
"md5": "2519dda3e188e440eb0955f3fdcf9715",
"sha256": "dad6cef8c2b494c48d31b92020fefaec5f5b520a9964c67b54d78877e032ce57"
},
"downloads": -1,
"filename": "malloovia-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2519dda3e188e440eb0955f3fdcf9715",
"packagetype": "bdist_wheel",
"python_version": "3.5",
"requires_python": null,
"size": 42562,
"upload_time": "2018-01-12T17:56:38",
"url": "https://files.pythonhosted.org/packages/af/c0/f7a3b6b9f95626c29d5c17d37b142f2e8212eeb50ba8d0865fcf3aede650/malloovia-1.0.1-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "83abe88e53413200be3c883f039a6c15",
"sha256": "b4de55672ebc38e93a909c247f73f33d0d87f6d660c50c4bb6031b150d8d0886"
},
"downloads": -1,
"filename": "malloovia-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "83abe88e53413200be3c883f039a6c15",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 171697,
"upload_time": "2018-01-12T17:56:32",
"url": "https://files.pythonhosted.org/packages/f2/ce/3dd2d5ebf9bb60d883aa2fe595ece48c021059c563f2b413563f34b130f2/malloovia-1.0.1.tar.gz"
}
],
"1.1.0": [
{
"comment_text": "",
"digests": {
"md5": "9fde471e6ffdfb9bf76b526f66ca8488",
"sha256": "d7b695602e0a2f7b926a2a8a10d3873b772b6ac68231998247762cf1d8b6207a"
},
"downloads": -1,
"filename": "malloovia-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9fde471e6ffdfb9bf76b526f66ca8488",
"packagetype": "bdist_wheel",
"python_version": "3.5",
"requires_python": null,
"size": 43181,
"upload_time": "2018-03-16T22:35:47",
"url": "https://files.pythonhosted.org/packages/67/83/1c26c9309b5aa6be7e70146e9c388b9d507b012de48af741c1226349df32/malloovia-1.1.0-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "d63fc00826e9736bb72ed6db72e42e4d",
"sha256": "c231cdef67077fa0dd4c3adae2600c8cf9c7a7234323209af3adce2415246027"
},
"downloads": -1,
"filename": "malloovia-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "d63fc00826e9736bb72ed6db72e42e4d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 172389,
"upload_time": "2018-03-16T22:35:41",
"url": "https://files.pythonhosted.org/packages/6b/92/030c80158f7ab19ccf5dbc3beb24e5f3d9b8d17326e9edce51679f8b250b/malloovia-1.1.0.tar.gz"
}
],
"2.1.2": [
{
"comment_text": "",
"digests": {
"md5": "08349cff13381e028dc36cd85ce8b2b5",
"sha256": "9f7f6fb087db2c575f907891be56e1f9baf5dd3ded9bb63f68826d74fb6ed638"
},
"downloads": -1,
"filename": "malloovia-2.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "08349cff13381e028dc36cd85ce8b2b5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 41689,
"upload_time": "2019-06-21T09:15:28",
"url": "https://files.pythonhosted.org/packages/46/88/8fbb690e1e7b256fa7d80589418564117dc12a833953a72fe96ffbf4ae25/malloovia-2.1.2-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "dbb73c231e989dcdf69b5824c6fdc680",
"sha256": "a427c744000d200c5da88ffd61269bb1116d8156c2b3973252541f449d89a571"
},
"downloads": -1,
"filename": "malloovia-2.1.2.tar.gz",
"has_sig": false,
"md5_digest": "dbb73c231e989dcdf69b5824c6fdc680",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 172637,
"upload_time": "2019-06-21T09:15:30",
"url": "https://files.pythonhosted.org/packages/a7/59/734d16ed2d3ced3310730c4d5fe6f3878e8b2253567f35e3e9d20f9e9ca8/malloovia-2.1.2.tar.gz"
}
]
},
"urls": [
{
"comment_text": "",
"digests": {
"md5": "08349cff13381e028dc36cd85ce8b2b5",
"sha256": "9f7f6fb087db2c575f907891be56e1f9baf5dd3ded9bb63f68826d74fb6ed638"
},
"downloads": -1,
"filename": "malloovia-2.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "08349cff13381e028dc36cd85ce8b2b5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 41689,
"upload_time": "2019-06-21T09:15:28",
"url": "https://files.pythonhosted.org/packages/46/88/8fbb690e1e7b256fa7d80589418564117dc12a833953a72fe96ffbf4ae25/malloovia-2.1.2-py3-none-any.whl"
},
{
"comment_text": "",
"digests": {
"md5": "dbb73c231e989dcdf69b5824c6fdc680",
"sha256": "a427c744000d200c5da88ffd61269bb1116d8156c2b3973252541f449d89a571"
},
"downloads": -1,
"filename": "malloovia-2.1.2.tar.gz",
"has_sig": false,
"md5_digest": "dbb73c231e989dcdf69b5824c6fdc680",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 172637,
"upload_time": "2019-06-21T09:15:30",
"url": "https://files.pythonhosted.org/packages/a7/59/734d16ed2d3ced3310730c4d5fe6f3878e8b2253567f35e3e9d20f9e9ca8/malloovia-2.1.2.tar.gz"
}
]
}