Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

RSS

docker-platform (3) Versions 1.0.0

Use Docker ressources to install/configure Docker with attributes

Berkshelf/Librarian
Policyfile
Knife
cookbook 'docker-platform', '= 1.0.0'
cookbook 'docker-platform', '= 1.0.0', :supermarket
knife cookbook site install docker-platform
knife cookbook site download docker-platform
README
Dependencies
Changelog
Quality

Docker Platform Cookbook

Description

Docker is an open-source project that automates the deployment of applications inside software containers, by providing an additional layer of abstraction and automation of operating-system-level virtualisation on Linux. Docker uses the resource isolation features of the Linux kernel such as cgroups and kernel namespaces, and a union-capable file system such as aufs and others to allow independent "containers" to run within a single Linux instance, avoiding the overhead of starting and maintaining virtual machines.

This cookbook provides recipes to install and configure Docker with configuration stored in attributes. It uses yum-docker cookbook to install official repository and it wraps docker cookbook resources to control Docker status.

Requirements

Cookbooks and gems

Declared in metadata.rb and in Gemfile.

Platforms

  • RHEL Family 7, tested on Centos

Note: by composing it with apt-docker cookbook, it should work fine on Debian / Ubuntu.

Usage

Test

This cookbook is fully tested in test-kitchen, using the vagrant driver and inspec verifier.

For more information, see .kitchen.yml and test directory.

Attributes

Configuration is done by overriding default attributes. All configuration keys have a default defined in attributes/default.rb. Please read it to have a comprehensive view of what and how you can configure this cookbook behavior.

In addition, you can use attributes to define docker cookbook resources. All you have to do is to define an attribute of the same name as the resource you want to call containing the different instances of this resource. For instance:

"docker_volume": {
  "data": {
    "action": "create"
  },
  "to_remove": {
    "action": "remove"
  }
}

It creates a docker volume named data and remove the one called to_remove. The key of each sub hash table is the name attribute and the value is an hash table containing the resource configuration, mapping exactly the attribute name defined in docker cookbook documentation.

If you need multiple arguments for an attribute, you have to declare them in an array. If you need an array as single argument, add an extra array.

For instance:

"docker_container": {
  "my_alpine": {
    "container_name": "alpine",
    "repo": "alpine",
    "volumes": [["data:/data"]],
    "action": "run",
    "subscribes": ["redeploy", "docker_image[alpine]", "immediately"]
  }
}

You can find other examples in .kitchen.yml file.

Recipes

default

Include repository, package, service and docker recipes.

repository

Use yum-docker cookbook to install official yum repository.

package

Install docker-engine package or upgrade it if attribute version is set to latest.

service

Enable and start docker service. Restart it if package was upgraded.

docker

Wrap all docker cookbook resources so it is possible to use them with attributes. Read attributes section for more details.

Resources/Providers

None.

Changelog

Available in CHANGELOG.md.

Contributing

Please read carefully CONTRIBUTING.md before making a merge request.

License and Author

Copyright (c) 2016 Sam4Mobile

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.

Dependent cookbooks

docker >= 0.0.0
yum-docker >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Changelog

1.0.0

  • Initial version for Centos 7

Foodcritic Metric
            

1.0.0 passed this metric