From 885fe9fbbfa7cab68e9a5c759bc6b74668089d35 Mon Sep 17 00:00:00 2001 From: CentOS Sources Date: Mar 26 2015 15:29:22 +0000 Subject: import kubernetes-0.9.0-0.3.git96af0c3.el7 --- diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..3d82cce --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +SOURCES/kubernetes-96af0c3.tar.gz diff --git a/.kubernetes.metadata b/.kubernetes.metadata new file mode 100644 index 0000000..0f64f32 --- /dev/null +++ b/.kubernetes.metadata @@ -0,0 +1 @@ +abc6c9d2409498142616ebaf58e90c78dc06bbf2 SOURCES/kubernetes-96af0c3.tar.gz diff --git a/README.md b/README.md deleted file mode 100644 index 98f42b4..0000000 --- a/README.md +++ /dev/null @@ -1,4 +0,0 @@ -The master branch has no content - -Look at the c7 branch if you are working with CentOS-7, or the c4/c5/c6 branch for CentOS-4, 5 or 6 -If you find this file in a distro specific branch, it means that no content has been checked in yet diff --git a/SOURCES/Change-kubelet-working-dir-to-var-lib-kubelet.patch b/SOURCES/Change-kubelet-working-dir-to-var-lib-kubelet.patch new file mode 100644 index 0000000..d76a320 --- /dev/null +++ b/SOURCES/Change-kubelet-working-dir-to-var-lib-kubelet.patch @@ -0,0 +1,29 @@ +From 5d117d7b9788b5727ffd5844becfbf00013f0013 Mon Sep 17 00:00:00 2001 +From: Eric Paris +Date: Tue, 27 Jan 2015 11:34:45 -0500 +Subject: [PATCH] Change kubelet working dir to /var/lib/kubelet + +Some image based OS do not allow writing to /. Since the kubelet looks +for .dockercfg files in the working dir and uses / as the working dir, +this means one can never set a .dockercfg on those distros. This moves +the kubelet working dir to /var/lib/kubelet, where the kubelet naturally +does its work. +--- + contrib/init/systemd/kubelet.service | 1 + + 1 file changed, 1 insertion(+) + +diff --git a/contrib/init/systemd/kubelet.service b/contrib/init/systemd/kubelet.service +index 6990f29..973db5b 100644 +--- a/contrib/init/systemd/kubelet.service ++++ b/contrib/init/systemd/kubelet.service +@@ -5,6 +5,7 @@ After=docker.service cadvisor.service + Requires=docker.service + + [Service] ++WorkingDirectory=/var/lib/kubelet + EnvironmentFile=-/etc/kubernetes/config + EnvironmentFile=-/etc/kubernetes/kubelet + ExecStart=/usr/bin/kubelet \ +-- +2.1.0 + diff --git a/SOURCES/Use-docker.service-not-docker.socket-in-unit-files.patch b/SOURCES/Use-docker.service-not-docker.socket-in-unit-files.patch new file mode 100644 index 0000000..e9f6af3 --- /dev/null +++ b/SOURCES/Use-docker.service-not-docker.socket-in-unit-files.patch @@ -0,0 +1,30 @@ +From 388c179f016a11d401dd6bab91e41cbf12003ede Mon Sep 17 00:00:00 2001 +From: Eric Paris +Date: Thu, 22 Jan 2015 11:36:21 -0500 +Subject: [PATCH] Use docker.service not docker.socket in unit files + +Some distros, include RHEL and Fedora, are doing away with the docker +socket by default in systemd units, for security reasons. Instead rely +on the docker.service being started instead of socket activation. +--- + contrib/init/systemd/kubelet.service | 4 ++-- + 1 file changed, 2 insertions(+), 2 deletions(-) + +diff --git a/contrib/init/systemd/kubelet.service b/contrib/init/systemd/kubelet.service +index 52b5b85..6990f29 100644 +--- a/contrib/init/systemd/kubelet.service ++++ b/contrib/init/systemd/kubelet.service +@@ -1,8 +1,8 @@ + [Unit] + Description=Kubernetes Kubelet Server + Documentation=https://github.com/GoogleCloudPlatform/kubernetes +-After=docker.socket cadvisor.service +-Requires=docker.socket ++After=docker.service cadvisor.service ++Requires=docker.service + + [Service] + EnvironmentFile=-/etc/kubernetes/config +-- +2.1.0 + diff --git a/SOURCES/man-page-updates-for-kubectl.patch b/SOURCES/man-page-updates-for-kubectl.patch new file mode 100644 index 0000000..d4f5404 --- /dev/null +++ b/SOURCES/man-page-updates-for-kubectl.patch @@ -0,0 +1,2523 @@ +From 04c31305d7e9f6df83a8053679a2f03208fe7442 Mon Sep 17 00:00:00 2001 +From: Eric Paris +Date: Sat, 31 Jan 2015 15:09:24 -0500 +Subject: [PATCH] man page updates for kubectl + +--- + cmd/gendocs/gen_kubectl_docs.go | 112 +++++++++++++++++---- + docs/man/kubectl-config-set-cluster.1.md | 34 +++++++ + docs/man/kubectl-config-set-context.1.md | 31 ++++++ + docs/man/kubectl-config-set-credentials.1.md | 34 +++++++ + docs/man/kubectl-config-set.1.md | 22 +++++ + docs/man/kubectl-config-unset.1.md | 20 ++++ + docs/man/kubectl-config-use-context.1.md | 17 ++++ + docs/man/kubectl-config-view.1.md | 22 +++++ + docs/man/kubectl-config.1.md | 17 ++++ + docs/man/kubectl-create.1.md | 31 ++++++ + docs/man/kubectl-delete.1.md | 47 +++++++++ + docs/man/kubectl-describe.1.md | 20 ++++ + docs/man/kubectl-get.1.md | 59 +++++++++++ + docs/man/kubectl-log.1.md | 28 ++++++ + docs/man/kubectl-namespace.1.md | 26 +++++ + docs/man/kubectl-proxy.1.md | 25 +++++ + docs/man/kubectl-resize.1.md | 42 ++++++++ + docs/man/kubectl-rollingupdate.1.md | 42 ++++++++ + docs/man/kubectl-run-container.1.md | 63 ++++++++++++ + docs/man/kubectl-update.1.md | 37 +++++++ + docs/man/kubectl-version.1.md | 22 +++++ + docs/man/kubectl.1.md | 96 ++++++++++++++++++ + docs/man/man1/kube-apiserver.1 | 7 ++ + docs/man/man1/kube-controller-manager.1 | 7 ++ + docs/man/man1/kube-proxy.1 | 7 ++ + docs/man/man1/kube-scheduler.1 | 7 ++ + docs/man/man1/kubectl-config-set-cluster.1 | 53 ++++++++++ + docs/man/man1/kubectl-config-set-context.1 | 49 +++++++++ + docs/man/man1/kubectl-config-set-credentials.1 | 53 ++++++++++ + docs/man/man1/kubectl-config-set.1 | 36 +++++++ + docs/man/man1/kubectl-config-unset.1 | 35 +++++++ + docs/man/man1/kubectl-config-use-context.1 | 26 +++++ + docs/man/man1/kubectl-config-view.1 | 32 ++++++ + docs/man/man1/kubectl-config.1 | 26 +++++ + docs/man/man1/kubectl-create.1 | 44 +++++++++ + docs/man/man1/kubectl-delete.1 | 65 ++++++++++++ + docs/man/man1/kubectl-describe.1 | 30 ++++++ + docs/man/man1/kubectl-get.1 | 81 +++++++++++++++ + docs/man/man1/kubectl-log.1 | 39 ++++++++ + docs/man/man1/kubectl-namespace.1 | 38 +++++++ + docs/man/man1/kubectl-proxy.1 | 36 +++++++ + docs/man/man1/kubectl-resize.1 | 56 +++++++++++ + docs/man/man1/kubectl-rollingupdate.1 | 58 +++++++++++ + docs/man/man1/kubectl-run-container.1 | 86 ++++++++++++++++ + docs/man/man1/kubectl-update.1 | 52 ++++++++++ + docs/man/man1/kubectl-version.1 | 32 ++++++ + docs/man/man1/kubectl.1 | 132 +++++++++++++++++++++++++ + docs/man/man1/kubelet.1 | 10 +- + 48 files changed, 1924 insertions(+), 20 deletions(-) + create mode 100644 docs/man/kubectl-config-set-cluster.1.md + create mode 100644 docs/man/kubectl-config-set-context.1.md + create mode 100644 docs/man/kubectl-config-set-credentials.1.md + create mode 100644 docs/man/kubectl-config-set.1.md + create mode 100644 docs/man/kubectl-config-unset.1.md + create mode 100644 docs/man/kubectl-config-use-context.1.md + create mode 100644 docs/man/kubectl-config-view.1.md + create mode 100644 docs/man/kubectl-config.1.md + create mode 100644 docs/man/kubectl-create.1.md + create mode 100644 docs/man/kubectl-delete.1.md + create mode 100644 docs/man/kubectl-describe.1.md + create mode 100644 docs/man/kubectl-get.1.md + create mode 100644 docs/man/kubectl-log.1.md + create mode 100644 docs/man/kubectl-namespace.1.md + create mode 100644 docs/man/kubectl-proxy.1.md + create mode 100644 docs/man/kubectl-resize.1.md + create mode 100644 docs/man/kubectl-rollingupdate.1.md + create mode 100644 docs/man/kubectl-run-container.1.md + create mode 100644 docs/man/kubectl-update.1.md + create mode 100644 docs/man/kubectl-version.1.md + create mode 100644 docs/man/kubectl.1.md + create mode 100644 docs/man/man1/kubectl-config-set-cluster.1 + create mode 100644 docs/man/man1/kubectl-config-set-context.1 + create mode 100644 docs/man/man1/kubectl-config-set-credentials.1 + create mode 100644 docs/man/man1/kubectl-config-set.1 + create mode 100644 docs/man/man1/kubectl-config-unset.1 + create mode 100644 docs/man/man1/kubectl-config-use-context.1 + create mode 100644 docs/man/man1/kubectl-config-view.1 + create mode 100644 docs/man/man1/kubectl-config.1 + create mode 100644 docs/man/man1/kubectl-create.1 + create mode 100644 docs/man/man1/kubectl-delete.1 + create mode 100644 docs/man/man1/kubectl-describe.1 + create mode 100644 docs/man/man1/kubectl-get.1 + create mode 100644 docs/man/man1/kubectl-log.1 + create mode 100644 docs/man/man1/kubectl-namespace.1 + create mode 100644 docs/man/man1/kubectl-proxy.1 + create mode 100644 docs/man/man1/kubectl-resize.1 + create mode 100644 docs/man/man1/kubectl-rollingupdate.1 + create mode 100644 docs/man/man1/kubectl-run-container.1 + create mode 100644 docs/man/man1/kubectl-update.1 + create mode 100644 docs/man/man1/kubectl-version.1 + create mode 100644 docs/man/man1/kubectl.1 + +diff --git a/cmd/gendocs/gen_kubectl_docs.go b/cmd/gendocs/gen_kubectl_docs.go +index d6490b4..13b5df5 100644 +--- a/cmd/gendocs/gen_kubectl_docs.go ++++ b/cmd/gendocs/gen_kubectl_docs.go +@@ -17,42 +17,116 @@ limitations under the License. + package main + + import ( ++ "bufio" ++ "bytes" + "fmt" +- "io" + "os" ++ "strings" + + "github.com/GoogleCloudPlatform/kubernetes/pkg/kubectl/cmd" + "github.com/spf13/cobra" ++ "github.com/spf13/pflag" + ) + + func main() { +- out := os.Stdout ++ docsdir := "docs/man/" ++ if len(os.Args) > 1 { ++ docsdir = os.Args[1] ++ } + // Set environment variables used by kubectl so the output is consistent, + // regardless of where we run. + os.Setenv("HOME", "/home/username") +- kubectl := cmd.NewFactory().NewKubectlCommand(out) +- fmt.Fprintf(out, "## %s\n\n", kubectl.Name()) +- fmt.Fprintf(out, "%s\n\n", kubectl.Short) +- fmt.Fprintln(out, "### Commands\n") ++ unused := new(bytes.Buffer) ++ kubectl := cmd.NewFactory().NewKubectlCommand(unused) ++ genMarkdown(kubectl, "", docsdir) + for _, c := range kubectl.Commands() { +- genMarkdown(c, nil, out) ++ genMarkdown(c, "kubectl", docsdir) + } + } + +-func genMarkdown(command, parent *cobra.Command, out io.Writer) { ++func preamble(out *bufio.Writer, name, short, long string) { ++ out.WriteString(`% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++`) ++ fmt.Fprintf(out, "%s \\- %s\n\n", name, short) ++ fmt.Fprintf(out, "# SYNOPSIS\n") ++ fmt.Fprintf(out, "**%s** [OPTIONS]\n\n", name) ++ fmt.Fprintf(out, "# DESCRIPTION\n") ++ fmt.Fprintf(out, "%s\n\n", long) ++} ++ ++func printFlags(out *bufio.Writer, flags *pflag.FlagSet) { ++ flags.VisitAll(func(flag *pflag.Flag) { ++ format := "**--%s**=%s\n\t%s\n\n" ++ if flag.Value.Type() == "string" { ++ // put quotes on the value ++ format = "**--%s**=%q\n\t%s\n\n" ++ } ++ if len(flag.Shorthand) > 0 { ++ format = "**-%s**, " + format ++ } else { ++ format = "%s" + format ++ } ++ fmt.Fprintf(out, format, flag.Shorthand, flag.Name, flag.DefValue, flag.Usage) ++ }) ++} ++ ++func printOptions(out *bufio.Writer, command *cobra.Command) { ++ var flags *pflag.FlagSet ++ if command.HasFlags() { ++ flags = command.Flags() ++ } else if !command.HasParent() && command.HasPersistentFlags() { ++ flags = command.PersistentFlags() ++ } ++ if flags == nil { ++ return ++ } ++ fmt.Fprintf(out, "# OPTIONS\n") ++ printFlags(out, flags) ++ fmt.Fprintf(out, "\n") ++} ++func genMarkdown(command *cobra.Command, parent, docsdir string) { ++ dparent := strings.Replace(parent, " ", "-", -1) + name := command.Name() +- if parent != nil { +- name = fmt.Sprintf("%s %s", parent.Name(), name) ++ dname := name ++ if len(parent) > 0 { ++ dname = dparent + "-" + name ++ name = parent + " " + name ++ } ++ filename := docsdir + dname + ".1.md" ++ f, err := os.Create(filename) ++ if err != nil { ++ fmt.Fprintf(os.Stderr, "Unable to open file docs file %s\n", filename) ++ return + } +- fmt.Fprintf(out, "#### %s\n", name) +- desc := command.Long +- if len(desc) == 0 { +- desc = command.Short ++ defer f.Close() ++ out := bufio.NewWriter(f) ++ short := command.Short ++ long := command.Long ++ if len(long) == 0 { ++ long = short + } +- fmt.Fprintf(out, "%s\n\n", desc) +- usage := command.UsageString() +- fmt.Fprintf(out, "Usage:\n```\n%s\n```\n\n", usage[9:len(usage)-1]) +- for _, c := range command.Commands() { +- genMarkdown(c, command, out) ++ ++ preamble(out, name, short, long) ++ printOptions(out, command) ++ ++ if len(command.Commands()) > 0 || len(parent) > 0 { ++ fmt.Fprintf(out, "# SEE ALSO\n") ++ if len(parent) > 0 { ++ fmt.Fprintf(out, "**%s(1)**, ", dparent) ++ } ++ for _, c := range command.Commands() { ++ fmt.Fprintf(out, "**%s-%s(1)**, ", dname, c.Name()) ++ genMarkdown(c, name, docsdir) ++ } ++ fmt.Fprintf(out, "\n") + } ++ ++ out.WriteString(` ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! ++`) ++ out.Flush() + } +diff --git a/docs/man/kubectl-config-set-cluster.1.md b/docs/man/kubectl-config-set-cluster.1.md +new file mode 100644 +index 0000000..58ed892 +--- /dev/null ++++ b/docs/man/kubectl-config-set-cluster.1.md +@@ -0,0 +1,34 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl config set-cluster \- Sets a cluster entry in .kubeconfig ++ ++# SYNOPSIS ++**kubectl config set-cluster** [OPTIONS] ++ ++# DESCRIPTION ++Sets a cluster entry in .kubeconfig ++ ++ Specifying a name that already exists overwrites that cluster entry. ++ ++ ++# OPTIONS ++**--api-version**="" ++ api-version for the cluster entry in .kubeconfig ++ ++**--certificate-authority**="" ++ certificate-authority for the cluster entry in .kubeconfig ++ ++**--insecure-skip-tls-verify**=false ++ insecure-skip-tls-verify for the cluster entry in .kubeconfig ++ ++**--server**="" ++ server for the cluster entry in .kubeconfig ++ ++ ++# SEE ALSO ++**kubectl-config(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-config-set-context.1.md b/docs/man/kubectl-config-set-context.1.md +new file mode 100644 +index 0000000..172b747 +--- /dev/null ++++ b/docs/man/kubectl-config-set-context.1.md +@@ -0,0 +1,31 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl config set-context \- Sets a context entry in .kubeconfig ++ ++# SYNOPSIS ++**kubectl config set-context** [OPTIONS] ++ ++# DESCRIPTION ++Sets a context entry in .kubeconfig ++ ++ Specifying a name that already exists overwrites that context entry. ++ ++ ++# OPTIONS ++**--cluster**="" ++ cluster for the context entry in .kubeconfig ++ ++**--namespace**="" ++ namespace for the context entry in .kubeconfig ++ ++**--user**="" ++ user for the context entry in .kubeconfig ++ ++ ++# SEE ALSO ++**kubectl-config(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-config-set-credentials.1.md b/docs/man/kubectl-config-set-credentials.1.md +new file mode 100644 +index 0000000..42a8879 +--- /dev/null ++++ b/docs/man/kubectl-config-set-credentials.1.md +@@ -0,0 +1,34 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl config set-credentials \- Sets a user entry in .kubeconfig ++ ++# SYNOPSIS ++**kubectl config set-credentials** [OPTIONS] ++ ++# DESCRIPTION ++Sets a user entry in .kubeconfig ++ ++ Specifying a name that already exists overwrites that user entry. ++ ++ ++# OPTIONS ++**--auth-path**="" ++ auth-path for the user entry in .kubeconfig ++ ++**--client-certificate**="" ++ client-certificate for the user entry in .kubeconfig ++ ++**--client-key**="" ++ client-key for the user entry in .kubeconfig ++ ++**--token**="" ++ token for the user entry in .kubeconfig ++ ++ ++# SEE ALSO ++**kubectl-config(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-config-set.1.md b/docs/man/kubectl-config-set.1.md +new file mode 100644 +index 0000000..86d3a1e +--- /dev/null ++++ b/docs/man/kubectl-config-set.1.md +@@ -0,0 +1,22 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl config set \- Sets an individual value in a .kubeconfig file ++ ++# SYNOPSIS ++**kubectl config set** [OPTIONS] ++ ++# DESCRIPTION ++Sets an individual value in a .kubeconfig file ++ ++ property-name is a dot delimitted name where each token represents either a attribute name or a map key. Map keys may not contain dots. ++ property-value is the new value you wish to set. ++ ++ ++ ++# SEE ALSO ++**kubectl-config(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-config-unset.1.md b/docs/man/kubectl-config-unset.1.md +new file mode 100644 +index 0000000..efd554c +--- /dev/null ++++ b/docs/man/kubectl-config-unset.1.md +@@ -0,0 +1,20 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl config unset \- Unsets an individual value in a .kubeconfig file ++ ++# SYNOPSIS ++**kubectl config unset** [OPTIONS] ++ ++# DESCRIPTION ++Unsets an individual value in a .kubeconfig file ++ ++ property-name is a dot delimitted name where each token represents either a attribute name or a map key. Map keys may not contain dots. ++ ++ ++# SEE ALSO ++**kubectl-config(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-config-use-context.1.md b/docs/man/kubectl-config-use-context.1.md +new file mode 100644 +index 0000000..7fa3965 +--- /dev/null ++++ b/docs/man/kubectl-config-use-context.1.md +@@ -0,0 +1,17 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl config use-context \- Sets the current-context in a .kubeconfig file ++ ++# SYNOPSIS ++**kubectl config use-context** [OPTIONS] ++ ++# DESCRIPTION ++Sets the current-context in a .kubeconfig file ++ ++# SEE ALSO ++**kubectl-config(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-config-view.1.md b/docs/man/kubectl-config-view.1.md +new file mode 100644 +index 0000000..517c837 +--- /dev/null ++++ b/docs/man/kubectl-config-view.1.md +@@ -0,0 +1,22 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl config view \- displays the specified .kubeconfig file or a merged result ++ ++# SYNOPSIS ++**kubectl config view** [OPTIONS] ++ ++# DESCRIPTION ++displays the specified .kubeconfig file or a merged result ++ ++# OPTIONS ++**--merge**=false ++ merge together the full hierarchy of .kubeconfig files ++ ++ ++# SEE ALSO ++**kubectl-config(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-config.1.md b/docs/man/kubectl-config.1.md +new file mode 100644 +index 0000000..3e7a634 +--- /dev/null ++++ b/docs/man/kubectl-config.1.md +@@ -0,0 +1,17 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl config \- config modifies .kubeconfig files ++ ++# SYNOPSIS ++**kubectl config** [OPTIONS] ++ ++# DESCRIPTION ++config modifies .kubeconfig files using subcommands like "kubectl config set current-context my-context" ++ ++# SEE ALSO ++**kubectl(1)**, **kubectl-config-view(1)**, **kubectl-config-set-cluster(1)**, **kubectl-config-set-credentials(1)**, **kubectl-config-set-context(1)**, **kubectl-config-set(1)**, **kubectl-config-unset(1)**, **kubectl-config-use-context(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-create.1.md b/docs/man/kubectl-create.1.md +new file mode 100644 +index 0000000..816fcc4 +--- /dev/null ++++ b/docs/man/kubectl-create.1.md +@@ -0,0 +1,31 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl create \- Create a resource by filename or stdin ++ ++# SYNOPSIS ++**kubectl create** [OPTIONS] ++ ++# DESCRIPTION ++Create a resource by filename or stdin. ++ ++JSON and YAML formats are accepted. ++ ++Examples: ++ $ kubectl create -f pod.json ++ ++ ++ $ cat pod.json | kubectl create -f - ++ ++ ++# OPTIONS ++**-f**, **--filename**=[] ++ Filename, directory, or URL to file to use to create the resource ++ ++ ++# SEE ALSO ++**kubectl(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-delete.1.md b/docs/man/kubectl-delete.1.md +new file mode 100644 +index 0000000..e97edc4 +--- /dev/null ++++ b/docs/man/kubectl-delete.1.md +@@ -0,0 +1,47 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl delete \- Delete a resource by filename, stdin or resource and id ++ ++# SYNOPSIS ++**kubectl delete** [OPTIONS] ++ ++# DESCRIPTION ++Delete a resource by filename, stdin, resource and id or by resources and label selector. ++ ++JSON and YAML formats are accepted. ++ ++If both a filename and command line arguments are passed, the command line ++arguments are used and the filename is ignored. ++ ++Note that the delete command does NOT do resource version checks, so if someone ++submits an update to a resource right when you submit a delete, their update ++will be lost along with the rest of the resource. ++ ++Examples: ++ $ kubectl delete -f pod.json ++ ++ ++ $ cat pod.json | kubectl delete -f - ++ ++ ++ $ kubectl delete pods,services -l name=myLabel ++ ++ ++ $ kubectl delete pod 1234-56-7890-234234-456456 ++ ++ ++# OPTIONS ++**-f**, **--filename**=[] ++ Filename, directory, or URL to a file containing the resource to delete ++ ++**-l**, **--selector**="" ++ Selector (label query) to filter on ++ ++ ++# SEE ALSO ++**kubectl(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-describe.1.md b/docs/man/kubectl-describe.1.md +new file mode 100644 +index 0000000..3de5180 +--- /dev/null ++++ b/docs/man/kubectl-describe.1.md +@@ -0,0 +1,20 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl describe \- Show details of a specific resource ++ ++# SYNOPSIS ++**kubectl describe** [OPTIONS] ++ ++# DESCRIPTION ++Show details of a specific resource. ++ ++This command joins many API calls together to form a detailed description of a ++given resource. ++ ++# SEE ALSO ++**kubectl(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-get.1.md b/docs/man/kubectl-get.1.md +new file mode 100644 +index 0000000..899909c +--- /dev/null ++++ b/docs/man/kubectl-get.1.md +@@ -0,0 +1,59 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl get \- Display one or many resources ++ ++# SYNOPSIS ++**kubectl get** [OPTIONS] ++ ++# DESCRIPTION ++Display one or many resources. ++ ++Possible resources include pods (po), replication controllers (rc), services ++(se), minions (mi), or events (ev). ++ ++If you specify a Go template, you can use any fields defined for the API version ++you are connecting to the server with. ++ ++Examples: ++ $ kubectl get pods ++ ++ ++ $ kubectl get replicationController 1234-56-7890-234234-456456 ++ ++ ++ $ kubectl get -o json pod 1234-56-7890-234234-456456 ++ ++ ++ $ kubectl get rc,services ++ ++ ++# OPTIONS ++**--no-headers**=false ++ When using the default output, don't print headers ++ ++**-o**, **--output**="" ++ Output format: json|yaml|template|templatefile ++ ++**--output-version**="" ++ Output the formatted object with the given version (default api-version) ++ ++**-l**, **--selector**="" ++ Selector (label query) to filter on ++ ++**-t**, **--template**="" ++ Template string or path to template file to use when -o=template or -o=templatefile. ++ ++**-w**, **--watch**=false ++ After listing/getting the requested object, watch for changes. ++ ++**--watch-only**=false ++ Watch for changes to the requested object(s), without listing/getting first. ++ ++ ++# SEE ALSO ++**kubectl(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-log.1.md b/docs/man/kubectl-log.1.md +new file mode 100644 +index 0000000..aafa9ab +--- /dev/null ++++ b/docs/man/kubectl-log.1.md +@@ -0,0 +1,28 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl log \- Print the logs for a container in a pod. ++ ++# SYNOPSIS ++**kubectl log** [OPTIONS] ++ ++# DESCRIPTION ++Print the logs for a container in a pod. If the pod has only one container, the container name is optional ++Examples: ++ $ kubectl log 123456-7890 ruby-container ++ ++ ++ $ kubectl log -f 123456-7890 ruby-container ++ ++ ++# OPTIONS ++**-f**, **--follow**=false ++ Specify if the logs should be streamed. ++ ++ ++# SEE ALSO ++**kubectl(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-namespace.1.md b/docs/man/kubectl-namespace.1.md +new file mode 100644 +index 0000000..a01a90b +--- /dev/null ++++ b/docs/man/kubectl-namespace.1.md +@@ -0,0 +1,26 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl namespace \- Set and view the current Kubernetes namespace ++ ++# SYNOPSIS ++**kubectl namespace** [OPTIONS] ++ ++# DESCRIPTION ++Set and view the current Kubernetes namespace scope for command line requests. ++ ++A Kubernetes namespace subdivides the cluster into groups of logically related pods, services, and replication controllers. ++ ++Examples: ++ $ kubectl namespace ++ Using namespace default ++ ++ $ kubectl namespace other ++ Set current namespace to other ++ ++# SEE ALSO ++**kubectl(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-proxy.1.md b/docs/man/kubectl-proxy.1.md +new file mode 100644 +index 0000000..80828d1 +--- /dev/null ++++ b/docs/man/kubectl-proxy.1.md +@@ -0,0 +1,25 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl proxy \- Run a proxy to the Kubernetes API server ++ ++# SYNOPSIS ++**kubectl proxy** [OPTIONS] ++ ++# DESCRIPTION ++Run a proxy to the Kubernetes API server. ++ ++# OPTIONS ++**-p**, **--port**=8001 ++ The port on which to run the proxy ++ ++**-w**, **--www**="" ++ Also serve static files from the given directory under the prefix /static ++ ++ ++# SEE ALSO ++**kubectl(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-resize.1.md b/docs/man/kubectl-resize.1.md +new file mode 100644 +index 0000000..f859d7d +--- /dev/null ++++ b/docs/man/kubectl-resize.1.md +@@ -0,0 +1,42 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl resize \- Set a new size for a resizable resource (currently only Replication Controllers) ++ ++# SYNOPSIS ++**kubectl resize** [OPTIONS] ++ ++# DESCRIPTION ++Set a new size for a resizable resource (currently only Replication Controllers) ++ ++Resize also allows users to specify one or more preconditions for the resize action. ++The new size is specified by --replicas=. You can also specify an optional precondition. ++The two currently supported options are --current-replicas or --resource-version. ++If a precondition is specified, it is validated before the resize is attempted, and it is ++guaranteed that the precondition holds true when the resize is sent to the server. ++ ++Examples: ++ $ kubectl resize --replicas=3 replicationcontrollers foo ++ resized ++ ++ # will only execute if the current size is 2 ++ $ kubectl resize --current-replicas=2 --replicas=3 replicationcontrollers foo ++ ++ ++# OPTIONS ++**--current-replicas**=-1 ++ Precondition for current size. Requires that the current size of the replication controller match this value in order to resize ++ ++**--replicas**=-1 ++ The new number desired number of replicas. Required. ++ ++**--resource-version**="" ++ Precondition for resource version. Requires that the current resource version match this value in order to resize ++ ++ ++# SEE ALSO ++**kubectl(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-rollingupdate.1.md b/docs/man/kubectl-rollingupdate.1.md +new file mode 100644 +index 0000000..3b20c1c +--- /dev/null ++++ b/docs/man/kubectl-rollingupdate.1.md +@@ -0,0 +1,42 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl rollingupdate \- Perform a rolling update of the given ReplicationController ++ ++# SYNOPSIS ++**kubectl rollingupdate** [OPTIONS] ++ ++# DESCRIPTION ++Perform a rolling update of the given ReplicationController. ++ ++Replaces named controller with new controller, updating one pod at a time to use the ++new PodTemplate. The new-controller.json must specify the same namespace as the ++existing controller and overwrite at least one (common) label in its replicaSelector. ++ ++Examples: ++$ kubectl rollingupdate frontend-v1 -f frontend-v2.json ++ ++ ++$ cat frontend-v2.json | kubectl rollingupdate frontend-v1 -f - ++ ++ ++# OPTIONS ++**-f**, **--filename**="" ++ Filename or URL to file to use to create the new controller ++ ++**--poll-interval**="3s" ++ Time delay between polling controller status after update. Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". ++ ++**--timeout**="5m0s" ++ Max time to wait for a controller to update before giving up. Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". ++ ++**--update-period**="1m0s" ++ Time to wait between updating pods. Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". ++ ++ ++# SEE ALSO ++**kubectl(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-run-container.1.md b/docs/man/kubectl-run-container.1.md +new file mode 100644 +index 0000000..d21f595 +--- /dev/null ++++ b/docs/man/kubectl-run-container.1.md +@@ -0,0 +1,63 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl run-container \- Run a particular image on the cluster. ++ ++# SYNOPSIS ++**kubectl run-container** [OPTIONS] ++ ++# DESCRIPTION ++Create and run a particular image, possibly replicated. ++Creates a replication controller to manage the created container(s) ++ ++Examples: ++ $ kubectl run-container nginx --image=dockerfile/nginx ++ ++ ++ $ kubectl run-container nginx --image=dockerfile/nginx --replicas=5 ++ ++ ++ $ kubectl run-container nginx --image=dockerfile/nginx --dry-run ++ ++ ++ $ kubectl run-container nginx --image=dockerfile/nginx --overrides='{ "apiVersion": "v1beta1", "desiredState": { ... } }' ++ ++ ++ $ cat pod.json | kubectl update -f - ++ ++ ++ $ kubectl update pods my-pod --patch='{ "apiVersion": "v1beta1", "desiredState": { "manifest": [{ "cpu": 100 }]}}' ++ ++ ++# OPTIONS ++**-f**, **--filename**="" ++ Filename or URL to file to use to update the resource ++ ++**--patch**="" ++ A JSON document to override the existing resource. The resource is downloaded, then patched with the JSON, the updated ++ ++ ++# SEE ALSO ++**kubectl(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl-version.1.md b/docs/man/kubectl-version.1.md +new file mode 100644 +index 0000000..c0d0627 +--- /dev/null ++++ b/docs/man/kubectl-version.1.md +@@ -0,0 +1,22 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl version \- Print version of client and server ++ ++# SYNOPSIS ++**kubectl version** [OPTIONS] ++ ++# DESCRIPTION ++Print version of client and server ++ ++# OPTIONS ++**-c**, **--client**=false ++ Client version only (no server required) ++ ++ ++# SEE ALSO ++**kubectl(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/kubectl.1.md b/docs/man/kubectl.1.md +new file mode 100644 +index 0000000..a48b194 +--- /dev/null ++++ b/docs/man/kubectl.1.md +@@ -0,0 +1,96 @@ ++% KUBERNETES(1) kubernetes User Manuals ++% Eric Paris ++% Jan 2015 ++# NAME ++kubectl \- kubectl controls the Kubernetes cluster manager ++ ++# SYNOPSIS ++**kubectl** [OPTIONS] ++ ++# DESCRIPTION ++kubectl controls the Kubernetes cluster manager. ++ ++Find more information at https://github.com/GoogleCloudPlatform/kubernetes. ++ ++# OPTIONS ++**--alsologtostderr**=false ++ log to standard error as well as files ++ ++**--api-version**="" ++ The API version to use when talking to the server ++ ++**-a**, **--auth-path**="" ++ Path to the auth info file. If missing, prompt the user. Only used if using https. ++ ++**--certificate-authority**="" ++ Path to a cert. file for the certificate authority. ++ ++**--client-certificate**="" ++ Path to a client key file for TLS. ++ ++**--client-key**="" ++ Path to a client key file for TLS. ++ ++**--cluster**="" ++ The name of the kubeconfig cluster to use ++ ++**--context**="" ++ The name of the kubeconfig context to use ++ ++**-h**, **--help**=false ++ help for kubectl ++ ++**--insecure-skip-tls-verify**=false ++ If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure. ++ ++**--kubeconfig**="" ++ Path to the kubeconfig file to use for CLI requests. ++ ++**--log_backtrace_at**=:0 ++ when logging hits line file:N, emit a stack trace ++ ++**--log_dir**="" ++ If non-empty, write log files in this directory ++ ++**--log_flush_frequency**=5s ++ Maximum number of seconds between log flushes ++ ++**--logtostderr**=true ++ log to standard error instead of files ++ ++**--match-server-version**=false ++ Require server version to match client version ++ ++**-n**, **--namespace**="" ++ If present, the namespace scope for this CLI request. ++ ++**--ns-path**="/home/username/.kubernetes_ns" ++ Path to the namespace info file that holds the namespace context to use for CLI requests. ++ ++**-s**, **--server**="" ++ The address of the Kubernetes API server ++ ++**--stderrthreshold**=2 ++ logs at or above this threshold go to stderr ++ ++**--token**="" ++ Bearer token for authentication to the API server. ++ ++**--user**="" ++ The name of the kubeconfig user to use ++ ++**--v**=0 ++ log level for V logs ++ ++**--validate**=false ++ If true, use a schema to validate the input before sending it ++ ++**--vmodule**= ++ comma-separated list of pattern=N settings for file-filtered logging ++ ++ ++# SEE ALSO ++**kubectl-version(1)**, **kubectl-proxy(1)**, **kubectl-get(1)**, **kubectl-describe(1)**, **kubectl-create(1)**, **kubectl-update(1)**, **kubectl-delete(1)**, **kubectl-config(1)**, **kubectl-namespace(1)**, **kubectl-log(1)**, **kubectl-rollingupdate(1)**, **kubectl-resize(1)**, **kubectl-run-container(1)**, ++ ++# HISTORY ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kube-apiserver.1 b/docs/man/man1/kube-apiserver.1 +index cdbd630..3f261cd 100644 +--- a/docs/man/man1/kube-apiserver.1 ++++ b/docs/man/man1/kube-apiserver.1 +@@ -1,13 +1,16 @@ + .TH "KUBERNETES" "1" " kubernetes User Manuals" "Scott Collier" "October 2014" "" + ++ + .SH NAME + .PP + kube\-apiserver \- Provides the API for kubernetes orchestration. + ++ + .SH SYNOPSIS + .PP + \fBkube\-apiserver\fP [OPTIONS] + ++ + .SH DESCRIPTION + .PP + The \fBkubernetes\fP API server validates and configures data for 3 types of objects: pods, services, and replicationControllers. Beyond just servicing REST operations, the API Server does two other things as well: 1. Schedules pods to worker nodes. Right now the scheduler is very simple. 2. Synchronize pod information (where they are, what ports they are exposing) with the service configuration. +@@ -15,6 +18,7 @@ The \fBkubernetes\fP API server validates and configures data for 3 types of obj + .PP + The the kube\-apiserver several options. + ++ + .SH OPTIONS + .PP + \fB\-\-address\fP="" +@@ -97,6 +101,7 @@ The the kube\-apiserver several options. + \fB\-\-vmodule\fP= + comma\-separated list of pattern=N settings for file\-filtered logging + ++ + .SH EXAMPLES + .PP + .RS +@@ -105,6 +110,8 @@ The the kube\-apiserver several options. + /usr/bin/kube\-apiserver \-\-logtostderr=true \-\-v=0 \-\-etcd\_servers=http://127.0.0.1:4001 \-\-address=0.0.0.0 \-\-port=8080 \-\-kubelet\_port=10250 \-\-allow\_privileged=false + + .fi ++.RE ++ + + .SH HISTORY + .PP +diff --git a/docs/man/man1/kube-controller-manager.1 b/docs/man/man1/kube-controller-manager.1 +index 49361ba..1b9b6c6 100644 +--- a/docs/man/man1/kube-controller-manager.1 ++++ b/docs/man/man1/kube-controller-manager.1 +@@ -1,13 +1,16 @@ + .TH "KUBERNETES" "1" " kubernetes User Manuals" "Scott Collier" "October 2014" "" + ++ + .SH NAME + .PP + kube\-controller\-manager \- Enforces kubernetes services. + ++ + .SH SYNOPSIS + .PP + \fBkube\-controller\-manager\fP [OPTIONS] + ++ + .SH DESCRIPTION + .PP + The \fBkubernetes\fP controller manager is really a service that is layered on top of the simple pod API. To enforce this layering, the logic for the replicationController is actually broken out into another server. This server watches etcd for changes to replicationController objects and then uses the public Kubernetes API to implement the replication algorithm. +@@ -15,6 +18,7 @@ The \fBkubernetes\fP controller manager is really a service that is layered on t + .PP + The kube\-controller\-manager has several options. + ++ + .SH OPTIONS + .PP + \fB\-\-address\fP="" +@@ -96,6 +100,7 @@ The kube\-controller\-manager has several options. + \fB\-\-vmodule\fP= + comma\-separated list of pattern=N settings for file\-filtered logging. + ++ + .SH EXAMPLES + .PP + .RS +@@ -104,6 +109,8 @@ The kube\-controller\-manager has several options. + /usr/bin/kube\-controller\-manager \-\-logtostderr=true \-\-v=0 \-\-master=127.0.0.1:8080 + + .fi ++.RE ++ + + .SH HISTORY + .PP +diff --git a/docs/man/man1/kube-proxy.1 b/docs/man/man1/kube-proxy.1 +index 340dab0..16b0925 100644 +--- a/docs/man/man1/kube-proxy.1 ++++ b/docs/man/man1/kube-proxy.1 +@@ -1,13 +1,16 @@ + .TH "KUBERNETES" "1" " kubernetes User Manuals" "Scott Collier" "October 2014" "" + ++ + .SH NAME + .PP + kube\-proxy \- Provides network proxy services. + ++ + .SH SYNOPSIS + .PP + \fBkube\-proxy\fP [OPTIONS] + ++ + .SH DESCRIPTION + .PP + The \fBkubernetes\fP network proxy runs on each node. This reflects services as defined in the Kubernetes API on each node and can do simple TCP stream forwarding or round robin TCP forwarding across a set of backends. Service endpoints are currently found through Docker\-links\-compatible environment variables specifying ports opened by the service proxy. Currently the user must select a port to expose the service on on the proxy, as well as the container's port to target. +@@ -15,6 +18,7 @@ The \fBkubernetes\fP network proxy runs on each node. This reflects services as + .PP + The kube\-proxy takes several options. + ++ + .SH OPTIONS + .PP + \fB\-\-alsologtostderr\fP=false +@@ -73,6 +77,7 @@ The kube\-proxy takes several options. + \fB\-\-vmodule\fP= + comma\-separated list of pattern=N settings for file\-filtered logging + ++ + .SH EXAMPLES + .PP + .RS +@@ -81,6 +86,8 @@ The kube\-proxy takes several options. + /usr/bin/kube\-proxy \-\-logtostderr=true \-\-v=0 \-\-etcd\_servers=http://127.0.0.1:4001 + + .fi ++.RE ++ + + .SH HISTORY + .PP +diff --git a/docs/man/man1/kube-scheduler.1 b/docs/man/man1/kube-scheduler.1 +index 7df1185..b8ccc35 100644 +--- a/docs/man/man1/kube-scheduler.1 ++++ b/docs/man/man1/kube-scheduler.1 +@@ -1,13 +1,16 @@ + .TH "KUBERNETES" "1" " kubernetes User Manuals" "Scott Collier" "October 2014" "" + ++ + .SH NAME + .PP + kube\-scheduler \- Schedules containers on hosts. + ++ + .SH SYNOPSIS + .PP + \fBkube\-scheduler\fP [OPTIONS] + ++ + .SH DESCRIPTION + .PP + The \fBkubernetes\fP scheduler is a policy\-rich, topology\-aware, workload\-specific function that significantly impacts availability, performance, and capacity. The scheduler needs to take into account individual and collective resource requirements, quality of service requirements, hardware/software/policy constraints, affinity and anti\-affinity specifications, data locality, inter\-workload interference, deadlines, and so on. Workload\-specific requirements will be exposed through the API as necessary. +@@ -15,6 +18,7 @@ The \fBkubernetes\fP scheduler is a policy\-rich, topology\-aware, workload\-spe + .PP + The kube\-scheduler can take several options. + ++ + .SH OPTIONS + .PP + \fB\-\-address=\fP"127.0.0.1" +@@ -72,6 +76,7 @@ The kube\-scheduler can take several options. + \fB\-\-vmodule\fP= + comma\-separated list of pattern=N settings for file\-filtered logging. + ++ + .SH EXAMPLES + .PP + .RS +@@ -80,6 +85,8 @@ The kube\-scheduler can take several options. + /usr/bin/kube\-scheduler \-\-logtostderr=true \-\-v=0 \-\-master=127.0.0.1:8080 + + .fi ++.RE ++ + + .SH HISTORY + .PP +diff --git a/docs/man/man1/kubectl-config-set-cluster.1 b/docs/man/man1/kubectl-config-set-cluster.1 +new file mode 100644 +index 0000000..42509d4 +--- /dev/null ++++ b/docs/man/man1/kubectl-config-set-cluster.1 +@@ -0,0 +1,53 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl config set\-cluster \- Sets a cluster entry in .kubeconfig ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl config set\-cluster\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Sets a cluster entry in .kubeconfig ++ ++.PP ++.RS ++ ++.nf ++ Specifying a name that already exists overwrites that cluster entry. ++ ++.fi ++.RE ++ ++ ++.SH OPTIONS ++.PP ++\fB\-\-api\-version\fP="" ++ api\-version for the cluster entry in .kubeconfig ++ ++.PP ++\fB\-\-certificate\-authority\fP="" ++ certificate\-authority for the cluster entry in .kubeconfig ++ ++.PP ++\fB\-\-insecure\-skip\-tls\-verify\fP=false ++ insecure\-skip\-tls\-verify for the cluster entry in .kubeconfig ++ ++.PP ++\fB\-\-server\fP="" ++ server for the cluster entry in .kubeconfig ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl\-config(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-config-set-context.1 b/docs/man/man1/kubectl-config-set-context.1 +new file mode 100644 +index 0000000..41b7337 +--- /dev/null ++++ b/docs/man/man1/kubectl-config-set-context.1 +@@ -0,0 +1,49 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl config set\-context \- Sets a context entry in .kubeconfig ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl config set\-context\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Sets a context entry in .kubeconfig ++ ++.PP ++.RS ++ ++.nf ++ Specifying a name that already exists overwrites that context entry. ++ ++.fi ++.RE ++ ++ ++.SH OPTIONS ++.PP ++\fB\-\-cluster\fP="" ++ cluster for the context entry in .kubeconfig ++ ++.PP ++\fB\-\-namespace\fP="" ++ namespace for the context entry in .kubeconfig ++ ++.PP ++\fB\-\-user\fP="" ++ user for the context entry in .kubeconfig ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl\-config(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-config-set-credentials.1 b/docs/man/man1/kubectl-config-set-credentials.1 +new file mode 100644 +index 0000000..6e99650 +--- /dev/null ++++ b/docs/man/man1/kubectl-config-set-credentials.1 +@@ -0,0 +1,53 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl config set\-credentials \- Sets a user entry in .kubeconfig ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl config set\-credentials\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Sets a user entry in .kubeconfig ++ ++.PP ++.RS ++ ++.nf ++ Specifying a name that already exists overwrites that user entry. ++ ++.fi ++.RE ++ ++ ++.SH OPTIONS ++.PP ++\fB\-\-auth\-path\fP="" ++ auth\-path for the user entry in .kubeconfig ++ ++.PP ++\fB\-\-client\-certificate\fP="" ++ client\-certificate for the user entry in .kubeconfig ++ ++.PP ++\fB\-\-client\-key\fP="" ++ client\-key for the user entry in .kubeconfig ++ ++.PP ++\fB\-\-token\fP="" ++ token for the user entry in .kubeconfig ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl\-config(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-config-set.1 b/docs/man/man1/kubectl-config-set.1 +new file mode 100644 +index 0000000..0f31b55 +--- /dev/null ++++ b/docs/man/man1/kubectl-config-set.1 +@@ -0,0 +1,36 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl config set \- Sets an individual value in a .kubeconfig file ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl config set\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Sets an individual value in a .kubeconfig file ++ ++.PP ++.RS ++ ++.nf ++ property\-name is a dot delimitted name where each token represents either a attribute name or a map key. Map keys may not contain dots. ++ property\-value is the new value you wish to set. ++ ++.fi ++.RE ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl\-config(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-config-unset.1 b/docs/man/man1/kubectl-config-unset.1 +new file mode 100644 +index 0000000..87d39fe +--- /dev/null ++++ b/docs/man/man1/kubectl-config-unset.1 +@@ -0,0 +1,35 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl config unset \- Unsets an individual value in a .kubeconfig file ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl config unset\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Unsets an individual value in a .kubeconfig file ++ ++.PP ++.RS ++ ++.nf ++ property\-name is a dot delimitted name where each token represents either a attribute name or a map key. Map keys may not contain dots. ++ ++.fi ++.RE ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl\-config(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-config-use-context.1 b/docs/man/man1/kubectl-config-use-context.1 +new file mode 100644 +index 0000000..cd1a720 +--- /dev/null ++++ b/docs/man/man1/kubectl-config-use-context.1 +@@ -0,0 +1,26 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl config use\-context \- Sets the current\-context in a .kubeconfig file ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl config use\-context\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Sets the current\-context in a .kubeconfig file ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl\-config(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-config-view.1 b/docs/man/man1/kubectl-config-view.1 +new file mode 100644 +index 0000000..7435e80 +--- /dev/null ++++ b/docs/man/man1/kubectl-config-view.1 +@@ -0,0 +1,32 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl config view \- displays the specified .kubeconfig file or a merged result ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl config view\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++displays the specified .kubeconfig file or a merged result ++ ++ ++.SH OPTIONS ++.PP ++\fB\-\-merge\fP=false ++ merge together the full hierarchy of .kubeconfig files ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl\-config(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-config.1 b/docs/man/man1/kubectl-config.1 +new file mode 100644 +index 0000000..991bc27 +--- /dev/null ++++ b/docs/man/man1/kubectl-config.1 +@@ -0,0 +1,26 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl config \- config modifies .kubeconfig files ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl config\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++config modifies .kubeconfig files using subcommands like "kubectl config set current\-context my\-context" ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl(1)\fP, \fBkubectl\-config\-view(1)\fP, \fBkubectl\-config\-set\-cluster(1)\fP, \fBkubectl\-config\-set\-credentials(1)\fP, \fBkubectl\-config\-set\-context(1)\fP, \fBkubectl\-config\-set(1)\fP, \fBkubectl\-config\-unset(1)\fP, \fBkubectl\-config\-use\-context(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-create.1 b/docs/man/man1/kubectl-create.1 +new file mode 100644 +index 0000000..df45788 +--- /dev/null ++++ b/docs/man/man1/kubectl-create.1 +@@ -0,0 +1,44 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl create \- Create a resource by filename or stdin ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl create\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Create a resource by filename or stdin. ++ ++.PP ++JSON and YAML formats are accepted. ++ ++.PP ++Examples: ++ $ kubectl create \-f pod.json ++ ++ ++.PP ++$ cat pod.json | kubectl create \-f \- ++ ++ ++ ++.SH OPTIONS ++.PP ++\fB\-f\fP, \fB\-\-filename\fP=[] ++ Filename, directory, or URL to file to use to create the resource ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-delete.1 b/docs/man/man1/kubectl-delete.1 +new file mode 100644 +index 0000000..e945bbb +--- /dev/null ++++ b/docs/man/man1/kubectl-delete.1 +@@ -0,0 +1,65 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl delete \- Delete a resource by filename, stdin or resource and id ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl delete\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Delete a resource by filename, stdin, resource and id or by resources and label selector. ++ ++.PP ++JSON and YAML formats are accepted. ++ ++.PP ++If both a filename and command line arguments are passed, the command line ++arguments are used and the filename is ignored. ++ ++.PP ++Note that the delete command does NOT do resource version checks, so if someone ++submits an update to a resource right when you submit a delete, their update ++will be lost along with the rest of the resource. ++ ++.PP ++Examples: ++ $ kubectl delete \-f pod.json ++ ++ ++.PP ++$ cat pod.json | kubectl delete \-f \- ++ ++ ++.PP ++$ kubectl delete pods,services \-l name=myLabel ++ ++ ++.PP ++$ kubectl delete pod 1234\-56\-7890\-234234\-456456 ++ ++ ++ ++.SH OPTIONS ++.PP ++\fB\-f\fP, \fB\-\-filename\fP=[] ++ Filename, directory, or URL to a file containing the resource to delete ++ ++.PP ++\fB\-l\fP, \fB\-\-selector\fP="" ++ Selector (label query) to filter on ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-describe.1 b/docs/man/man1/kubectl-describe.1 +new file mode 100644 +index 0000000..24ddd42 +--- /dev/null ++++ b/docs/man/man1/kubectl-describe.1 +@@ -0,0 +1,30 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl describe \- Show details of a specific resource ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl describe\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Show details of a specific resource. ++ ++.PP ++This command joins many API calls together to form a detailed description of a ++given resource. ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-get.1 b/docs/man/man1/kubectl-get.1 +new file mode 100644 +index 0000000..d5cb4a8 +--- /dev/null ++++ b/docs/man/man1/kubectl-get.1 +@@ -0,0 +1,81 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl get \- Display one or many resources ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl get\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Display one or many resources. ++ ++.PP ++Possible resources include pods (po), replication controllers (rc), services ++(se), minions (mi), or events (ev). ++ ++.PP ++If you specify a Go template, you can use any fields defined for the API version ++you are connecting to the server with. ++ ++.PP ++Examples: ++ $ kubectl get pods ++ ++ ++.PP ++$ kubectl get replicationController 1234\-56\-7890\-234234\-456456 ++ ++ ++.PP ++$ kubectl get \-o json pod 1234\-56\-7890\-234234\-456456 ++ ++ ++.PP ++$ kubectl get rc,services ++ ++ ++ ++.SH OPTIONS ++.PP ++\fB\-\-no\-headers\fP=false ++ When using the default output, don't print headers ++ ++.PP ++\fB\-o\fP, \fB\-\-output\fP="" ++ Output format: json|yaml|template|templatefile ++ ++.PP ++\fB\-\-output\-version\fP="" ++ Output the formatted object with the given version (default api\-version) ++ ++.PP ++\fB\-l\fP, \fB\-\-selector\fP="" ++ Selector (label query) to filter on ++ ++.PP ++\fB\-t\fP, \fB\-\-template\fP="" ++ Template string or path to template file to use when \-o=template or \-o=templatefile. ++ ++.PP ++\fB\-w\fP, \fB\-\-watch\fP=false ++ After listing/getting the requested object, watch for changes. ++ ++.PP ++\fB\-\-watch\-only\fP=false ++ Watch for changes to the requested object(s), without listing/getting first. ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-log.1 b/docs/man/man1/kubectl-log.1 +new file mode 100644 +index 0000000..2bbd66e +--- /dev/null ++++ b/docs/man/man1/kubectl-log.1 +@@ -0,0 +1,39 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl log \- Print the logs for a container in a pod. ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl log\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Print the logs for a container in a pod. If the pod has only one container, the container name is optional ++Examples: ++ $ kubectl log 123456\-7890 ruby\-container ++ ++ ++.PP ++$ kubectl log \-f 123456\-7890 ruby\-container ++ ++ ++ ++.SH OPTIONS ++.PP ++\fB\-f\fP, \fB\-\-follow\fP=false ++ Specify if the logs should be streamed. ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-namespace.1 b/docs/man/man1/kubectl-namespace.1 +new file mode 100644 +index 0000000..4348f9f +--- /dev/null ++++ b/docs/man/man1/kubectl-namespace.1 +@@ -0,0 +1,38 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl namespace \- Set and view the current Kubernetes namespace ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl namespace\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Set and view the current Kubernetes namespace scope for command line requests. ++ ++.PP ++A Kubernetes namespace subdivides the cluster into groups of logically related pods, services, and replication controllers. ++ ++.PP ++Examples: ++ $ kubectl namespace ++ Using namespace default ++ ++.PP ++$ kubectl namespace other ++ Set current namespace to other ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-proxy.1 b/docs/man/man1/kubectl-proxy.1 +new file mode 100644 +index 0000000..aa0992c +--- /dev/null ++++ b/docs/man/man1/kubectl-proxy.1 +@@ -0,0 +1,36 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl proxy \- Run a proxy to the Kubernetes API server ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl proxy\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Run a proxy to the Kubernetes API server. ++ ++ ++.SH OPTIONS ++.PP ++\fB\-p\fP, \fB\-\-port\fP=8001 ++ The port on which to run the proxy ++ ++.PP ++\fB\-w\fP, \fB\-\-www\fP="" ++ Also serve static files from the given directory under the prefix /static ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-resize.1 b/docs/man/man1/kubectl-resize.1 +new file mode 100644 +index 0000000..dc68647 +--- /dev/null ++++ b/docs/man/man1/kubectl-resize.1 +@@ -0,0 +1,56 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl resize \- Set a new size for a resizable resource (currently only Replication Controllers) ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl resize\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Set a new size for a resizable resource (currently only Replication Controllers) ++ ++.PP ++Resize also allows users to specify one or more preconditions for the resize action. ++The new size is specified by \-\-replicas=. You can also specify an optional precondition. ++The two currently supported options are \-\-current\-replicas or \-\-resource\-version. ++If a precondition is specified, it is validated before the resize is attempted, and it is ++guaranteed that the precondition holds true when the resize is sent to the server. ++ ++.PP ++Examples: ++ $ kubectl resize \-\-replicas=3 replicationcontrollers foo ++ resized ++ ++.PP ++# will only execute if the current size is 2 ++ $ kubectl resize \-\-current\-replicas=2 \-\-replicas=3 replicationcontrollers foo ++ ++ ++.SH OPTIONS ++.PP ++\fB\-\-current\-replicas\fP=\-1 ++ Precondition for current size. Requires that the current size of the replication controller match this value in order to resize ++ ++.PP ++\fB\-\-replicas\fP=\-1 ++ The new number desired number of replicas. Required. ++ ++.PP ++\fB\-\-resource\-version\fP="" ++ Precondition for resource version. Requires that the current resource version match this value in order to resize ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-rollingupdate.1 b/docs/man/man1/kubectl-rollingupdate.1 +new file mode 100644 +index 0000000..9285937 +--- /dev/null ++++ b/docs/man/man1/kubectl-rollingupdate.1 +@@ -0,0 +1,58 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl rollingupdate \- Perform a rolling update of the given ReplicationController ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl rollingupdate\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Perform a rolling update of the given ReplicationController. ++ ++.PP ++Replaces named controller with new controller, updating one pod at a time to use the ++new PodTemplate. The new\-controller.json must specify the same namespace as the ++existing controller and overwrite at least one (common) label in its replicaSelector. ++ ++.PP ++Examples: ++$ kubectl rollingupdate frontend\-v1 \-f frontend\-v2.json ++ ++ ++.PP ++$ cat frontend\-v2.json | kubectl rollingupdate frontend\-v1 \-f \- ++ ++ ++ ++.SH OPTIONS ++.PP ++\fB\-f\fP, \fB\-\-filename\fP="" ++ Filename or URL to file to use to create the new controller ++ ++.PP ++\fB\-\-poll\-interval\fP="3s" ++ Time delay between polling controller status after update. Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". ++ ++.PP ++\fB\-\-timeout\fP="5m0s" ++ Max time to wait for a controller to update before giving up. Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". ++ ++.PP ++\fB\-\-update\-period\fP="1m0s" ++ Time to wait between updating pods. Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". ++ ++ ++.SH SEE ALSO ++.PP ++\fBkubectl(1)\fP, ++ ++ ++.SH HISTORY ++.PP ++January 2015, Originally compiled by Eric Paris (eparis at redhat dot com) based on the kubernetes source material, but hopefully they have been automatically generated since! +diff --git a/docs/man/man1/kubectl-run-container.1 b/docs/man/man1/kubectl-run-container.1 +new file mode 100644 +index 0000000..70dc2ac +--- /dev/null ++++ b/docs/man/man1/kubectl-run-container.1 +@@ -0,0 +1,86 @@ ++.TH "KUBERNETES" "1" " kubernetes User Manuals" "Eric Paris" "Jan 2015" "" ++ ++ ++.SH NAME ++.PP ++kubectl run\-container \- Run a particular image on the cluster. ++ ++ ++.SH SYNOPSIS ++.PP ++\fBkubectl run\-container\fP [OPTIONS] ++ ++ ++.SH DESCRIPTION ++.PP ++Create and run a particular image, possibly replicated. ++Creates a replication controller to manage the created container(s) ++ ++.PP ++Examples: ++ $ kubectl run\-container nginx \-\-image=dockerfile/nginx ++ ++ ++.PP ++$ kubectl run\-container nginx \-\-image=dockerfile/nginx \-\-replicas=5 ++ ++ ++.PP ++$ kubectl run\-container nginx \-\-image=dockerfile/nginx \-\-dry\-run ++ ++ ++.PP ++$ kubectl run\-container nginx \-\-image=dockerfile/nginx \-\-overrides='\{ "apiVersion": "v1beta1", "desiredState": \{ ... \} \}' ++ = 21 || 0%{?rhel} +Requires: docker +%else +Requires: docker-io +%endif + +Requires: etcd +Requires: hostname + +Requires(pre): shadow-utils + +BuildRequires: git +BuildRequires: golang >= 1.2-7 +BuildRequires: systemd +BuildRequires: etcd +BuildRequires: hostname + +%if 0%{?fedora} +# needed for go cover. Not available in RHEL/CentOS (available in Fedora/EPEL) +BuildRequires: golang-cover + +BuildRequires: golang(code.google.com/p/gcfg) +BuildRequires: golang(code.google.com/p/goauth2) +BuildRequires: golang(code.google.com/p/google-api-go-client) > 0-0.3 +BuildRequires: golang(code.google.com/p/go-uuid) +BuildRequires: golang(github.com/coreos/go-etcd/etcd) +BuildRequires: golang(github.com/davecgh/go-spew/spew) +BuildRequires: golang(github.com/elazarl/go-bindata-assetfs) +BuildRequires: golang(github.com/emicklei/go-restful) +BuildRequires: golang(github.com/fsouza/go-dockerclient) > 0-0.6 +BuildRequires: golang(github.com/ghodss/yaml) +BuildRequires: golang(github.com/golang/glog) +BuildRequires: golang(github.com/google/cadvisor) >= 0.6.2 +BuildRequires: golang(github.com/google/gofuzz) +BuildRequires: golang(github.com/kr/text) +BuildRequires: golang(github.com/mitchellh/goamz/aws) +BuildRequires: golang(github.com/mitchellh/goamz/ec2) +BuildRequires: golang(github.com/mitchellh/mapstructure) +BuildRequires: golang(github.com/racker/perigee) +BuildRequires: golang(github.com/rackspace/gophercloud) +BuildRequires: golang(github.com/skratchdot/open-golang/open) +BuildRequires: golang(github.com/spf13/cobra) +BuildRequires: golang(github.com/spf13/pflag) +BuildRequires: golang(github.com/stretchr/objx) +BuildRequires: golang(github.com/stretchr/testify) +BuildRequires: golang(github.com/tonnerre/golang-pretty) +BuildRequires: golang(github.com/vaughan0/go-ini) +BuildRequires: golang(golang.org/x/net/context) +BuildRequires: golang(golang.org/x/net/html) +BuildRequires: golang(golang.org/x/net/websocket) +BuildRequires: golang(gopkg.in/v2/yaml) +%endif + +%description +%{summary} + +%prep +%autosetup -Sgit -n %{name}-%{commit} + +%build +export KUBE_GIT_TREE_STATE="clean" +export KUBE_GIT_COMMIT=%{commit} +export KUBE_GIT_VERSION=v0.9.0 + +%if 0%{?fedora} +export KUBE_GIT_TREE_STATE="dirty" +export KUBE_EXTRA_GOPATH=%{gopath} +export KUBE_NO_GODEPS="true" +%endif + +hack/build-go.sh --use_go_build + +%check +%if 0%{?fedora} +export KUBE_EXTRA_GOPATH=%{gopath} +export KUBE_NO_GODEPS="true" +%endif + +echo "******Testing the commands*****" +hack/test-cmd.sh +echo "******Benchmarking kube********" +hack/benchmark-go.sh + +# In Fedora 20 and RHEL7 the go cover tools isn't available correctly +%if 0%{?fedora} >= 21 +echo "******Testing the go code******" +hack/test-go.sh +echo "******Testing integration******" +hack/test-integration.sh --use_go_build +%endif + +%install +. hack/lib/init.sh +kube::golang::setup_env + +output_path="${KUBE_OUTPUT_BINPATH}/$(kube::golang::current_platform)" + +binaries=(kube-apiserver kube-controller-manager kube-scheduler kube-proxy kubelet kubectl) +install -m 755 -d %{buildroot}%{_bindir} +for bin in "${binaries[@]}"; do + echo "+++ INSTALLING ${bin}" + install -p -m 755 -t %{buildroot}%{_bindir} ${output_path}/${bin} +done + +# install the bash completion +install -d -m 0755 %{buildroot}%{_datadir}/bash-completion/completions/ +install -t %{buildroot}%{_datadir}/bash-completion/completions/ contrib/completions/bash/kubectl + +# install config files +install -d -m 0755 %{buildroot}%{_sysconfdir}/%{name} +install -m 644 -t %{buildroot}%{_sysconfdir}/%{name} contrib/init/systemd/environ/* + +# install service files +install -d -m 0755 %{buildroot}%{_unitdir} +install -m 0644 -t %{buildroot}%{_unitdir} contrib/init/systemd/*.service + +# install manpages +install -d %{buildroot}%{_mandir}/man1 +install -p -m 644 docs/man/man1/* %{buildroot}%{_mandir}/man1 + +# install the place the kubelet defaults to put volumes +install -d %{buildroot}/var/lib/kubelet + +%files +%doc README.md LICENSE CONTRIB.md CONTRIBUTING.md DESIGN.md +%{_mandir}/man1/* +%{_bindir}/kube-apiserver +%{_bindir}/kubectl +%{_bindir}/kube-controller-manager +%{_bindir}/kubelet +%{_bindir}/kube-proxy +%{_bindir}/kube-scheduler +%{_unitdir}/kube-apiserver.service +%{_unitdir}/kubelet.service +%{_unitdir}/kube-scheduler.service +%{_unitdir}/kube-controller-manager.service +%{_unitdir}/kube-proxy.service +%dir %{_sysconfdir}/%{name} +%{_datadir}/bash-completion/completions/kubectl +%dir /var/lib/kubelet +%config(noreplace) %{_sysconfdir}/%{name}/config +%config(noreplace) %{_sysconfdir}/%{name}/apiserver +%config(noreplace) %{_sysconfdir}/%{name}/controller-manager +%config(noreplace) %{_sysconfdir}/%{name}/proxy +%config(noreplace) %{_sysconfdir}/%{name}/kubelet +%config(noreplace) %{_sysconfdir}/%{name}/scheduler + +%pre +getent group kube >/dev/null || groupadd -r kube +getent passwd kube >/dev/null || useradd -r -g kube -d / -s /sbin/nologin \ + -c "Kubernetes user" kube +%post +%systemd_post kube-apiserver kube-scheduler kube-controller-manager kubelet kube-proxy + +%preun +%systemd_preun kube-apiserver kube-scheduler kube-controller-manager kubelet kube-proxy + +%postun +%systemd_postun + +%changelog +* Sat Jan 31 2015 Eric Paris - 0.9.0-0.3.git96af0c3 +- Add man pages for kubectl commands + +* Tue Jan 27 2015 Eric Paris - 0.9.0-0.2.git96af0c3 +- change kubelet WorkingDir to /var/lib/kubelet, so .dockercfg can work (rhbz#1184654) + +* Thu Jan 22 2015 Eric Paris - 0.9.0-0.1.git96af0c3 +- use docker.service, not docker.socket in the kubelet service file + +* Wed Jan 21 2015 Eric Paris - 0.9.0-0.0.git96af0c3 +- Bump to upstream v0.9.0 + +* Fri Jan 09 2015 Eric Paris - 0.8.0-125.0.git68298f0 +- Bump to upstream 68298f08a4980f95dfbf7b9f58bfec1808fb2670 + +* Tue Dec 16 2014 Eric Paris - 0.7.0-18.0.git52e165a +- Bump to upstream 52e165a4fd720d1703ebc31bd6660e01334227b8 + +* Mon Dec 15 2014 Eric Paris - 0.6-297.0.git5ef34bf +- Bump to upstream 5ef34bf52311901b997119cc49eff944c610081b + +* Wed Dec 03 2014 Eric Paris +- Replace patch to use old googlecode/go.net/ with BuildRequires on golang.org/x/net/ + +* Tue Dec 02 2014 Eric Paris - 0.6-4.0.git993ef88 +- Bump to upstream 993ef88eec9012b221f79abe8f2932ee97997d28 + +* Mon Dec 01 2014 Eric Paris - 0.5-235.0.git6aabd98 +- Bump to upstream 6aabd9804fb75764b70e9172774002d4febcae34 + +* Wed Nov 26 2014 Eric Paris - 0.5-210.0.gitff1e9f4 +- Bump to upstream ff1e9f4c191342c24974c030e82aceaff8ea9c24 + +* Tue Nov 25 2014 Eric Paris - 0.5-174.0.git64e07f7 +- Bump to upstream 64e07f7fe03d8692c685b09770c45f364967a119 + +* Mon Nov 24 2014 Eric Paris - 0.5-125.0.git162e498 +- Bump to upstream 162e4983b947d2f6f858ca7607869d70627f5dff + +* Fri Nov 21 2014 Eric Paris - 0.5-105.0.git3f74a1e +- Bump to upstream 3f74a1e9f56b3c3502762930c0c551ccab0557ea + +* Thu Nov 20 2014 Eric Paris - 0.5-65.0.gitc6158b8 +- Bump to upstream c6158b8aa9c40fbf1732650a8611429536466b21 +- include go-restful build requirement + +* Tue Nov 18 2014 Eric Paris - 0.5-14.0.gitdf0981b +- Bump to upstream df0981bc01c5782ad30fc45cb6f510f365737fc1 + +* Tue Nov 11 2014 Eric Paris - 0.4-680.0.git30fcf24 +- Bump to upstream 30fcf241312f6d0767c7d9305b4c462f1655f790 + +* Mon Nov 10 2014 Eric Paris - 0.4-633.0.git6c70227 +- Bump to upstream 6c70227a2eccc23966d32ea6d558ee05df46e400 + +* Fri Nov 07 2014 Eric Paris - 0.4-595.0.gitb695650 +- Bump to upstream b6956506fa2682afa93770a58ea8c7ba4b4caec1 + +* Thu Nov 06 2014 Eric Paris - 0.4-567.0.git3b1ef73 +- Bump to upstream 3b1ef739d1fb32a822a22216fb965e22cdd28e7f + +* Thu Nov 06 2014 Eric Paris - 0.4-561.0.git06633bf +- Bump to upstream 06633bf4cdc1ebd4fc848f85025e14a794b017b4 +- Make spec file more RHEL/CentOS friendly + +* Tue Nov 04 2014 Eric Paris - 0.4-0.0.git4452163 +- rebase to v0.4 +- include man pages + +* Tue Oct 14 2014 jchaloup - 0.3-0.3.git98ac8e1 +- create /var/lib/kubelet +- Use bash completions from upstream +- Bump to upstream 98ac8e178fcf1627399d659889bcb5fe25abdca4 +- all by Eric Paris + +* Mon Sep 29 2014 Jan Chaloupka - 0.3-0.2.git88fdb65 +- replace * with coresponding files +- remove dependency on gcc + +* Wed Sep 24 2014 Eric Paris - 0.1-0.4.git6ebe69a +- prefer autosetup instead of setup (revert setup change in 0-0.3.git) +https://fedoraproject.org/wiki/Autosetup_packaging_draft +- revert version number to 0.1 + +* Mon Sep 08 2014 Lokesh Mandvekar - 0-0.3.git6ebe69a +- gopath defined in golang package already +- package owns /etc/kubernetes +- bash dependency implicit +- keep buildroot/$RPM_BUILD_ROOT macros consistent +- replace with macros wherever possible +- set version, release and source tarball prep as per +https://fedoraproject.org/wiki/Packaging:SourceURL#Github + +* Mon Sep 08 2014 Eric Paris +- make services restart automatically on error + +* Sat Sep 06 2014 Eric Paris +- update to upstream +- redo build to use project scripts +- use project scripts in %check +- rework deletion of third_party packages to easily detect changes +- run apiserver and controller-manager as non-root + +* Mon Aug 11 2014 Adam Miller +- update to upstream +- decouple the rest of third_party + +* Thu Aug 7 2014 Eric Paris +- update to head +- update package to include config files + +* Wed Jul 16 2014 Colin Walters +- Initial package