dockery

bash script shortcuts for repetitive docker tasks to improve workflow efficiency during container composition.

Description

The following scripts automate routine tasks associated with docker composition and container devlepment. Basically they are transcribed from a docker cheat sheet I have been compiling. The intent of this repo is to provide a controlled list of docker shortcuts for community use.

If you have suggestions for improvements commit your revisions to the repo and submit a push request for review and incorporation.

Prerequisites

!!! docker disk volume information WILL NOT be backed up the scripts only back up images and routes!!!

Scripts that REMOVE DATA are: dcl.sh drm.sh and dqd.sh.

To manually backup any critical volume data use these commands:

docker run -v /dbdata --name dbstore ubuntu /bin/bash
docker run --rm --volumes-from dbstore -v $(pwd):/backup ubuntu tar cvf ~/backup_volume.tar /dbdata

The above opens a container volume /dbdata on dbstore for backup to localhost ./$HOME/ update the the output tar location and containerID before executing.

See Usage for data removal script flagsl.

Set-up

Clone repo to $HOME

cd ~/ && git clone https://github.com/GrayHatGuy/dockery.git

Run setup script sudo bash ~/dockery/bin/setup.sh If setup fails manually add aliases

• Method 1 - Update .bashrc with alias using script.

  sudo bash ~/dockery/bin/alias.sh

• Method 2 - If you are currently not using aliases the copy the example .bash_aliases included to $HOME

  sudo cp ~/dockery/.bash_alias ~/

• Method 3 - If you are using .bash_alias append the aliases listed in the .bash_aliases example

  sudo nano .bash_aliases

  Log out for changes to be incorporated

Verify shortcuts are active by typing the script alias: dhi

Usage

Typical use of the scripts is to execute common docker housekeeping routines for status checks, backup, clearing/sweeping, install removal/purge, and install individually or e excuted sequentially in a single script to nuke all things docker and* reinstall. The scripts make use of a simple 3-letter shell command for execution as opposed to the mulitline commands required to executed the housekeeping routines.
*

To run scripts #1 to #5 separately use the form below.

• Script #1 dbu.sh shown as an example as alias dbu or alternates . dbu.sh sudo bash /$HOME/dockery/bin/dbu.sh

Script flag usage

To run the docker nuke sequence per dqd.sh use the following syntax for data removal prompts:

• Null flag - Prompt user before data removal [""] with alias dqd or alternate . ddq.sh sudo bash ~/dockery/dqd.sh
• -y flag - Accept data removal without prompts [-y] with alias dqdy or alternate . ddq.sh -y sudo bash ~/dockery/dqd.sh -y
• -n flag - Bypass data removal and prompts [-n] with alias dqdn or alternate . dqd.sh -n sudo bash ~/dockery/dqd.sh -n

Details

Scripts can be ran individually or in custom sequences.

!!! WARNING: ☢️ indicates data will be removed with these scripts !!!

Discrete scripts

• dbu.sh - #1 Backup all images and ifconfig routes to ~/dockbkup/
• ☢️ dcl.sh - #2 Cleans docker removes containers images then prunes network and volumes.
• ☢️ drm.sh - #3 Nuke ALL things docker including installation prerequisite #2.
• ddn.sh - #4 Quick install script for docker. Alternate full install manually at http://getdocker.com prequisite #2 and #3. Do not perform if docker is installed.
• dhi.sh - #5 Default run image hello-world or user specified continue with #6 optional.
• dok.sh - #6 Check apt update/upgrade docker engine and compose versions list processes network images and containers.

Sequential scripts

• ☢️ dqd.sh - #1 to #6 Factory reset. god mode executes all scripts in their order listed above {*.sh(i) for i = 1 to n; where n =6}. Ideal for nuking your install of docker and starting with a clean foundation.