Skip to content

A bash (and some python) script that wraps docker and gnome-terminal in a convenient dev tool for automatic run of several docker images

License

Notifications You must be signed in to change notification settings

Kukuster/penguinsOnWhale

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

penguinsOnWhale

Run multiple Docker containers each in a separate terminal with a single command.

Requirements/Dependencies

  • bash 4 or 5
  • Python >3.6
  • Docker >19.03.0 or podman >2.0.2
  • GNOME Terminal >3.27.0

Installation

Download and run:

./penguinsOnWhale --install

or

sudo ./penguinsOnWhale --install

Follow the instructions

Supported terminals

Supported Ubuntu Debian OpenSUSE Fedora Linux Mint CentOS Arch Tails Elementary OS
aTerm
Eterm
GNOME Terminal ✔️ ✔️ ✔️
Hyper
Guake
Konsole
Nautilus Terminal
rxvt
Terminator
Tilda
XFCE4 Terminal
XTerm
VTE Terminal

Usage

Help output:

Usage: penguinsOnWhale <COMMAND> [<penguin> [<penguin> [...]]]
  or:  penguinsOnWhale [<option>]

Commands:
  run                    invokes a terminal and starts a docker container for each specified penguin
  all                    invokes a terminal and starts a docker container for all penguins in the config file
  here                   starts a single penguin in the current terminal
  create-config          creates a new example config file in the current directory
  create-config-full     creates a new extensive example config file, demonstrating all available features
  reinstall              runs an installation script located at "/opt/penguinsOnWhale/installator.sh"


options:
  -h, --help         as a first keyword, displays this message. Run 'penguinsOnWhale <COMMAND> --help' for more info on a command
  -v, --version      displays general info about the program


Default config file (created with penguinsOnWhale create-config):

[Settings]
docker_images_prefix = 
docker_mount_source = 
docker_mount_destination = 
terminal_profile = penguinsOnWhale
cmd = ls
cmd_arg1 = -la

[penguin "ubuntu18.04"]
terminal_name = Ubuntu 18.04
docker_image = ubuntu:18.04
docker_container = myReusableUbuntu1804container
reuse_container = True

[penguin "fedora31"]
terminal_name = Fedora 31
docker_image = fedora:31

[penguin "amazonlinux2"]
terminal_name = Amazon Linux 2
docker_image = amazonlinux:2

use penguinsOnWhale create-config-full to check out more features

About

A bash (and some python) script that wraps docker and gnome-terminal in a convenient dev tool for automatic run of several docker images

Resources

License

Stars

Watchers

Forks

Languages