From 7a68a5aebfc14517d491ca32d08390549723fab4 Mon Sep 17 00:00:00 2001 From: Daniel Smith Date: Wed, 4 Mar 2015 13:46:36 -0800 Subject: [PATCH] Add cluster management doc --- docs/README.md | 2 ++ docs/cluster_management.md | 33 +++++++++++++++++++++++++++++++++ 2 files changed, 35 insertions(+) create mode 100644 docs/cluster_management.md diff --git a/docs/README.md b/docs/README.md index fb556f39d93..9807c43700b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -58,6 +58,8 @@ Frequently asked questions are answered on this project's [wiki](https://github. * **Glossary** ([glossary.md](glossary.md)): Terms and concepts. +* **Cluster Management** ([cluster_management.md](cluster_management.md)): Starting and upgrading clusters. + ## Further reading diff --git a/docs/cluster_management.md b/docs/cluster_management.md new file mode 100644 index 00000000000..459bb2046d4 --- /dev/null +++ b/docs/cluster_management.md @@ -0,0 +1,33 @@ +# Cluster Management + +This doc is in progress. + +## Upgrading a cluster + +The `cluster/kube-push.sh` script will do a rudimentary update; it is a 1.0 roadmap item to have a robust live cluster update system. + +## Updgrading to a different API version + +There is a sequence of steps to upgrade to a new API version. + +1. Turn on the new version. +2. Upgrade the cluster's storage to use the new version. +3. Upgrade all config files. Identify users of the old api version endpoints. +3. Turn off the old version. + +### Turn on or off an API version for your cluster + +TODO: There's an apiserver flag for this. + +### Switching your cluster's storage API version + +TODO: This functionality hasn't been written yet. + +### Switching your config files to a new API version + +You can use the kube-version-change utility to convert config files between different API versions. + +``` +$ hack/build-go.sh cmd/kube-version-change +$ _output/go/bin/kube-version-change -i myPod.v1beta1.yaml -o myPod.v1beta3.yaml +```