A Linux backend for Garden.
You can deploy Garden (inside a Garden container) using the Garden BOSH Release repository.
See the old README for old documentation, caveat lector.
Note: the rest of these instructions assume you arranged for the garden-linux code, and dependencies, to be
installed in your
$GOPATH inside a linux environment, either by following the steps above or through some other mechanism.
The rest of these instructions assume you are running inside an Ubuntu environment (for example, the above vagrant box) with go installed and the code checked out.
cd $GOPATH/src/github.com/cloudfoundry-incubator/garden-linux # assuming your $GOPATH has only one entry make go build -a -tags daemon -o out/garden-linux
Set up necessary directories
sudo mkdir -p /opt/garden/containers sudo mkdir -p /opt/garden/snapshots sudo mkdir -p /opt/garden/overlays sudo mkdir -p /opt/garden/rootfs
(Optional) Set up a RootFS
If you plan to run docker images instead of using the warden rootfs provider, you can skip this step.
Follow the instructions at https://github.com/cloudfoundry/stacks to generate a rootfs, or download one from
http://cf-runtime-stacks.s3.amazonaws.com/lucid64.dev.tgz. Extract it to
/opt/warden/rootfs(or pass a different directory in the next step).
wget http://cf-runtime-stacks.s3.amazonaws.com/lucid64.dev.tgz sudo tar -xzpf lucid64.dev.tgz -C /opt/garden/rootfs
cd $GOPATH/src/github.com/cloudfoundry-incubator/garden-linux # assuming your $GOPATH has only one entry sudo ./out/garden-linux \ -depot=/opt/garden/containers \ -bin=$PWD/old/linux_backend/bin \ -rootfs=/opt/garden/rootfs \ -snapshots=/opt/garden/snapshots \ -overlays=/opt/garden/overlays \ -listenNetwork=tcp \ -listenAddr=127.0.0.1:7777 \ "$@"
Kick the tyres
The external API is exposed using Garden, the instructions at that repo document the various API calls that you can now make (it will be running at
http://127.0.0.1:7777if you followed the above instructions).
garden-linux executable provides a server which clients can use to perform operations on Garden Linux,
such as creating containers and running processes inside containers.
Garden Linux is configured by passing command line flags to the
Garden defines the protocol supported by the server and provides a Go API for programmatic access.
Restructure in progress: code in the
old/ directory is being replaced with code elsewhere in the repository.
See the Developer's Guide to get started.