Skip to main content

A Docker and AWS utility package

Project description

dokr - Make your docker and ecs tasks easy

A 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

Assumptions:

  • Assuming python is installed on your system.
  • Docker is installed on your system
  • aws-cli is installed and credentials are configured on your system.
  • ecs-cli is installed on system [For Log Command only]

Install dokr on your system using :

pip install dokr

ECS Options

  • login into ecs directly (Assuming awscli is installed and configured)
dokr ecs login

alt dokr_aws_ip

  • Deploy an image on a cluster
dokr ecs deploy --cluster cluster_name --service service_name --tag image_version

alt dokr_aws_ip

  • Check ecs running logs of a Task - this command will ask for cluster/service and task defination.

Note: Install ecs-cli before running this command from here: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_CLI_installation.html

dokr ecs log

alt dokr_aws_ip

Docker Helper Commands

  • Prune whole system - Cleans unused images, containers and volumes.
dokr dock --clean-all

alt dokr_aws_ip

  • Delete all the images matching the pattern
dokr dock --clean pattern_xxx

alt dokr_aws_ip

  • Add a tag to the existing image matching the provided pattern (for latest tag only)
dokr dock --tag pattern_xxx tag_name

alt dokr_aws_ip

  • Push all images on a system matching a pattern

This will push all images matching pattern 'pat'

dokr dock --push pat

alt dokr_aws_ip

AWS Commands

  • Check current public ip of a machine on AWS
dokr aws --ip jenkins 

alt dokr_aws_ip

Run Apps (subsitute to docker run command and DockerCompose)

  • Configure your default values(like docker registry, port mapping, volume mapping etc. that will be same for all apps):

alt dokr_aws_ip

  • Add an new app for deployment:

alt dokr_aws_ip

  • Run all configured apps:

alt dokr_aws_ip

  • Run a particular app from ECR tags:

alt dokr_aws_ip

  • Run a particular app by providing a tag:

alt dokr_aws_ip

Development:

  • Clean ununsed: rm -rf build/ dist/ *egg* **.pyc __pycache__
  • Build package: python setup.py bdist_wheel
  • deploy package: python -m twine upload dist/*

follow this link for more details https://dzone.com/articles/executable-package-pip-install

Project details


Release history Release notifications | RSS feed

This version

1.5

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dokr199-1.5.tar.gz (9.8 kB view details)

Uploaded Source

Built Distribution

dokr199-1.5-py3-none-any.whl (12.5 kB view details)

Uploaded Python 3

File details

Details for the file dokr199-1.5.tar.gz.

File metadata

  • Download URL: dokr199-1.5.tar.gz
  • Upload date:
  • Size: 9.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.7

File hashes

Hashes for dokr199-1.5.tar.gz
Algorithm Hash digest
SHA256 2315e2b1bfd7aa76e75145e3108702cd5c185f86a9fc197ccf94400f8cb9799a
MD5 084638e3bfe75b1b024136ef39650eaa
BLAKE2b-256 101ba2dd9df04c05f925b7be7c7a43d4a43296797539684d78660e178373b113

See more details on using hashes here.

File details

Details for the file dokr199-1.5-py3-none-any.whl.

File metadata

  • Download URL: dokr199-1.5-py3-none-any.whl
  • Upload date:
  • Size: 12.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.46.0 CPython/3.7.7

File hashes

Hashes for dokr199-1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 7f73e609a95520e14f329addbd79dae3f55fe230a80f337f376bb4f1ad05d2ed
MD5 3ea07c324dc00314b1042a20df112b58
BLAKE2b-256 76be373984e97efaa6b7da104ddd87ec117732ca4558049b97c5df7ce22a82c6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page