Houcho is obsoleted.

Do not plan to future maintenance.

---

Houcho

• wrapping to execute serverspec
• depends on ruby 1.9.3 later(recommended: 2.0.0 later).

Install and Initialize

• install houcho from ruby gems

  $ gem install houcho

• initialize working directory.

  • set houcho repository on directory set environment variable HOUCHO_ROOT
  • default: /etc/houcho

$ houcho init $ ls /etc/houcho houcho.conf houcho.db log outerrole script spec

## Simple Usage
- example of the most simplest use case

```sh
$ houcho spec exec houcho_sample --hosts test.studio3104.com 

• run houcho_sample_spec.rb to test.studio3104.com
• arguments are able to specify multiple space-delimited.
• argument of spec exec is able to specify exception of _spec.rb, and relative path from spec/ under working directory.

Create Role, Run Role

Houcho is able to define role of combination to be used well.

• create role at first.

  $ houcho role create studio3104::www

• attach hosts to role just created.

  $ houcho host attach www01.studio3104.com www02.studio3104.com --roles studio3104::www

• attach specs to role.

• argument is able to specify exception of _spec.rb, and relative path from spec/ under working directory same as simple usage.

  $ houcho spec attach houcho_sample houcho_sample2 --roles studio3104::www

• show details of a role just created.

$ houcho role details studio3104::www [studio3104::www] host ├─ www01.studio3104.com └─ www02.studio3104.com

spec ├─ houcho_sample └─ houcho_sample2

- execute role.
- it can specify multiple space-delimited.

```sh
$ houcho role exec studio3104::www

• it is also possible to use regular expressions.

  $ houcho role exec studio3104.+

Include CloudForecast's yaml file

Houcho is able to load yaml of CloudForecast, and attach to the role defined.

• install yaml of CloudForecast to ${HOUCHO_ROOT}/outerrole/cloudforecast/ under working directory.

• extension have to be yaml.

• load cloudforecast's yaml.

  • run each time you replace the yaml. do not need to run every time.

$ houcho outerrole load $ houcho outerrole list houcho::author::studio3104 $ houcho cf details houcho::author::studio3104 [houcho::author::studio3104] host ├─ studio3104.test └─ studio3105.test

  
- attach to the original role defined, the role read from cloudforecast.

```sh
$ houcho outerrole attach houcho::author::studio3104 --roles studio3104::www
$ houcho role details studio3104::www
[studio3104::www]
 host
 ├─ www01.studio3104.com
 └─ www02.studio3104.com

 spec
 ├─ houcho_sample
 └─ houcho_sample2
 
 outer role
    houcho::author::studio3104
       host
       ├─ studio3104.test
       └─ studio3105.test

Setting Attribute to Role, Outer Role, Host

• houcho is able to set individual attribute.

• For example, you have a spec file like this.

  require "spec_helper"
  
  describe file(attr[:httpd_conf]) do
    it { should contain "SSLCompression\soff" }
  end
  

• set variable attr[:httpd_conf] to be evaluated at runtime.

  $ houcho attr set --target role:studio3104::www --value httpd_conf:/etc/httpd/conf/httpd.conf
  

  • args of --target's key can specify host, role, outerrole

Applied Usage

• at modified specs, run specs by sampling appropriately host.

  • --samples can specifies the number of samples(default: 5)
  • argument is able to specify exception of _spec.rb, and relative path from spec/ under working directory same as simple usage.

$ houcho spec check houcho_sample hogehogechan 7 examples, 7 failures studio3109.test => houcho_sample 7 examples, 7 failures studio3110.test => houcho_sample 7 examples, 7 failures www02.studio3104.com => houcho_sample 7 examples, 7 failures studio3105.test => houcho_sample 7 examples, 7 failures studio3104.test => houcho_sample hogehogechan has not attached to any roles

- Run exclude from the target some hosts that are included in the role of cloudforecast.

```sh
$ houcho role exec studio3104::www --exclude-hosts studio3104.test

TODO

• write more tests