supermarket-omnibus-cookbook

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

supermarket-omnibus-cookbook

★ 17 Open GitHub ↗

Archived from chef-cookbooks/supermarket-omnibus-cookbook - A cookbook for installing supermarket from Omnibus (deb, rpm) packages

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Archived Repository
This repository has been archived and will no longer receive updates.
It was archived as part of the [Repository Standardization Initiative](https://github.com/chef-boneyard/oss-repo-standardization-2025).
If you are a Chef customer and need support for this repository, please contact your Chef account team.

---

# supermarket-omnibus-cookbook

[![Build Status](https://travis-ci.org/chef-cookbooks/supermarket-omnibus-cookbook.svg?branch=master)](https://travis-ci.org/chef-cookbooks/supermarket-omnibus-cookbook) [![Cookbook Version](https://img.shields.io/cookbook/v/supermarket-omnibus-cookbook.svg)](https://supermarket.chef.io/cookbooks/supermarket-omnibus-cookbook)

This cookbook installs the [Chef Supermarket](https://github.com/opscode/supermarket) server using the [omnibus-supermarket](https://github.com/opscode/omnibus-supermarket) packages from package.chef.io.<br>
This cookbook also renders supermarket.json file which is used for managing configuration of Supermarket.

**Umbrella Project**: [Supermarket](https://github.com/chef/chef-oss-practices/blob/master/projects/supermarket.md)

* **[Project State](https://github.com/chef/chef-oss-practices/blob/master/repo-management/repo-states.md):** Maintained
* **Issues [Response Time Maximum](https://github.com/chef/chef-oss-practices/blob/master/repo-management/repo-states.md):** 14 days
* **Pull Request [Response Time Maximum](https://github.com/chef/chef-oss-practices/blob/master/repo-management/repo-states.md):** 14 days

## Requirements

### Platforms

- Ubuntu 14.04+
- RHEL 6+

### Chef

- Chef 12.5+

### Cookbooks

- chef-ingredient
- hostsfile

## Usage

Set the following attributes in the [`kitchen.local.yml`](https://github.com/irvingpop/supermarket-omnibus-cookbook/blob/master/kitchen.local.yml.example) or via a wrapper cookbook. The values will be obtained from your oc-id server. For more information see: [Getting Started with oc-id and Supermarket](http://irvingpop.github.io/blog/2015/04/07/setting-up-your-private-supermarket-server/)

```ruby
default['supermarket_omnibus']['chef_server_url'] = 'https://chefserver.mycompany.com'
default['supermarket_omnibus']['chef_oauth2_app_id'] = '14dfcf186221781cff51eedd5ac1616'
default['supermarket_omnibus']['chef_oauth2_secret'] = 'a49402219627cfa6318d58b13e90aca'
default['supermarket_omnibus']['chef_oauth2_verify_ssl'] = false
```

If you wish to specify a package version, a channel, or a source, you can do that now. You can also specify a recipe to install from your own package repository.

```ruby
default['supermarket_omnibus']['package_version'] = '1.2.3'

# install from Chef's `current` channel
default['supermarket_omnibus']['package_repo'] = 'current'

# OR, specify a Supermarket package explicitly from a location of your choosing
default['supermarket_omnibus']['package_url'] = 'http://example.com/my_repo/supermarket_package.deb'

# specify a recipe to install from your own package repository
default['supermarket_omnibus']['custom_repo_recipe'] = 'my_cookbook::my_repo'
```

If you wish to specify additional settings, you can pass them via the `default['supermarket_omnibus']['config']` attribute.<br>
Example: for custom SSL certificates define the following `config` attributes:

```ruby
default['supermarket_omnibus']['config']['ssl']['certificate'] = '/full/path/to/ssl.crt'
default['supermarket_omnibus']['config']['ssl']['certificate_key'] = '/full/path/to/ssl.key'
```

Above attributes, if defined in supermarket.rb directly, would look like this:

```ruby
supermarket['ssl']['certificate'] = '/full/path/to/ssl.crt'
supermarket['ssl']['certificate_key'] = '/full/path/to/ssl.key'
```

The [Collaborator Groups](https://www.chef.io/blog/2015/12/18/collaborator-groups-on-supermarket/) [feature](https://www.youtube.com/watch?v=1t1T5CQ0j48) is enabled in this cookbook's `attributes/default.rb`.

:warning: It's super important to be aware that **supermarket.json always wins**. Best practice is to modify your supermarket configuration via `['config']` setting in a wrapper cookbook.

To find out all supermarket `config` attributes you can override, see [supermarket](https://github.com/chef/supermarket/blob/master/omnibus/cookbooks/omnibus-supermarket/attributes/default.rb). Translation of attributes from `supermarket-omnibus-cookbook` to attributes in `supermarket` occurs in the `supermarket_server` resource provided by this cookbook which produces a JSON(`/etc/supermarket/supermarket.json`) that `omnibus-supermarket` reads. For example:

```ruby
# an attribute you define via this supermarket-omnibus-cookbook
default['supermarket_omnibus']['config']['nginx']['log_rotation']['num_to_keep'] = 10

# becomes the following in omnibus-supermarket
default['supermarket']['nginx']['log_rotation']['num_to_keep'] = 10
```

## License & Authors

- Author: Irving Popovetsky ([irving@chef.io](mailto:irving@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.
```

supermarket-omnibus-cookbook

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README