{ "info": { "author": "chaostoolkit Team", "author_email": "sh@defuze.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Intended Audience :: Developers", "License :: Freely Distributable", "License :: OSI Approved :: Apache Software License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: Implementation", "Programming Language :: Python :: Implementation :: CPython" ], "description": "# chaostoolkit-gremlin\n\n[![Build Status](https://travis-ci.org/chaostoolkit/chaostoolkit-gremlin.svg?branch=master)](https://travis-ci.org/chaostoolkit/chaostoolkit-gremlin)\n\n[Gremlin, Inc][gremlin] support for the [Chaos Toolkit][chaostoolkit].\n\n[gremlin]: https://gremlininc.com/\n[chaostoolkit]: http://chaostoolkit.org/\n\n## Install\n\nTo be used from your experiment, this package must be installed in the Python\nenvironment where [chaostoolkit][] already lives.\n\n[chaostoolkit]: https://github.com/chaostoolkit/chaostoolkit\n\n```\n$ pip install chaostoolkit-gremlin\n```\n\n## Usage\n\nTo use this package, you must create an account with [Gremlin, Inc][gremlin].\nOnce registered, create a new organisation (formerly known as team). You may\nhave to ask your Gremlin administrator to do this for you.\n\nOnce this is done, you must set the following environmental variables\nso the Chaos Toolkit can pick up them:\n\n* `GREMLIN_EMAIL`: the email used to register to Gremlin and associated to that\n organisation\n* `GREMLIN_PWD`: your password\n* `GREMLIN_ORG_NAME`: the oprganisation's name you created\n\nNote that 2FA is not yet implemented in this package.\n\nNext you need to specify to load those\nvariables and inject them into this package's activities. At the top of the\nexperiment file, add the following object:\n\n```json\n{\n \"secrets\": {\n \"gremlin\": {\n \"email\": \"env.GREMLIN_EMAIL\",\n \"password\": \"env.GREMLIN_PWD\",\n \"org_name\": \"env.GREMLIN_ORG_NAME\"\n }\n }\n}\n```\n\nFinally, in all activities where you call a function from this package, make\nsure to add the following property:\n\n```json\n\"secrets\": \"gremlin\"\n```\n\nHere is a full example of running a CPU attack experiment:\n\n```json\n{\n \"title\": \"Can our system handle a node being CPU-busy?\",\n \"description\": \"CPU-usage may be impactful on our response time\",\n \"secrets\": {\n \"gremlin\": {\n \"email\": \"env.GREMLIN_EMAIL\",\n \"password\": \"env.GREMLIN_PWD\",\n \"org_name\": \"env.GREMLIN_ORG_NAME\"\n }\n },\n \"method\": [\n {\n \"title\": \"attack-on-cpu\",\n \"type\": \"action\",\n \"background\": true,\n \"secrets\": \"gremlin\",\n \"provider\": {\n \"type\": \"python\",\n \"module\": \"chaosgremlin.actions\",\n \"func\": \"attack\",\n \"arguments\": {\n \"command\": {\n \"type\": \"cpu\"\n },\n \"target\": {\n \"type\": \"Random\"\n }\n }\n }\n }\n ]\n}\n```\n\n## Contribute\n\nIf you wish to contribute more functions to this package, you are more than\nwelcome to do so. Please, fork this project, make your changes following the\nusual [PEP 8][pep8] code style, sprinkling with tests and submit a PR for\nreview.\n\n[pep8]: https://pycodestyle.readthedocs.io/en/latest/\n\n\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://chaostoolkit.org", "keywords": "", "license": "Apache License Version 2.0", "maintainer": "", "maintainer_email": "", "name": "chaostoolkit-gremlin", "package_url": "https://pypi.org/project/chaostoolkit-gremlin/", "platform": "", "project_url": "https://pypi.org/project/chaostoolkit-gremlin/", "project_urls": { "Homepage": "http://chaostoolkit.org" }, "release_url": "https://pypi.org/project/chaostoolkit-gremlin/0.3.0/", "requires_dist": [ "chaostoolkit-lib (>=0.7.0)", "logzero", "pycodestyle", "requests" ], "requires_python": ">=3.5.*", "summary": "Chaos Toolkit Gremlin, Inc. support", "version": "0.3.0" }, "last_serial": 3410678, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "bf17918e590510863f1a7f56974c625e", "sha256": "32f5d92dc8492a704f2658aa78344ed27a55a516f400f54a386d729ded20beb2" }, "downloads": -1, "filename": "chaostoolkit_gremlin-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "bf17918e590510863f1a7f56974c625e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 6193, "upload_time": "2017-10-16T21:16:42", "url": "https://files.pythonhosted.org/packages/64/92/09e57f35a4eb020f57c7f26552a152e6ddbf2426fe10c532e396ae12e630/chaostoolkit_gremlin-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0e37a733279dd53483c2e360748abbae", "sha256": "1987a87d1dcd020ff4cb772289942cd16513d1554331ae0c1c65b03e96cad554" }, "downloads": -1, "filename": "chaostoolkit-gremlin-0.1.0.tar.gz", "has_sig": false, "md5_digest": "0e37a733279dd53483c2e360748abbae", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 3692, "upload_time": "2017-10-16T21:16:44", "url": "https://files.pythonhosted.org/packages/8a/60/bcddc00d11b9730c9589e649a343940ef7c6419a4dea9e19ec02e08ac974/chaostoolkit-gremlin-0.1.0.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "b2ef22b734e812749cbe600db06a8145", "sha256": "b6dac7ba1a08e3bcd5f130f2ae48252b3fd20ee08b1be3ef8f709ea4d88230bb" }, "downloads": -1, "filename": "chaostoolkit_gremlin-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "b2ef22b734e812749cbe600db06a8145", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 6154, "upload_time": "2017-12-07T20:06:47", "url": "https://files.pythonhosted.org/packages/78/eb/e958488d7a356cecd7ffa66e89615589d4d580f52f4c3393c18bef958bab/chaostoolkit_gremlin-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "af850a9783a429ae2ef9f7cdfcb5f66f", "sha256": "9d13f6033bcde9161178c69d055f8cfc05812695a37689bc9ebb9923569e8783" }, "downloads": -1, "filename": "chaostoolkit-gremlin-0.2.0.tar.gz", "has_sig": false, "md5_digest": "af850a9783a429ae2ef9f7cdfcb5f66f", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 8745, "upload_time": "2017-12-07T20:06:49", "url": "https://files.pythonhosted.org/packages/85/4a/f88c194638062070b6f078b4708eba961992066353450d88ce14c6e78974/chaostoolkit-gremlin-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "952708bcca8d54417726214875397bea", "sha256": "957458cf568f7b0a19e787eb6012e317617c1f7adf3c992a137fd08ee5a81a95" }, "downloads": -1, "filename": "chaostoolkit_gremlin-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "952708bcca8d54417726214875397bea", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 6218, "upload_time": "2017-12-12T15:58:00", "url": "https://files.pythonhosted.org/packages/b1/53/576063cb7ae6feb4d93a2a56fa50056b8ac11640f6612dba728cee2e0eec/chaostoolkit_gremlin-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e591cd9d1f310378d90b4091a4cf046f", "sha256": "7efc4b441aaeb755a08ccef489fbb646c2b3b217057fe007afa46ef5a203177c" }, "downloads": -1, "filename": "chaostoolkit-gremlin-0.3.0.tar.gz", "has_sig": false, "md5_digest": "e591cd9d1f310378d90b4091a4cf046f", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 8868, "upload_time": "2017-12-12T15:58:01", "url": "https://files.pythonhosted.org/packages/90/58/43a0de5149fd52222f2e7ef68ffc0bea0da33143ecc45edfb0a84d3ded89/chaostoolkit-gremlin-0.3.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "952708bcca8d54417726214875397bea", "sha256": "957458cf568f7b0a19e787eb6012e317617c1f7adf3c992a137fd08ee5a81a95" }, "downloads": -1, "filename": "chaostoolkit_gremlin-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "952708bcca8d54417726214875397bea", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5.*", "size": 6218, "upload_time": "2017-12-12T15:58:00", "url": "https://files.pythonhosted.org/packages/b1/53/576063cb7ae6feb4d93a2a56fa50056b8ac11640f6612dba728cee2e0eec/chaostoolkit_gremlin-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e591cd9d1f310378d90b4091a4cf046f", "sha256": "7efc4b441aaeb755a08ccef489fbb646c2b3b217057fe007afa46ef5a203177c" }, "downloads": -1, "filename": "chaostoolkit-gremlin-0.3.0.tar.gz", "has_sig": false, "md5_digest": "e591cd9d1f310378d90b4091a4cf046f", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5.*", "size": 8868, "upload_time": "2017-12-12T15:58:01", "url": "https://files.pythonhosted.org/packages/90/58/43a0de5149fd52222f2e7ef68ffc0bea0da33143ecc45edfb0a84d3ded89/chaostoolkit-gremlin-0.3.0.tar.gz" } ] }