{ "info": { "author": "Andrey Kurilin", "author_email": "", "bugtrack_url": null, "classifiers": [ "Intended Audience :: Developers", "Intended Audience :: Information Technology", "License :: OSI Approved :: Apache Software License", "Operating System :: POSIX :: Linux", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6" ], "description": "# xrally-docker\n\nxRally plugins for [Docker engine](https://www.docker.com).\n\n## What is it?!\n\nOriginally, it was created as a quick proof-of-concept to show ability of\n[Rally](https://github.com/openstack/rally) to test platforms other than\n[OpenStack](https://www.openstack.org/). After the first preview,\nit became obvious that it should be developed as a complete package.\n\n__xrally_docker__ is a pack of xRally plugins for execution different workloads\nat the top of Docker Engine. Such workloads can be used as like for testing\nenvironments with Docker or testing behaviour of specified docker image.\n\n## How to use?!\n\n### Install package\n\n__xrally_docker__ package is configured to be auto-discovered by Rally. Since\nrally package is a dependency of __xrally_docker__ , so to start using\n__xrally_docker__ you need to install just one package:\n\n```commandline\n\npip install xrally_docker\n\n```\n\n### Specify entry-point of docker engine to use\n\nThe next step is to specify entry-point to docker, i.e. create rally \nenvironment. There are 2 way to do it:\n\n1. Specify environment specification manually. For a simple case (no cert, \n tls, etc), it looks like ``{\"docker@existing\": {}}``.\n2. Create environment specification from system environment variables \n (supported by Rally >= 0.11.2) using \n ``rally env create --name example --from-sysenv`` command. An expected \n system variables are the same as native docker client supports.\n\n### Check that Rally can access the docker\n\nFirst of all try to execute ``rally env check`` command. It checks all \nplatforms of the environment to be available. If it does not show any errors \nfor communicating with docker, go and execute any task against docker. \nIf is fails, try to execute the command again with ``--detailed`` flag.\n\nAlso, you can use ``rally env info`` command for the same purpose. Unlike \n``rally env check`` it will not only check the platforms, but print some \ninformation about them. In case of docker platform, it will print the similar \nto ``docker --version`` data.\n\n### Execute a workload against docker\n\nHere is a simple workload:\n\n```yaml\n\n---\n version: 2\n title: Simple task with only one workload\n subtasks:\n -\n title: a subtask with one workload\n description: This workload should run a container from \"ubuntu\" \n image and execute simple command.\n scenario:\n Docker.run_container:\n image_name: \"ubuntu\"\n command: \"echo 'Hello world!'\"\n runner:\n constant:\n times: 10\n concurrency: 2\n sla:\n failure_rate:\n max: 0\n```\n\nThis task will download _ubuntu_ image first, if it does not present in the \nsystem. Then, it will run 10 containers from the image with 2 concurrency and \nexecute a simple command. The output of the command will be saved as \nTextArea and will be available via json and html reports.\n\nSee plugin references for the full list of available plugins for docker \nplatform to combine workloads. \n\n## Known issues\n\nThis package works fine, but you need to install the proper version of Docker\nclient which suits your Docker API version.", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://xrally.org/plugins/docker/overview", "keywords": "", "license": "Apache License, Version 2.0", "maintainer": "", "maintainer_email": "", "name": "xrally-docker", "package_url": "https://pypi.org/project/xrally-docker/", "platform": "", "project_url": "https://pypi.org/project/xrally-docker/", "project_urls": { "Homepage": "https://xrally.org/plugins/docker/overview" }, "release_url": "https://pypi.org/project/xrally-docker/1.0.0/", "requires_dist": null, "requires_python": "", "summary": "a set of xRally plugins for Docker platform.", "version": "1.0.0" }, "last_serial": 3918647, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "8b3eed00220356295832ad13fbc9eb67", "sha256": "4b786abfd7568cf79dc08953d53271c61c21058e1aac53f151e11cc0638fb909" }, "downloads": -1, "filename": "xrally-docker-1.0.0.tar.gz", "has_sig": false, "md5_digest": "8b3eed00220356295832ad13fbc9eb67", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 34326, "upload_time": "2018-05-31T21:26:11", "url": "https://files.pythonhosted.org/packages/c3/00/350554bcfa7d6dbe170c11cb579494f4ff2441b20cb7ab5c2109ba332023/xrally-docker-1.0.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "8b3eed00220356295832ad13fbc9eb67", "sha256": "4b786abfd7568cf79dc08953d53271c61c21058e1aac53f151e11cc0638fb909" }, "downloads": -1, "filename": "xrally-docker-1.0.0.tar.gz", "has_sig": false, "md5_digest": "8b3eed00220356295832ad13fbc9eb67", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 34326, "upload_time": "2018-05-31T21:26:11", "url": "https://files.pythonhosted.org/packages/c3/00/350554bcfa7d6dbe170c11cb579494f4ff2441b20cb7ab5c2109ba332023/xrally-docker-1.0.0.tar.gz" } ] }