Knife Container

This project is deprecated in favor of the Docker driver inside Chef Provisioning, and no longer maintained.

This is the official Chef plugin for Linux Containers. This plugin gives knife the ability to initialize and build Linux Containers.

For full documentation, including examples, please check out the docs site.

Installation

Build Locally

If you would like to build the gem from source locally, please clone this repository on to your local machine and build the gem locally.

    $ bundle install
    $ bundle exec rake install

Subcommands

This plugin provides the following Knife subcommands. Specific command options can be found by invoking the subcommand with a --help flag.

`knife container docker init`

Initializes a new folder that will hold all the files and folders necessary to build a Docker image called a “Docker context.” This files and folders that can make up your Docker context include a Dockerfile, Berksfile, cookbooks and chef-client configuration files.

`knife container docker build`

Builds a Docker image based on the Docker context specified. If the image was initialized using the -z flag and a Berksfile exists, it will run berks vendor and vendor the required cookbooks into the required directory. If the image was initialized without the -z flag and a Berksfile exists, it will run berks upload and upload the required cookbooks to you Chef Server.

Configuration

This plugin allows certain values to be specified in your knife.rb

`knife[:dockerfiles_path]`

Allows you to specify the directory where you wish to keep your Docker Contexts. By default this value is a folder named dockerfiles folder in your chef-repo directory.

`knife[:docker_image]`

Allows you to specify what Docker Image should be used if the -f flag is not specified when you run knife container docker init. The default value is chef/ubuntu-12.04:latest.

`knife[:berksfile_source]`

Allows you to specify the source you wish to use in your generated Berksfiles. The default value is https://supermarket.chef.io.

Contributing

Please read CONTRIBUTING.md

License

Full License: here

Knife-Container - a Knife plugin for chef-container

Author:: Tom Duffield (tom@chef.io)
Author:: Michael Goetz (mpgoetz@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.

knife-container

Development

Runtime