server_maint 0.0.3 → 0.0.4

data/lib/cookbooks/mysql/templates/default/my.cnf.erb

@@ -0,0 +1,211 @@
+#
+# Generated by Chef for <%= node['hostname'] %>
+#
+# Local modifications will be overwritten.
+#
+# The MySQL database server configuration file.
+#
+# You can copy this to one of:
+# - "/etc/mysql/my.cnf" to set global options,
+# - "~/.my.cnf" to set user-specific options.
+#
+# One can use all long options that the program supports.
+# Run program with --help to get a list of available options and with
+# --print-defaults to see which it would actually understand and use.
+#
+# For explanations see
+# http://dev.mysql.com/doc/mysql/en/server-system-variables.html
+
+# This will be passed to all mysql clients
+# It has been reported that passwords should be enclosed with ticks/quotes
+# escpecially if they contain "#" chars...
+# Remember to edit /etc/mysql/debian.cnf when changing the socket location.
+[client]
+port            = <%= node['mysql']['port'] %>
+socket          = <%= node['mysql']['socket'] %>
+
+# Here is entries for some specific programs
+# The following values assume you have at least 32M ram
+
+# This was formally known as [safe_mysqld]. Both versions are currently parsed.
+[mysqld_safe]
+socket          = <%= node['mysql']['socket'] %>
+nice            = 0
+
+[mysqld]
+#
+# * Basic Settings
+#
+
+#
+# * IMPORTANT
+#   If you make changes to these settings and your system uses apparmor, you may
+#   also need to also adjust /etc/apparmor.d/usr.sbin.mysqld.
+#
+
+user            = mysql
+pid-file        = <%= node['mysql']['pid_file'] %>
+socket          = <%= node['mysql']['socket'] %>
+port            = <%= node['mysql']['port'] %>
+basedir         = <%= node['mysql']['basedir'] %>
+datadir         = <%= node['mysql']['data_dir'] %>
+tmpdir          = /tmp
+skip-external-locking
+#
+# Instead of skip-networking the default is now to listen only on
+# localhost which is more compatible and is not less secure.
+bind-address            = <%= node['mysql']['bind_address'] %>
+#
+# * Fine Tuning
+#
+key_buffer              = <%= node['mysql']['tunable']['key_buffer'] %>
+max_allowed_packet      = <%= node['mysql']['tunable']['max_allowed_packet'] %>
+thread_stack            = <%= node['mysql']['tunable']['thread_stack'] %>
+thread_cache_size       = <%= node['mysql']['tunable']['thread_cache_size'] %>
+
+auto-increment-increment = <%= node['mysql']['auto-increment-increment'] %>
+auto-increment-offset    = <%= node['mysql']['auto-increment-offset'] %>
+
+# This replaces the startup script and checks MyISAM tables if needed
+# the first time they are touched
+myisam-recover          = BACKUP
+#max_connections        = 100
+#table_cache            = 64
+#thread_concurrency     = 10
+max_connections         = <%= node['mysql']['tunable']['max_connections'] %>
+wait_timeout            = <%= node['mysql']['tunable']['wait_timeout'] %>
+net_read_timeout        = <%= node['mysql']['tunable']['net_read_timeout'] %>
+net_write_timeout       = <%= node['mysql']['tunable']['net_write_timeout'] %>
+back_log                = <%= node['mysql']['tunable']['back_log'] %>
+table_cache             = <%= node['mysql']['tunable']['table_cache'] %>
+max_heap_table_size     = <%= node['mysql']['tunable']['max_heap_table_size'] %>
+
+#
+# * Query Cache Configuration
+#
+query_cache_limit       = <%= node['mysql']['tunable']['query_cache_limit'] %>
+query_cache_size        = <%= node['mysql']['tunable']['query_cache_size'] %>
+#
+# * Logging and Replication
+#
+# Both location gets rotated by the cronjob.
+# Be aware that this log type is a performance killer.
+#log            = /var/log/mysql/mysql.log
+#
+# Error logging goes to syslog. This is a Debian improvement :)
+<%- if node['mysql']['tunable']['log_error'] %>
+log-error = <%= node['mysql']['tunable']['log_error'] %>
+<%- end %>
+#
+# Here you can see queries with especially long duration
+log_slow_queries        = <%= node['mysql']['tunable']['log_slow_queries'] %>
+long_query_time         = <%= node['mysql']['tunable']['long_query_time'] %>
+<%- if node['mysql']['tunable']['log_queries_not_using_index'] %>
+log-queries-not-using-indexes
+<%- end %>
+#
+# The following can be used as easy to replay backup logs or for replication.
+# note: if you are setting up a replication slave, see README.Debian about
+#       other settings you may need to change.
+#server-id              = 1
+<%- if node['mysql']['tunable']['log_bin'] %>
+log_bin = <%= node['mysql']['tunable']['log_bin'] %>
+log_slave_updates       = <%= node['mysql']['tunable']['log_slave_updates'] %>
+<%- end %>
+<%- if node['mysql']['tunable']['log_bin_trust_function_creators'] %>
+log_bin_trust_function_creators
+<%- end %>
+expire_logs_days        = <%= node['mysql']['tunable']['expire_logs_days'] %>
+max_binlog_size         = <%= node['mysql']['tunable']['max_binlog_size'] %>
+#binlog_do_db           = include_database_name
+#binlog_ignore_db       = include_database_name
+<%- if node['mysql']['tunable']['relay_log'] %>
+relay-log               = <%= node['mysql']['tunable']['relay_log'] %>
+<%- end %>
+sync_binlog             = <%= node['mysql']['tunable']['sync_binlog'] %>
+<%- if node['mysql']['tunable']['skip_slave_start'] %>
+skip_slave_start
+<%- end %>
+
+#
+# * InnoDB
+#
+# InnoDB is enabled by default with a 10MB datafile in /var/lib/mysql/.
+# Read the manual for more InnoDB related options. There are many!
+# You might want to disable InnoDB to shrink the mysqld process by circa 100MB.
+#skip-innodb
+innodb_buffer_pool_size = <%= node['mysql']['tunable']['innodb_buffer_pool_size'] %>
+innodb_log_file_size    = <%= node['mysql']['tunable']['innodb_log_file_size'] %>
+innodb_additional_mem_pool_size = <%= node['mysql']['tunable']['innodb_additional_mem_pool_size'] %>
+innodb_data_file_path   = <%= node['mysql']['tunable']['innodb_data_file_path'] %>
+innodb_file_per_table
+innodb_flush_log_at_trx_commit = <%= node['mysql']['tunable']['innodb_flush_log_at_trx_commit'] %>
+<%- if node['mysql']['tunable']['innodb_flush_method'] %>
+innodb_flush_method     = <%= node['mysql']['tunable']['innodb_flush_method'] %>
+<%- end %>
+innodb_log_buffer_size  = <%= node['mysql']['tunable']['innodb_log_buffer_size'] %>
+<%- if node['mysql']['tunable']['innodb_adaptive_flushing'] %>
+innodb_adaptive_flushing  = <%= node['mysql']['tunable']['innodb_adaptive_flushing'] %>
+<%- end %>
+
+<% if @skip_federated %>
+#
+# * Federated
+#
+# The FEDERATED storage engine is disabled since 5.0.67 by default in the .cnf files
+# shipped with MySQL distributions (my-huge.cnf, my-medium.cnf, and so forth).
+#
+skip-federated
+<% end %>
+#
+# * Security Features
+#
+# Read the manual, too, if you want chroot!
+# chroot = /var/lib/mysql/
+#
+# For generating SSL certificates I recommend the OpenSSL GUI "tinyca".
+#
+# ssl-ca=/etc/mysql/cacert.pem
+# ssl-cert=/etc/mysql/server-cert.pem
+# ssl-key=/etc/mysql/server-key.pem
+
+[mysqldump]
+quick
+quote-names
+max_allowed_packet      = <%= node['mysql']['tunable']['max_allowed_packet'] %>
+
+[mysql]
+#no-auto-rehash # faster start of mysql but no tab completition
+
+[isamchk]
+key_buffer              = <%= node['mysql']['tunable']['max_allowed_packet'] %>
+
+#
+# * NDB Cluster
+#
+# See /usr/share/doc/mysql-server-*/README.Debian for more information.
+#
+# The following configuration is read by the NDB Data Nodes (ndbd processes)
+# not from the NDB Management Nodes (ndb_mgmd processes).
+#
+# [MYSQL_CLUSTER]
+# ndb-connectstring=127.0.0.1
+
+<% case node['platform'] -%>
+<% when "centos", "redhat", "fedora", "suse", "scientific", "amazon"-%>
+#
+# * BerkeleyDB
+#
+# Using BerkeleyDB is now discouraged as its support will cease in 5.1.12.
+skip-bdb
+# Default to using old password format for compatibility with mysql 3.x
+# clients (those using the mysqlclient10 compatibility package).
+old_passwords           = <%= node['mysql']['old_passwords'] %>
+
+<% else -%>
+#
+# * IMPORTANT: Additional settings that can override those from this file!
+#   The files must end with '.cnf', otherwise they'll be ignored.
+#
+!includedir <%= node['mysql']['confd_dir'] %>/
+<% end -%>

data/lib/cookbooks/mysql/templates/default/mysql-server.seed.erb

@@ -0,0 +1,10 @@
+mysql-server-5.0        mysql-server/root_password_again        select <%= node['mysql']['server_root_password'] %>
+mysql-server-5.0        mysql-server/root_password      select <%= node['mysql']['server_root_password'] %>
+mysql-server-5.0        mysql-server-5.0/really_downgrade       boolean false
+mysql-server-5.0        mysql-server-5.0/need_sarge_compat      boolean false
+mysql-server-5.0        mysql-server-5.0/start_on_boot  boolean true
+mysql-server-5.0        mysql-server/error_setting_password     boolean false
+mysql-server-5.0        mysql-server-5.0/nis_warning    note
+mysql-server-5.0        mysql-server-5.0/postrm_remove_databases        boolean false
+mysql-server-5.0        mysql-server/password_mismatch  boolean false
+mysql-server-5.0        mysql-server-5.0/need_sarge_compat_done boolean true

data/lib/cookbooks/mysql/templates/default/port_mysql.erb

@@ -0,0 +1,3 @@
+# MySQL
+-A FWR -p tcp -m tcp --dport 3306 -j ACCEPT
+-A FWR -p udp -m udp --dport 3306 -j ACCEPT

data/lib/cookbooks/mysql/templates/windows/my.cnf.erb

@@ -0,0 +1,61 @@
+#
+# Generated by Chef for <%= node['hostname'] %>
+#
+# Local modifications will be overwritten.
+#
+# The MySQL database server configuration file.
+#
+# One can use all long options that the program supports.
+# Run program with --help to get a list of available options and with
+# --print-defaults to see which it would actually understand and use.
+#
+# For explanations see
+# http://dev.mysql.com/doc/mysql/en/server-system-variables.html
+
+# This will be passed to all mysql clients
+# It has been reported that passwords should be enclosed with ticks/quotes
+# escpecially if they contain "#" chars...
+[client]
+port = 3306
+
+[mysql]
+default-character-set = latin1
+
+[mysqld]
+#
+# * Basic Settings
+#
+port                      = 3306
+basedir                   = <%= node['mysql']['basedir'] %>
+datadir                   = <%= node['mysql']['data_dir'] %>
+character-set-server      = latin1
+default-storage-engine    = INNODB
+sql-mode                  = "STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION"
+
+#
+# * Fine Tuning
+#
+thread_cache_size         = <%= node['mysql']['tunable']['thread_cache_size'] %>
+max_connections           = <%= node['mysql']['tunable']['max_connections'] %>
+table_cache               = <%= node['mysql']['tunable']['table_cache'] %>
+query_cache_size          = <%= node['mysql']['tunable']['query_cache_size'] %>
+tmp_table_size            = 5M
+myisam_max_sort_file_size = 100G
+myisam_sort_buffer_size   = 8M
+key_buffer_size           = 8M
+read_buffer_size          = 64K
+read_rnd_buffer_size      = 256K
+sort_buffer_size          = 212K
+
+#
+# * InnoDB
+#
+# Read the manual for more InnoDB related options. There are many!
+# You might want to disable InnoDB to shrink the mysqld process by circa 100MB.
+#
+innodb_additional_mem_pool_size = 2M
+innodb_flush_log_at_trx_commit  = 1
+innodb_log_buffer_size          = 1M
+innodb_buffer_pool_size         = <%= node['mysql']['tunable']['innodb_buffer_pool_size'] %>
+innodb_log_file_size            = 10M
+innodb_thread_concurrency       = 8

data/lib/cookbooks/mysql/test/features/query_database.feature

@@ -0,0 +1,26 @@
+@server
+Feature: Query database
+
+In order to persist and retrieve my application data
+As a developer
+I want to be able to query the database
+
+  Scenario: Query database
+    Given a new database server with some example data
+     When I query the database
+     Then the expected data should be returned
+
+  Scenario: Update a row
+    Given a new database server with some example data
+     When I update a row in a database table
+     Then the updated data should be returned for subsequent queries
+
+  Scenario: Insert a row
+    Given a new database server with some example data
+     When I insert a new row into a database table
+     Then the inserted data should be returned for subsequent queries
+
+  Scenario: Delete a row
+    Given a new database server with some example data
+     When I delete a row from a database table
+     Then the deleted data should not be returned for subsequent queries

data/lib/cookbooks/mysql/test/features/step_definitions/mysql_steps.rb

@@ -0,0 +1,47 @@
+Given 'a new database server with some example data' do
+
+end
+
+When 'I delete a row from a database table' do
+  delete_chef 'Alison Holst'
+end
+
+When 'I query the database' do
+  select_tv_chefs
+end
+
+When 'I insert a new row into a database table' do
+  insert_chef 'Ainsley Harriott'
+end
+
+When 'I update a row in a database table' do
+  update_chef_name('Paula Deen', 'Paula Hiers Deen')
+end
+
+Then 'the expected data should be returned' do
+  tv_chefs.must_equal(['Alison Holst', 'Nigella Lawson', 'Paula Deen'])
+end
+
+Then 'the inserted data should be returned for subsequent queries' do
+  begin
+    select_tv_chefs.must_include 'Ainsley Harriott'
+  ensure
+    delete_chef 'Ainsley Harriott'
+  end
+end
+
+Then 'the deleted data should not be returned for subsequent queries' do
+  begin
+    select_tv_chefs.must_equal(['Nigella Lawson', 'Paula Deen'])
+  ensure
+    insert_chef 'Alison Holst'
+  end
+end
+
+Then 'the updated data should be returned for subsequent queries' do
+  begin
+    select_tv_chefs.must_equal(['Alison Holst', 'Nigella Lawson', 'Paula Hiers Deen'])
+  ensure
+    update_chef_name('Paula Hiers Deen', 'Paula Deen')
+  end
+end

data/lib/cookbooks/mysql/test/features/support/env.rb

@@ -0,0 +1,3 @@
+require 'minitest/spec'
+World(MiniTest::Assertions)
+MiniTest::Spec.new(nil)

data/lib/cookbooks/mysql/test/features/support/mysql_helpers.rb

@@ -0,0 +1,51 @@
+def query(sql)
+  cmd_prefix = test_client_host ? "ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no root@#{test_client_host}" : ''
+  result = %x{echo "#{sql}" | #{cmd_prefix} mysql --host=#{test_server_host} --user=#{test_user} --password=#{test_password} --skip-column-names #{test_database}}
+  assert $?.success?
+  result
+end
+alias :insert :query
+alias :update :query
+alias :delete :query
+
+def delete_chef(name)
+  delete("DELETE FROM tv_chef WHERE name = '#{name}'")
+end
+
+def insert_chef(name)
+  insert("INSERT INTO tv_chef (name) VALUES('#{name}')")
+end
+
+def select_tv_chefs
+  @tv_chefs = query('SELECT name FROM tv_chef ORDER BY name').split("\n")
+  @tv_chefs
+end
+
+def test_client_host
+  ENV['TEST_CLIENT_HOST']
+end
+
+def test_database
+  'mysql_test'
+end
+
+def test_server_host
+  ENV['TEST_SERVER_HOST'] || 'localhost'
+end
+
+def test_password
+  'neshFiapog'
+end
+
+def test_user
+  'test_user'
+end
+
+def tv_chefs
+  @tv_chefs
+end
+
+def update_chef_name(old_name, new_name)
+  update("UPDATE tv_chef SET name = '#{new_name}' WHERE name = '#{old_name}'")
+end
+

data/lib/cookbooks/mysql/test/kitchen/Kitchenfile

@@ -0,0 +1,5 @@
+cookbook "mysql" do
+  configuration "client"
+  configuration "ruby"
+  configuration "server"
+end

data/lib/cookbooks/mysql/test/kitchen/cookbooks/mysql_test/.gitignore

@@ -0,0 +1 @@
+*.html

data/lib/cookbooks/mysql/test/kitchen/cookbooks/mysql_test/README.md

@@ -0,0 +1,63 @@
+Description
+===========
+
+This cookbook defines acceptance tests for MySQL. It includes:
+
+* A `features` sub-directory where the Cucumber features for the database
+  are defined.
+
+* Creation of a simple test database for the tests to run against.
+
+Usage
+=====
+
+Set environment variable `TEST_SERVER_HOST` to specify the MySQL server to
+connect to. You can optionally set `TEST_CLIENT_HOST` which will test a client
+install by running the same features from a remote client.
+
+Requirements
+============
+
+## Cookbooks:
+
+This cookbook depends on the `mysql` cookbook. It also uses the `database`
+cookbook to create the test database and relies on the `yum` cookbook in order
+to add the EPEL repository on RHEL-derived distributions.
+
+## Platforms:
+
+* Ubuntu
+* CentOS
+
+Attributes
+==========
+
+* `node['mysql_test']['database']` - The name of the test database to create.
+* `node['mysql_test']['username']` - The username of the datbase user.
+* `node['mysql_test']['password']` - The password of the database user.
+
+Recipes
+=======
+
+* `client` - Simply includes `mysql::client` for a vanilla mysql client install.
+* `server` - Includes `mysql::server` to install the server and configures a
+  test database.
+
+License and Authors
+===================
+
+Author:: Andrew Crump <andrew@kotirisoftware.com>
+
+    Copyright:: 2012, Opscode, Inc
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.

data/lib/cookbooks/mysql/test/kitchen/cookbooks/mysql_test/attributes/default.rb

@@ -0,0 +1,27 @@
+#
+# Cookbook Name:: mysql_test
+# Attributes:: default
+#
+# Copyright 2012, Opscode, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# Must be specified for chef-solo for successful re-converge
+override['mysql']['server_root_password'] = 'ebrilvOpCethHienRoj7'
+
+default['mysql_test']['database'] = 'mysql_test'
+default['mysql_test']['username'] = 'test_user'
+default['mysql_test']['password'] = 'neshFiapog'
+
+override['mysql']['bind_address'] = 'localhost'

data/lib/cookbooks/mysql/test/kitchen/cookbooks/mysql_test/metadata.rb

@@ -0,0 +1,10 @@
+maintainer       "Andrew Crump"
+maintainer_email "andrew@kotirisoftware.com"
+license          "Apache 2.0"
+description      "Acceptance tests for mysql"
+long_description IO.read(File.join(File.dirname(__FILE__), 'README.md'))
+version          "0.1.0"
+
+depends          "database"
+depends          "mysql"
+depends          "yum"

data/lib/cookbooks/mysql/test/kitchen/cookbooks/mysql_test/recipes/client.rb

@@ -0,0 +1,20 @@
+#
+# Cookbook Name:: mysql_test
+# Recipe:: client
+#
+# Copyright 2012, Opscode, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+include_recipe "yum::epel" if platform?('centos')

data/lib/cookbooks/mysql/test/kitchen/cookbooks/mysql_test/recipes/server.rb

@@ -0,0 +1,72 @@
+#
+# Cookbook Name:: mysql_test
+# Recipe:: server
+#
+# Copyright 2012, Opscode, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+case node.platform
+  when 'ubuntu'
+    %w{mysql-client libmysqlclient-dev}
+  when 'centos'
+    %w{mysql mysql-devel}
+end.each do |pkg|
+  package pkg do
+    action :nothing
+  end.run_action(:install)
+end
+
+gem_package "mysql" do
+  action :nothing
+end.run_action(:install)
+
+include_recipe "yum::epel" if platform?('centos')
+
+file "/etc/sysconfig/network" do
+  content "NETWORKING=yes"
+  action :create_if_missing
+  only_if { platform?('amazon', 'centos', 'fedora', 'redhat', 'scientific') }
+end
+
+include_recipe 'mysql::server'
+
+mysql_connection = {:host => "localhost", :username => 'root',
+                    :password => node['mysql']['server_root_password']}
+
+mysql_database node['mysql_test']['database'] do
+  connection mysql_connection
+  action :create
+end
+
+mysql_database_user node['mysql_test']['username'] do
+  connection mysql_connection
+  password node['mysql_test']['password']
+  database_name node['mysql_test']['database']
+  host 'localhost'
+  privileges [:select,:update,:insert, :delete]
+  action [:create, :grant]
+end
+
+mysql_conn_args = "--user=root --password=#{node['mysql']['server_root_password']}"
+
+execute 'create-sample-data' do
+  command %Q{mysql #{mysql_conn_args} #{node['mysql_test']['database']} <<EOF
+    CREATE TABLE tv_chef (name VARCHAR(32) PRIMARY KEY);
+    INSERT INTO tv_chef (name) VALUES ('Alison Holst');
+    INSERT INTO tv_chef (name) VALUES ('Nigella Lawson');
+    INSERT INTO tv_chef (name) VALUES ('Paula Deen');
+EOF}
+  not_if "echo 'SELECT count(name) FROM tv_chef' | mysql #{mysql_conn_args} --skip-column-names #{node['mysql_test']['database']} | grep '^3$'"
+end

data/lib/cookbooks/openssl/CONTRIBUTING

@@ -0,0 +1,29 @@
+If you would like to contribute, please open a ticket in JIRA:
+
+* http://tickets.opscode.com
+
+Create the ticket in the COOK project and use the cookbook name as the
+component.
+
+For all code contributions, we ask that contributors sign a
+contributor license agreement (CLA). Instructions may be found here:
+
+* http://wiki.opscode.com/display/chef/How+to+Contribute
+
+When contributing changes to individual cookbooks, please do not
+modify the version number in the metadata.rb. Also please do not
+update the CHANGELOG.md for a new version. Not all changes to a
+cookbook may be merged and released in the same versions. Opscode will
+handle the version updates during the release process. You are welcome
+to correct typos or otherwise make updates to documentation in the
+README.
+
+If a contribution adds new platforms or platform versions, indicate
+such in the body of the commit message(s), and update the relevant
+COOK ticket. When writing commit messages, it is helpful for others if
+you indicate the COOK ticket. For example:
+
+    git commit -m '[COOK-1041] Updated pool resource to correctly delete.'
+
+In the ticket itself, it is also helpful if you include log output of
+a successful Chef run, but this is not absolutely required.