from-scratch 0.1.0 → 0.1.1

data/cookbooks/build-essential/CHANGELOG.md

@@ -0,0 +1,136 @@
+build-essential Cookbook CHANGELOG
+==================================
+This file is used to list changes made in each version of the build-essential cookbook.
+
+v2.2.4 (2015-10-06)
+-------------------
+* Add patch package on Fedora systems
+* Add additional platforms to Kitchen CI
+* Use Chef standard Rubocop file and resolve several issues
+* Update contributing and testing docs
+* Update Gemfile with the latest testing and development deps
+* Add maintainers.md and maintainers.toml files
+* Add chefignore file to limit the files uploaded to the Chef server
+* Add source_url and issues_url metadata for Supermarket
+
+v2.2.3 (2015-04-15)
+-------------------
+* Don’t install omnibus-build-essential on Solaris 10 - We decided it’s easier to use the old GCC that ships with Solaris 10.
+* Use ChefDK for all Travis testing.
+
+v2.2.2 (2015-03-27)
+-------------------
+* Update Solar 10’s omnibus-build-essential to 0.0.5
+
+v2.2.1 (2015-03-23)
+-------------------
+* Install GNU Patch on Solaris 11
+
+v2.2.0 (2015-03-18)
+-------------------
+* [solaris] Differentiate between Solaris 10 and 11
+* [solaris] Add ucb compat package
+* [solaris] Solaris 10 build essential setup
+* Fix metadata to use a string instead of a bool (see #56, #57)
+
+v2.1.3 (2014-11-18)
+-------------------
+* Update metadata for supported versions of OS X (10.7+) as noted from
+  v2.0.0 previously (#38)
+* Clarify requirement to have apt package cache updated in README. (#41)
+* Fix Xcode CLI installation on OS X (#50)
+
+v2.1.2 (2014-10-14)
+-------------------
+* Mac OS X 10.10 Yosemite support
+
+v2.1.0 (2014-10-14)
+-------------------
+* Use fully-qualified names when installing FreeBSD package
+
+v2.0.6 (2014-08-11)
+-------------------
+* Use the resource form of `remote_file` to prevent context issues
+
+v2.0.4 (2014-06-06)
+-------------------
+* [COOK-4661] added patch package to _rhel recipe
+
+
+v2.0.2 (2014-05-02)
+-------------------
+- Updated documentation about older Chef versions
+- Added new SVG badges to the README
+- Fix a bug where `potentially_at_compile_time` fails on non-resources
+
+v2.0.0 (2014-03-13)
+-------------------
+- Updated tested harnesses to use latest ecosystem tools
+- Added support for FreeBSD
+- Added support for installing XCode Command Line Tools on OSX (10.7, 10.8, 10.9)
+- Created a DSL method for wrapping compile_time vs runtime execution
+- Install additional developement tools on some platforms
+- Add nicer log and warning messages with helpful information
+
+**Potentially Breaking Changes**
+
+- Dropped support for OSX 10.6
+- OSX no longer downloads OSX GCC and uses XCode CLI tools instead
+- `build_essential` -> `build-essential` in node attributes
+- `compiletime` -> `compile_time` in node attributes
+- Cookbook version 2.x no longer supports Chef 10.x
+
+v1.4.4 (2014-02-27)
+-------------------
+- [COOK-4245] Wrong package name used for developer tools on OS X 10.9
+
+v1.4.2
+------
+### Bug
+- **[COOK-3318](https://tickets.chef.io/browse/COOK-3318)** - Use Mixlib::ShellOut instead of Chef::ShellOut
+
+### New Feature
+- **[COOK-3093](https://tickets.chef.io/browse/COOK-3093)** - Add OmniOS support
+
+### Improvement
+- **[COOK-3024](https://tickets.chef.io/browse/COOK-3024)** - Use newer package on SmartOS
+
+v1.4.0
+------
+This version splits up the default recipe into recipes included based on the node's platform_family.
+
+- [COOK-2505] - backport omnibus builder improvements
+
+v1.3.4
+------
+- [COOK-2272] - Complete `platform_family` conversion in build-essential
+
+v1.3.2
+------
+- [COOK-2069] - build-essential will install osx-gcc-installer when XCode is present
+
+v1.3.0
+------
+- [COOK-1895] - support smartos
+
+v1.2.0
+------
+- Add test-kitchen support (source repo only)
+- [COOK-1677] - build-essential cookbook support for OpenSuse and SLES
+- [COOK-1718] - build-essential cookbook metadata should include scientific
+- [COOK-1768] - The apt-get update in build-essentials needs to be renamed
+
+v1.1.2
+------
+- [COOK-1620] - support OS X 10.8
+
+v1.1.0
+------
+- [COOK-1098] - support amazon linux
+- [COOK-1149] - support Mac OS X
+- [COOK-1296] - allow for compile-time installation of packages through an attribute (see README)
+
+v1.0.2
+------
+- [COOK-1098] - Add Amazon Linux platform support
+- [COOK-1149] - Add OS X platform support

data/cookbooks/build-essential/README.md

@@ -0,0 +1,108 @@
+Description
+===========
+[![Cookbook Version](http://img.shields.io/cookbook/v/build-essential.svg)][cookbook]
+[![Build Status](http://img.shields.io/travis/chef-cookbooks/build-essential.svg)][travis]
+
+[cookbook]: https://community.chef.io/cookbooks/build-essential
+[travis]: http://travis-ci.org/chef-cookbooks/build-essential
+
+Installs packages required for compiling C software from source. Use this
+cookbook if you wish to compile C programs, or install RubyGems with native
+extensions.
+
+Requirements
+------------
+Chef 11+ and Ohai 6.14+ are required. For the latest list of supported
+platforms, please see the `metadata.rb`.
+
+**Note for Debian platform family:** On Debian platform-family systems, it is recommended that `apt-get update` be run, to ensure that the package cache is updated. It's not in the scope of this cookbook to do that, as it can [create a duplicate resource](https://tickets.chef.io/browse/CHEF-3694). We recommend using the [apt](https://supermarket.chef.io/cookbooks/apt) cookbook to do this.
+
+**Note for OmniOS**: Currently, OmniOS's Ruby package is built with
+GCC 4.6.3, and the path is hardcoded, as the gcc binaries are not
+installed in the default $PATH. This means that in order to install
+RubyGems into the "system" Ruby, one must install `developer/gcc46`.
+[An issue](https://github.com/omniti-labs/omnios-build/issues/19) is
+open upstream w/ OmniOS to rebuild the Ruby package with GCC 4.7.2.
+
+Attributes
+----------
+| Attribute      | Default | Description                       |
+|----------------|:-------:|-----------------------------------|
+| `compile_time` | `false` | Execute resources at compile time |
+
+
+Usage
+-----
+Include the build-essential recipe in your run list:
+
+```sh
+knife node run_list add NODE "recipe[build-essential::default]"
+```
+
+or add the build-essential recipe as a dependency and include it from inside
+another cookbook:
+
+```ruby
+include_recipe 'build-essential::default'
+```
+
+### Gems with C extensions
+For RubyGems that include native C extensions you wish to use with Chef, you
+should do the following.
+
+1. Set the `compile_time` attribute to true in your wrapper cookbook or role:
+
+    ```ruby
+    # Wrapper attribute
+    default['build-essential']['compile_time'] = true
+    ```
+
+    ```ruby
+    # Role
+    default_attributes(
+      'build-essential' => {
+        'compile_time' => true
+      }
+    )
+    ```
+
+1. Ensure that the C libraries, which include files and other assorted "dev"
+type packages, are installed in the compile phase after the build-essential
+recipe is executed. For example:
+
+    ```ruby
+    include_recipe 'build-essential::default'
+
+    package('mypackage-devel') { action :nothing }.run_action(:install)
+    ```
+
+1. Use the `chef_gem` resource in your recipe to install the gem with the native
+extension:
+
+    ```ruby
+    chef_gem 'gem-with-native-extension'
+    ```
+
+
+License & Authors
+-----------------
+- Author: Seth Vargo (<sethvargo@gmail.com>)
+- Author: Joshua Timberman (<joshua@chef.io>)
+- Author: Seth Chisamore (<schisamo@chef.io>)
+
+```text
+Copyright 2009-2015, Chef Software, Inc. (<legal@chef.io>)
+
+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/cookbooks/build-essential/attributes/default.rb

@@ -0,0 +1,20 @@
+#
+# Cookbook Name:: build-essential
+# Attributes:: default
+#
+# Copyright 2008-2012, Chef Software, 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.
+#
+
+default['build-essential']['compile_time'] = false

data/cookbooks/build-essential/libraries/matchers.rb

@@ -0,0 +1,5 @@
+if defined?(ChefSpec)
+  def install_xcode_command_line_tools(resource_name)
+    ChefSpec::Matchers::ResourceMatcher.new(:xcode_command_line_tools, :install, resource_name)
+  end
+end

data/cookbooks/build-essential/libraries/timing.rb

@@ -0,0 +1,124 @@
+#
+# Cookbook Name:: build-essential
+# Library:: timing
+#
+# Copyright 2014, Chef Software, 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.
+#
+
+#
+# This module is used to clean up the recipe DSL and "potentially" execute
+# resources at compile time (depending on the value of an attribute).
+#
+# This library is only for use within the build-essential cookbook. Resources
+# inside the potentially_at_compile_time block will not fire notifications in
+# some situations. This is fixable, but since none of the resources in this
+# cookbook actually use notifications, it is not worth the added technical debt.
+#
+# TL;DR Don't use this DSL method outside of this cookbook.
+#
+module BuildEssential
+  module Timing
+    #
+    # Potentially evaluate the given block at compile time, depending on the
+    # value of the +node['build-essential']['compile_time']+ attribute.
+    #
+    # @example
+    #   potentially_at_compile_time do
+    #     package 'apache2'
+    #   end
+    #
+    # @param [Proc] block
+    #   the thing to eval
+    #
+    def potentially_at_compile_time(&block)
+      if compile_time?
+        CompileTime.new(self).evaluate(&block)
+      else
+        instance_eval(&block)
+      end
+    end
+
+    private
+
+    #
+    # Checks if the DSL should be evaluated at compile time.
+    #
+    # @return [true, false]
+    #
+    def compile_time?
+      check_for_old_attributes!
+      !!node['build-essential']['compile_time']
+    end
+
+    #
+    # Checks for the presence of the "old" attributes.
+    #
+    # @todo Remove in 2.0.0
+    #
+    # @return [void]
+    #
+    def check_for_old_attributes!
+      unless node['build_essential'].nil?
+        Chef::Log.warn <<-EOH
+node['build_essential'] has been changed to node['build-essential'] to match the
+cookbook name and community standards. I have gracefully converted the attribute
+for you, but this warning and conversion will be removed in the next major
+release of the build-essential cookbook.
+EOH
+        node.default['build-essential'] = node['build_essential']
+      end
+
+      unless node['build-essential']['compiletime'].nil?
+        Chef::Log.warn <<-EOH
+node['build-essential']['compiletime'] has been deprecated. Please use
+node['build-essential']['compile_time'] instead. I have gracefully converted the
+attribute for you, but this warning and conversion will be removed in the next
+major release of the build-essential cookbook.
+EOH
+        node.default['build-essential']['compile_time'] = node['build-essential']['compiletime']
+      end
+    end
+
+    #
+    # A class graciously borrowed from Chef Sugar for evaluating a resource at
+    # compile time in a block.
+    #
+    class CompileTime
+      def initialize(recipe)
+        @recipe = recipe
+      end
+
+      def evaluate(&block)
+        instance_eval(&block)
+      end
+
+      def method_missing(m, *args, &block)
+        resource = @recipe.send(m, *args, &block)
+        if resource.is_a?(Chef::Resource)
+          actions = Array(resource.action)
+          resource.action(:nothing)
+
+          actions.each do |action|
+            resource.run_action(action)
+          end
+        end
+        resource
+      end
+    end
+  end
+end
+
+# Include the timing module into the main recipe DSL
+Chef::Recipe.send(:include, BuildEssential::Timing)

data/cookbooks/build-essential/libraries/xcode_command_line_tools.rb

@@ -0,0 +1,210 @@
+#
+# Cookbook Name:: build-essential
+# Library:: xcode_command_line_tools
+#
+# Copyright 2014, Chef Software, 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.
+#
+
+class Chef
+  class Resource::XcodeCommandLineTools < Resource::LWRPBase
+    def self.resource_name
+      :xcode_command_line_tools
+    end
+
+    actions :install
+    default_action :install
+
+    def initialize(name, run_context = nil)
+      super
+
+      @provider = case node['platform_version'].to_f
+                  when 10.7, 10.8
+                    Provider::XcodeCommandLineToolsFromDmg
+                  when 10.9, 10.10
+                    Provider::XcodeCommandLineToolsFromSoftwareUpdate
+                  else
+                    Chef::Log.warn <<-EOH
+OSX #{node['platform_version']} is not an officially supported platform for the
+build-essential cookbook. I am going to try and install the command line tools
+from Software Update, but there is a high probability that it will fail...
+
+If you have tested and verified OSX #{node['platform_version']} and you are sick
+of seeing this warning in your Chef Client runs, please submit a Pull Request to
+https://github.com/chef-cookbooks/build-essential and add this version of OSX
+to provider list.
+EOH
+                    Provider::XcodeCommandLineToolsFromSoftwareUpdate
+                  end
+    end
+  end
+end
+
+#
+# This is a legacy provider for installing OSX from DMGs. It only supports OSX
+# versions 10.7 and 10.8 and will (hopefully) be deprecated in the future. It
+# downloads a remote .dmg file, mounts it, installs it, and unmounts it
+# automatically. In later versions of OSX, the operating system handles this for
+# the end user.
+#
+class Chef
+  class Provider::XcodeCommandLineToolsFromDmg < Provider::LWRPBase
+    action(:install) do
+      if installed?
+        Chef::Log.debug("#{new_resource} already installed - skipping")
+      else
+        converge_by("Install #{new_resource}") do
+          download
+          attach
+          install
+          detach
+        end
+      end
+    end
+
+    private
+
+    #
+    # Determine if the XCode Command Line Tools are installed
+    #
+    # @return [true, false]
+    #
+    def installed?
+      cmd = Mixlib::ShellOut.new('pkgutil --pkgs=com.apple.pkg.DeveloperToolsCLI')
+      cmd.run_command
+      cmd.error!
+      true
+    rescue Mixlib::ShellOut::ShellCommandFailed
+      false
+    end
+
+    #
+    # The path where the dmg should be cached on disk.
+    #
+    # @return [String]
+    #
+    def dmg_cache_path
+      ::File.join(Chef::Config[:file_cache_path], 'osx-command-line-tools.dmg')
+    end
+
+    #
+    # The path where the dmg should be downloaded from. This is intentionally
+    # not a configurable object by the end user. If you do not like where we
+    # are downloading XCode from - too bad.
+    #
+    # @return [String]
+    #
+    def dmg_remote_source
+      case node['platform_version'].to_f
+      when 10.7
+        'http://devimages.apple.com/downloads/xcode/command_line_tools_for_xcode_os_x_lion_april_2013.dmg'
+      when 10.8
+        'http://devimages.apple.com/downloads/xcode/command_line_tools_for_xcode_os_x_mountain_lion_march_2014.dmg'
+      else
+        fail "Unknown DMG download URL for OSX #{node['platform_version']}"
+      end
+    end
+
+    #
+    # The path where the volume should be mounted.
+    #
+    # @return [String]
+    #
+    def mount_path
+      ::File.join(Chef::Config[:file_cache_path], 'osx-command-line-tools')
+    end
+
+    #
+    # Action: download the remote dmg.
+    #
+    # @return [void]
+    #
+    def download
+      remote_file = Resource::RemoteFile.new(dmg_cache_path, run_context)
+      remote_file.source(dmg_remote_source)
+      remote_file.backup(false)
+      remote_file.run_action(:create)
+    end
+
+    #
+    # Action: attach the dmg (basically, double-click on it)
+    #
+    # @return [void]
+    #
+    def attach
+      execute %(hdiutil attach "#{dmg_cache_path}" -mountpoint "#{mount_path}")
+    end
+
+    #
+    # Action: install the package inside the dmg
+    #
+    # @return [void]
+    #
+    def install
+      execute %|installer -package "$(find '#{mount_path}' -name *.mpkg)" -target "/"|
+    end
+
+    #
+    # Action: detach the dmg (basically, drag it to eject on the dock)
+    #
+    # @return [void]
+    #
+    def detach
+      execute %(hdiutil detach "#{mount_path}")
+    end
+  end
+end
+
+class Chef
+  class Provider::XcodeCommandLineToolsFromSoftwareUpdate < Provider::LWRPBase
+    action(:install) do
+      if installed?
+        Chef::Log.debug("#{new_resource} already installed - skipping")
+      else
+        converge_by("Install #{new_resource}") do
+          # This script was graciously borrowed and modified from Tim Sutton's
+          # osx-vm-templates at https://github.com/timsutton/osx-vm-templates/blob/b001475df54a9808d3d56d06e71b8fa3001fff42/scripts/xcode-cli-tools.sh
+          execute 'install XCode Command Line tools' do
+            command <<-EOH.gsub(/^ {14}/, '')
+              # create the placeholder file that's checked by CLI updates' .dist code
+              # in Apple's SUS catalog
+              touch /tmp/.com.apple.dt.CommandLineTools.installondemand.in-progress
+              # find the CLI Tools update
+              PROD=$(softwareupdate -l | grep "\*.*Command Line" | head -n 1 | awk -F"*" '{print $2}' | sed -e 's/^ *//' | tr -d '\n')
+              # install it
+              softwareupdate -i "$PROD" -v
+            EOH
+            # rubocop:enable Metrics/LineLength
+          end
+        end
+      end
+    end
+
+    private
+
+    #
+    # Determine if the XCode Command Line Tools are installed
+    #
+    # @return [true, false]
+    #
+    def installed?
+      cmd = Mixlib::ShellOut.new('pkgutil --pkgs=com.apple.pkg.CLTools_Executables')
+      cmd.run_command
+      cmd.error!
+      true
+    rescue Mixlib::ShellOut::ShellCommandFailed
+      false
+    end
+  end
+end