{ "info": { "author": "Siddharth Bhonge", "author_email": "bsiddharth4@gmail.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "# dokr - Make your docker and ecs tasks easy\n\nA Helper pip package for docker and ECS tasks. This pip package helps you automate your CI/CD pipeline. If your using docker and Amazon ECS for deployments, this tool can be really helpful. This package uses aws cli and ecs cli. Mak\n\n\n### Assumptions:\n\n+ Assuming python is installed on your system.\n+ Docker is installed on your system\n+ [aws-cli](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) is installed and credentials are configured on your system.\n+ [ecs-cli](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_CLI_installation.html) is installed on system [*For Log Command only*]\n\n\nInstall `dokr` on your system using : \n\n```\npip install dokr\n```\n\n## ECS Options\n\n+ login into ecs directly (Assuming awscli is installed and configured)\n\n```\ndokr ecs login\n```\n![alt dokr_aws_ip](https://raw.githubusercontent.com/javatechy/dokr/master/screenshots/dokr_ecs_login.png)\n\n\n+ Deploy an image on a cluster \n\n```\ndokr ecs deploy --cluster cluster_name --service service_name --tag image_version\n```\n![alt dokr_aws_ip](https://raw.githubusercontent.com/javatechy/dokr/master/screenshots/dokr_ecs_deploy.png)\n\n\n+ Check ecs running logs of a Task - this command will ask for cluster/service and task defination.\n\n**Note:** Install ecs-cli before running this command from here:\n\t https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_CLI_installation.html\n\n```\ndokr ecs log\n```\n![alt dokr_aws_ip](https://raw.githubusercontent.com/javatechy/dokr/master/screenshots/dokr_ecs_log.png)\n\n\n## Docker Helper Commands\n\n+ Prune whole system - Cleans unused images, containers and volumes.\n\n```\ndokr dock --clean-all\n```\n![alt dokr_aws_ip](https://raw.githubusercontent.com/javatechy/dokr/master/screenshots/dokr_dock_clean_all.png)\n\n\n+ Delete all the images matching the pattern\n\n```\ndokr dock --clean pattern_xxx\n```\n![alt dokr_aws_ip](https://raw.githubusercontent.com/javatechy/dokr/master/screenshots/dokr_dock_clean.png)\n\n\n+ Add a tag to the existing image matching the provided pattern (for latest tag only)\n\n```\ndokr dock --tag pattern_xxx tag_name\n```\n![alt dokr_aws_ip](https://raw.githubusercontent.com/javatechy/dokr/master/screenshots/dokr_dock_tag.png)\n\n\n\n+ Push all images on a system matching a pattern\n\nThis will push all images matching pattern 'pat'\n\n```\ndokr dock --push pat\n```\n![alt dokr_aws_ip](https://raw.githubusercontent.com/javatechy/dokr/master/screenshots/dokr_dock_push.png)\n\n\n#### AWS Commands\n\n+ Check current public ip of a machine on AWS\n\n```\ndokr aws --ip jenkins \n```\n\n![alt dokr_aws_ip](https://raw.githubusercontent.com/javatechy/dokr/master/screenshots/dokr_aws_ip.png)\n\n\n#### Run Apps (subsitute to `docker run` command and DockerCompose)\n\n+ Configure your default values(like docker registry, port mapping, volume mapping etc. that will be same for all apps):\n\n![alt dokr_aws_ip](https://raw.githubusercontent.com/javatechy/dokr/master/screenshots/dokr_configure.png)\n\n\n+ Add an new app for deployment:\n\n![alt dokr_aws_ip](https://raw.githubusercontent.com/javatechy/dokr/master/screenshots/dokr_configure_app.png)\n\n+ Run all configured apps:\n\n![alt dokr_aws_ip](https://raw.githubusercontent.com/javatechy/dokr/master/screenshots/dokr_run.png)\n\n+ Run a particular app from ECR tags:\n\n![alt dokr_aws_ip](https://raw.githubusercontent.com/javatechy/dokr/master/screenshots/dokr_run_app.png)\n\n\n+ Run a particular app by providing a tag:\n\n![alt dokr_aws_ip](https://raw.githubusercontent.com/javatechy/dokr/master/screenshots/dokr_run_app_tag.png)\n\n\n### Development:\n\n+ Clean ununsed: `rm -rf build/ dist/ *egg* **.pyc __pycache__`\n+ Build package: `python setup.py bdist_wheel`\n+ deploy package: `python -m twine upload dist/*`\n\nfollow this link for more details https://dzone.com/articles/executable-package-pip-install\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "printsid", "package_url": "https://pypi.org/project/printsid/", "platform": "", "project_url": "https://pypi.org/project/printsid/", "project_urls": null, "release_url": "https://pypi.org/project/printsid/0.1/", "requires_dist": [ "requests", "click", "configparser" ], "requires_python": "", "summary": "A dummy package", "version": "0.1" }, "last_serial": 5756635, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "8474edc6798a8bf152617c1b50ce5621", "sha256": "f3c629fed4560c69d3be402a1ae34db91e3abaa957160adac8af5f3fc5af96e5" }, "downloads": -1, "filename": "printsid-0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "8474edc6798a8bf152617c1b50ce5621", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 11430, "upload_time": "2019-08-29T19:57:14", "url": "https://files.pythonhosted.org/packages/33/b3/9bc026549f20b0624ca1a83f685a652ddb794c764e212a5617e8e24b1405/printsid-0.1-py3-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "8474edc6798a8bf152617c1b50ce5621", "sha256": "f3c629fed4560c69d3be402a1ae34db91e3abaa957160adac8af5f3fc5af96e5" }, "downloads": -1, "filename": "printsid-0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "8474edc6798a8bf152617c1b50ce5621", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 11430, "upload_time": "2019-08-29T19:57:14", "url": "https://files.pythonhosted.org/packages/33/b3/9bc026549f20b0624ca1a83f685a652ddb794c764e212a5617e8e24b1405/printsid-0.1-py3-none-any.whl" } ] }