docker_janitor 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 24cbd25bc167a878775ac6f639d1a63f02800272
+  data.tar.gz: cadfadf016a03c1652837286e528fae9cba89de3
+SHA512:
+  metadata.gz: d15c0d4d8468209bb659974232a92911110807c56e1bb57608d9929628ce0c6038a983ece03a5b5fc705858d86414fec87bd8303d1259574b21972f6b0b2aed3
+  data.tar.gz: ee5b14050bef633718575ae2308f94d437753a59ccd9c4876ca32a59929d07bddabcc7291f67548ee2becea282a0575c06ffe7be4af929c7c0af212122be7cbd

data/bin/docker-janitor

@@ -0,0 +1,238 @@
+#!/usr/bin/env ruby
+
+require 'thor'
+require 'sys/filesystem'
+require 'ostruct'
+require 'colorize'
+
+require 'docker_janitor'
+
+class DockerJanitorBin < Thor
+  class_option :dryrun, type: :boolean, aliases: ['dry-run', 'd'], default: false
+
+  desc 'clean', 'Clean up leftover docker cruft (does containers, images, volumes)'
+  long_desc <<-LONGDESC
+    Clean up leftover docker cruft
+
+    This command will clean up the saved cache items that docker
+    fills up your disk with.  This includes containers that have
+    exited, images that are unlabeled, and old volumes.
+
+    To restrict what is cleaned up, you can specify [-c|--containers],
+    [-i|--images], and/or [-v|--volumes].  If nothing is specified,
+    all three will be cleaned.
+
+    Named volumes are not included by default to avoid data loss.
+    If you want to include them, pass --include-named or -n or --named
+
+    > $ docker-janitor [-c|--containers] [-i|--images] [-v|--volumes]
+  LONGDESC
+  option :containers, type: :boolean, aliases: ['c', 'container'], default: false
+  option :images, type: :boolean, aliases: ['i', 'image'], default: false
+  option :volumes, type: :boolean, aliases: ['v', 'volumes'], default: false
+  option :'include-named', type: :boolean, aliases: ['n', 'named'], default: false
+  def clean
+    args = options.dup
+    if !args[:containers] && !args[:images] && !args[:volumes]
+      args[:containers] = true
+      args[:images]     = true
+      args[:volumes]    = true
+    end
+    exec_clean(args)
+  end
+
+  desc 'containers', 'Delete exited containers'
+  def containers
+    exec_clean({
+      dryrun: options[:dryrun],
+      containers: true,
+      images: false,
+      volumes: false
+    })
+  end
+
+  desc 'images', 'Delete unlabeled imaged'
+  def images
+    exec_clean({
+      dryrun: options[:dryrun],
+      containers: false,
+      images: true,
+      volumes: false
+    })
+  end
+
+  desc 'volumes', 'Delete orphaned volumes'
+  def volumes
+    exec_clean({
+      dryrun: options[:dryrun],
+      containers: false,
+      images: false,
+      volumes: true
+    })
+  end
+
+  desc 'config-file', 'Write a default config file'
+  long_desc <<-LONGDESC
+    Writes a dory config file to #{DockerJanitor::Config.filename}
+    containing the default settings.  This can then be configured
+    as preferred.
+  LONGDESC
+  def config_file
+    exec_config_file(options)
+  end
+
+  private
+
+  def exec_clean(options)
+    mounts = Sys::Filesystem.mounts.select do |m|
+      %w[ntfs vfat xfs].include?(m) ||
+      m.mount_type =~ /^ext[234]$/i ||
+      m.mount_type =~ /^reiser/i
+    end
+    mounts.map! do |m|
+      OpenStruct.new({
+        mount: m,
+        mbfree: mb_free(m.mount_point)
+      })
+    end
+
+    if options[:containers]
+      puts "[*] Deleting stopped containers".cyan
+      containers = DockerJanitor::Sh.run_command(
+        "docker ps -a | grep -E 'Exited|Created'"
+      ).stdout.split("\n")
+      puts "[*] #{containers.count} containers to delete".green
+      containers.each do |cont|
+        id_sha, image, command, created, status, ports, name = cont.split(/\s{2,}/)
+        unless name
+          name = ports
+          ports = ''
+        end
+        if options[:dryrun]
+          puts "[*] Not actually deleting containers (dry run)".yellow
+        else
+          if DockerJanitor::Config.settings[:safe_containers].any?{ |safe_container|
+            name   =~ /#{safe_container}/ ||
+            id_sha =~ /#{safe_container}/ ||
+            image  =~ /#{safe_container}/
+          }
+            puts "[*] Container '#{name}' with ID '#{id_sha}' is protected.  " \
+                 "Not deleting.".yellow
+          else
+            puts "[*] Deleting container '#{name}' with ID '#{id_sha}' created #{created}...".blue
+            unless DockerJanitor::Sh.run_command("docker rm #{id_sha}").success?
+              puts "[*] Failed deleting container '#{name}' with ID " \
+                   "'#{id_sha}' with command '#{command}' created " \
+                   "#{created}.  Status: '#{status}'".red
+            end
+          end
+        end
+      end
+    end
+
+    if options[:images]
+      puts "[*] Deleting all unlabeled images".cyan
+      to_del = DockerJanitor::Sh.run_command(
+        "docker images | grep -iE '^<none>' | awk '{print $3}'"
+      ).stdout.split("\n")
+      puts "[*] #{to_del.count} images to delete".green
+      puts "[*] #{to_del.join(' ')}".blue
+      if to_del.empty?
+        puts "[*] No unlabeled images to delete!".green
+      else
+        if options[:dryrun]
+          puts "[*] Not actually deleting images (dry run)".yellow
+        else
+          if del_images.success?
+            puts "[*] Unlabeled images successfully delete".green
+          else
+            puts "[*] Error deleting unlabeled images".red
+          end
+        end
+      end
+    end
+
+    if options[:volumes]
+      puts "[*] Deleting all dangling docker volumes".cyan
+      if options[:'include-named']
+        command = 'docker volume ls -qf dangling=true'
+      else
+        command = "docker volume ls -qf dangling=true | grep -E --color=none '^[A-Fa-f0-9]{64}$'"
+      end
+      volumes = DockerJanitor::Sh.run_command(command).stdout.split("\n")
+      if volumes.empty?
+        puts "[*] No dangling volumes to delete!".green
+      else
+        puts "[*] Removing these volumes:".green
+        volumes.each{ |v| puts v.blue }
+        if options[:dryrun]
+          puts "[*] Not actually deleting volumes (dry run)".yellow
+        else
+          if del_volumes(volumes).success?
+            puts "[*] Succeeded removing dangling volumes".green
+          else
+            puts "[*] Error removing dangling volumes".red
+          end
+        end
+      end
+    end
+
+    puts "Mount Name:\tMount Point:\tFree Before:\tFree After:\tTotal freed:".cyan
+    mounts.each do |m|
+      m.mount.name
+      m.mount.mount_point
+      m.mbfree
+      puts "#{m.mount.name}\t" \
+           "#{m.mount.mount_point}\t\t" \
+           "#{free_space(m.mbfree)}\t\t" \
+           "#{free_space(mb_free(m.mount.mount_point))}\t\t" \
+           "#{free_space(mb_free(m.mount.mount_point) - m.mbfree)}"
+    end
+  end
+
+  def del_images
+    DockerJanitor::Sh.run_command(
+      "docker rmi $(docker images | grep -iE '^<none>' " \
+      "| awk '{print $3}' | xargs)"
+    )
+  end
+
+  def del_volumes(volumes)
+    DockerJanitor::Sh.run_command(
+      "docker volume rm #{volumes.join(' ')}"
+    )
+  end
+
+  def free_space(megabytes)
+    if megabytes / 1024 > 9
+      "#{megabytes / 1024} GB"
+    else
+      "#{megabytes} MB"
+    end
+  end
+
+  def mb_free(mount_point)
+    Sys::Filesystem.stat(mount_point).bytes_free / 1024 / 1024
+  end
+
+  def exec_config_file(options)
+    if File.exist?(DockerJanitor::Config.filename)
+      print "A config file already exists at #{DockerJanitor::Config.filename}" \
+            ".  Overwrite with default settings? (Y/N): ".yellow
+      conf = STDIN.gets.chomp
+      unless conf =~ /y/i
+        puts "User declined over-writing.  Not writing config file".red
+        return
+      end
+    end
+    puts "Writing config file to #{DockerJanitor::Config.filename}".green
+    DockerJanitor::Config.write_default_settings_file
+  end
+
+end
+
+if !ARGV.empty? && %w[-v --version].include?(ARGV.first)
+  puts "Docker Janitor - Version: #{DockerJanitor::VERSION}"
+else
+  DockerJanitorBin.start(ARGV)
+end

data/lib/docker_janitor.rb

@@ -0,0 +1,3 @@
+Gem.find_files('docker_janitor/**/*.rb').each do |path|
+  require path.gsub(/\.rb$/, '') unless path =~ /bot.*cli/
+end

data/lib/docker_janitor/config.rb

@@ -0,0 +1,52 @@
+require 'yaml'
+
+module DockerJanitor
+  class Config
+    def self.filename
+      "#{Dir.home}/.docker-janitor.yml"
+    end
+
+    def self.default_yaml
+      %q(---
+        :docker-janitor:
+          # safe-containers is an array of regular expressions
+          # against which container names will be checked to see if
+          # they are protected.  This can help to make sure that
+          # data-only containers for example are not
+          # unintentionally deleted.  These are ruby flavored
+          # regular expressions, check with the ruby operator =~
+          # rubular.com is a helpful site for testing your regex
+          :safe_containers:
+            - db$
+            - postgres
+            - mongo
+            - dynamo
+            - mysql
+          :safe_images:
+            - a-sha-of-some-sort
+          :safe_volumes:
+            - a-sha-of-some-sort
+      ).split("\n").map{|s| s.sub(' ' * 8, '')}.join("\n")
+    end
+
+    def self.default_settings
+      YAML.load(self.default_yaml)
+    end
+
+    def self.settings(filename = self.filename)
+      if File.exist?(filename)
+        self.default_settings.merge(YAML.load_file(filename))
+      else
+        self.default_settings
+      end
+    end
+
+    def self.write_settings(settings, filename = self.filename)
+      File.write(filename, settings)
+    end
+
+    def self.write_default_settings_file(filename = self.filename)
+      self.write_settings(self.default_yaml, filename)
+    end
+  end
+end

data/lib/docker_janitor/shell.rb

@@ -0,0 +1,25 @@
+require 'ostruct'
+
+module DockerJanitor
+  module Sh
+    def self.run_command(command)
+      stdout = `#{command}`
+      OpenStruct.new({
+        success?: $?.exitstatus == 0,
+        exitstatus: $?.exitstatus,
+        stdout: stdout
+      })
+    end
+  end
+
+  module Bash
+    def self.run_command(command)
+      stdout = `bash -c "#{command}"`
+      OpenStruct.new({
+        success?: $?.exitstatus == 0,
+        exitstatus: $?.exitstatus,
+        stdout: stdout
+      })
+    end
+  end
+end

data/lib/docker_janitor/version.rb

@@ -0,0 +1,3 @@
+module DockerJanitor
+  VERSION = "0.0.2"
+end

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification
+name: docker_janitor
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Ben Porter
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-07-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: sys-filesystem
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.5'
+description: 'The slack web api is good, but very raw.  '
+email: BenjaminPorter86@gmail.com
+executables:
+- docker-janitor
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/docker-janitor
+- lib/docker_janitor.rb
+- lib/docker_janitor/config.rb
+- lib/docker_janitor/shell.rb
+- lib/docker_janitor/version.rb
+homepage: https://github.com/FreedomBen/docker-janitor
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: docker janitor helps you clean up after the sometimes messy house guest known
+  as docker
+test_files: []
+has_rdoc: