# Knife Container [![Gem Version](https://badge.fury.io/rb/knife-container.png)](http://badge.fury.io/rb/knife-container) [![Build Status](https://travis-ci.org/opscode/knife-container.svg?branch=master)](https://travis-ci.org/opscode/knife-container) 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](http://docs.opscode.com/plugin_knife_container.html). ## 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. ## Contributing Please read [CONTRIBUTING.md](CONTRIBUTING.md) ## License Full License: [here](LICENSE) Knife-Container - a Knife plugin for chef-container Author:: Tom Duffield () Author:: Michael Goetz () Copyright:: Copyright (c) 2012-2014 Chef Software, Inc. 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.