Skip to content

Latest commit

 

History

History
55 lines (40 loc) · 2.26 KB

README.md

File metadata and controls

55 lines (40 loc) · 2.26 KB
Raw

blp-gemrc cookbook

Build Status Cookbook Version License

The blp-gemrc cookbook is a library cookbook that provides a custom resource for configuring the gemrc file for a RubyGems environment.

Platforms

The following platforms are tested automatically using Test Kitchen, in Docker, with the default suite of integration tests:

  • Ubuntu 12.04/14.04/16.04
  • CentOS (RHEL) 6/7

Additionally, the platforms below are also known to work:

  • AIX 7.1
  • Solaris 5.11
  • Windows 2008r2/2012r2

Recipes

The default recipe configures the embedded gem configuration of the Chef Client. This allows for changing the gem sources that would get pulled from during a normal convergence.

Attributes

Attribute Name Type Default Value Description
node['gemrc']['config'] Hash gem: '--no-ri --no-rdoc' Sets the options for the default recipe gemrc configuration.
node['gemrc']['sensitive'] Boolean false Tells the default recipe whether the gemrc is sensitive (should not be output to Chef log)

Basic Usage

A common use case for this cookbook is to configure the Chef Client's gem environment to an internal mirror if behind the veil of the corporate firewall.

Here is an example of how to use an internal Artifactory instance to mirror the RubyGems.org repository.

node.default['gemrc']['path'] = Gem::ConfigFile::SYSTEM_WIDE_CONFIG_FILE
node.default['gemrc']['reload'] = true
node.default['gemrc']['config']['sources'] = ['http://artifactory.corporate.com/artifactory/api/gems/ruby-gems/']
include_recipe 'gemrc::default'