Kubernetes is an open source reference implementation of container cluster management.
- You need a Google Cloud Platform account with billing enabled. Visit http://cloud.google.com/console for more details
- You must have Go installed: www.golang.org
- Ensure that your
gcloudcomponents are up-to-date by runninggcloud components update. - Get the Kubernetes source:
git clone https://github.com/GoogleCloudPlatform/kubernetes.git
cd kubernetes
./src/scripts/dev-build-and-up.sh
cd kubernetes
./src/scripts/build-go.sh
./src/scripts/cloudcfg.sh -p 8080:80 run dockerfile/nginx 2 myNginx
This will spin up two containers running Nginx mapping port 80 to 8080.
To stop the container:
./src/scripts/cloudcfg.sh stop myNginx
To delete the container:
./src/scripts/cloudcfg.sh rm myNginx
cd kubernetes
./src/scripts/cloudcfg.sh -c examples/task.json create /tasks
Where task.json contains something like:
{
"ID": "nginx",
"desiredState": {
"image": "dockerfile/nginx",
"networkPorts": [{
"containerPort": 80,
"hostPort": 8080
}]
},
"labels": {
"name": "foo"
}
}
Look in the examples/ for more examples
cd kubernetes
./src/scripts/kube-down.sh
# Before committing any changes, please link/copy these hooks into your .git
# directory. This will keep you from accidentally committing non-gofmt'd
# go code.
cd kubernetes
ln -s "../../hooks/prepare-commit-msg" .git/hooks/prepare-commit-msg
ln -s "../../hooks/commit-msg" .git/hooks/commit-msg
cd kubernetes
./src/scripts/test-go.sh
cd kubernetes
go tool cover -html=target/c.out
# You need an etcd somewhere in your path.
# To get from head:
go get github.com/coreos/etcd
go install github.com/coreos/etcd
sudo ln -s "$GOPATH/bin/etcd" /usr/bin/etcd
# Or just use the packaged one:
sudo ln -s "$REPO_ROOT/target/bin/etcd" /usr/bin/etcd
cd kubernetes
./src/scripts/integration-test.sh
One time after cloning your forked repo:
git remote add upstream https://github.com/GoogleCloudPlatform/kubernetes.git
Then each time you want to sync to upstream:
git fetch upstream
git rebase upstream/master
Install nodejs, npm, and raml2html, then run:
cd kubernetes/api
raml2html kubernetes.raml > kubernetes.html