Change:
Simple version is done, more complex version needs work. Done, now that readiness corresponds to Running and is tracked by Kubelet status if the readiness hook is set? Done Done Do we want to do a more generic one or a less generic one? OpenShift was looking more at specific topical plugin commands ("add-volume", "set-default-resources"), but not sure how much hand-holding users need. Getting close. Exec has landed and is a replacement for ssh Attach on start remains hard. Implemented
I/we should also file issues for outstanding items without issues, and add lines for newly filed issues (e.g., command flag for run-container). Readiness is not yet used by rollingupdate. With respect to patch on the command line: I was thinking of a generic mechanism, but I could see the case for domain-aware commands, also. I think we need to better factor the command code and library code, and generic functionality vs. domain-aware functionality. Neither should ever convert to the internal representation. Domain-aware functionality (e.g., describe) should target a specific API version. Configuration generators, such as run-container, should be provided as services, or at least as separate plugin commands.
ref
ref
ref
ref
ref
ref

Discussion:
* [component/CLI](https://github.com/GoogleCloudPlatform/kubernetes/labels/component%2FCLI) * [component/client](https://github.com/GoogleCloudPlatform/kubernetes/labels/component%2Fclient) <del> 1. Kind-based filtering on object streams -- only operate on the kinds of objects specified. This would make directory-based kubectl operations much more useful. Users should be able to instantiate the example applications using `kubectl create -f <example-dir> ...` </del> 1. Create services before other objects, or at least before objects that depend upon them. Namespace-relative DNS mitigates this some, but most users are still using service environment variables. [#1768](https://github.com/GoogleCloudPlatform/kubernetes/issues/1768) <del> 1. Pretty printing of endpoints 1. Service address/port lookup command(s) </del> 1. Finish rolling update [#1353](https://github.com/GoogleCloudPlatform/kubernetes/issues/1353) 1. Friendly to auto-scaling [#2863](https://github.com/GoogleCloudPlatform/kubernetes/pull/2863#issuecomment-69701562) 1. Rollback (make rolling-update reversible, and complete an in-progress rolling update by taking 2 replication controller names rather than always taking a file)

1. Use readiness [#620](https://github.com/GoogleCloudPlatform/kubernetes/issues/620) 1. Perhaps factor this in a way that it can be shared with [Openshift’s deployment controller](https://github.com/GoogleCloudPlatform/kubernetes/issues/1743) 1. Rolling update service as a plugin <del> 1. List supported API versions </del> <ins> 1. Kind-based filtering on object streams -- only operate on the kinds of objects specified. This would make directory-based kubectl operations much more useful. Users should be able to instantiate the example applications using `kubectl create -f <example-dir> ...` 1. Improved pretty printing of endpoints, such as in the case that there are more than a few endpoints 1. Service address/port lookup command(s) </ins> 1. List supported resources 1. Swagger lookups [#3060](https://github.com/GoogleCloudPlatform/kubernetes/issues/3060) 1. --name, --name-suffix applied during creation and updates 1. --labels and opinionated label injection: --app=foo, --tier={fe,cache,be,db}, --uservice=redis, --env={dev,test,prod}, --stage={canary,final}, --track={hourly,daily,weekly}, --release=0.4.3c2. Exact ones TBD. We could allow arbitrary values -- the keys are important. The actual label keys would be (optionally?) namespaced with kubectl.kubernetes.io/, or perhaps the user’s namespace. 1. --annotations and opinionated annotation injection: --description, --revision <del> 1. Bulk updates (similar to get, create, delete) </del> 1. Imperative updates. We'll want to optionally make these safe(r) by supporting preconditions based on the current value and resourceVersion. 1. annotation updates similar to label updates <del> 1. more user-friendly on-command-line json for patch </del> <ins> 1. other custom commands for common imperative updates 1. more user-friendly (but still generic) on-command-line json for patch </ins> 1. We also want to support the following flavors of more general updates: 1. whichever we don’t support: 1. safe update: update the full resource, guarded by resourceVersion precondition (and perhaps selected value-based preconditions) 1. forced update: update the full resource, blowing away the previous Spec without preconditions; delete and re-create if necessary <del> 1. diff/dryrun: Compare new config with current Spec </del> <ins> 1. diff/dryrun: Compare new config with current Spec [#6284](https://github.com/GoogleCloudPlatform/kubernetes/issues/6284) </ins> 1. submit/apply/reconcile/ensure/merge: Merge user-provided fields with current Spec. Keep track of user-provided fields using an annotation -- see [#1702](https://github.com/GoogleCloudPlatform/kubernetes/issues/1702). Delete all objects with deployment-specific labels. 1. --dry-run for all commands 1. Support full label selection syntax, including support for namespaces. 1. Wait on conditions [#1899](https://github.com/GoogleCloudPlatform/kubernetes/issues/1899) 1. Make kubectl scriptable: make output and exit code behavior consistent and useful for wrapping in workflows and piping back into kubectl and/or xargs (e.g., dump full URLs?, distinguish permanent and retry-able failure, identify objects that should be retried) <del> 1. Here's [an example](http://techoverflow.net/blog/2013/10/22/docker-remove-all-images-and-containers/) where multiple objects on the command line and an option to dump object names only (`-q`) would be useful in combination. </del> <ins> 1. Here's [an example](http://techoverflow.net/blog/2013/10/22/docker-remove-all-images-and-containers/) where multiple objects on the command line and an option to dump object names only (`-q`) would be useful in combination. [#5906](https://github.com/GoogleCloudPlatform/kubernetes/issues/5906) </ins> 1. Easy generation of clean configuration files from existing objects (including containers -- podex) -- remove readonly fields, status 1. Export from one namespace, import into another is an important use case 1. Derive objects from other objects

1. More intelligent defaulting of fields (e.g., [#2643](https://github.com/GoogleCloudPlatform/kubernetes/issues/2643)) 1. Update preconditions based on the values of arbitrary object fields. 1. Deployment manager compatibility on GCP: [#3685](https://github.com/GoogleCloudPlatform/kubernetes/issues/3685) <ins> 1. Describe multiple objects, multiple kinds of objects [#5905](https://github.com/GoogleCloudPlatform/kubernetes/issues/5905) 1. Support yaml document separator [#5840](https://github.com/GoogleCloudPlatform/kubernetes/issues/5840) </ins> TODO: * watch <del> * ssh [#1513](https://github.com/GoogleCloudPlatform/kubernetes/issues/1513) </del> * attach [#1521](https://github.com/GoogleCloudPlatform/kubernetes/issues/1521) * image/registry commands * do any other server paths make sense? validate? generic curl functionality?

Server-side support: <del> Only finishing v1beta3 is a requirement for 1.0. The others are strong nice-to-haves. 1. Finish v1beta3 </del> 1. Default selectors from labels [#1698](https://github.com/GoogleCloudPlatform/kubernetes/issues/1698#issuecomment-71048278) <del> 1. List supported resources [#2057](https://github.com/GoogleCloudPlatform/kubernetes/issues/2057) </del> 1. Stop [#1535](https://github.com/GoogleCloudPlatform/kubernetes/issues/1535) 1. Deleted objects [#2789](https://github.com/GoogleCloudPlatform/kubernetes/issues/2789) 1. Clone [#170](https://github.com/GoogleCloudPlatform/kubernetes/issues/170) 1. Resize [#1629](https://github.com/GoogleCloudPlatform/kubernetes/issues/1629) 1. Useful /operations API: wait for finalization/reification <del> 1. Readiness [#620](https://github.com/GoogleCloudPlatform/kubernetes/issues/620) </del> <ins> 1. List supported resources [#2057](https://github.com/GoogleCloudPlatform/kubernetes/issues/2057) </ins> 1. Reverse label lookup [#1348](https://github.com/GoogleCloudPlatform/kubernetes/issues/1348) 1. Field selection [#1362](https://github.com/GoogleCloudPlatform/kubernetes/issues/1362) 1. Field filtering [#1459](https://github.com/GoogleCloudPlatform/kubernetes/issues/1459)

Other details: <del> * [API](api-conventions.md) </del> <ins> * [API](api.md) </ins> * [Client libraries](client-libraries.md) * [Command-line interface](kubectl.md) * [UI](ui.md)

(e.g. ssh keys, passwords) separately from the Pods that use them, protecting the sensitive data from proliferation by tools that process pods. <ins> * **API Overview** ([api.md](api.md)): Pointers to API documentation on various topics and explanation of Kubernetes's approaches to API changes and API versioning. </ins> * **Accessing the API** ([accessing_the_api.md](accessing_the_api.md)): Ports, IPs, proxies, and firewall rules.