Fletcher Nichol's Bash Profile Chef Cookbook
- Supermarket: https://supermarket.chef.io/cookbooks/bashrc
- Source Code: https://github.com/ut-cookbooks/bashrc
A Chef cookbook containing a resource to install a bash profile from http://github.com/fnichol/bashrc.
Place a dependency on the bashrc cookbook in your cookbook's metadata.rb
depends "bashrc", "~> 2.0"
Then, to install systemwide, put the following in a recipe:
Or for a particular user:
For a more complete example, checkout the provided example cookbook.
As of version 2.0.0, this cookbook is a library-style or resource-only cookbook. In other words, there are no recipes, attributes, etc. and you use the provded resource in your own cookbook. This helps keep dependencies and maintenance as low as possible.
- Chef 12 or higher
This cookbook is tested on the following platforms with Test Kitchen:
- CentOS 7.1 64-bit
- Debian 8.1 64-bit
- Mac OS X 10.9
- Mac OS X 10.10
- Ubuntu 12.04 64-bit
- Ubuntu 14.04 64-bit
- Ubuntu 15.04 64-bit
This cookbook has no external cookbook dependencies.
This cookbook has no recipes.
This cookbook has no attributes.
Resources and Providers
bashrc resource manages the installation of the bashrc profile for all users on the system when the root user is provided or can install it on a per-user basis.
The system-wide installation puts the profile under
/etc/bash and the per-user installation puts the profile under the user's
$HOME directory in
:install action installs the profile, which is the default (and only) action.
bashrc "system-wide installation" do user "root" action :install end # short form of above example bashrc "root" bashrc "install only for jdoe user" do user "jdoe" action :install end # short form of above example bashrc "jdoe"
Note that for per-user installations, the user must already exist with their home directory created and appropriate permissions assigned (i.e. the user must be able to write in their own home directory).
user- The user that the profile will be installed under. If
"root"is provided, a system-wide installation will be performed, setting up under
/etc/bash. Defaults to the resource name.
:install- Downloads, extracts, and initializes the profile for the given user.
Pull requests are very welcome! Make sure your patches are well tested. Ideally create a topic branch for every seperate change you make.
License and Author
Copyright:: 2010, 2011, 2015 Fletcher Nichol
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
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.