DDash

Purposes

docker and docker-compose cli tool, to specify and automatic apply with current work directory.

Installation

pip install ddash

Instruction

• This program is using stdout and stderr which means it's able to support the next level deployment scripting.

• Setup following variable in you enviroment to make it permanently:

  • DDASH_TIMEOUT: Execute cli timeout [default is None(never timeout)]
  • DDASH_PROJECT_DELIMITER: Project delimiter for extracting prefix [default: _(underscore)]
  • DDASH_PROJECT_SPLIT_LIMIT: Project prefix word number for extracting prefix [default: 1]
  • DDASH_ROOT_PATH: Workspace [default: $HOME]
  • DDASH_SUB_PATH: Group directory combine with ROOT_PATH, {PREFIX} will be replace with porject prefix
  • DDASH_SATELLITE_SUFFIX: Satellite container name [default: service]
  • DDASH_COMPOSE_FILENAME: docker-compose filename [default: docker-compose.yml]
  • DDASH_DOCKER_EXEC_COMMAND: docker exec command [default: bash]

Command

• ps: List running containers, format table and grep rows
• launch: Launch satellite container through project {PREFIX} which is extract from $PWD or --project, combine {SUFFIX} to up a satellite container [default: {PREFIX}_service]
• terminate: Terminate satellite container through project {PREFIX} which is extract from $PWD or --project, combine {SUFFIX} to up a satellite container [default: {PREFIX}_service]
• up: up container through project {PREFIX} which is extract from $PWD or --project, combine {SUFFIX} to up a satellite container [default: {PREFIX}_service]
• down: down container through project {PREFIX} which is extract from $PWD or --project, combine {SUFFIX} to up a satellite container [default: {PREFIX}_service]
• run: exec container with interactive tty mode through project {PREFIX} which is extract from $PWD or --project, combine {SUFFIX} to up a satellite container [default: {PREFIX}_service]

Update Logs

#	date	version
4	2022/04/14	v0.3.0
3	2022/02/02	v0.2.0
2	2022/01/31	v0.1.0
1	2022/01/20	v0.0.0

0.3.0

• Merge pull request from Michael to fix color display issue.

0.2.0

• Removed useless param DDASH_TIMEOUT.
• Fixed _parse_sub_path get unexpected value None due to _SUB_PATH has no default value.

0.1.0

• Adjust execute method, use subprocess.Popen(cmd, shell=True).wait() instead of subprocess.check_output() to avoid no reactions during a long term processing.

0.0.0

• Add the following commands:
  • ps
  • launch
  • terminate
  • up
  • down
  • run

If you like my work, please consider buying me a coffee or PayPal Thanks for your support! Cheers! 🎉