目次

• Cucumber って？
• 振舞駆動開発（BDD）って？
• Cucumber-Chef って？
• もろもろインストール
• Cucumber-Chef のセットアップ
• Hello World!
• その他のコマンド／ツール

Cucumber って？

• 振舞駆動開発（Behavior Driven Development; BDD） に基づいた受け入れテストを行う為のツール
• Ruby で書かれているが、テストする対象は縛られない。
• Ruby のライブラリ／ツールを利用すれば、ブラウザをエミュレートしてサイトの動作テストも可能
• Gherkin と呼ばれる自然言語に近い形の文法でテストケースを記述
• Feature(Background、Scenario) と呼ばれるテストケースと、Step と呼ばれる実際のテストコードの対でテストが実行される。
• あくまで外部から見た振舞いを記述するものなので、実装に関わる内部の変数等は記述しないことに要注意

振舞駆動開発（BDD）って？

• 振舞駆動開発は、テスト駆動開発から派生したものである。
• しかし、個々の実装（プログラム）レベルのテストではなく、結果としての振る舞い（仕様）を記述、テストするところが大きく異なる。
• その為、外部仕様、要求仕様（スペック）に適合するようにプログラムを作成するというより自然な開発の流れになる。
• また、コード（実装）をリファクタリングした際にも、同じテストがそのまま使用可能となる。
• 記述したテストケースは、開発完了後の仕様確認、受け入れテストとしても利用可能である。

Cucumber-Chef って？

• Cucumber を Chef に特化し、かつ、そのテスト環境の構築から実際のテストまでを一元、自動化するツール
• 現在はテスト環境として EC2 のみを利用しているが、次期バージョン（v2.1.0）から Vagrant（VirtualBox）も選択可能
• テスト環境の構築やインフラに対する基本的なテストコード（Step）が予め組み込まれており、それに合わせたテストケース（Scenario）を書くことにより、より速く簡単にテストが可能
• 同様のものに Opscode が提供する Test-Kitchen がある。
  Cookbook 単体のテストに特化されており、Vagrant を使用して様々なOS環境下での動作確認が可能である。
  ただし、予め完成された Cookbook、Chef 環境を前提としており、BDD としての利用や手軽に始められる感じではない。

もろもろインストール

• Ruby / RVM（Ruby 環境の管理ツール）のインストール

  $ \curl -L https://get.rvm.io | bash -s stable
  $ source ~/.rvm/scripts/rvm
  $ rvm requirements
  $ brew install autoconf automake apple-gcc42 ... # 環境によって異なる
  $ rvm install 1.9.3
  

• Bundler（アプリ環境の隔離化ツール）のインストール

  $ gem install bundler
  

• Cucumber-Chef のインストール

  $ mkdir <project-home>
  $ cd <project-home>
  $ rvm --rvmrc --create 1.9.3
  $ vi Gemfile
  

  source :rubygems
  gem "cucumber-chef",
    :git => "git://github.com/Atalanta/cucumber-chef",
    :tag => "v2.1.0.rc.15"  # v2.1.0.rc.12~14 はバグあり
  gem "vagrant"  # v2.1.0.rc.12 以降、Vagrant は別途インストールが必要
  

  $ bundle --path=vendor/bundle
  

Cucumber-Chef のセットアップ

• Cucumber-Chef のコンフィグレーションファイルの作成

  $ mkdir .chef  # ダミー
  $ bundle exec cucumber-chef init
  $ vi .cucumber-chef/config.rb
  

  provider                        :vagrant
  librarian_chef                  false
  lxc_user                        "root"
  lab_user                        "ubuntu"
  prerelease                      true
  
  <中略>
  
  # TODO
  vagrant[:identity_file]      = "~/.vagrant.d/insecure_private_key"
  

• Knife のコンフィグレーションファイルの作成（ダミー）

  $ mkdir -p .cucumber-chef/vagrant
  $ touch .cucumber-chef/vagrant/knife.rb
  $ bundle exec cucumber-chef displayconfig  # 設定の確認
  

Cucumber-Chef のセットアップ

• Vagrant のコンフィグレーションファイルの作成

  $ bundle exec vagrant init precise64
  $ vi Vagrantfile
  

    config.vm.box       = "precise64"
    config.vm.box_url = "http://files.vagrantup.com/precise64.box"
  
    config.vm.customize ["modifyvm", :id, "--memory", 512]  # メモリは適宜
  
  <中略>
  
    config.vm.forward_port 4000, 4000
    config.vm.forward_port 4040, 4040
    config.vm.forward_port 8787, 8787
  

• Chef Server の構築

  $ bundle exec cucumber-chef setup
  

  ※ 環境にもよるが完了まで10分以上かかる

Cucumber-Chef のセットアップ

• LXC コンテナ（Node）の環境設定

  $ bundle exec cc-knife cookbook create chef-client
  $ bundle exec cucumber-chef create devopserver
  $ vi features/devopserver/devopserver.feature
  

  @devopserver
  Feature: Perform test driven infrastructure with Cucumber-Chef
    In order to learn how to develop test driven infrastructure
    As an infrastructure developer
    I want to better understand how to use Cucumber-Chef
  
    Background:
      * I have a server called "devopserver"
      * "devopserver" is running "ubuntu" "precise"
      * "devopserver" has been provisioned
      * the following cookbooks have been uploaded:
        | cookbook | cookbook_path |
        | chef-client | ./cookbooks |
      * the "chef-client::default" recipe has been added to the "devopserver" run list
      * the chef-client has been run on "devopserver"
      * I ssh to "devopserver" with the following credentials:
        | username | keyfile |
        | $lxc$ | $lxc$ |
  
  <以下略>
  

Cucumber-Chef のセットアップ

• LXC コンテナ（Node）の構築と Cucumber の動作確認

  $ bundle exec cucumber
  

    * cucumber-chef v2.1.0.rc.15
  @devopserver
  Feature: Perform test driven infrastructure with Cucumber-Chef
    In order to learn how to develop test driven infrastructure
    As an infrastructure developer
    I want to better understand how to use Cucumber-Chef
  
    Background:                                                                        # features/devopserver/devopserver.feature:7
      * I have a server called "devopserver"                                           # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/provision_steps.rb:22
      * "devopserver" is running "ubuntu" "precise"                                    # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/provision_steps.rb:26
      * "devopserver" has been provisioned                                             # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/provision_steps.rb:46
      * the following cookbooks have been uploaded:                                    # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/chef_steps.rb:57
        | cookbook    | cookbook_path |
        | chef-client | ./cookbooks   |
      * the "chef-client::default" recipe has been added to the "devopserver" run list # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/provision_steps.rb:54
      * the chef-client has been run on "devopserver"                                  # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/provision_steps.rb:62
      * I ssh to "devopserver" with the following credentials:                         # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/ssh_steps.rb:28
        | username | keyfile |
        | $lxc$    | $lxc$   |
  
  <以下略>
  

  ※ 初回起動時のみ precise のルートファイルシステムを作成するため時間が掛かる
  ※ 空のレシピの為、正常の場合でも最後のシナリオは失敗する

Cucumber-Chef のセットアップ

• LXC コンテナ（Node）の破棄

  $ bundle exec cucumber-chef destroy devopserver
  

  ※ コンテナは破棄されるが、precise のルートファイルシステムは残る。

Hello World!

• Cucumber Scenario の作成
  

  $ vi features/devopserver/devopserver.feature
  

  @devopserver
  Feature: Perform test driven infrastructure with Cucumber-Chef
    In order to learn how to develop test driven infrastructure
    As an infrastructure developer
    I want to better understand how to use Cucumber-Chef
  
    Background:
      * I have a server called "devopserver"
      * "devopserver" is running "ubuntu" "precise"
      * "devopserver" has been provisioned
      * the following cookbooks have been uploaded:
        | cookbook | cookbook_path |
        | hello-world | ./cookbooks |
      * the "hello-world::default" recipe has been added to the "devopserver" run list
      * the chef-client has been run on "devopserver"
      * I ssh to "devopserver" with the following credentials:
        | username | keyfile |
        | $lxc$ | $lxc$ |
  
    Scenario: Say "Hello World!"
      Then file "/tmp/hello-world" should exist
      And file "/tmp/hello-world" should be owned by "root"
      And file "/tmp/hello-world" should contain
        """
        Hello World!
        """
  

Hello World!

• Cookbook の作成
  

  $ mkdir -p cookbooks/hello-world
  $ touch cookbooks/hello-world/README.md
  $ vi cookbooks/hello-world/metadata.rb
  

  name    "Hello World"
  version "0.1.0"
  

• レシピの作成
  

  $ mkdir -p cookbooks/hello-world/recipes
  $ vi cookbooks/hello-world/recipes/default.rb
  

  file "/tmp/hello-world" do
    content "Hello World!\n"
    owner "root"
    group "root"
    mode 0755
    action :create
  end

Hello World!

• Cucumber の実行

  $ bundle exec cucumber
  

    * cucumber-chef v2.1.0.rc.15
  @devopserver
  Feature: Perform test driven infrastructure with Cucumber-Chef
    In order to learn how to develop test driven infrastructure
    As an infrastructure developer
    I want to better understand how to use Cucumber-Chef
  
    Background:                                                                        # features/devopserver/devopserver.feature:7
      * I have a server called "devopserver"                                           # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/provision_steps.rb:22
      * "devopserver" is running "ubuntu" "precise"                                    # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/provision_steps.rb:26
      * "devopserver" has been provisioned                                             # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/provision_steps.rb:46
      * the following cookbooks have been uploaded:                                    # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/chef_steps.rb:57
        | cookbook    | cookbook_path |
        | hello-world | ./cookbooks   |
      * the "hello-world::default" recipe has been added to the "devopserver" run list # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/provision_steps.rb:54
      * the chef-client has been run on "devopserver"                                  # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/provision_steps.rb:62
      * I ssh to "devopserver" with the following credentials:                         # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/ssh_steps.rb:28
        | username | keyfile |
        | $lxc$    | $lxc$   |
  
    Scenario: Say "Hello World!"                                                       # features/devopserver/devopserver.feature:20
  hello-world
  regular file
      Then file "/tmp/hello-world" should exist                                        # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/ssh_steps.rb:88
  root:root
      And file "/tmp/hello-world" should be owned by "root"                            # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/ssh_steps.rb:122
  Hello World!
      And file "/tmp/hello-world" should contain                                       # vendor/bundle/ruby/1.9.1/bundler/gems/cucumber-chef-0f94e45a0de5/lib/cucumber/chef/steps/ssh_steps.rb:131
        """
        Hello World!
        """
  
  1 scenario (1 passed)
  10 steps (10 passed)
  0m11.055s
  

その他のコマンド／ツール

• 作業の中断
  

  $ bundle exec cucumber-chef halt
  

• 作業の再開
  

  $ bundle exec cucumber-chef up
  

• 環境の破棄
  

  $ bundle exec cucumber-chef destroy
  

• Cookbook のチェック：Foodcritic

  $ gem install foodcritic
  $ foodcritic cookbooks/hello-world
  

• Cookbook の取得／管理：Librarian
• Cookbook のデプロイ：Spiceweasel

  ※ Bundler による実行環境下ではそのままでは動作しない

Thank you!

おしまい