lxc: High level Haskell bindings to LXC (Linux containers).
This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.
Properties
| Versions | 0.1, 0.1.1, 0.2, 0.2, 0.3, 0.3.1, 0.3.1.1, 0.3.2 |
|---|---|
| Change log | CHANGELOG.md |
| Dependencies | base (>=4.7 && <4.8), bindings-lxc (>=0.2 && <0.3) [details] |
| License | BSD-3-Clause |
| Author | Nickolay Kudasov |
| Maintainer | nickolay.kudasov@gmail.com |
| Category | System |
| Home page | https://github.com/fizruk/lxc |
| Bug tracker | https://github.com/fizruk/lxc/issues |
| Source repo | head: git clone https://github.com/fizruk/lxc.git -b master |
| Uploaded | by NickolayKudasov at 2014-09-28T00:49:56Z |
Modules
[Index]
Downloads
- lxc-0.2.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
Package maintainers
For package maintainers and hackage trustees
Readme for lxc-0.2
[back to package description]lxc
High level Haskell bindings to LXC (Linux containers).
The library provides Haskell LXC API, wrapping <http://hackage.haskell.org/package/bindings-lxc bindings-lxc package>.
Requirements
Before installation make sure you have LXC installed on your system with header files and static library.
On Ubuntu 14.04 LTS (Trusty Tahr):
$ sudo apt-get install lxc-dev
On previous Ubuntu versions (including 12.04 LTS Precise Pangolin) standard repositories do not contain liblxc1 package.
You might want to use ppa:ubuntu-lxc/stable repository instead:
$ sudo apt-get install software-properties-common python-software-properties
$ sudo add-apt-repository ppa:ubuntu-lxc/stable
$ sudo apt-get update
$ sudo apt-get install lxc-dev
Installation
Get the latest stable version from Hackage:
$ cabal install lxc
or clone this repository:
$ git clone https://github.com/fizruk/lxc.git
$ cd lxc
$ cabal install
Documentation
Haddock documentation is available at http://fizruk.github.io/lxc/docs/
Usage
You can start using these bindings just like command line tool:
>>> trusty <- mkContainer "trusty" Nothing
>>> create trusty "download" Nothing Nothing [] ["-d", "ubuntu", "-r", "trusty", "-a", "amd64"]
Using image from local cache
Unpacking the rootfs
---
You just created an Ubuntu container (release=trusty, arch=amd64, variant=default)
The default username/password is: ubuntu / ubuntu
To gain root privileges, please use sudo.
True
>>> start trusty False []
True
>>> state trusty
ContainerRunning
>>> attachRunWait trusty defaultAttachOptions "echo" ["echo", "Hello, world!"]
Hello, world!
Just ExitSuccess
>>> stop trusty
True
>>> trustySnap <- clone trusty (Just "trusty-snap") Nothing [CloneSnapshot] Nothing Nothing Nothing []
>>> start trustySnap False []
True
>>> getInterfaces trustySnap
["eth0","lo"]
>>> getIPs trustySnap "eth0" "inet" 0
["10.0.3.135"]
>>> shutdown trustySnap (-1)
True
>>> state trustySnap
ContainerStopped
Contributing
Contributions and bug reports are welcome!
Please feel free to contact me via GitHub or on the #haskell IRC channel on irc.freenode.net.
-Nickolay Kudasov