Vagrant Talk (Drupalcamp NJ & Drupalcamp Ottawa)

Intro-to-Vagrant-for-Drupal.md

Vagrant tutorial

• Slideshow structure
  • About me - Alex Dergachev, co-founder @evolvingweb (follow me gh/twitter: @dergachev)
  • The problem
  • The solution - Chef & Virtualbox & Vagrant
    • Benefits
      • repo + sql dump + cookbooks + ubuntu ISO = Drupal stack
      • prod vs dev consistency
      • sysadmin code reuse
        • like packages but configurable
        • write your own!
      • version control for sysadmins
        • code is the best documentation
      • turn it off and on again
    • Nice Virtualbox Features
      • folder sharing
      • snapshots
      • networking
  • What vagrant is
    • Installing (virtualbox, vagrantup.com)
    • Vagrantfile
      • config.vm.forward_port 80, 4567
      • config.vm.box = "precise64"
      • config.vm.share_folder "foo", "/guest/path", "/host/path", :nfs => true
      • config.vm.network :hostonly, "10.11.12.13" "config.vm.network :bridged"
      • config.vm.customize ["modifyvm", :id, "--memory", 1024]
      • config.vm.provision :shell, :inline => "echo foo > /vagrant/test"
      • support for multiple VMs
    • Base boxes
    • Docs
    • Workflow
      • vagrant box add precise64 http://files.vagrantup.com/precise64.box "http://www.vagrantbox.es/ - but do you trust them? base boxes"
      • vagrant init
      • vagrant up "--no provision"
      • vagrant reload
      • vagrant provision
      • vagrant destroy --force && vagrant up
      • vagrant ssh "vagrant ssh -p -- -l alex"
      • ls /vagrant "inside the VM"
      • vagrant package
      • vagrant snap
  • Provisioning
    • Shell
      • config.vm.provision :shell, :inline => "echo "Europe/London" | sudo tee /etc/timezone && dpkg-reconfigure --frontend noninteractive tzdata"
    • Chef-solo
      • Client vs server
      • examples from http://docs.vagrantup.com/v1/docs/provisioners/chef_solo.html " config.vm.provision :chef_solo do |chef| chef.cookbooks_path = ["cookbooks", "~/company/cookbooks"] chef.add_recipe("apache") chef.add_recipe("php") chef.json = { :load_limit => 42, :chunky_bacon => true } end"
      • http://fnichol.github.com/iterative_chef/
  • Chef tutorial
    • http://wiki.opscode.com/display/chef/Chef+Basics
    • http://docs.opscode.com/essentials_cookbooks.html
      • cookbook file structure
    • https://github.com/opscode-cookbooks "officially supported cookbooks"
  • Drupal-chef
    • https://github.com/msonnabaum/chef-drush
    • https://github.com/dergachev/vagrant_drupal
    • other cookbooks
      • https://github.com/xforty/chef-drupal
      • https://github.com/myplanetdigital/vagrant-ariadne
  • Testing
    • TravisCI,
      • https://github.com/learnchef/deploy_drupal/tree/master/cookbooks/drupal
    • https://github.com/calavera/minitest-chef-handler
  • See also
    • cookbook tools
      • https://github.com/applicationsonline/librarian
      • http://berkshelf.com/ "http://vialstudios.com/guide-authoring-cookbooks.html"
    • chef server, opscode
    • vagrant extensions
      • https://github.com/jedi4ever/veewee
      • https://github.com/t9md/vagrant-snap
    • other chef/vagrant tutorials
      • http://vialstudios.com/guide-authoring-cookbooks.html
    • my other stuff
      • https://gist.github.com/3866825#vagrant-tutorial
        • https://github.com/dergachev/chef_homesick_agent#readme
    • More about vagrant
      • https://github.com/mitchellh/vagrant
      • http://docs.vagrantup.com/v1/docs/index.html
      • #vagrant on irc
    • More about chef
      • http://wiki.opscode.com/display/chef "read all of it"
      • http://docs.opscode.com/
      • #ChefConf 2013 " April 24-26 in SFO"
  • My notes
    • console2 for powershell

Gist with notes from the BoF this afternoon: https://gist.github.com/4699228

Ruby-and-Chef.md

Ruby for Chef

Just enough not to freak out

Methods

def double(num)
  num * 2
end
double 33 # => 66

Ruby Strings

:bob == 'bob'.to_sym
%w{git apache2 mysql} == ['git', 'apache2', 'mysql']
"head #{variable} tail" == "head " +  variable + " tail"

Ruby dictionaries

options = {
  :deploy_drupal => { 
    :apache_group => 'vagrant', 
    :sql_load_file => '/vagrant/db/fga.sql.gz',
    :source =>  "/vagrant/public/fga/www",
  },
  :mysql => {
    :server_root_password => "root",
  },
}

DSL

template "/etc/mysql/drupal-grants.sql" do
  path "/etc/mysql/drupal-grants.sql"
  source "grants.sql.erb"
  owner "root"
  group "root"
  mode "0600"
  notifies :run, "execute[mysql-install-drupal-privileges]", :immediately
end

In javascript:

template("/etc/mysql/drupal-grants.sql", function() {  
  this.path("/etc/mysql/drupal-grants.sql");
  this.source("grants.sql.erb");
  this.owner("root");
  this.group("root");
  this.mode("0600");
  this.notifies('run', "execute[mysql-install-drupal-privileges]", 'immediately');
});

---

Chef Basics

What can recipes do?

Install a user

user "sam" do
     home "/home/sam"
     shell "/bin/zsh"
     comment "Sam loves DevOps"
     action :create
     password :$1$pfFfDG3M$22vsMsPnn93ZnuodI86Ec0
end

Install a template

template '/var/www/sites/default/settings.php' do
  # action :create
  # action :create_if_missing
  source "settings.php.erb"
  variables ( {
    :user => 'root',
    :pass => node[:mysql]['root_password'],
    :name => 'drupalsite_v1',
  })
end

Install packages

package "tar" do
  action :install
end
package %w{vim git}
php_pear "uploadprogress"
gem_package "syntax"

Execute bash

execute "download drupal" do
  cwd '/var/www'
  command "drush dl drupal-7.20"
  creates '/var/www/drupal-7.20/index.php'
end

Deploy from git

deploy "/my/deploy/dir" do
  repo "git@github.com/mycompany/project"
  user "www-data"
  group "www-data"
  revision "master"
  action :sync # default value, also :checkout
end

defining and controlling service daemons

# runs /etc/init.d/apache2 (start|stop|restart), etc.
service "apache2" do
  supports :status => true, :restart => true, :reload => true
  action [ :enable, :start ]
end

apache cookbook: webapp LWRP

web_app 'drupalcampottawa' do
  template "web_app.conf.erb"
  port 80
  server_name 'drupalcampottawa.com'
  docroot '/var/www/dcampottawa'
  notifies :restart, resources("service[apache2]"), :delayed
end

Cookbook structure