diff --git a/docs/README.md b/docs/README.md deleted file mode 100644 index e9a1c77a2ff..00000000000 --- a/docs/README.md +++ /dev/null @@ -1,32 +0,0 @@ -# Kubernetes Documentation: releases.k8s.io/HEAD - -* The [User's guide](user-guide/README.md) is for anyone who wants to run programs and - services on an existing Kubernetes cluster. - -* The [Cluster Admin's guide](admin/README.md) is for anyone setting up - a Kubernetes cluster or administering it. - -* The [Developer guide](devel/README.md) is for anyone wanting to write - programs that access the Kubernetes API, write plugins or extensions, or - modify the core code of Kubernetes. - -* The [Kubectl Command Line Interface](user-guide/kubectl/kubectl.md) is a detailed reference on - the `kubectl` CLI. - -* The [API object documentation](api-reference/README.md) - is a detailed description of all fields found in core API objects. - -* An overview of the [Design of Kubernetes](design/) - -* There are example files and walkthroughs in the [examples](../examples/) - folder. - -* If something went wrong, see the [troubleshooting](http://kubernetes.io/docs/troubleshooting/) guide for how to debug. -You should also check the [known issues for the release](../CHANGELOG.md) you're using. - -* To report a security issue, see [Reporting a Security Issue](reporting-security-issues.md). - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/README.md?pixel)]() - diff --git a/docs/admin/README.md b/docs/admin/README.md deleted file mode 100644 index c8f68806cfd..00000000000 --- a/docs/admin/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/README.md?pixel)]() - diff --git a/docs/admin/accessing-the-api.md b/docs/admin/accessing-the-api.md deleted file mode 100644 index 65855d784d1..00000000000 --- a/docs/admin/accessing-the-api.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/accessing-the-api/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/accessing-the-api.md?pixel)]() - diff --git a/docs/admin/admission-controllers.md b/docs/admin/admission-controllers.md deleted file mode 100644 index 84ce46af0cd..00000000000 --- a/docs/admin/admission-controllers.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/admission-controllers/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/admission-controllers.md?pixel)]() - diff --git a/docs/admin/authentication.md b/docs/admin/authentication.md deleted file mode 100644 index 294d727442e..00000000000 --- a/docs/admin/authentication.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/authentication/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/authentication.md?pixel)]() - diff --git a/docs/admin/authorization.md b/docs/admin/authorization.md deleted file mode 100644 index 7307c8efdf0..00000000000 --- a/docs/admin/authorization.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/authorization/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/authorization.md?pixel)]() - diff --git a/docs/admin/cluster-components.md b/docs/admin/cluster-components.md deleted file mode 100644 index f36a67b2146..00000000000 --- a/docs/admin/cluster-components.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/cluster-components/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/cluster-components.md?pixel)]() - diff --git a/docs/admin/cluster-large.md b/docs/admin/cluster-large.md deleted file mode 100644 index 3ca45e358c1..00000000000 --- a/docs/admin/cluster-large.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/cluster-large/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/cluster-large.md?pixel)]() - diff --git a/docs/admin/cluster-management.md b/docs/admin/cluster-management.md deleted file mode 100644 index f661bebec19..00000000000 --- a/docs/admin/cluster-management.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/cluster-management/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/cluster-management.md?pixel)]() - diff --git a/docs/admin/cluster-troubleshooting.md b/docs/admin/cluster-troubleshooting.md deleted file mode 100644 index 2b11e49ec09..00000000000 --- a/docs/admin/cluster-troubleshooting.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/cluster-troubleshooting/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/cluster-troubleshooting.md?pixel)]() - diff --git a/docs/admin/daemons.md b/docs/admin/daemons.md deleted file mode 100644 index bbe353c9080..00000000000 --- a/docs/admin/daemons.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/daemons/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/daemons.md?pixel)]() - diff --git a/docs/admin/dns.md b/docs/admin/dns.md deleted file mode 100644 index 7a94db8d825..00000000000 --- a/docs/admin/dns.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/dns/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/dns.md?pixel)]() - diff --git a/docs/admin/etcd.md b/docs/admin/etcd.md deleted file mode 100644 index 748768e72f3..00000000000 --- a/docs/admin/etcd.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/etcd/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/etcd.md?pixel)]() - diff --git a/docs/admin/garbage-collection.md b/docs/admin/garbage-collection.md deleted file mode 100644 index e81b307b548..00000000000 --- a/docs/admin/garbage-collection.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/garbage-collection/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/garbage-collection.md?pixel)]() - diff --git a/docs/admin/high-availability.md b/docs/admin/high-availability.md deleted file mode 100644 index a11117b6588..00000000000 --- a/docs/admin/high-availability.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/high-availability/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/high-availability.md?pixel)]() - diff --git a/docs/admin/introduction.md b/docs/admin/introduction.md deleted file mode 100644 index 73f199f2f07..00000000000 --- a/docs/admin/introduction.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/introduction/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/introduction.md?pixel)]() - diff --git a/docs/admin/limitrange/README.md b/docs/admin/limitrange/README.md deleted file mode 100644 index 093c4517ce7..00000000000 --- a/docs/admin/limitrange/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/limitrange/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/limitrange/README.md?pixel)]() - diff --git a/docs/admin/master-node-communication.md b/docs/admin/master-node-communication.md deleted file mode 100644 index 5e8b0aa11f9..00000000000 --- a/docs/admin/master-node-communication.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/master-node-communication/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/master-node-communication.md?pixel)]() - diff --git a/docs/admin/multi-cluster.md b/docs/admin/multi-cluster.md deleted file mode 100644 index 37870f8180f..00000000000 --- a/docs/admin/multi-cluster.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/multi-cluster/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/multi-cluster.md?pixel)]() - diff --git a/docs/admin/namespaces.md b/docs/admin/namespaces.md deleted file mode 100644 index 81cc1ece6e4..00000000000 --- a/docs/admin/namespaces.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/namespaces/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/namespaces.md?pixel)]() - diff --git a/docs/admin/namespaces/README.md b/docs/admin/namespaces/README.md deleted file mode 100644 index b7024b1c1f9..00000000000 --- a/docs/admin/namespaces/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/namespaces/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/namespaces/README.md?pixel)]() - diff --git a/docs/admin/network-plugins.md b/docs/admin/network-plugins.md deleted file mode 100644 index 89f32f486ed..00000000000 --- a/docs/admin/network-plugins.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/network-plugins/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/network-plugins.md?pixel)]() - diff --git a/docs/admin/networking.md b/docs/admin/networking.md deleted file mode 100644 index 42d4d1e548c..00000000000 --- a/docs/admin/networking.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/networking/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/networking.md?pixel)]() - diff --git a/docs/admin/node.md b/docs/admin/node.md deleted file mode 100644 index 3265efd3bbb..00000000000 --- a/docs/admin/node.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/node/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/node.md?pixel)]() - diff --git a/docs/admin/ovs-networking.md b/docs/admin/ovs-networking.md deleted file mode 100644 index 8cea5ac10f9..00000000000 --- a/docs/admin/ovs-networking.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/ovs-networking/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/ovs-networking.md?pixel)]() - diff --git a/docs/admin/resource-quota.md b/docs/admin/resource-quota.md deleted file mode 100644 index f886566584b..00000000000 --- a/docs/admin/resource-quota.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/resource-quota/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/resource-quota.md?pixel)]() - diff --git a/docs/admin/resourcequota/README.md b/docs/admin/resourcequota/README.md deleted file mode 100644 index 1521265683b..00000000000 --- a/docs/admin/resourcequota/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/resourcequota/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/resourcequota/README.md?pixel)]() - diff --git a/docs/admin/salt.md b/docs/admin/salt.md deleted file mode 100644 index 60426bf4935..00000000000 --- a/docs/admin/salt.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/salt/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/salt.md?pixel)]() - diff --git a/docs/admin/service-accounts-admin.md b/docs/admin/service-accounts-admin.md deleted file mode 100644 index dea3f1032df..00000000000 --- a/docs/admin/service-accounts-admin.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/service-accounts-admin/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/service-accounts-admin.md?pixel)]() - diff --git a/docs/admin/static-pods.md b/docs/admin/static-pods.md deleted file mode 100644 index bb3d5892a8c..00000000000 --- a/docs/admin/static-pods.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/admin/static-pods/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/admin/static-pods.md?pixel)]() - diff --git a/docs/api-reference/README.md b/docs/api-reference/README.md deleted file mode 100644 index 4ec8b066ca5..00000000000 --- a/docs/api-reference/README.md +++ /dev/null @@ -1,13 +0,0 @@ -# API Reference - -Use the following reference docs to understand the kubernetes REST API for various API group versions: - -* v1: [operations](https://htmlpreview.github.io/?https://github.com/kubernetes/kubernetes/blob/HEAD/docs/api-reference/v1/operations.html), [model definitions](https://htmlpreview.github.io/?https://github.com/kubernetes/kubernetes/blob/HEAD/docs/api-reference/v1/definitions.html) -* extensions/v1beta1: [operations](https://htmlpreview.github.io/?https://github.com/kubernetes/kubernetes/blob/HEAD/docs/api-reference/extensions/v1beta1/operations.html), [model definitions](https://htmlpreview.github.io/?https://github.com/kubernetes/kubernetes/blob/HEAD/docs/api-reference/extensions/v1beta1/definitions.html) -* batch/v1: [operations](https://htmlpreview.github.io/?https://github.com/kubernetes/kubernetes/blob/HEAD/docs/api-reference/batch/v1/operations.html), [model definitions](https://htmlpreview.github.io/?https://github.com/kubernetes/kubernetes/blob/HEAD/docs/api-reference/batch/v1/definitions.html) -* autoscaling/v1: [operations](https://htmlpreview.github.io/?https://github.com/kubernetes/kubernetes/blob/HEAD/docs/api-reference/autoscaling/v1/operations.html), [model definitions](https://htmlpreview.github.io/?https://github.com/kubernetes/kubernetes/blob/HEAD/docs/api-reference/autoscaling/v1/definitions.html) - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/api-reference/README.md?pixel)]() - diff --git a/docs/api-reference/extensions/v1beta1/definitions.md b/docs/api-reference/extensions/v1beta1/definitions.md deleted file mode 100644 index 61c4ba5630e..00000000000 --- a/docs/api-reference/extensions/v1beta1/definitions.md +++ /dev/null @@ -1,9 +0,0 @@ - -{% include /extensions-v1beta1-definitions.html %} - - - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/api-reference/extensions/v1beta1/definitions.md?pixel)]() - diff --git a/docs/api-reference/extensions/v1beta1/operations.md b/docs/api-reference/extensions/v1beta1/operations.md deleted file mode 100644 index 639ffe32878..00000000000 --- a/docs/api-reference/extensions/v1beta1/operations.md +++ /dev/null @@ -1,9 +0,0 @@ - -{% include /extensions-v1beta1-operations.html %} - - - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/api-reference/extensions/v1beta1/operations.md?pixel)]() - diff --git a/docs/api-reference/labels-annotations-taints.md b/docs/api-reference/labels-annotations-taints.md deleted file mode 100644 index ef7574ffcd0..00000000000 --- a/docs/api-reference/labels-annotations-taints.md +++ /dev/null @@ -1,111 +0,0 @@ -# Well-Known Labels, Annotations and Taints - -Kubernetes reserves all labels and annotations in the kubernetes.io namespace. This document describes -the well-known kubernetes.io labels and annotations. - -This document serves both as a reference to the values, and as a coordination point for assigning values. - -**Table of contents:** - - -- [Well-Known Labels, Annotations and Taints](#well-known-labels-annotations-and-taints) - - [beta.kubernetes.io/arch](#betakubernetesioarch) - - [beta.kubernetes.io/os](#betakubernetesioos) - - [kubernetes.io/hostname](#kubernetesiohostname) - - [beta.kubernetes.io/instance-type](#betakubernetesioinstance-type) - - [failure-domain.beta.kubernetes.io/region](#failure-domainbetakubernetesioregion) - - [failure-domain.beta.kubernetes.io/zone](#failure-domainbetakubernetesiozone) - - - - -## beta.kubernetes.io/arch - -Example: `beta.kubernetes.io/arch=amd64` - -Used on: Node - -Kubelet populates this with `runtime.GOARCH` as defined by Go. This can be handy if you are mixing arm and x86 nodes, -for example. - -## beta.kubernetes.io/os - -Example: `beta.kubernetes.io/os=linux` - -Used on: Node - -Kubelet populates this with `runtime.GOOS` as defined by Go. This can be handy if you are mixing operating systems -in your cluster (although currently Linux is the only OS supported by kubernetes). - -## kubernetes.io/hostname - -Example: `kubernetes.io/hostname=ip-172-20-114-199.ec2.internal` - -Used on: Node - -Kubelet populates this with the hostname. Note that the hostname can be changed from the "actual" hostname -by passing the `--hostname-override` flag to kubelet. - -## beta.kubernetes.io/instance-type - -Example: `beta.kubernetes.io/instance-type=m3.medium` - -Used on: Node - -Kubelet populates this with the instance type as defined by the `cloudprovider`. It will not be set if -not using a cloudprovider. This can be handy if you want to target certain workloads to certain instance -types, but typically you want to rely on the kubernetes scheduler to perform resource-based scheduling, -and you should aim to schedule based on properties rather than on instance types (e.g. require a GPU, instead -of requiring a `g2.2xlarge`) - - -## failure-domain.beta.kubernetes.io/region - -See [failure-domain.beta.kubernetes.io/zone](#failure-domainbetakubernetesiozone) - -## failure-domain.beta.kubernetes.io/zone - -Example: - -`failure-domain.beta.kubernetes.io/region=us-east-1` - -`failure-domain.beta.kubernetes.io/zone=us-east-1c` - -Used on: Node, PersistentVolume - -On the Node: Kubelet populates this with the zone information as defined by the `cloudprovider`. It will not be set if -not using a `cloudprovider`, but you should consider setting it on the nodes if it makes sense in your topology. - -On the PersistentVolume: The `PersistentVolumeLabel` admission controller will automatically add zone labels to PersistentVolumes, -on GCE and AWS. - -Kubernetes will automatically spread the pods in a replication controller or service across nodes in a single-zone -cluster (to reduce the impact of failures.) With multiple-zone clusters, this spreading behaviour is extended -across zones (to reduce the impact of zone failures.) This is achieved via SelectorSpreadPriority. - -This is a best-effort placement, and so if the zones in your cluster are heterogeneous (e.g. different numbers of nodes, -different types of nodes, or different pod resource requirements), this might prevent equal spreading of -your pods across zones. If desired, you can use homogenous zones (same number and types of nodes) to reduce -the probability of unequal spreading. - -The scheduler (via the VolumeZonePredicate predicate) will also ensure that pods that claim a given volume -are only placed into the same zone as that volume, as volumes cannot be attached across zones. - - -The actual values of zone and region don't matter, and nor is the meaning of the hierarchy rigidly defined. The expectation -is that failures of nodes in different zones should be uncorrelated unless the entire region has failed. For example, -zones should typically avoid sharing a single network switch. The exact mapping depends on your particular -infrastructure - a three-rack installation will choose a very different setup to a multi-datacenter configuration. - -If `PersistentVolumeLabel` does not support automatic labeling of your PersistentVolumes, you should consider -adding the labels manually (or adding support to `PersistentVolumeLabel`), if you want the scheduler to prevent -pods from mounting volumes in a different zone. If your infrastructure doesn't have this constraint, you don't -need to add the zone labels to the volumes at all. - - - - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/api-reference/labels-annotations-taints.md?pixel)]() - diff --git a/docs/api-reference/v1/definitions.md b/docs/api-reference/v1/definitions.md deleted file mode 100644 index 237afe9861a..00000000000 --- a/docs/api-reference/v1/definitions.md +++ /dev/null @@ -1,9 +0,0 @@ - -{% include /v1-definitions.html %} - - - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/api-reference/v1/definitions.md?pixel)]() - diff --git a/docs/api-reference/v1/operations.md b/docs/api-reference/v1/operations.md deleted file mode 100644 index 632dee0e4ca..00000000000 --- a/docs/api-reference/v1/operations.md +++ /dev/null @@ -1,9 +0,0 @@ - -{% include /v1-operations.html %} - - - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/api-reference/v1/operations.md?pixel)]() - diff --git a/docs/api.md b/docs/api.md deleted file mode 100644 index de8ed119714..00000000000 --- a/docs/api.md +++ /dev/null @@ -1,161 +0,0 @@ -# The Kubernetes API - -Primary system and API concepts are documented in the [User guide](user-guide/README.md). - -Overall API conventions are described in the [API conventions doc](devel/api-conventions.md). - -Complete API details are documented via [Swagger](http://swagger.io/). The Kubernetes apiserver (aka "master") exports an API that can be used to retrieve the [Swagger spec](https://github.com/swagger-api/swagger-spec/tree/master/schemas/v1.2) for the Kubernetes API, by default at `/swaggerapi`. It also exports a UI you can use to browse the API documentation at `/swagger-ui` if the apiserver is passed --enable-swagger-ui=true flag. We also host generated [API reference docs](api-reference/README.md). - -Remote access to the API is discussed in the [access doc](admin/accessing-the-api.md). - -The Kubernetes API also serves as the foundation for the declarative configuration schema for the system. The [Kubectl](user-guide/kubectl/kubectl.md) command-line tool can be used to create, update, delete, and get API objects. - -Kubernetes also stores its serialized state (currently in [etcd](https://coreos.com/docs/distributed-configuration/getting-started-with-etcd/)) in terms of the API resources. - -Kubernetes itself is decomposed into multiple components, which interact through its API. - -## Adding APIs to Kubernetes - -Every API that is added to Kubernetes carries with it increased cost and complexity for all parts of the Kubernetes ecosystem. New APIs imply new code to maintain, -new tests that may flake, new documentation that users are required to understand, increased cognitive load for kubectl users and many other incremental costs. - -Of course, the addition of new APIs also enables new functionality that empowers users to simply do things that may have been previously complex, costly or both. - -Given this balance between increasing the complexity of the project versus the reduction of complexity in user actions, we have set out to set up a set of criteria -to guide how we as a development community decide when an API should be added to the set of core Kubernetes APIs. - -The criteria for inclusion are as follows: - * Within the Kubernetes ecosystem, there is a single well known definition of such an API. As an example, `cron` has a well understood and generally accepted -specification, whereas there are countless different systems for definition workflows of dependent actions (e.g. Celery et al.). - * The API object is expected to be generally useful to greater than 50% of the Kubernetes users. This is to ensure that we don't build up a collection of niche APIs -that users rarely need. - * There is general consensus in the Kubernetes community that the API object is in the "Kubernetes layer". See ["What is Kubernetes?"](http://kubernetes.io/docs/whatisk8s/) for a detailed -explanation of what we believe the "Kubernetes layer" to be. - -Of course for every set of rules, we need to ensure that we are not hamstrung or limited by slavish devotion to those rules. Thus we also introduce two exceptions -for adding APIs in Kubernetes that violate these criteria. - -These exceptions are: - * There is no other way to implement the functionality in Kubernetes. We are not sure there are any examples of this anymore, but we retain this exception just in case -we have overlooked something. - * Exceptional circumstances, as judged by the Kubernetes committers and discussed in community meeting prior to inclusion of the API. We hope (expect?) that this -exception will be used rarely if at all. - - -## API changes - -In our experience, any system that is successful needs to grow and change as new use cases emerge or existing ones change. Therefore, we expect the Kubernetes API to continuously change and grow. However, we intend to not break compatibility with existing clients, for an extended period of time. In general, new API resources and new resource fields can be expected to be added frequently. Elimination of resources or fields will require following a deprecation process. The precise deprecation policy for eliminating features is TBD, but once we reach our 1.0 milestone, there will be a specific policy. - -What constitutes a compatible change and how to change the API are detailed by the [API change document](devel/api_changes.md). - -## API versioning - -To make it easier to eliminate fields or restructure resource representations, Kubernetes supports -multiple API versions, each at a different API path, such as `/api/v1` or -`/apis/extensions/v1beta1`. - -We chose to version at the API level rather than at the resource or field level to ensure that the API presents a clear, consistent view of system resources and behavior, and to enable controlling access to end-of-lifed and/or experimental APIs. - -Note that API versioning and Software versioning are only indirectly related. The [API and release -versioning proposal](design/versioning.md) describes the relationship between API versioning and -software versioning. - - -Different API versions imply different levels of stability and support. The criteria for each level are described -in more detail in the [API Changes documentation](devel/api_changes.md#alpha-beta-and-stable-versions). They are summarized here: - -- Alpha level: - - The version names contain `alpha` (e.g. `v1alpha1`). - - May be buggy. Enabling the feature may expose bugs. Disabled by default. - - Support for feature may be dropped at any time without notice. - - The API may change in incompatible ways in a later software release without notice. - - Recommended for use only in short-lived testing clusters, due to increased risk of bugs and lack of long-term support. -- Beta level: - - The version names contain `beta` (e.g. `v2beta3`). - - Code is well tested. Enabling the feature is considered safe. Enabled by default. - - Support for the overall feature will not be dropped, though details may change. - - The schema and/or semantics of objects may change in incompatible ways in a subsequent beta or stable release. When this happens, - we will provide instructions for migrating to the next version. This may require deleting, editing, and re-creating - API objects. The editing process may require some thought. This may require downtime for applications that rely on the feature. - - Recommended for only non-business-critical uses because of potential for incompatible changes in subsequent releases. If you have - multiple clusters which can be upgraded independently, you may be able to relax this restriction. - - **Please do try our beta features and give feedback on them! Once they exit beta, it may not be practical for us to make more changes.** -- Stable level: - - The version name is `vX` where `X` is an integer. - - Stable versions of features will appear in released software for many subsequent versions. - -## API groups - -To make it easier to extend the Kubernetes API, we are in the process of implementing [*API -groups*](proposals/api-group.md). These are simply different interfaces to read and/or modify the -same underlying resources. The API group is specified in a REST path and in the `apiVersion` field -of a serialized object. - -Currently there are two API groups in use: - -1. the "core" group, which is at REST path `/api/v1` and is not specified as part of the `apiVersion` field, e.g. - `apiVersion: v1`. -1. the "extensions" group, which is at REST path `/apis/extensions/$VERSION`, and which uses - `apiVersion: extensions/$VERSION` (e.g. currently `apiVersion: extensions/v1beta1`). - This holds types which will probably move to another API group eventually. -1. the "componentconfig" and "metrics" API groups. - -In the future we expect that there will be more API groups, all at REST path `/apis/$API_GROUP` and using `apiVersion: $API_GROUP/$VERSION`. -We expect that there will be a way for [third parties to create their own API groups](design/extending-api.md). -To avoid naming collisions, third-party API groups must be a DNS name at least three segments long. -New Kubernetes API groups are suffixed with `.k8s.io` (e.g. `storage.k8s.io`, `rbac.authorization.k8s.io`). - -## Enabling resources in the extensions group - -DaemonSets, Deployments, HorizontalPodAutoscalers, Ingress, Jobs and ReplicaSets are enabled by default. -Other extensions resources can be enabled by setting runtime-config on -apiserver. runtime-config accepts comma separated values. For ex: to disable deployments and jobs, set -`--runtime-config=extensions/v1beta1/deployments=false,extensions/v1beta1/jobs=false` - -## v1beta1, v1beta2, and v1beta3 are deprecated; please move to v1 ASAP - -As of June 4, 2015, the Kubernetes v1 API has been enabled by default. The v1beta1 and v1beta2 APIs were deleted on June 1, 2015. v1beta3 is planned to be deleted on July 6, 2015. - -### v1 conversion tips (from v1beta3) - -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. - -* The `service.spec.portalIP` property is renamed to `service.spec.clusterIP`. -* The `service.spec.createExternalLoadBalancer` property is removed. Specify `service.spec.type: "LoadBalancer"` to create an external load balancer instead. -* The `service.spec.publicIPs` property is deprecated and now called `service.spec.deprecatedPublicIPs`. This property will be removed entirely when v1beta3 is removed. The vast majority of users of this field were using it to expose services on ports on the node. Those users should specify `service.spec.type: "NodePort"` instead. Read [External Services](user-guide/services.md#external-services) for more info. If this is not sufficient for your use case, please file an issue or contact @thockin. - -Some other difference between v1beta3 and v1: - -* The `pod.spec.containers[*].privileged` and `pod.spec.containers[*].capabilities` properties are now nested under the `pod.spec.containers[*].securityContext` property. See [Security Contexts](user-guide/security-context.md). -* The `pod.spec.host` property is renamed to `pod.spec.nodeName`. -* The `endpoints.subsets[*].addresses.IP` property is renamed to `endpoints.subsets[*].addresses.ip`. -* The `pod.status.containerStatuses[*].state.termination` and `pod.status.containerStatuses[*].lastState.termination` properties are renamed to `pod.status.containerStatuses[*].state.terminated` and `pod.status.containerStatuses[*].lastState.terminated` respectively. -* The `pod.status.Condition` property is renamed to `pod.status.conditions`. -* The `status.details.id` property is renamed to `status.details.name`. - -### v1beta3 conversion tips (from v1beta1/2) - -Some important differences between v1beta1/2 and v1beta3: - -* The resource `id` is now called `name`. -* `name`, `labels`, `annotations`, and other metadata are now nested in a map called `metadata` -* `desiredState` is now called `spec`, and `currentState` is now called `status` -* `/nodes` has been moved to `/nodes`, and the resource has kind `Node` -* The namespace is required (for all namespaced resources) and has moved from a URL parameter to the path: `/api/v1beta3/namespaces/{namespace}/{resource_collection}/{resource_name}`. If you were not using a namespace before, use `default` here. -* The names of all resource collections are now lower cased - instead of `replicationControllers`, use `replicationcontrollers`. -* To watch for changes to a resource, open an HTTP or Websocket connection to the collection query and provide the `?watch=true` query parameter along with the desired `resourceVersion` parameter to watch from. -* The `labels` query parameter has been renamed to `labelSelector`. -* The `fields` query parameter has been renamed to `fieldSelector`. -* The container `entrypoint` has been renamed to `command`, and `command` has been renamed to `args`. -* Container, volume, and node resources are expressed as nested maps (e.g., `resources{cpu:1}`) rather than as individual fields, and resource values support [scaling suffixes](user-guide/compute-resources.md#specifying-resource-quantities) rather than fixed scales (e.g., milli-cores). -* Restart policy is represented simply as a string (e.g., `"Always"`) rather than as a nested map (`always{}`). -* Pull policies changed from `PullAlways`, `PullNever`, and `PullIfNotPresent` to `Always`, `Never`, and `IfNotPresent`. -* The volume `source` is inlined into `volume` rather than nested. -* Host volumes have been changed from `hostDir` to `hostPath` to better reflect that they can be files or directories. - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/api.md?pixel)]() - diff --git a/docs/design/clustering/.gitignore b/docs/design/clustering/.gitignore deleted file mode 100644 index 67bcd6cb58a..00000000000 --- a/docs/design/clustering/.gitignore +++ /dev/null @@ -1 +0,0 @@ -DroidSansMono.ttf diff --git a/docs/devel/git_workflow.png b/docs/devel/git_workflow.png deleted file mode 100644 index 80a66248fb8..00000000000 Binary files a/docs/devel/git_workflow.png and /dev/null differ diff --git a/docs/devel/gubernator-images/filterpage.png b/docs/devel/gubernator-images/filterpage.png deleted file mode 100644 index 2d08bd8e1b6..00000000000 Binary files a/docs/devel/gubernator-images/filterpage.png and /dev/null differ diff --git a/docs/devel/gubernator-images/filterpage1.png b/docs/devel/gubernator-images/filterpage1.png deleted file mode 100644 index 838cb0fa707..00000000000 Binary files a/docs/devel/gubernator-images/filterpage1.png and /dev/null differ diff --git a/docs/devel/gubernator-images/filterpage2.png b/docs/devel/gubernator-images/filterpage2.png deleted file mode 100644 index 63da782e1c0..00000000000 Binary files a/docs/devel/gubernator-images/filterpage2.png and /dev/null differ diff --git a/docs/devel/gubernator-images/filterpage3.png b/docs/devel/gubernator-images/filterpage3.png deleted file mode 100644 index 33066d78662..00000000000 Binary files a/docs/devel/gubernator-images/filterpage3.png and /dev/null differ diff --git a/docs/devel/gubernator-images/skipping1.png b/docs/devel/gubernator-images/skipping1.png deleted file mode 100644 index a5dea440e63..00000000000 Binary files a/docs/devel/gubernator-images/skipping1.png and /dev/null differ diff --git a/docs/devel/gubernator-images/skipping2.png b/docs/devel/gubernator-images/skipping2.png deleted file mode 100644 index b133347e422..00000000000 Binary files a/docs/devel/gubernator-images/skipping2.png and /dev/null differ diff --git a/docs/devel/gubernator-images/testfailures.png b/docs/devel/gubernator-images/testfailures.png deleted file mode 100644 index 1b331248b82..00000000000 Binary files a/docs/devel/gubernator-images/testfailures.png and /dev/null differ diff --git a/docs/devel/local-cluster/k8s-singlenode-docker.png b/docs/devel/local-cluster/k8s-singlenode-docker.png deleted file mode 100644 index 5ebf812682d..00000000000 Binary files a/docs/devel/local-cluster/k8s-singlenode-docker.png and /dev/null differ diff --git a/docs/devel/pr_workflow.dia b/docs/devel/pr_workflow.dia deleted file mode 100644 index 753a284b4a4..00000000000 Binary files a/docs/devel/pr_workflow.dia and /dev/null differ diff --git a/docs/devel/pr_workflow.png b/docs/devel/pr_workflow.png deleted file mode 100644 index 0e2bd5d6eda..00000000000 Binary files a/docs/devel/pr_workflow.png and /dev/null differ diff --git a/docs/getting-started-guides/README.md b/docs/getting-started-guides/README.md deleted file mode 100644 index b192f28c2d8..00000000000 --- a/docs/getting-started-guides/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/README.md?pixel)]() - diff --git a/docs/getting-started-guides/aws.md b/docs/getting-started-guides/aws.md deleted file mode 100644 index ccbc8afd338..00000000000 --- a/docs/getting-started-guides/aws.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/aws/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/aws.md?pixel)]() - diff --git a/docs/getting-started-guides/azure.md b/docs/getting-started-guides/azure.md deleted file mode 100644 index 2ead376b94f..00000000000 --- a/docs/getting-started-guides/azure.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/azure/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/azure.md?pixel)]() - diff --git a/docs/getting-started-guides/binary_release.md b/docs/getting-started-guides/binary_release.md deleted file mode 100644 index ab7af5f01dd..00000000000 --- a/docs/getting-started-guides/binary_release.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/binary_release/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/binary_release.md?pixel)]() - diff --git a/docs/getting-started-guides/centos/centos_manual_config.md b/docs/getting-started-guides/centos/centos_manual_config.md deleted file mode 100644 index 1b545a5114b..00000000000 --- a/docs/getting-started-guides/centos/centos_manual_config.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/centos/centos_manual_config/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/centos/centos_manual_config.md?pixel)]() - diff --git a/docs/getting-started-guides/cloudstack.md b/docs/getting-started-guides/cloudstack.md deleted file mode 100644 index 1bc6d942504..00000000000 --- a/docs/getting-started-guides/cloudstack.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/cloudstack/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/cloudstack.md?pixel)]() - diff --git a/docs/getting-started-guides/coreos.md b/docs/getting-started-guides/coreos.md deleted file mode 100644 index 66c41760c43..00000000000 --- a/docs/getting-started-guides/coreos.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/coreos/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/coreos.md?pixel)]() - diff --git a/docs/getting-started-guides/coreos/azure/README.md b/docs/getting-started-guides/coreos/azure/README.md deleted file mode 100644 index 839c8991bfd..00000000000 --- a/docs/getting-started-guides/coreos/azure/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/coreos/azure/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/coreos/azure/README.md?pixel)]() - diff --git a/docs/getting-started-guides/coreos/bare_metal_calico.md b/docs/getting-started-guides/coreos/bare_metal_calico.md deleted file mode 100644 index 25c4042eeb8..00000000000 --- a/docs/getting-started-guides/coreos/bare_metal_calico.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/coreos/bare_metal_calico/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/coreos/bare_metal_calico.md?pixel)]() - diff --git a/docs/getting-started-guides/coreos/bare_metal_offline.md b/docs/getting-started-guides/coreos/bare_metal_offline.md deleted file mode 100644 index d34dbc57d52..00000000000 --- a/docs/getting-started-guides/coreos/bare_metal_offline.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/coreos/bare_metal_offline/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/coreos/bare_metal_offline.md?pixel)]() - diff --git a/docs/getting-started-guides/coreos/coreos_multinode_cluster.md b/docs/getting-started-guides/coreos/coreos_multinode_cluster.md deleted file mode 100644 index 598647e1cdb..00000000000 --- a/docs/getting-started-guides/coreos/coreos_multinode_cluster.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/coreos/coreos_multinode_cluster/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/coreos/coreos_multinode_cluster.md?pixel)]() - diff --git a/docs/getting-started-guides/dcos.md b/docs/getting-started-guides/dcos.md deleted file mode 100644 index a77583de6a0..00000000000 --- a/docs/getting-started-guides/dcos.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/dcos/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/dcos.md?pixel)]() - diff --git a/docs/getting-started-guides/docker-multinode.md b/docs/getting-started-guides/docker-multinode.md deleted file mode 100644 index 11695b12311..00000000000 --- a/docs/getting-started-guides/docker-multinode.md +++ /dev/null @@ -1,6 +0,0 @@ -This deployment has moved to: https://github.com/kubernetes/kube-deploy - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/docker-multinode.md?pixel)]() - diff --git a/docs/getting-started-guides/fedora/fedora_ansible_config.md b/docs/getting-started-guides/fedora/fedora_ansible_config.md deleted file mode 100644 index 52e53e92d42..00000000000 --- a/docs/getting-started-guides/fedora/fedora_ansible_config.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/fedora/fedora_ansible_config/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/fedora/fedora_ansible_config.md?pixel)]() - diff --git a/docs/getting-started-guides/fedora/fedora_manual_config.md b/docs/getting-started-guides/fedora/fedora_manual_config.md deleted file mode 100644 index 6502f196f7c..00000000000 --- a/docs/getting-started-guides/fedora/fedora_manual_config.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/fedora/fedora_manual_config/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/fedora/fedora_manual_config.md?pixel)]() - diff --git a/docs/getting-started-guides/fedora/flannel_multi_node_cluster.md b/docs/getting-started-guides/fedora/flannel_multi_node_cluster.md deleted file mode 100644 index 5d93acfcf46..00000000000 --- a/docs/getting-started-guides/fedora/flannel_multi_node_cluster.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/fedora/flannel_multi_node_cluster/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/fedora/flannel_multi_node_cluster.md?pixel)]() - diff --git a/docs/getting-started-guides/gce.md b/docs/getting-started-guides/gce.md deleted file mode 100644 index a7fbbda9448..00000000000 --- a/docs/getting-started-guides/gce.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/gce/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/gce.md?pixel)]() - diff --git a/docs/getting-started-guides/juju.md b/docs/getting-started-guides/juju.md deleted file mode 100644 index 64bc6901692..00000000000 --- a/docs/getting-started-guides/juju.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/juju/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/juju.md?pixel)]() - diff --git a/docs/getting-started-guides/libvirt-coreos.md b/docs/getting-started-guides/libvirt-coreos.md deleted file mode 100644 index 22497ef9bb4..00000000000 --- a/docs/getting-started-guides/libvirt-coreos.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/libvirt-coreos/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/libvirt-coreos.md?pixel)]() - diff --git a/docs/getting-started-guides/logging-elasticsearch.md b/docs/getting-started-guides/logging-elasticsearch.md deleted file mode 100644 index 702fbcb0a18..00000000000 --- a/docs/getting-started-guides/logging-elasticsearch.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/logging-elasticsearch/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/logging-elasticsearch.md?pixel)]() - diff --git a/docs/getting-started-guides/logging.md b/docs/getting-started-guides/logging.md deleted file mode 100644 index fe231be821d..00000000000 --- a/docs/getting-started-guides/logging.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: https://kubernetes.io/docs/user-guide/logging/overview/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/logging.md?pixel)]() - diff --git a/docs/getting-started-guides/mesos-docker.md b/docs/getting-started-guides/mesos-docker.md deleted file mode 100644 index 5734173163b..00000000000 --- a/docs/getting-started-guides/mesos-docker.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/mesos-docker/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/mesos-docker.md?pixel)]() - diff --git a/docs/getting-started-guides/mesos.md b/docs/getting-started-guides/mesos.md deleted file mode 100644 index f3a4fec7d4d..00000000000 --- a/docs/getting-started-guides/mesos.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/mesos/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/mesos.md?pixel)]() - diff --git a/docs/getting-started-guides/ovirt.md b/docs/getting-started-guides/ovirt.md deleted file mode 100644 index 2224e1843fc..00000000000 --- a/docs/getting-started-guides/ovirt.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/ovirt/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/ovirt.md?pixel)]() - diff --git a/docs/getting-started-guides/rackspace.md b/docs/getting-started-guides/rackspace.md deleted file mode 100644 index 82dce4161a8..00000000000 --- a/docs/getting-started-guides/rackspace.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/rackspace/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/rackspace.md?pixel)]() - diff --git a/docs/getting-started-guides/rkt/README.md b/docs/getting-started-guides/rkt/README.md deleted file mode 100644 index 83da39525c2..00000000000 --- a/docs/getting-started-guides/rkt/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/rkt/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/rkt/README.md?pixel)]() - diff --git a/docs/getting-started-guides/rkt/notes.md b/docs/getting-started-guides/rkt/notes.md deleted file mode 100644 index 1b3ec165f70..00000000000 --- a/docs/getting-started-guides/rkt/notes.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/rkt/notes/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/rkt/notes.md?pixel)]() - diff --git a/docs/getting-started-guides/scratch.md b/docs/getting-started-guides/scratch.md deleted file mode 100644 index 262c3b4dba5..00000000000 --- a/docs/getting-started-guides/scratch.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/scratch/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/scratch.md?pixel)]() - diff --git a/docs/getting-started-guides/ubuntu-calico.md b/docs/getting-started-guides/ubuntu-calico.md deleted file mode 100644 index 90954af9d64..00000000000 --- a/docs/getting-started-guides/ubuntu-calico.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/ubuntu-calico/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/ubuntu-calico.md?pixel)]() - diff --git a/docs/getting-started-guides/ubuntu.md b/docs/getting-started-guides/ubuntu.md deleted file mode 100644 index d3751a83b55..00000000000 --- a/docs/getting-started-guides/ubuntu.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/ubuntu/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/ubuntu.md?pixel)]() - diff --git a/docs/getting-started-guides/vsphere.md b/docs/getting-started-guides/vsphere.md deleted file mode 100644 index e7057ad3e81..00000000000 --- a/docs/getting-started-guides/vsphere.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/getting-started-guides/vsphere/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/getting-started-guides/vsphere.md?pixel)]() - diff --git a/docs/images/newgui.png b/docs/images/newgui.png deleted file mode 100644 index 383ee1ed2d0..00000000000 Binary files a/docs/images/newgui.png and /dev/null differ diff --git a/docs/man/man1/.files_generated b/docs/man/man1/.files_generated deleted file mode 100644 index 89e38e687c4..00000000000 --- a/docs/man/man1/.files_generated +++ /dev/null @@ -1,36 +0,0 @@ -kubectl-apply.1 -kubectl-annotate.1 -kubectl-api-versions.1 -kubectl-attach.1 -kubectl-cluster-info.1 -kubectl-config-set-cluster.1 -kubectl-config-set-context.1 -kubectl-config-set-credentials.1 -kubectl-config-set.1 -kubectl-config-unset.1 -kubectl-config-use-context.1 -kubectl-config-view.1 -kubectl-config.1 -kubectl-convert.1 -kubectl-create.1 -kubectl-delete.1 -kubectl-describe.1 -kubectl-edit.1 -kubectl-exec.1 -kubectl-explain.1 -kubectl-expose.1 -kubectl-get.1 -kubectl-label.1 -kubectl-logs.1 -kubectl-namespace.1 -kubectl-patch.1 -kubectl-port-forward.1 -kubectl-proxy.1 -kubectl-replace.1 -kubectl-rolling-update.1 -kubectl-run.1 -kubectl-scale.1 -kubectl-stop.1 -kubectl-top.1 -kubectl-version.1 -kubectl.1 diff --git a/docs/proposals/Kubemark_architecture.png b/docs/proposals/Kubemark_architecture.png deleted file mode 100644 index 479ad8b11f4..00000000000 Binary files a/docs/proposals/Kubemark_architecture.png and /dev/null differ diff --git a/docs/proposals/federation-high-level-arch.png b/docs/proposals/federation-high-level-arch.png deleted file mode 100644 index 8a416cc1e68..00000000000 Binary files a/docs/proposals/federation-high-level-arch.png and /dev/null differ diff --git a/docs/proposals/images/.gitignore b/docs/proposals/images/.gitignore deleted file mode 100644 index e69de29bb2d..00000000000 diff --git a/docs/proposals/node-allocatable.png b/docs/proposals/node-allocatable.png deleted file mode 100644 index d6f5383e7ad..00000000000 Binary files a/docs/proposals/node-allocatable.png and /dev/null differ diff --git a/docs/proposals/pleg.png b/docs/proposals/pleg.png deleted file mode 100644 index f15c5d83dad..00000000000 Binary files a/docs/proposals/pleg.png and /dev/null differ diff --git a/docs/proposals/pod-cache.png b/docs/proposals/pod-cache.png deleted file mode 100644 index dee86c40cb0..00000000000 Binary files a/docs/proposals/pod-cache.png and /dev/null differ diff --git a/docs/reporting-security-issues.md b/docs/reporting-security-issues.md deleted file mode 100755 index f8618f6557a..00000000000 --- a/docs/reporting-security-issues.md +++ /dev/null @@ -1 +0,0 @@ -This document has moved to https://kubernetes.io/security/ diff --git a/docs/user-guide/README.md b/docs/user-guide/README.md deleted file mode 100644 index ff0340855d6..00000000000 --- a/docs/user-guide/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/README.md?pixel)]() - diff --git a/docs/user-guide/accessing-the-cluster.md b/docs/user-guide/accessing-the-cluster.md deleted file mode 100644 index 7ab06336f7a..00000000000 --- a/docs/user-guide/accessing-the-cluster.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/accessing-the-cluster/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/accessing-the-cluster.md?pixel)]() - diff --git a/docs/user-guide/annotations.md b/docs/user-guide/annotations.md deleted file mode 100644 index 5ba16a232c1..00000000000 --- a/docs/user-guide/annotations.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/annotations/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/annotations.md?pixel)]() - diff --git a/docs/user-guide/application-troubleshooting.md b/docs/user-guide/application-troubleshooting.md deleted file mode 100644 index d650f35c2a5..00000000000 --- a/docs/user-guide/application-troubleshooting.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/application-troubleshooting/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/application-troubleshooting.md?pixel)]() - diff --git a/docs/user-guide/compute-resources.md b/docs/user-guide/compute-resources.md deleted file mode 100644 index d26dbeee909..00000000000 --- a/docs/user-guide/compute-resources.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/compute-resources/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/compute-resources.md?pixel)]() - diff --git a/docs/user-guide/config-best-practices.md b/docs/user-guide/config-best-practices.md deleted file mode 100644 index c7238477c37..00000000000 --- a/docs/user-guide/config-best-practices.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/config-best-practices/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/config-best-practices.md?pixel)]() - diff --git a/docs/user-guide/configmap.md b/docs/user-guide/configmap.md deleted file mode 100644 index 3453ce927c7..00000000000 --- a/docs/user-guide/configmap.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/configmap/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/configmap.md?pixel)]() - diff --git a/docs/user-guide/configmap/README.md b/docs/user-guide/configmap/README.md deleted file mode 100644 index 974ccc2d822..00000000000 --- a/docs/user-guide/configmap/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/configmap/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/configmap/README.md?pixel)]() - diff --git a/docs/user-guide/configuring-containers.md b/docs/user-guide/configuring-containers.md deleted file mode 100644 index c11f87ba06c..00000000000 --- a/docs/user-guide/configuring-containers.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/configuring-containers/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/configuring-containers.md?pixel)]() - diff --git a/docs/user-guide/connecting-applications.md b/docs/user-guide/connecting-applications.md deleted file mode 100644 index 9857bfbdaf1..00000000000 --- a/docs/user-guide/connecting-applications.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/connecting-applications/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/connecting-applications.md?pixel)]() - diff --git a/docs/user-guide/connecting-to-applications-port-forward.md b/docs/user-guide/connecting-to-applications-port-forward.md deleted file mode 100644 index f58babf156b..00000000000 --- a/docs/user-guide/connecting-to-applications-port-forward.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/connecting-to-applications-port-forward/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/connecting-to-applications-port-forward.md?pixel)]() - diff --git a/docs/user-guide/connecting-to-applications-proxy.md b/docs/user-guide/connecting-to-applications-proxy.md deleted file mode 100644 index 9ce21613d4f..00000000000 --- a/docs/user-guide/connecting-to-applications-proxy.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/connecting-to-applications-proxy/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/connecting-to-applications-proxy.md?pixel)]() - diff --git a/docs/user-guide/container-environment.md b/docs/user-guide/container-environment.md deleted file mode 100644 index 4f64f92194a..00000000000 --- a/docs/user-guide/container-environment.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/container-environment/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/container-environment.md?pixel)]() - diff --git a/docs/user-guide/containers.md b/docs/user-guide/containers.md deleted file mode 100644 index f7a9fcdcb48..00000000000 --- a/docs/user-guide/containers.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/containers/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/containers.md?pixel)]() - diff --git a/docs/user-guide/debugging-services.md b/docs/user-guide/debugging-services.md deleted file mode 100644 index 48012ea8cff..00000000000 --- a/docs/user-guide/debugging-services.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/debugging-services/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/debugging-services.md?pixel)]() - diff --git a/docs/user-guide/deploying-applications.md b/docs/user-guide/deploying-applications.md deleted file mode 100644 index ed181cc4c5a..00000000000 --- a/docs/user-guide/deploying-applications.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/deploying-applications/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/deploying-applications.md?pixel)]() - diff --git a/docs/user-guide/deployments.md b/docs/user-guide/deployments.md deleted file mode 100644 index e8b13c97a89..00000000000 --- a/docs/user-guide/deployments.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/deployments/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/deployments.md?pixel)]() - diff --git a/docs/user-guide/docker-cli-to-kubectl.md b/docs/user-guide/docker-cli-to-kubectl.md deleted file mode 100644 index 9903d642c94..00000000000 --- a/docs/user-guide/docker-cli-to-kubectl.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/docker-cli-to-kubectl/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/docker-cli-to-kubectl.md?pixel)]() - diff --git a/docs/user-guide/downward-api.md b/docs/user-guide/downward-api.md deleted file mode 100644 index fae4077cdf7..00000000000 --- a/docs/user-guide/downward-api.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/downward-api/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/downward-api.md?pixel)]() - diff --git a/docs/user-guide/downward-api/README.md b/docs/user-guide/downward-api/README.md deleted file mode 100644 index c195760706f..00000000000 --- a/docs/user-guide/downward-api/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/downward-api/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/downward-api/README.md?pixel)]() - diff --git a/docs/user-guide/downward-api/volume/README.md b/docs/user-guide/downward-api/volume/README.md deleted file mode 100644 index dbca9b0c727..00000000000 --- a/docs/user-guide/downward-api/volume/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/downward-api/volume/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/downward-api/volume/README.md?pixel)]() - diff --git a/docs/user-guide/environment-guide/README.md b/docs/user-guide/environment-guide/README.md deleted file mode 100644 index 705b0d099c6..00000000000 --- a/docs/user-guide/environment-guide/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/environment-guide/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/environment-guide/README.md?pixel)]() - diff --git a/docs/user-guide/environment-guide/containers/README.md b/docs/user-guide/environment-guide/containers/README.md deleted file mode 100644 index bb759f7df49..00000000000 --- a/docs/user-guide/environment-guide/containers/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/environment-guide/containers/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/environment-guide/containers/README.md?pixel)]() - diff --git a/docs/user-guide/getting-into-containers.md b/docs/user-guide/getting-into-containers.md deleted file mode 100644 index 35edfea2679..00000000000 --- a/docs/user-guide/getting-into-containers.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/getting-into-containers/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/getting-into-containers.md?pixel)]() - diff --git a/docs/user-guide/horizontal-pod-autoscaler.md b/docs/user-guide/horizontal-pod-autoscaler.md deleted file mode 100644 index 048ad917c2b..00000000000 --- a/docs/user-guide/horizontal-pod-autoscaler.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/horizontal-pod-autoscaler/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/horizontal-pod-autoscaler.md?pixel)]() - diff --git a/docs/user-guide/horizontal-pod-autoscaling/README.md b/docs/user-guide/horizontal-pod-autoscaling/README.md deleted file mode 100644 index 4372bb60109..00000000000 --- a/docs/user-guide/horizontal-pod-autoscaling/README.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/horizontal-pod-autoscaling/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/horizontal-pod-autoscaling/README.md?pixel)]() - diff --git a/docs/user-guide/identifiers.md b/docs/user-guide/identifiers.md deleted file mode 100644 index 17add553b57..00000000000 --- a/docs/user-guide/identifiers.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/identifiers/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/identifiers.md?pixel)]() - diff --git a/docs/user-guide/images.md b/docs/user-guide/images.md deleted file mode 100644 index fe55323900b..00000000000 --- a/docs/user-guide/images.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/images/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/images.md?pixel)]() - diff --git a/docs/user-guide/ingress.md b/docs/user-guide/ingress.md deleted file mode 100644 index c1dcb7d9dc6..00000000000 --- a/docs/user-guide/ingress.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/ingress/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/ingress.md?pixel)]() - diff --git a/docs/user-guide/introspection-and-debugging.md b/docs/user-guide/introspection-and-debugging.md deleted file mode 100644 index 48a1d58026d..00000000000 --- a/docs/user-guide/introspection-and-debugging.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/introspection-and-debugging/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/introspection-and-debugging.md?pixel)]() - diff --git a/docs/user-guide/jobs.md b/docs/user-guide/jobs.md deleted file mode 100644 index 9abf249e7da..00000000000 --- a/docs/user-guide/jobs.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/jobs/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/jobs.md?pixel)]() - diff --git a/docs/user-guide/jsonpath.md b/docs/user-guide/jsonpath.md deleted file mode 100644 index da9593f603d..00000000000 --- a/docs/user-guide/jsonpath.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/jsonpath/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/jsonpath.md?pixel)]() - diff --git a/docs/user-guide/known-issues.md b/docs/user-guide/known-issues.md deleted file mode 100644 index 1e893e8d6b8..00000000000 --- a/docs/user-guide/known-issues.md +++ /dev/null @@ -1,5 +0,0 @@ -This file has moved to: https://github.com/kubernetes/kubernetes/blob/master/CHANGELOG.md - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/known-issues.md?pixel)]() - diff --git a/docs/user-guide/kubeconfig-file.md b/docs/user-guide/kubeconfig-file.md deleted file mode 100644 index 9b9fbcc7e22..00000000000 --- a/docs/user-guide/kubeconfig-file.md +++ /dev/null @@ -1,6 +0,0 @@ -This file has moved to: http://kubernetes.github.io/docs/user-guide/kubeconfig-file/ - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubeconfig-file.md?pixel)]() - diff --git a/docs/user-guide/kubectl-cheatsheet.md b/docs/user-guide/kubectl-cheatsheet.md deleted file mode 100644 index e5f4cc57f65..00000000000 --- a/docs/user-guide/kubectl-cheatsheet.md +++ /dev/null @@ -1,126 +0,0 @@ - -An assortment of compact kubectl examples - -See also: [Kubectl overview](kubectl-overview.md) and [JsonPath guide](jsonpath.md). - -## Creating Objects - -```console -$ kubectl create -f ./file.yml # create resource(s) in a json or yaml file - -$ kubectl create -f ./file1.yml -f ./file2.yaml # create resource(s) in a json or yaml file - -$ kubectl create -f ./dir # create resources in all .json, .yml, and .yaml files in dir - -# Create from a URL -$ kubectl create -f http://www.fpaste.org/279276/48569091/raw/ - -# Create multiple YAML objects from stdin -$ cat < # List a particular replication controller -$ kubectl get replicationcontroller # List a particular RC - -# Verbose output -$ kubectl describe nodes -$ kubectl describe pods -$ kubectl describe pods/ # Equivalent to previous -$ kubectl describe pods # Lists pods created by using common prefix - -# List Services Sorted by Name -$ kubectl get services --sort-by=.metadata.name - -# List pods Sorted by Restart Count -$ kubectl get pods --sort-by=.status.containerStatuses[0].restartCount - -# Get the version label of all pods with label app=cassandra -$ kubectl get pods --selector=app=cassandra rc -o 'jsonpath={.items[*].metadata.labels.version}' - -# Get ExternalIPs of all nodes -$ kubectl get nodes -o jsonpath='{.items[*].status.addresses[?(@.type=ExternalIP)].address}' - -# List Names of Pods that belong to Particular RC -# "jq" command useful for transformations that are too complex for jsonpath -$ sel=$(./kubectl get rc --output=json | jq -j '.spec.selector | to_entries | .[] | "\(.key)=\(.value),"') -$ sel=${sel%?} # Remove trailing comma -$ pods=$(kubectl get pods --selector=$sel --output=jsonpath={.items..metadata.name})` - -# Check which nodes are ready -$ kubectl get nodes -o jsonpath='{range .items[*]}{@.metadata.name}:{range @.status.conditions[*]}{@.type}={@.status};{end}{end}'| tr ';' "\n" | grep "Ready=True" -``` - -## Modifying and Deleting Resources - -```console -$ kubectl label pods new-label=awesome # Add a Label -$ kubectl annotate pods icon-url=http://goo.gl/XXBTWq # Add an annotation - -# TODO: examples of kubectl edit, patch, delete, replace, scale, and rolling-update commands. -``` - -## Interacting with running Pods - -```console -$ kubectl logs # dump pod logs (stdout) -$ kubectl logs -f # stream pod logs (stdout) until canceled (ctrl-c) or timeout - -$ kubectl run -i --tty busybox --image=busybox -- sh # Run pod as interactive shell -$ kubectl attach -i # Attach to Running Container -$ kubectl port-forward # Forward port of Pod to your local machine -$ kubectl port-forward # Forward port to service -$ kubectl exec -- ls / # Run command in existing pod (1 container case) -$ kubectl exec -c -- ls / # Run command in existing pod (multi-container case) -``` - - - - -[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl-cheatsheet.md?pixel)]() - diff --git a/docs/user-guide/kubectl-overview.md b/docs/user-guide/kubectl-overview.md deleted file mode 100644 index 5b020972a75..00000000000 --- a/docs/user-guide/kubectl-overview.md +++ /dev/null @@ -1,285 +0,0 @@ -# kubectl overview - -Use this overview of the `kubectl` command line interface to help you start running commands against Kubernetes clusters. This overview quickly covers `kubectl` syntax, describes the command operations, and provides common examples. For details about each command, including all the supported flags and subcommands, see the [kubectl](kubectl/kubectl.md) reference documentation. - -**Table of contents:** - - -- [kubectl overview](#kubectl-overview) - - [Syntax](#syntax) - - [Operations](#operations) - - [Resource types](#resource-types) - - [Output options](#output-options) - - [Formatting output](#formatting-output) - - [Syntax](#syntax-1) - - [Example](#example) - - [Custom columns](#custom-columns) - - [Examples](#examples) - - [Sorting list objects](#sorting-list-objects) - - [Syntax](#syntax-2) - - [Example](#example-1) - - [Examples: Common operations](#examples-common-operations) - - [Next steps](#next-steps) - - - -TODO: Auto-generate this file to ensure it's always in sync with any `kubectl` changes, see [#14177](http://pr.k8s.io/14177). - -## Syntax - -Use the following syntax to run `kubectl` commands from your terminal window: - -``` -kubectl [command] [TYPE] [NAME] [flags] -``` - -where `command`, `TYPE`, `NAME`, and `flags` are: - -* `command`: Specifies the operation that you want to perform on one or more resources, for example `create`, `get`, `describe`, `delete`. -* `TYPE`: Specifies the [resource type](#resource-types). Resource types are case-sensitive and you can specify the singular, plural, or abbreviated forms. For example, the following commands produce the same output: - - ``` - $ kubectl get pod pod1 - $ kubectl get pods pod1 - $ kubectl get po pod1 - ``` - -* `NAME`: Specifies the name of the resource. Names are case-sensitive. If the name is omitted, details for all resources are displayed, for example `$ kubectl get pods`. - - When performing an operation on multiple resources, you can specify each resource by type and name or specify one or more files: - * To specify resources by type and name: - * To group resources if they are all the same type: `TYPE1 name1 name2 name<#>`
- Example: `$ kubectl get pod example-pod1 example-pod2` - * To specify multiple resource types individually: `TYPE1/name1 TYPE1/name2 TYPE2/name3 TYPE<#>/name<#>`
- Example: `$ kubectl get pod/example-pod1 replicationcontroller/example-rc1` - * To specify resources with one or more files: `-f file1 -f file2 -f file<#>` - [Use YAML rather than JSON](config-best-practices.md#general-config-tips) since YAML tends to be more user-friendly, especially for configuration files.
- Example: `$ kubectl get pod -f ./pod.yaml` -* `flags`: Specifies optional flags. For example, you can use the `-s` or `--server` flags to specify the address and port of the Kubernetes API server.
-**Important**: Flags that you specify from the command line override default values and any corresponding environment variables. - -If you need help, just run `kubectl help` from the terminal window. - -## Operations - -The following table includes short descriptions and the general syntax for all of the `kubectl` operations: - -Operation | Syntax | Description --------------------- | -------------------- | -------------------- -`annotate` | `kubectl annotate (-f FILENAME | TYPE NAME | TYPE/NAME) KEY_1=VAL_1 ... KEY_N=VAL_N [--overwrite] [--all] [--resource-version=version] [flags]` | Add or update the annotations of one or more resources. -`api-versions` | `kubectl api-versions [flags]` | List the API versions that are available. -`apply` | `kubectl apply -f FILENAME [flags]`| Apply a configuration change to a resource from a file or stdin. -`attach` | `kubectl attach POD -c CONTAINER [-i] [-t] [flags]` | Attach to a running container either to view the output stream or interact with the container (stdin). -`autoscale` | `autoscale (-f FILENAME | TYPE NAME | TYPE/NAME) [--min=MINPODS] --max=MAXPODS [--cpu-percent=CPU] [flags]` | Automatically scale the set of pods that are managed by a replication controller. -`cluster-info` | `kubectl cluster-info [flags]` | Display endpoint information about the master and services in the cluster. -`config` | `kubectl config SUBCOMMAND [flags]` | Modifies kubeconfig files. See the individual subcommands for details. -`create` | `kubectl create -f FILENAME [flags]` | Create one or more resources from a file or stdin. -`delete` | `kubectl delete (-f FILENAME | TYPE [NAME | /NAME | -l label | --all]) [flags]` | Delete resources either from a file, stdin, or specifying label selectors, names, resource selectors, or resources. -`describe` | `kubectl describe (-f FILENAME | TYPE [NAME_PREFIX | /NAME | -l label]) [flags]` | Display the detailed state of one or more resources. -`edit` | `kubectl edit (-f FILENAME | TYPE NAME | TYPE/NAME) [flags]` | Edit and update the definition of one or more resources on the server by using the default editor. -`exec` | `kubectl exec POD [-c CONTAINER] [-i] [-t] [flags] [-- COMMAND [args...]]` | Execute a command against a container in a pod. -`expose` | `kubectl expose (-f FILENAME | TYPE NAME | TYPE/NAME) [--port=port] [--protocol=TCP|UDP] [--target-port=number-or-name] [--name=name] [----external-ip=external-ip-of-service] [--type=type] [flags]` | Expose a replication controller, service, deployment or pod as a new Kubernetes service. -`get` | `kubectl get (-f FILENAME | TYPE [NAME | /NAME | -l label]) [--watch] [--sort-by=FIELD] [[-o | --output]=OUTPUT_FORMAT] [flags]` | List one or more resources. -`label` | `kubectl label (-f FILENAME | TYPE NAME | TYPE/NAME) KEY_1=VAL_1 ... KEY_N=VAL_N [--overwrite] [--all] [--resource-version=version] [flags]` | Add or update the labels of one or more resources. -`logs` | `kubectl logs POD [-c CONTAINER] [--follow] [flags]` | Print the logs for a container in a pod. -`patch` | `kubectl patch (-f FILENAME | TYPE NAME | TYPE/NAME) --patch PATCH [flags]` | Update one or more fields of a resource by using the strategic merge patch process. -`port-forward` | `kubectl port-forward POD [LOCAL_PORT:]REMOTE_PORT [...[LOCAL_PORT_N:]REMOTE_PORT_N] [flags]` | Forward one or more local ports to a pod. -`proxy` | `kubectl proxy [--port=PORT] [--www=static-dir] [--www-prefix=prefix] [--api-prefix=prefix] [flags]` | Run a proxy to the Kubernetes API server. -`replace` | `kubectl replace -f FILENAME` | Replace a resource from a file or stdin. -`rolling-update` | `kubectl rolling-update OLD_CONTROLLER_NAME ([NEW_CONTROLLER_NAME] --image=NEW_CONTAINER_IMAGE | -f NEW_CONTROLLER_SPEC) [flags]` | Perform a rolling update by gradually replacing the specified replication controller and its pods. -`run` | `kubectl run NAME --image=image [--env="key=value"] [--port=port] [--replicas=replicas] [--dry-run=bool] [--overrides=inline-json] [flags]` | Run a specified image on the cluster. -`scale` | `kubectl scale (-f FILENAME | TYPE NAME | TYPE/NAME) --replicas=COUNT [--resource-version=version] [--current-replicas=count] [flags]` | Update the size of the specified replication controller. -`stop` | `kubectl stop` | Deprecated: Instead, see `kubectl delete`. -`version` | `kubectl version [--client] [flags]` | Display the Kubernetes version running on the client and server. - -Remember: For more about command operations, see the [kubectl](kubectl/kubectl.md) reference documentation. - -## Resource types - -The following table includes a list of all the supported resource types and their abbreviated aliases: - -Resource type | Abbreviated alias --------------------- | -------------------- -`componentstatuses` | `cs` -`daemonsets` | `ds` -`deployments` | -`events` | `ev` -`endpoints` | `ep` -`horizontalpodautoscalers` | `hpa` -`ingresses` | `ing` -`jobs` | -`limitranges` | `limits` -`nodes` | `no` -`namespaces` | `ns` -`pods` | `po` -`persistentvolumes` | `pv` -`persistentvolumeclaims` | `pvc` -`resourcequotas` | `quota` -`replicationcontrollers` | `rc` -`secrets` | -`serviceaccounts` | -`services` | `svc` - -## Output options - -Use the following sections for information about how you can format or sort the output of certain commands. For details about which commands support the various output options, see the [kubectl](kubectl/kubectl.md) reference documentation. - -### Formatting output - -The default output format for all `kubectl` commands is the human readable plain-text format. To output details to your terminal window in a specific format, you can add either the `-o` or `-output` flags to a supported `kubectl` command. - -#### Syntax - -``` -kubectl [command] [TYPE] [NAME] -o= -``` - -Depending on the `kubectl` operation, the following output formats are supported: - -Output format | Description ---------------| ----------- -`-o=custom-columns=` | Print a table using a comma separated list of [custom columns](#custom-columns). -`-o=custom-columns-file=` | Print a table using the [custom columns](#custom-columns) template in the `` file. -`-o=json` | Output a JSON formatted API object. -`-o=jsonpath=