kubernetes/docs/man
Piotr Szczesniak e92192d379 Added new command clusterinfo to kubectl
This is first version of the command. It prints IPs of master and cluster
services. Should be improved once generalized labels are implemented #341.

It requires label kubernet.io/cluster-service=true set for cluster services.

Follow up cl after discussion in #4417.
2015-03-03 20:14:24 +01:00
..
man1 Added new command clusterinfo to kubectl 2015-03-03 20:14:24 +01:00
Dockerfile Man pages - initial release 2014-10-13 15:57:26 -05:00
kube-apiserver.1.md Convert kube-apiserver to hyperkube. 2015-01-30 13:06:28 -08:00
kube-controller-manager.1.md Add missing flag description; regenerate man1 2015-02-26 11:15:01 -05:00
kube-proxy.1.md Fix up for posix flags 2015-01-15 09:12:19 -08:00
kube-scheduler.1.md Fix up for posix flags 2015-01-15 09:12:19 -08:00
kubelet.1.md Replace "net" by "pod infra" in docs and format strings. 2015-01-28 15:03:06 -08:00
md2man-all.sh Man pages - initial release 2014-10-13 15:57:26 -05:00
README.md Add missing flag description; regenerate man1 2015-02-26 11:15:01 -05:00

Kubernetes Documentation

This directory contains the Docker user manual in the Markdown format. Do not edit the man pages in the man1 directory. Instead, amend the Markdown (*.md) files.

File List

kube-apiserver.1.md
kube-controller-manager.1.md
kubelet.1.md
kube-proxy.1.md
kube-scheduler.1.md
Dockerfile
md2man-all.sh

Generating man pages from the Markdown files

The recommended approach for generating the man pages is via a Docker container using the supplied Dockerfile to create an image with the correct environment. This uses go-md2man, a pure Go Markdown to man page generator.

Building the md2man image

There is a Dockerfile provided in the docker/docs/man directory.

Using this Dockerfile, create a Docker image tagged docker/md2man:

docker build -t docker/md2man .

Utilizing the image

Once the image is built, run a container using the image with volumes:

docker run -v /<path-to-git-dir>/kubernetes/docs/man:/docs:rw \
-w /docs -i docker/md2man /docs/md2man-all.sh

The md2man Docker container will process the Markdown files and generate the man pages inside the docker/docs/man/man1 directory using Docker volumes. For more information on Docker volumes see the man page for docker run and also look at the article [Sharing Directories via Volumes] (http://docs.docker.com/use/working_with_volumes/).