https://github.com/joemiller/chef-openbsd

Chef LWRPs (package, service) for OpenBSD
https://github.com/joemiller/chef-openbsd

Last synced: 13 days ago
JSON representation

Chef LWRPs (package, service) for OpenBSD

• Host: GitHub
• URL: https://github.com/joemiller/chef-openbsd
• Owner: joemiller
• Created: 2013-03-09T19:01:58.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2013-03-09T19:08:00.000Z (over 11 years ago)
• Last Synced: 2023-03-11T06:58:06.826Z (over 1 year ago)
• Language: Ruby
• Homepage: joemiller.me
• Size: 117 KB
• Stars: 14
• Watchers: 0
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
OpenBSD Chef Resources

======================

This cookbook includes basic LWRPs for OpenBSD. Included resources are:

- Package

- Service

Package resource

----------------

The package resource is loosely based on the FreeBSD package resource included

with Chef except it does not include support for compiling from ports. Use

this resource to install compiled packages, such as from an openbsd ftp mirror.

### Setting $PKG_PATH

OpenBSD's pkg_add and pkg_info tools use the $PKG_PATH variable to find

packages. This recipe supports setting a default PKG_PATH for all packages

or explicitly setting a PKG_PATH for individual packages.

Set the `node['openbsd']['pkg_path']` variable to assign a default for all

packages.

Alternatively, the `source` attribute may be set on an individual package

resource to specify an alternate $PKG_PATH, eg:

    package "thttpd" do

      source "ftp://ftp.dom.tld/packages/i386"

    end

Any PKG_PATH accepted by pkg_add and pkg_info should work fine, such as FTP,

HTTP, local path. (Only tested with ftp)

### Package install

Most packages can be installed by specifying their base name, eg:

    package "git"

Some packages have multiple versions or flavors and these need to be explicitly

defined using the `version` attribute.

This recipe does not currently support picking a package automatically if there

are multiple flavors available. You need to explicitly set the version and

flavor in these cases. eg:

    package "vim" do

      version "7.3.154p2-no_x11"

    end

    package "python" do

      version "2.7.3p0"

    end

Service resource

----------------

This resource is based on the FreeBSD Service resource included with Chef and

is compatible with OpenBSD 5.x which uses the `rc.d` method for service script

management.

Enabled services are added to the `/etc/rc.conf.local` file so that

`/etc/rc.conf` is left untouched, simplifying openbsd upgrades.

Passing parameters to the service is doing by setting the `:flags` attribute

on the `parameters` hash.

### Usage

    # adds to /etc/rc.conf.local:

    # ntpd_flags="-s"

    service "ntpd" do

      parameters({:flags => "-s"})

      action [:enable, :start]

    end

    # adds to /etc/rc.conf.local:

    # ftpproxy_flags=""

    service "ftpproxy" do

      action [:enable, :start]

    end

Author

------

* [Joe Miller](https://twitter.com/miller_joe) - http://joemiller.me / https://github.com/joemiller

License

-------

    Author:: Joe Miller ()

    Copyright:: Copyright (c) 2013 Joe Miller

    License:: Apache License, Version 2.0

    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.