,-.
) \
.--' |
/ /
|_______|
( O O )
{'-(_)-'}
.-{ ^ }-.
/ '.___.' \
/ | o | \
|__| o |__|
(((\_________/)))
\___|___/
jgs.--' | | '--.
\__._| |_.__/
A rich golang client and server for container creation and management with pluggable backends for linux, windows and The Open Container Initiative Spec.
Garden is a platform-agnostic Go API for container creation and management, with pluggable backends for different platforms and runtimes. This package contains the canonical client, as well as a server package containing an interface to be implemented by backends.
If you're just getting started, you probably want to begin by setting up one of the backends listed below. If you want to use the Garden client to manage containers, see the Client API section.
Backends
Backends implement support for various specific platforms. So far, the list of backends is as follows:
- Garden Linux - Linux backend
- Guardian - Linux backend using runc
- Greenhouse - Windows backend
Client API
The canonical API for Garden is defined as a collection of Go interfaces. See the godoc documentation for details.
Example use
Error checking ignored for brevity.
Import these packages:
"github.com/cloudfoundry-incubator/garden"
"github.com/cloudfoundry-incubator/garden/client"
"github.com/cloudfoundry-incubator/garden/client/connection"
Create a client:
gardenClient := client.New(connection.New("tcp", "127.0.0.1:7777"))
Create a container:
container, _ := gardenClient.Create(garden.ContainerSpec{})
Run a process:
buffer := &bytes.Buffer{}
process, _ := container.Run(garden.ProcessSpec{
User: "alice",
Path: "echo",
Args: []string{"hello from the container"},
}, garden.ProcessIO{
Stdout: buffer,
Stderr: buffer,
})
exitCode := process.Wait()
fmt.Println(buffer.String())
Development
Prerequisites
Running the tests
Assuming go is installed and $GOPATH is set:
mkdir -p $GOPATH/src/github.com/cloudfoundry-incubator
cd $GOPATH/src/github.com/cloudfoundry-incubator
git clone [email protected]:cloudfoundry-incubator/garden
cd garden
go get -t -u ./...
go install github.com/onsi/ginkgo/ginkgo
ginkgo -r
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent