docker-compose-wrapper

Overview

Wrapper for script for docker-compose adding some very useful convenience commands:

Convenience commands (parameters in brackets are optional):
cleanup Removes all docker containers and images
edit Edit the current compose file in vi
exec <name> <cmd> Executes a command in a container
gc [<name>] Removes unused docker containers and images
inspect <name> Show all container information in JSON format
shell <name> Opens a bash terminal in a container
show Shows the current compose file
stats [<name>] Print system usage statistics for containers
status [<name>] See 'ps' command
renew [<name>] Renews containers by stopping, removing and creating them
update [<name>] Updates containers by pulling, stopping, removing and creating them

Prerequisites

• Docker must be installed
• Docker-Compose must be installed

Installation

• Download docker-compose-wrapper script to /usr/local/bin folder:

  sudo wget https://raw.githubusercontent.com/chrisipa/docker-compose-wrapper/master/docker-compose-wrapper -O /usr/local/bin/docker-compose-wrapper
  

• Make docker-compose-wrapper script executable:

  sudo chmod +x /usr/local/bin/docker-compose-wrapper
  

• Create sample init script /etc/init.d/my-app-stack for your application stack:

  #!/bin/bash
  ### BEGIN INIT INFO
  # Provides: my-app-stack
  # Required-Start: docker
  # Required-Stop:
  # Default-Start: 3 5
  # Default-Stop: 0 1 2 6
  # Description: My App Stack Init Script
  ### END INIT INFO
  # set environment variables
  export TZ="Europe/Berlin"
  # set compose file location
  composeFile="/opt/my-app-stack/docker-compose.yml"
  # include docker-compose-wrapper script
  source /usr/local/bin/docker-compose-wrapper
  

• Make init script executable:

  sudo chmod +x /etc/init.d/my-app-stack
  

• Register init script for autostart:

  sudo chkconfig my-app-stack on
  

• Now you can use your init script to control docker-compose in a convenient way:

  sudo service my-app-stack