houcho 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZjRkYjFlODg2OGNmOTY1ZWY1NzIzMGM0NDZiOTJlZDIyNThiMjcwYQ==
+  data.tar.gz: !binary |-
+    YzYzNDQ0NzI2MmViN2QzNThkMDk5NmMwYjIzOTVkYTBiYjg3OTgzZg==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    NTQwOGM5YWY2MjM0NmYxNDM1ZGY5YmFjNTI5OTlmOTI0ZjBkMzdhNzdhNDAx
+    NDg5Yzk3NzA2M2RlZDU4MmZjYWEwZjBkNjUwZjFkMWI5ZTkwMzg2NGMzNGZi
+    MzU3Y2E5OTI1ZGFkMGY4MTE1Y2U3MjYyZGRlMzZhMTc2MTNhODY=
+  data.tar.gz: !binary |-
+    ODNlM2NiYTBmZTUxZmIyMjI4ZTA3M2Q4OWNiYmJiMWZiNzg5ZGZhOTAzZjMy
+    ZGZjMWFjZTBhMjAwY2QzNjRhMjZjZTFiZmJjZWYyZjQwMzRkODA3OTIwY2Jl
+    MGQ0ZjUxMTJlMDliZmNiMWVjNTRkMjQ4NWViOTE5OWIzMWIzNDE=

data/.gitignore

@@ -0,0 +1,8 @@
+*.swp
+pkg
+coverage
+coverage.data
+rdoc
+.yardoc
+.bundle
+

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gem 'rainbow'
+gem 'parallel_tests'
+gem 'systemu'
+gem 'serverspec'

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 studio3104
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,187 @@
+# Houcho
+- wrapping to execute serverspec
+
+## Install and Initialize
+- git cloneして、bin/にPATHを通します。
+
+  ```sh
+$ git clone git://github.com/studio3104/houcho.git
+$ echo PATH=`pwd`'/houcho/bin:$PATH' >> ~/.bachrc
+  ```
+
+- 作業ディレクトリを作成し、イニシャライズします。
+  - このディレクトリ配下にrole情報やspecなどが蓄積されます。
+  - `houcho init`すると`git init`されます。
+  
+  ```sh
+$ mkdir houcho-repo
+$ cd houcho-repo
+$ houcho init
+  ```
+
+## Simple Usage
+- もっともシンプルな使い方の例。
+
+  ```sh
+$ houcho spec exec --specs houcho_sample --hosts test.studio3104.com 
+  ```
+
+  - `test.studio3104.com`に`houcho_sample_spec.rb`を実行します。
+  - `--specs`,`--hosts`の引数は、スペース区切りで複数指定が可能です。
+  - `--specs`の引数は、作業ディレクトリの`spec/`からの相対パスで、`_spec.rb`を除いて指定します。
+  
+## Create Role, Run Role
+よく使う組み合わせをroleとして定義しておくことが出来ます。
+
+- まずはroleの作成。
+
+  - role名はフリーワードでokです。
+
+    ```sh
+$ houcho role create studio3104::www
+    ```
+  
+  - 作成したroleにホストをattachします。
+    - TODO: 複数指定出来るようにする。
+  
+    ```sh
+$ houcho host attach www01.studio3104.com studio3104::www
+$ houcho host attach www02.studio3104.com studio3104::www
+    ```
+    
+  - specをattachします。
+    - TODO: 複数指定出来るようにする。
+  - simple usageと同じように、作業ディレクトリの`spec/`からの相対パスで、`_spec.rb`を除いて指定します。
+    
+    ```sh
+$ houcho spec attach houcho_sample studio3104::www
+    ```
+
+- 作成したroleの内容を確認します。
+
+  ```sh
+$ houcho role details studio3104::www
+studio3104::www
+
+   [host]
+   ├─ www01.studio3104.com
+   └─ www02.studio3104.com
+
+   [spec]
+   └─ houcho_sample
+  ```
+
+- roleを実行します。
+  - 複数指定が可能です。
+  
+  ```sh
+$ houcho spec exec --roles studio3104::www
+  ```
+  
+  - 正規表現を使うことも出来ます。
+  
+  ```sh
+$ houcho spec exec --roles studio3104.+
+  ```
+  
+
+## Include CloudForecast's yaml file
+cloudoforecastのyamlを読み込み、定義済みのオリジナルroleにattach出来ます。
+
+- cloudforecastのyamlを、`role/cloudforecast/`に設置します。
+  - 拡張子を`yaml`にしておく必要があります。
+  
+- cloudforecastのyamlを読み込みます。(例では`role/cloudforecast/houcho_sample.yaml`を読み込んでいます。)
+  - yamlを置き換えるたびに実行してください。毎回実行する必要はありません。
+  
+  ```sh
+$ houcho cfrole configure
+$ houcho cfrole show
+houcho::author::studio3104
+$ houcho cfrole details houcho::author::studio3104
+[host(s)]
+studio3104.test
+studio3105.test
+studio3106.test
+studio3107.test
+studio3108.test
+studio3109.test
+studio3110.test
+  ```
+    
+- cloudforecastから読み込んだroleを、定義済みのオリジナルroleにattachします。
+  - TODO: 複数指定出来るようにする。
+
+  ```sh
+$ houcho cfrole attach houcho::author::studio3104 studio3104::www
+$ houcho role details studio3104::www
+studio3104::www
+
+   [host]
+   ├─ www01.studio3104.com
+   └─ www02.studio3104.com
+
+   [spec]
+   └─ houcho_sample
+
+   [cloudforecast's]
+      houcho::author::studio3104
+         [host]
+         ├─ studio3104.test
+         ├─ studio3105.test
+         ├─ studio3106.test
+         ├─ studio3107.test
+         ├─ studio3108.test
+         ├─ studio3109.test
+         └─ studio3110.test
+  ```
+  
+## Applied Usage
+- specを修正したときに、該当のspecが関連付けられているホストを適当にサンプリングして実行する。
+  - 複数指定可能。
+  - `--sample-host-count`でサンプル数を指定。(default: 5)
+  - simple usageと同じように、作業ディレクトリの`spec/`からの相対パスで、`_spec.rb`を除いて指定します。
+  
+  ```sh
+$ houcho spec check houcho_sample hogehogechan
+7 examples, 7 failures  studio3109.test, spec/houcho_sample_spec.rb
+7 examples, 7 failures  studio3110.test, spec/houcho_sample_spec.rb
+7 examples, 7 failures  www02.studio3104.com, spec/houcho_sample_spec.rb
+7 examples, 7 failures  studio3105.test, spec/houcho_sample_spec.rb
+7 examples, 7 failures  studio3104.test, spec/houcho_sample_spec.rb
+hogehogechan has not attached to any roles
+  ```
+
+- cloudforecastのroleに含まれている一部のホストを実行対象から外す。
+
+  ```sh
+$ houcho host ignore studio3109.test
+$ houcho role details studio3104::www
+studio3104::www
+
+   [host]
+   ├─ www01.studio3104.com
+   └─ www02.studio3104.com
+
+   [spec]
+   └─ houcho_sample
+
+   [cloudforecast's]
+      houcho::author::studio3104
+         [host]
+         ├─ <ignored>studio3109.test</ignored>
+         ├─ studio3104.test
+         ├─ studio3105.test
+         ├─ studio3106.test
+         ├─ studio3107.test
+         ├─ studio3108.test
+         └─ studio3110.test
+  ```
+
+## TODO
+- testがない
+- attach|detachの引数を複数取れるようにする
+- host ignore|disignoreはなにやら変なので他のやりかた考える
+  - 引数を複数取れるようにもする
+  - disignoreって英語として変
+  - include|excludeにすれば実装はそのままでいいかな・・・

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/houcho

@@ -0,0 +1,254 @@
+#!/usr/bin/env ruby
+# -*- encoding: utf-8 -*-
+
+app_dir = File.expand_path("#{File.dirname(__FILE__)}/..")
+require 'rubygems'
+require 'thor'
+require app_dir + '/lib/Conductor'
+
+def conduct
+  Conductor.new
+end
+
+class Thor::MyHelper < Thor
+  class_option :help, :type => :boolean, :aliases => '-h', :desc => 'Help message.'
+
+  no_tasks do
+    def invoke_task(task, *args)
+      if options[:help] && task.name != 'help'
+        self.class.task_help(shell, task.name)
+      else
+        super
+      end
+    end
+  end
+
+  def self.banner(task, namespace = false, subcommand = true)
+    super
+  end
+end
+
+
+class Spec < Thor::MyHelper
+  namespace :spec
+
+  desc 'details [spec]', 'show details about a spec'
+  def details(spec)
+    conduct.show_spec_details(spec)
+  end
+
+  desc 'show', 'show all of specs'
+  def show
+    conduct.show_all_specs
+  end
+
+  desc 'attach [spec] [role]', 'attach a spec to a role'
+  def attach(spec, role)
+    conduct.attach_spec_to_role(spec, role)
+  end
+
+  desc 'detach [spec] [role]', 'detach a spec from a role'
+  def detach(spec, role)
+    conduct.detach_spec_from_role(spec, role)
+  end
+
+  desc 'check [options]', '指定specを、関連付けられているhostを適当に選んで実行させる'
+  option :sample_host_count, :type => :numeric, :default => 5, :desc => 'サンプルホスト数'
+  def check(*args)
+    if args.empty?
+      self.class.task_help(shell, __method__)
+      exit
+    end
+    conduct.check_specs(options[:sample_host_count], args)
+  end
+
+  desc 'exec [options]', 'run serverspec'
+  option :hosts,   :type => :array,   :desc => 'hosts that run specs (required: --specs)'
+  option :specs,   :type => :array,   :desc => 'run specs (requied: --hosts)'
+  option :roles,   :type => :array,   :desc => 'runspecs by role'
+  option :ukigumo, :type => :boolean, :desc => 'post results to UkigumoServer'
+  option :ikachan, :type => :boolean, :desc => 'post fail results to Ikachan'
+  option :dry_run, :type => :boolean, :desc => 'show commands that may exexute'
+  def exec
+    hosts, specs, roles =
+      (options[:hosts]||[]), (options[:specs]||[]), (options[:roles]||[])
+
+    if (hosts + specs + roles).empty? || (hosts.empty? && ! specs.empty?) || (! hosts.empty? && specs.empty?)
+      self.class.task_help(shell, __method__)
+      exit
+    end
+
+    conduct.runspec_prepare(
+      roles, hosts, specs,
+      {
+        ukigumo: options[:ukigumo],
+        ikachan: options[:ikachan],
+      },
+      options[:dry_run],
+    )
+  end
+end
+
+
+class Host < Thor::MyHelper
+  namespace :host
+
+  desc 'details [host]', 'show details about a host'
+  def details(host)
+    conduct.show_host_details(host)
+  end
+
+  desc 'show', 'show all of hosts'
+  def show
+    conduct.show_all_hosts
+  end
+
+  desc 'attach [host] [role]', 'attach a host to a role'
+  def attach(host, role)
+    conduct.attach_host_to_role(host, role)
+  end
+
+  desc 'detach [host] [role]', 'detach a host from a role'
+  def detach(host, role)
+    conduct.detach_host_from_role(host, role)
+  end
+
+  desc "ignore [host]", "add host to ignore list"
+  def ignore(host)
+    conduct.ignore_host(host)
+  end
+
+  desc "disignore [host]", "delete host from ignore list"
+  def disignore(host)
+    conduct.disignore_host(host)
+  end
+end
+
+
+class Role < Thor::MyHelper
+  namespace :role
+
+  desc 'create [role]', 'cretate a role'
+  def create(role)
+    conduct.create_role(role)
+  end
+
+  desc 'delete [role]', 'delete a role'
+  def delete(role)
+    conduct.delete_role(role)
+  end
+
+  desc 'rename [exist role] [name]', 'rename a role'
+  def rename(role, rename)
+    conduct.rename_role(role, rename)
+  end
+
+  desc 'details [role]', 'show details about a role'
+  def details(role)
+    conduct.show_role_details(role)
+  end
+
+  desc 'show', 'show all of roles'
+  def show
+    conduct.show_all_roles
+  end
+end
+
+
+class CloudForecast < Thor::MyHelper
+  namespace :cfrole
+
+  desc "details [cfrole]", "show details about a cf's role"
+  def details(cf_role)
+    conduct.show_cf_role_details(cf_role)
+  end
+
+  desc 'show', "show all of cf's roles"
+  def show
+    conduct.show_all_cf_roles
+  end
+
+  desc 'attach [cfrole] [role]', 'attach a cf role to a role'
+  def attach(cf_role, role)
+    conduct.attach_cfrole_to_role(cf_role, role)
+  end
+
+  desc 'detach [cfrole] [role]', 'detach a cf role from a role'
+  def detach(cf_role, role)
+    conduct.detach_cfrole_from_role(cf_role, role)
+  end
+
+  desc 'configure', '(re)loading yamls of cloudforecast'
+  def configure
+    conduct.configure_houcho
+  end
+
+end
+
+
+class Runlist < Thor::MyHelper
+  namespace :runlist
+
+  desc 'create [runlist]', 'cretate a runlist'
+  def create(runlist)
+    conduct.create_runlist(runlist)
+  end
+
+  desc 'delete [runlist]', 'delete a runlist'
+  def delete(runlist)
+    conduct.delete_runlist(runlist)
+  end
+
+  desc 'include [role] [runlist]', 'include a role among a runlist'
+  def include(role, runlist)
+    conduct.include_role_among_runlist(role, runlist)
+  end
+
+  desc 'exclude [role] [runlist]', 'exclude a role from a runlist'
+  def exclude(role, runlist)
+    conduct.exclude_role_from_runlist(role, runlist)
+  end
+
+  desc 'rename [exist runlist] [name]', 'rename a runlist'
+  def rename(runlist, rename)
+    conduct.rename_runlist(runlist, rename)
+  end
+
+  desc 'details [runlist]', 'show details about a runlist'
+  def details(runlist)
+    conduct.show_runlist_details(runlist)
+  end
+
+  desc 'show', 'show all of runlists'
+  def show
+    conduct.show_all_runlists
+  end
+end
+
+
+class Houcho < Thor
+  register(CloudForecast, 'cfrole', 'cfrole [attach|detach|show|details|configure]', 'cloudforecastをのyamlから情報を読み込んで操作します')
+  register(Role, 'role', 'role [create|delete|rename|details|show]', 'roleを追加したり情報を表示したり')
+  register(Host, 'host', 'host [attach|detach|show|details|ignore|disignore]', 'hostを追加したり情報を表示したり')
+  register(Spec, 'spec', 'spec [attach|detach|show|details|exec|check]', 'specを追加したり情報を表示したり')
+
+  class_option :help, :type => :boolean, :aliases => '-h', :desc => 'Help message.'
+  no_tasks do
+    def invoke_task(task, *args)
+      if options[:help] && ! %w{role host spec exec cf help}.include?(task.name)
+        Houcho.task_help(shell, task.name)
+      else
+        super
+      end
+    end
+  end
+
+  desc 'init', 'set houcho repository on current directory'
+  def init
+    conduct.initialize_houcho
+  end
+
+end
+
+Houcho.start
+exit! if $fail_runspec