https://github.com/alunduil/margarine-chef
Chef cookbook for Margarine
https://github.com/alunduil/margarine-chef
chef cookbooks deprecated recipe ruby
Last synced: 2 months ago
JSON representation
Chef cookbook for Margarine
- Host: GitHub
- URL: https://github.com/alunduil/margarine-chef
- Owner: alunduil
- License: mit
- Created: 2013-09-05T17:07:31.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2014-05-28T02:49:27.000Z (about 11 years ago)
- Last Synced: 2024-04-16T03:19:56.441Z (about 1 year ago)
- Topics: chef, cookbooks, deprecated, recipe, ruby
- Language: Ruby
- Size: 481 KB
- Stars: 1
- Watchers: 5
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
margarine Cookbook
==================
This cookbook is used to deploy margarine on a system or set of systems. This cookbook expects to you to override a number of it's settings a may not work "out of the box".
Requirements
------------
- Chef 11.6.0+
- Ohai 6.18.0+
### Platforms
The following platforms are tested:
- Ubuntu 12.04, 14.04
- Debian 7.4
Other platforms may or may not work as intended or desired but probably not.
### Cookbook Dependencies
The following cookbooks are dependencies and required for this cookbook to
function:
- python
- git
- build-essential
Attributes
----------
The following attributes affect the behaviour of the deployment of margarine.
The commonly changed attributes are listed first followed by less commonly
modified attributes.
* `node['margarine']['components']` - Sets which componentns components to install/enable on a specific node. Defaults to both `blend` and `spread`.
* `node['margarine']['service']['provider']` - Sets the service mechanism used
to run the flask portion of margarine. Default: uwsgi.
* `node['margarine']['service']['hostname']` - Sets the hostname to bind the
service provider to. Default: localhost.
* `node['margarine']['service']['port']` - Sets the port to bind the service
provider to. Default: 5000.
* `node['margarine']['service']['proxy']` - Sets the proxy service to host the
WSGI application behind. Default: None.
The following describe the install methods available for margarine:
*`['margarine']['install']['method']` - Currently only `pip` is supported
*`['margarine']['install']['commit']` - branch, ref or tag to pull. defaults to `master`
*`['margarine']['install']['repository']` - git repo location
The service attributes have a bit of overlap and the following attributes apply
to the datastore, email, token_store and queue sections. Thus the following
attributes should have SERVICE replaced with one of the aforementioned sections
(i.e. `node['margarine']['datastore']['type']` instead of
`node['margarine'][SERVICE]['type']`.
* `node['margarine'][SERVICE]['type']` - Sets the type of service used for the
particular component of margarine. Defaults:
* datastore - mongodb
* email - smtp
* token_store - redis
* queue - amqp
* `node['margarine'][SERVICE]['username']` - Sets the username for the service.
* `node['margarine'][SERVICE]['password']` - Sets the password for the service.
* `node['margarine'][SERVICE]['hostname']` - Sets the hostname to connect to
for the service. Default: localhost
* `node['margarine'][SERVICE]['port']` - Sets the port to connect to for the
service.
* `node['margarine']['datastore']['database']` - Sets the database to use for
margarine's metadata.
* `node['margarine']['email']['from']` - Sets the FROM address for outgoing
emails that margarine produces. Default: no-reply@HOSTNAME.
The last three common attributes set deployment specific information:
* `node['margarine']['urls']['tinge']` - Sets the URL that tinge (the frontend
service) runs behind. Default: http://HOSTNAME.
* `node['margarine']['urls']['blend']` - Sets the URL endpoint that blend (the
API service) runs behind. Default: http://api.HOSTNAME/v1/.
* `node['margarine']['security']['uuid']` - Sets the opaque value used in the
HTTP Digest mechanism in margarine. This should be set on an environment for
maximum efficiency and allow requests to slide between hosts. Default: None.
More attributes are available but not generally necessary for normal operation.
These attributes are defined in the attributes directory and should be reviewed
for any functionality that might be desirable if the above does not fill a
particular need.
Recipes
-------
This section outlines how to use the basic recipes in your environment. The
recipes you find in the cookbook not listed here are functional but not
recommended for direct usage.
### default
Includes the necessary recipes to install, configure and start the the specific service.
### component recipes
The `margarine::tinge`, `margarine::blend`, and `margarine::spread` recipes are
the bread of margarine deployments. The simplest use of margarine is to
configure the appropriate attributes from the above and add one of the
aforementioned component cookbooks to node or role run_lists.
These recipes include the three basic components of cconfiguration management:
- install (package)
- configure (template)
- service (service)
### install
Creates the margarine user/group. Will also include the the install type recipe which is currently `install_pip`.
### install_pip
Includes required recipes to set up margarine directly from git via `python_pip`. Installs margarine from `node['margarine']['install']['repository']`
### configure
Sets up the configuration files and required directories for margarine. The
following configuration files are created:
- margarine.ini
- logging.ini (via include recipe `configure_logging`)
The logging configuration has been updated to read from the node attributes and
will merge with the defaults appropriately (or be overwritten appropriately as
well).
### service
Sets up the various services based on the `node['margarine']['components']` array. The init files are dropped in (`/etc/init` or `/etc/init.d/` respectively) for the components of margarine installed on the node. This will also start the service(s).
Usage
-----
Use the recipes and attributes described above to configure margarine for a
particular environment.
Often, the only attributes requiring modification are the hostname attributes
for the various services and the url attributes.
A great example of configuring this cookbook for a particular environment can
be found in margarine itself under the chef directory and the associated
Vagrantfile.