cult 0.1.1.pre

data/lib/cult/template.rb

@@ -0,0 +1,92 @@
+require 'erb'
+require 'json'
+
+module Cult
+  class Template
+
+    # Alright!  We found a use for refinements!
+    module Refinements
+      module Util
+        module_function
+        def squote(s)
+          "'" + s.gsub("'", "\\\\\'") + "'"
+        end
+
+
+        def quote(s)
+          s.to_json
+        end
+
+
+        def slash(s)
+          Shellwords.escape(s)
+        end
+      end
+
+      refine String do
+        def quote
+          Util.quote(self)
+        end
+        alias_method :q, :quote
+
+
+        def squote
+          Util.squote(self)
+        end
+        alias_method :sq, :squote
+
+
+        def slash
+          Util.slash(self)
+        end
+      end
+
+      refine Array do
+        def quote(sep = ' ')
+          map {|v| Util.quote(v) }.join(sep)
+        end
+        alias_method :q, :quote
+
+
+        def squote(sep = ' ')
+          map {|v| Util.squote(v) }.join(sep)
+        end
+        alias_method :sq, :squote
+
+
+        def slash
+          map {|v| Util.slash(v) }.join(' ')
+        end
+      end
+    end
+
+    class Context
+      using Refinements
+
+      def initialize(pwd: nil, **kw)
+        @pwd = pwd
+        kw.each do |k,v|
+          define_singleton_method(k) { v }
+        end
+      end
+
+
+      def _process(template)
+        Dir.chdir(@pwd || Dir.pwd) do
+          ::ERB.new(template).result(binding)
+        end
+      end
+    end
+
+
+    def initialize(pwd: nil, **kw)
+      @context = Context.new(pwd: pwd, **kw)
+    end
+
+
+    def process(text)
+      @context._process(text)
+    end
+
+  end
+end

data/lib/cult/transferable.rb

@@ -0,0 +1,61 @@
+require 'cult/template'
+
+module Cult
+  module Transferable
+
+    module ClassMethods
+      def collection_name
+        name.split('::')[-1].downcase + 's'
+      end
+    end
+
+
+    def self.included(cls)
+      cls.extend(ClassMethods)
+    end
+
+
+    def collection_name
+      self.class.collection_name
+    end
+
+
+    def remote_path
+      File.join(role.remote_path, role_relative_path)
+    end
+
+
+    def role_relative_path
+      File.join(collection_name, relative_path)
+    end
+
+
+    def binary?
+      !! File.read(path, 512).match(/[\x00-\x08]/)
+    end
+
+
+    def contents(project, role, node, pwd: nil)
+      if binary?
+        File.read(path)
+      else
+        erb = Template.new(pwd: pwd, project: project, role: role, node: node)
+        erb.process File.read(path)
+      end
+    end
+
+
+    def name
+      prefix = File.join(role.path, collection_name) + "/"
+      if path.start_with?(prefix)
+        path[prefix.size .. -1]
+      end
+    end
+
+
+    def file_mode
+      File.stat(path).mode & 0777
+    end
+
+  end
+end

data/lib/cult/version.rb

@@ -0,0 +1,3 @@
+module Cult
+  VERSION = '0.1.1.pre'
+end

data/lib/cult.rb

@@ -0,0 +1,4 @@
+require 'cult/version'
+
+module Cult
+end

data/skel/.cultconsolerc

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+# This file is loaded right before `cult console` is launched. You have access
+# to the same scope as the console.

data/skel/.cultrc.erb

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+
+# This file is loaded every time the cult command is run in the project
+# directory.  If there's any special setup you'd like to do, this is the place
+# to do it.
+
+# Note: This file MUST exist, even if you're not doing anything with it.  It's
+# how the Cult tool decides whether a directory is a project or not.
+
+
+Cult.project.instance_eval do
+  # In this this scope, you're in a context very similar to the console, where
+  # `nodes`, `roles`, `providers` etc, work as you'd expect.
+
+  # This marks the version of Cult the project was created with.  If future
+  # versions of Cult have backward-incompatible changes, it'll know you expect
+  # the behavior of this version.
+  self.cult_version = <%= Cult::VERSION.sq %>
+
+  # Git integration is great, it basically makes sure you stay in sync.  If
+  # this was enabled with the generator (it <%=project.git? ? 'was' : "wasn\'t" %>), you've already got a Git
+  # project and everything was committed.
+  self.git_integration = <%= !! project.git_integration %>
+
+  # If you don't set this, the project's default_provider will be nil until one
+  # is created, and otherwise, the first one.  This really only comes into play
+  # when you're using multiple providers.
+  # self.default_provider = providers[/my-vps/]
+end

data/skel/README.md.erb

@@ -0,0 +1,22 @@
+# <%= project.name %>
+
+This is project is managed by [Cult][1].  You'll need to install it to do
+anything useful.
+
+## A Tour
+
+Cult projects have a defined directory structure:
+
+  * `keys/{public,private}`: SSH keys you'll need to log in to the fleet.  Cult
+    will work without these, assuming the keys you'll need are known to SSH when
+    you try to command nodes.  It is up to your policy if `keys/private` gets
+    checked into source control.
+  * `nodes/(nodename)`: Nodes are created by the `cult nodes create your-node-name`
+    command, and live here.  A node represents information about a living,
+    breathing actual machine out there.
+  * `roles/(rolename)`: A node has one or more roles.  When you synchronize a
+    node, it's applying rules to conform to its role.  Generate new roles with
+    `cult roles create your-role-name`
+  * `vps`: Configuration for your VPS.
+
+[1]: https://github.com/metermd/cult/ "Cult"

data/skel/roles/all/role.json

@@ -0,0 +1,4 @@
+{
+  "includes": [],
+  "user": "cult"
+}

data/skel/roles/all/tasks/00000-do-something-cool

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -e
+
+# This will be the first (normal) Task to be run on your new server.  Rename
+# it, and make it do something useful.
+
+# This file will be processed by ERB right before it's shipped to a Node, so
+# you can customize it based on the node, roles, project, etc.
+
+# The ERB helper has quite a few methods for shell-escaping, for example:
+
+# The "q" method quotes a string with double-quotes.
+echo <%= node.name.q %>
+
+# The "sq" method single-quotes the string.
+echo <%= node.name.sq %>
+
+# "slash" does shell slash-escaping, e.g., I\'m\ Awesome
+echo <%= node.name.slash %>
+
+# The same methods work on Array (over each item), and have an optional
+# separator argument, which defaults to ' '
+echo <%= node.roles.sq %>
+
+# This script executes in the task directory, so files are accessible as
+# "files/something".  Text files in files/ are also pre-processed through IRB,
+# with the same context.

data/skel/roles/bootstrap/files/cult-motd

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+set -e
+
+NODE=<%= node.name.sq %>
+ROLES=<%= node.roles.map(&:name).sq %>
+SPAWN=<%= Time.now.to_s.sq %>
+
+colorize() {
+  i=124
+  d=1
+  while IFS='' read -r LINE ; do
+    printf "\e[38;5;${i}m$LINE\e[0m\n"
+    i=$(($i + $d))
+    if [ $i -eq 124 ] ; then
+      d=1
+    elif [ $i -eq 135 ] ; then
+      d=-1
+    fi
+  done
+}
+
+inf() {
+  TEXT=$(echo "$1" | fold -s -w 60 | fmt -s -c -w 78)
+  printf '\e[38;5;8m%s\e[0m\n' "$TEXT"
+}
+
+# We don't want everyone to have to install figlet.
+cat <<EOD | colorize
+
+                     @@@@@@@  @@@  @@@  @@@       @@@@@@@
+                    @@@@@@@@  @@@  @@@  @@@       @@@@@@@
+                    !@@       @@!  @@@  @@!         @@!
+                    !@!       !@!  @!@  !@!         !@!
+                    !@!       @!@  !@!  @!!         @!!
+                    !!!       !@!  !!!  !!!         !!!
+                    :!!       !!:  !!!  !!:         !!:
+                    :!:       :!:  !:!   :!:        :!:
+                     ::: :::  ::::: ::   :: ::::     ::
+                     :: :: :   : :  :   : :: : :     :
+
+EOD
+
+inf "node: $NODE, since $SPAWN"
+inf "roles: $ROLES"
+echo

data/skel/roles/bootstrap/role.json

@@ -0,0 +1,4 @@
+{
+  "includes": [],
+  "user": "root"
+}

data/skel/roles/bootstrap/tasks/00000-set-hostname

@@ -0,0 +1,22 @@
+#!/bin/sh
+set -e
+
+# We make sure this node has a valid hostname.  Different VPS providers handle
+# this differently, and sudo will be weird if it can't resolve its hostname.
+
+NODE_NAME=<%= node.name.q %>
+
+echo "$NODE_NAME" > /etc/hostname
+hostname "$NODE_NAME"
+
+HOSTS=$(cat /etc/hosts | sed -e 's/#.*//g' | sed -e 's/\t/ /g' | tr -s ' ' | \
+        grep -v '^\s*$' | cut -d' ' -f2-)
+
+# See if we're in hosts
+if ! echo "$HOSTS" | grep -q "$NODE_NAME" ; then
+  echo "127.0.1.1 $NODE_NAME" >> /etc/hosts
+  echo "::1 $NODE_NAME" >> /etc/hosts
+fi
+
+# Make the SSH experience a little nicer with the full hostname in the prompt
+echo "export PS1='\u@\H:\w\$ '" > /etc/bash.bashrc

data/skel/roles/bootstrap/tasks/00001-add-cult-user

@@ -0,0 +1,21 @@
+#!/bin/sh
+set -e
+
+# We move root's authorized_keys to a new 'cult' user, disable the root account,
+# and give 'cult' sudo superpowers.
+
+adduser --disabled-password --gecos 'Cult Deployment Account' cult
+
+mkdir -p /home/cult/.ssh
+mv "$HOME/.ssh/authorized_keys" /home/cult/.ssh
+chown -R cult:cult /home/cult/.ssh
+chmod -R 0700 /home/cult/.ssh
+chmod -R 0600 /home/cult/.ssh/*
+
+echo 'cult ALL=(ALL) NOPASSWD:ALL' > /etc/sudoers.d/cult-nopasswd
+
+# disable root account
+passwd -l root
+sed -i.bak -e 's/^PermitRootLogin.*/PermitRootLogin no/' /etc/ssh/sshd_config
+
+systemctl reload sshd

data/skel/roles/bootstrap/tasks/00002-install-cult-motd

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+set -e
+
+if [ -d "/etc/update-motd.d" ]; then
+  sudo cp "files/cult-motd" "/etc/update-motd.d/99-cult-motd"
+  sudo chmod +x "/etc/update-motd.d/99-cult-motd"
+elif [ -f "/etc/motd" ]; then
+  ./files/cult-motd | sudo tee -a "/etc/motd"
+fi

metadata

@@ -0,0 +1,183 @@
+--- !ruby/object:Gem::Specification
+name: cult
+version: !ruby/object:Gem::Version
+  version: 0.1.1.pre
+platform: ruby
+authors:
+- Mike Owens
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-08-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: cri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.7.0
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.2.0
+- !ruby/object:Gem::Dependency
+  name: net-scp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: 
+email:
+- mike@meter.md
+executables:
+- cult
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- cult
+- cult.gemspec
+- doc/welcome.txt
+- exe/cult
+- lib/cult.rb
+- lib/cult/artifact.rb
+- lib/cult/cli/common.rb
+- lib/cult/cli/console_cmd.rb
+- lib/cult/cli/cri_extensions.rb
+- lib/cult/cli/init_cmd.rb
+- lib/cult/cli/load.rb
+- lib/cult/cli/node_cmd.rb
+- lib/cult/cli/provider_cmd.rb
+- lib/cult/cli/role_cmd.rb
+- lib/cult/cli/task_cmd.rb
+- lib/cult/commander.rb
+- lib/cult/config.rb
+- lib/cult/definition.rb
+- lib/cult/driver.rb
+- lib/cult/drivers/common.rb
+- lib/cult/drivers/digital_ocean_driver.rb
+- lib/cult/drivers/linode_driver.rb
+- lib/cult/drivers/load.rb
+- lib/cult/drivers/script_driver.rb
+- lib/cult/drivers/vultr_driver.rb
+- lib/cult/named_array.rb
+- lib/cult/node.rb
+- lib/cult/project.rb
+- lib/cult/provider.rb
+- lib/cult/role.rb
+- lib/cult/skel.rb
+- lib/cult/task.rb
+- lib/cult/template.rb
+- lib/cult/transferable.rb
+- lib/cult/version.rb
+- skel/.cultconsolerc
+- skel/.cultrc.erb
+- skel/README.md.erb
+- skel/keys/.keep
+- skel/nodes/.keep
+- skel/providers/.keep
+- skel/roles/all/role.json
+- skel/roles/all/tasks/00000-do-something-cool
+- skel/roles/bootstrap/files/cult-motd
+- skel/roles/bootstrap/role.json
+- skel/roles/bootstrap/tasks/00000-set-hostname
+- skel/roles/bootstrap/tasks/00001-add-cult-user
+- skel/roles/bootstrap/tasks/00002-install-cult-motd
+homepage: https://github.com/metermd/cult
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.6
+signing_key: 
+specification_version: 4
+summary: Fleet Management like its 1990
+test_files: []