chef-lmctfy

Description

Installs/Configures Google's Let Me Contain That For You. Please see [COMPATIBILITY.md](COMPATIBILITY.md) for more information about LMCTFY versions that are tested and supported by cookbook versions along with LWRP features.

Requirements

Platforms

• Ubuntu 12.10, 13.04, 13.10

Upcoming Platforms

• CentOS 6 (requires newer g++, CentOS devtoolset-1.1 likely in another cookbook)
• Fedora 17+ (should work, requires testing)
• RHEL 6 (requires newer g++, Red Hat devtoolset-1.1 likely in another cookbook)
• Ubuntu 12.04 (requires newer g++, ubuntu-toolchain-r likely in another cookbook)

Cookbooks

Opscode Cookbooks

• build-essential
• git

Third-Party Cookbooks

• control_groups
• gflags
• protobuf
• re2

Attributes

These attributes are under the node['lmctfy'] namespace.

cgroups Attributes

These attributes are under the node['lmctfy']['cgroups'] namespace.

Source Attributes

These attributes are under the node['lmctfy']['source'] namespace.

Recipes

• recipe[lmctfy] Installs/Configures lmctfy
• recipe[lmctfy::cgroups] Installs/Configures cgroups
• recipe[lmctfy::lmctfy_init] Runs lmctfy init
• recipe[lmctfy::source] Installs lmctfy via source
• recipe[lmctfy::source_cli] Installs lmctfy CLI via source
• recipe[lmctfy::source_cpp] Installs lmctfy C++ via source

LWRPs

lmctfy_container

Create a container without spec:

lmctfy_container "my_container" do
  spec ""
end

Create a container with spec:

lmctfy_container "my_100mb_container" do
  spec "memory:{limit:100000000}"
end

Create a container with spec in config:

lmctfy_container "my_config_container" do
  config "/path/to/lmctfy-config"
end

Create a container and run command at same time:

lmctfy_container "my_command_container" do
  command "sleep 9999"
  nowait true
  spec ""
  action [:create,:run]
end

Run a command in a container:

lmctfy_container "my_container" do
  command "sleep 9999"
  nowait true
  action :run
end

Kill all processes in a container:

lmctfy_container "my_container" do
  action :killall
end

Kill all processes and destroy container at same time:

lmctfy_container "my_container" do
  action [:killall, :destroy]
end

Destroy a container:

lmctfy_container "my_container" do
  action :destroy
end

Usage

Default Installation

• Add recipe[lmctfy] to your node's run list

Testing and Development

Vagrant

Here's how you can quickly get testing or developing against the cookbook thanks to Vagrant and Berkshelf.

vagrant plugin install vagrant-berkshelf
vagrant plugin install vagrant-cachier
vagrant plugin install vagrant-omnibus
git clone git://github.com/bflad/chef-docker.git
cd chef-docker
vagrant up BOX # BOX being ubuntu1204, ubuntu1210, or ubuntu1304

You can then SSH into the running VM using the vagrant ssh BOX command.

The VM can easily be stopped and deleted with the vagrant destroy command. Please see the official Vagrant documentation for a more in depth explanation of available commands.

Test Kitchen

Please see documentation in: [TESTING.md](TESTING.md)

Contributing

Please use standard Github issues/pull requests and if possible, in combination with testing on the Vagrant boxes or Test Kitchen suite.

Maintainers

• Brian Flad (bflad417@gmail.com)