dock0 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 95cc83b7d86b80b1baa9f4f0797a30cf0b2dc9c1
-  data.tar.gz: fb56e339692dbdbc0637a341f32af33b2c51d9d4
+  metadata.gz: 93d7456a2290387ed74a1b3d5dacfd934faf86b2
+  data.tar.gz: f0752fe961880c4cc65eef15125f89627d0356b8
 SHA512:
-  metadata.gz: 4624dcbc724f1da805be5b330bdef462133608d3bdf702eb840f24deeec3f128ea3d101eebc8c62baad36558e5701b937f38d471806e3c22ca1dc8c53ab16874
-  data.tar.gz: c1e16756f6dbcd25d969712ff4a7668549037792ba4b5d4e190504e201811df369c6199460e2d1860cf7f18cbc4db1fd60166d048082fe1bcc450d62f10571ba
+  metadata.gz: 0aae22f19127ceaa4eefad8b4eb50f5e58e9e0a793c1260702e5cda3a14728ad2080db9da300a911123fec1bdb79556973eecd63f8751d8b62683fd505630c64
+  data.tar.gz: 2e5d2ea2a39355e3516c28f85d9ea45c860ff46937f9f3bed59db305498055db92ec8c0f7ee854e3cbfe8bd51d4bad1c288b667e68139788ed6b543963ff2df5

data/README.md

@@ -8,27 +8,33 @@ dock0
 [![Build Status](https://img.shields.io/travis/dock0/dock0.svg)](https://travis-ci.org/dock0/dock0)
 [![MIT Licensed](https://img.shields.io/badge/license-MIT-green.svg)](https://tldrlegal.com/license/mit-license)
 
-Dynamic Arch image generator for building a read-only host system for [Docker](https://www.docker.io)
+Component generator for building Arch systems
 
 ## Usage
 
-This is basically a meta-script that builds Arch images. Its primary use is to build read-only Docker hosts for me, but it could realistically be repurposed for other kinds of minimal deployments.
+### Build a rootfs
 
-An example configuration can be found in [this repo](https://www.github.com/dock0/host_config).
+```
+dock0 image config.yaml
+```
 
-The dock0 command accepts a list of configuration files as arguments. It changes to the directory of the first file given, so all other files and configuration options can use relative pathing based from that location:
+This will build a compressed rootfs from your configuration. Here is [an example configuration](https://github.com/dock0/vm_root)
 
-    dock0 /opt/my_dock0/config.yaml ./configs/foobar.yaml
+### Build a config bundle
 
-The module's Dock0::Image class exposes various methods, but the recommended option is to run .easy_mode(), which runs through them all in the preferred order. This is the sequence (@config represents the merged configs provided):
+```
+dock0 config config.yaml
+```
 
-1. `.prepare_device()` makes an ext2 filesystem at `@config['paths']['device']` and mounts it at `@config['paths']['mount']`
-2. `.prepare_root()` creates a filesystem at `@config['paths']['build_file']` and mounts it at `@config['paths']['build']`
-3. `.install_packages()` pacstraps the root filesystem with all the packages listed in `@config['paths']['package_list']`
-4. `.apply_overlay()` copies the contents of `@config['paths']['overlay']` into the root filesystem
-5. `.run_scripts()` runs all the ruby scripts in `@config['paths']['scripts']` in its own scope (the have access to `@config` and such)
-6. `.run_commands()` runs all commands in `@config['commands']['chroot']` using arch-chroot and all commands in `@config['commands']['host']` on the host system
-7. `.finalize()` unmounts the root FS, packs it in a squashfs, puts it on the target device, and unmounts that
+This builds a config tarball designed to be used to customize a rootfs. Here is [an example configuration](https://github.com/dock0/vm_config)
+
+### Build a system deployment
+
+```
+dock0 install config.yaml
+```
+
+This downloads created artifacts and runs build scripts to combine precreated and dynamic components into a full system. Here is [an example configuration](https://github.com/dock0/vm_install)
 
 ## Installation
 

data/bin/dock0

@@ -28,6 +28,16 @@ Mercenary.program(:dock0) do |p|
     end
   end
 
+  p.command(:install) do |c|
+    c.syntax 'install CONFIG1 [... CONFIGN]'
+    c.description 'Build/update a install'
+
+    c.action do |args, _|
+      Dock0.easy_mode :Install, args
+      puts 'All done!'
+    end
+  end
+
   p.action do
     puts p
     exit 1

data/lib/dock0.rb

@@ -70,3 +70,4 @@ end
 require 'dock0/version'
 require 'dock0/image'
 require 'dock0/config'
+require 'dock0/install'

data/lib/dock0/install.rb

@@ -0,0 +1,87 @@
+require 'fileutils'
+require 'open-uri'
+
+module Dock0
+  ##
+  # An Install is a deployment of components onto a system
+  class Install < Base
+    def default_config
+      {
+        'paths' => {
+          'templates' => './templates',
+          'scripts' => './scripts',
+          'build' => './build'
+        },
+        'artifacts' => []
+      }
+    end
+
+    def build_url(artifact)
+      org = @config[:org]
+      name, version, file = artifact.fetch('name', 'version', 'file')
+      "https://github.com/#{org}/#{name}/releases/download/#{version}/#{file}"
+    end
+
+    def build_path(artifact)
+      "#{artifact['name']}/#{artifact['file']}"
+    end
+
+    def download(artifact)
+      url, path = artifact.values_at('url', 'full_path')
+      puts "Downloading #{url} to #{path}"
+      File.open(path, 'wb') do |fh|
+        open(url, 'rb') { |request| fh.write request.read }
+      end
+    end
+
+    def chmod(artifact)
+      File.chmod(artifact['mode'], full_path) if artifact['mode']
+    end
+
+    def link(artifact)
+      FileUtils.ln_sf artifact['link'], artifact['path']
+    end
+
+    def load_artifacts
+      @config['artifacts'].each do |artifact|
+        artifact['url'] ||= build_url(artifact)
+        artifact['path'] ||= build_path(artifact)
+        artifact['full_path'] = "#{@config['build']}/#{artifact['path']}"
+        download artifact
+        chmod artifact
+        link(artifact) if artifact['link']
+      end
+    end
+
+    def templates
+      Dir.chdir(@paths['templates']) do
+        Dir.glob('**/*').select { |x| File.file? x }
+      end
+    end
+
+    def render_templates
+      templates.each do |path|
+        puts "Templating #{path}"
+        template = File.read "#{@paths['templates']}/#{path}"
+        parsed = ERB.new(template, nil, '<>').result(binding)
+
+        target_path = "#{@paths['build']}/#{path}"
+        FileUtils.mkdir_p File.dirname(target_path)
+        File.open(target_path, 'w') { |fh| fh.write parsed }
+      end
+    end
+
+    def finalize
+      puts "Packing config into #{@paths['output']}"
+      tar = Dir.chdir(File.dirname(@paths['build'])) { run 'tar cz .' }
+      File.open(@paths['output'], 'w') { |fh| fh << tar }
+    end
+
+    def easy_mode
+      load_artifacts
+      render_templates
+      run_scripts
+      finalize
+    end
+  end
+end

data/lib/dock0/version.rb

@@ -1,5 +1,5 @@
 ##
 # Set the version (needed for Mercenary -v)
 module Dock0
-  VERSION = '0.2.2'
+  VERSION = '0.2.3'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dock0
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Les Aker
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-06 00:00:00.000000000 Z
+date: 2014-12-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mercenary
@@ -114,6 +114,7 @@ files:
 - lib/dock0.rb
 - lib/dock0/config.rb
 - lib/dock0/image.rb
+- lib/dock0/install.rb
 - lib/dock0/version.rb
 - spec/dock0_spec.rb
 - spec/examples/alpha.yml