Clean up standalone conversion tool

cmd/kube-version-change/import_known_versions.go

-/*
-Copyright 2015 The Kubernetes Authors All rights reserved.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-*/
-
-package main
-
-// These imports are the API groups the kube-version-change tool will support.
-import (
-	_ "k8s.io/kubernetes/pkg/api/install"
-	_ "k8s.io/kubernetes/pkg/apis/componentconfig/install"
-	_ "k8s.io/kubernetes/pkg/apis/extensions/install"
-	_ "k8s.io/kubernetes/pkg/apis/metrics/install"
-)

cmd/kube-version-change/version.go

-/*
-Copyright 2014 The Kubernetes Authors All rights reserved.
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-*/
-
-// kube-version-change is a simple utility for converting a
-// kubernetes object into a different api version.
-package main
-
-import (
-	"bytes"
-	"encoding/json"
-	"io"
-	"io/ioutil"
-	"log"
-	"os"
-	"runtime"
-
-	"k8s.io/kubernetes/pkg/api"
-	"k8s.io/kubernetes/pkg/api/latest"
-	"k8s.io/kubernetes/pkg/util"
-
-	"github.com/ghodss/yaml"
-	flag "github.com/spf13/pflag"
-)
-
-var (
-	inputSource   = flag.StringP("input", "i", "-", "Input source; '-' means stdin")
-	outputDest    = flag.StringP("output", "o", "-", "Output destination; '-' means stdout")
-	rewrite       = flag.StringP("rewrite", "r", "", "If nonempty, use this as both input and output.")
-	outputVersion = flag.StringP("out-version", "v", latest.GroupOrDie(api.GroupName).GroupVersion.Version, "Version to convert input to")
-)
-
-// isYAML determines whether data is JSON or YAML formatted by seeing
-// if it will parse as json.
-func isYAML(data []byte) bool {
-	var unused interface{}
-	if err := json.Unmarshal(data, &unused); err != nil {
-		return true
-	}
-	return false
-}
-
-func main() {
-	runtime.GOMAXPROCS(runtime.NumCPU())
-	flag.CommandLine.SetNormalizeFunc(util.WordSepNormalizeFunc)
-	flag.Parse()
-
-	if *rewrite != "" {
-		*inputSource = *rewrite
-		*outputDest = *rewrite
-	}
-
-	var in io.Reader
-	if *inputSource == "-" {
-		in = os.Stdin
-	} else {
-		f, err := os.Open(*inputSource)
-		if err != nil {
-			log.Fatalf("Couldn't open %q: %q", *inputSource, err)
-		}
-		defer f.Close()
-		in = f
-	}
-
-	data, err := ioutil.ReadAll(in)
-	if err != nil {
-		log.Fatalf("Couldn't read from input: %q", err)
-	}
-	isYAML := isYAML(data)
-
-	if isYAML {
-		data, err = yaml.YAMLToJSON(data)
-		if err != nil {
-			log.Fatalf("Failed to convert YAML to JSON: %q", err)
-		}
-	}
-	obj, err := api.Scheme.Decode(data)
-	if err != nil {
-		log.Fatalf("Couldn't decode input: %q", err)
-	}
-
-	outData, err := api.Scheme.EncodeToVersion(obj, *outputVersion)
-	if err != nil {
-		log.Fatalf("Failed to encode to version %q: %q", *outputVersion, err)
-	}
-
-	if isYAML {
-		outData, err = yaml.JSONToYAML(outData)
-		if err != nil {
-			log.Fatalf("Failed to convert to YAML: %q", err)
-		}
-	} else if true {
-		// TODO: figure out if input JSON was pretty.
-		var buf bytes.Buffer
-		err = json.Indent(&buf, outData, "", "  ")
-		if err != nil {
-			log.Fatalf("Failed to indent JSON: %q", err)
-		}
-		outData = buf.Bytes()
-	}
-
-	var out io.Writer
-	if *outputDest == "-" {
-		out = os.Stdout
-	} else {
-		f, err := os.Create(*outputDest)
-		if err != nil {
-			log.Fatalf("Couldn't open %q: %q", *outputDest, err)
-		}
-		defer f.Close()
-		out = f
-	}
-
-	if _, err = out.Write(outData); err != nil {
-		log.Fatalf("Failed to write: %q", err)
-	}
-}

docs/admin/cluster-management.md

@@ -204,13 +204,13 @@ for changes to this variable to take effect.
 
 ### 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.
+You can use `kubectl convert` command to convert config files between different API versions.
 
 ```console
-$ hack/build-go.sh cmd/kube-version-change
-$ _output/local/go/bin/kube-version-change -i myPod.v1beta3.yaml -o myPod.v1.yaml
+$ kubectl convert -f pod.yaml --output-version v1
 ```
 
+For more options, please refer to the usage of [kubectl convert](../user-guide/kubectl/kubectl_convert.md) command.
 
 <!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
 [![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/cluster-management.md?pixel)]()

docs/api.md

@@ -121,7 +121,7 @@ As of June 4, 2015, the Kubernetes v1 API has been enabled by default. The v1bet
 
 ### v1 conversion tips (from v1beta3)
 
-We're working to convert all documentation and examples to v1. A simple [API conversion tool](admin/cluster-management.md#switching-your-config-files-to-a-new-api-version) has been written to simplify the translation process. Use `kubectl create --validate` in order to validate your json or yaml against our Swagger spec.
+We're working to convert all documentation and examples to v1. Use `kubectl create --validate` in order to validate your json or yaml against our Swagger spec.
 
 Changes to services are the most significant difference between v1beta3 and v1.
 

docs/devel/adding-an-APIGroup.md

@@ -42,7 +42,7 @@ We plan on improving the way the types are factored in the future; see [#16062](
 
 2. Create pkg/apis/`<group>`/{register.go, `<version>`/register.go} to register this group's API objects to the encoding/decoding scheme (e.g., [pkg/apis/extensions/register.go](../../pkg/apis/extensions/register.go) and [pkg/apis/extensions/v1beta1/register.go](../../pkg/apis/extensions/v1beta1/register.go);
 
-3. Add a pkg/apis/`<group>`/install/install.go, which is responsible for adding the group to the `latest` package, so that other packages can access the group's meta through `latest.Group`. You probably only need to change the name of group and version in the [example](../../pkg/apis/extensions/install/install.go)). You need to import this `install` package in {pkg/master, pkg/client/unversioned, cmd/kube-version-change}/import_known_versions.go, if you want to make your group accessible to other packages in the kube-apiserver binary, binaries that uses the client package, or the kube-version-change tool.
+3. Add a pkg/apis/`<group>`/install/install.go, which is responsible for adding the group to the `latest` package, so that other packages can access the group's meta through `latest.Group`. You probably only need to change the name of group and version in the [example](../../pkg/apis/extensions/install/install.go)). You need to import this `install` package in {pkg/master, pkg/client/unversioned}/import_known_versions.go, if you want to make your group accessible to other packages in the kube-apiserver binary, binaries that uses the client package.
 
 Step 2 and 3 are mechanical, we plan on autogenerate these using the cmd/libs/go2idl/ tool.