Skip to content

Commit 3eff8fc

Browse files
committed
automated link fixes
1 parent 14c3fc5 commit 3eff8fc

File tree

96 files changed

+287
-287
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

96 files changed

+287
-287
lines changed

docs/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ certainly want the docs that go with that version.</h1>
1414
<!-- END MUNGE: UNVERSIONED_WARNING -->
1515
# Kubernetes Documentation: releases.k8s.io/HEAD
1616

17-
* The [User's guide](user-guide.md) is for anyone who wants to run programs and
17+
* The [User's guide](user-guide/user-guide.md) is for anyone who wants to run programs and
1818
services on an existing Kubernetes cluster.
1919

2020
* The [Cluster Admin's guide](admin/README.md) is for anyone setting up

docs/admin/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ certainly want the docs that go with that version.</h1>
1515
# Kubernetes Cluster Admin Guide
1616

1717
The cluster admin guide is for anyone creating or administering a Kubernetes cluster.
18-
It assumes some familiarity with concepts in the [User Guide](../user-guide.md).
18+
It assumes some familiarity with concepts in the [User Guide](../user-guide/user-guide.md).
1919

2020
## Planning a cluster
2121

@@ -63,7 +63,7 @@ project.](salt.md).
6363
* **DNS Integration with SkyDNS** ([dns.md](dns.md)):
6464
Resolving a DNS name directly to a Kubernetes service.
6565

66-
* **Logging** with [Kibana](../logging.md)
66+
* **Logging** with [Kibana](../user-guide/logging.md)
6767

6868
## Multi-tenant support
6969

@@ -74,7 +74,7 @@ project.](salt.md).
7474

7575
## Security
7676

77-
* **Kubernetes Container Environment** ([docs/container-environment.md](../container-environment.md)):
77+
* **Kubernetes Container Environment** ([docs/user-guide/container-environment.md](../user-guide/container-environment.md)):
7878
Describes the environment for Kubelet managed containers on a Kubernetes
7979
node.
8080

docs/admin/accessing-the-api.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ cluster administrators who want to customize their cluster
2020
or understand the details.
2121

2222
Most questions about accessing the cluster are covered
23-
in [Accessing the cluster](../accessing-the-cluster.md).
23+
in [Accessing the cluster](../user-guide/accessing-the-cluster.md).
2424

2525

2626
## Ports and IPs Served On

docs/admin/admission-controllers.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ We strongly recommend using this plug-in if you intend to make use of Kubernetes
8686

8787
### SecurityContextDeny
8888

89-
This plug-in will deny any pod with a [SecurityContext](../security-context.md) that defines options that were not available on the ```Container```.
89+
This plug-in will deny any pod with a [SecurityContext](../user-guide/security-context.md) that defines options that were not available on the ```Container```.
9090

9191
### ResourceQuota
9292

docs/admin/namespaces.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ certainly want the docs that go with that version.</h1>
1414
<!-- END MUNGE: UNVERSIONED_WARNING -->
1515
# Namespaces
1616

17-
Namespaces help different projects, teams, or customers to share a kubernetes cluster. First, they provide a scope for [Names](../identifiers.md). Second, as our access control code develops, it is expected that it will be convenient to attach authorization and other policy to namespaces.
17+
Namespaces help different projects, teams, or customers to share a kubernetes cluster. First, they provide a scope for [Names](../user-guide/identifiers.md). Second, as our access control code develops, it is expected that it will be convenient to attach authorization and other policy to namespaces.
1818

1919
Use of multiple namespaces is optional. For small teams, they may not be needed.
2020

@@ -23,7 +23,7 @@ This is a placeholder document about namespace administration.
2323
TODO: document namespace creation, ownership assignment, visibility rules,
2424
policy creation, interaction with network.
2525

26-
Namespaces are still under development. For now, the best documentation is the [Namespaces Design Document](../design/namespaces.md). The user documentation can be found at [Namespaces](../../docs/namespaces.md)
26+
Namespaces are still under development. For now, the best documentation is the [Namespaces Design Document](../design/namespaces.md). The user documentation can be found at [Namespaces](../../docs/user-guide/namespaces.md)
2727

2828

2929
<!-- BEGIN MUNGE: GENERATED_ANALYTICS -->

docs/admin/networking.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -34,10 +34,10 @@ certainly want the docs that go with that version.</h1>
3434
Kubernetes approaches networking somewhat differently than Docker does by
3535
default. There are 4 distinct networking problems to solve:
3636
1. Highly-coupled container-to-container communications: this is solved by
37-
[pods](../pods.md) and `localhost` communications.
37+
[pods](../user-guide/pods.md) and `localhost` communications.
3838
2. Pod-to-Pod communications: this is the primary focus of this document.
39-
3. Pod-to-Service communications: this is covered by [services](../services.md).
40-
4. External-to-Service communications: this is covered by [services](../services.md).
39+
3. Pod-to-Service communications: this is covered by [services](../user-guide/services.md).
40+
4. External-to-Service communications: this is covered by [services](../user-guide/services.md).
4141

4242
## Summary
4343

docs/admin/node.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ certainly want the docs that go with that version.</h1>
3636

3737
`Node` is a worker machine in Kubernetes, previously known as `Minion`. Node
3838
may be a VM or physical machine, depending on the cluster. Each node has
39-
the services necessary to run [Pods](../pods.md) and be managed from the master
39+
the services necessary to run [Pods](../user-guide/pods.md) and be managed from the master
4040
systems. The services include docker, kubelet and network proxy. See
4141
[The Kubernetes Node](../design/architecture.md#the-kubernetes-node) section in design
4242
doc for more details.
@@ -101,7 +101,7 @@ The information is gathered by Kubernetes from the node.
101101

102102
## Node Management
103103

104-
Unlike [Pods](../pods.md) and [Services](../services.md), a Node is not inherently
104+
Unlike [Pods](../user-guide/pods.md) and [Services](../user-guide/services.md), a Node is not inherently
105105
created by Kubernetes: it is either created from cloud providers like Google Compute Engine,
106106
or from your physical or virtual machines. What this means is that when
107107
Kubernetes creates a node, it only creates a representation for the node.

docs/api-conventions.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ Kinds are grouped into three categories:
8787

8888
Most objects defined in the system should have an endpoint that returns the full set of resources, as well as zero or more endpoints that return subsets of the full list. Some objects may be singletons (the current user, the system defaults) and may not have lists.
8989

90-
In addition, all lists that return objects with labels should support label filtering (see [labels.md](labels.md), and most lists should support filtering by fields.
90+
In addition, all lists that return objects with labels should support label filtering (see [user-guide/labels.md](user-guide/labels.md), and most lists should support filtering by fields.
9191

9292
Examples: PodLists, ServiceLists, NodeLists
9393

@@ -120,17 +120,17 @@ These fields are required for proper decoding of the object. They may be populat
120120

121121
Every object kind MUST have the following metadata in a nested object field called "metadata":
122122

123-
* namespace: a namespace is a DNS compatible subdomain that objects are subdivided into. The default namespace is 'default'. See [namespaces.md](namespaces.md) for more.
124-
* name: a string that uniquely identifies this object within the current namespace (see [identifiers.md](identifiers.md)). This value is used in the path when retrieving an individual object.
125-
* uid: a unique in time and space value (typically an RFC 4122 generated identifier, see [identifiers.md](identifiers.md)) used to distinguish between objects with the same name that have been deleted and recreated
123+
* namespace: a namespace is a DNS compatible subdomain that objects are subdivided into. The default namespace is 'default'. See [admin/namespaces.md](admin/namespaces.md) for more.
124+
* name: a string that uniquely identifies this object within the current namespace (see [user-guide/identifiers.md](user-guide/identifiers.md)). This value is used in the path when retrieving an individual object.
125+
* uid: a unique in time and space value (typically an RFC 4122 generated identifier, see [user-guide/identifiers.md](user-guide/identifiers.md)) used to distinguish between objects with the same name that have been deleted and recreated
126126

127127
Every object SHOULD have the following metadata in a nested object field called "metadata":
128128

129129
* resourceVersion: a string that identifies the internal version of this object that can be used by clients to determine when objects have changed. This value MUST be treated as opaque by clients and passed unmodified back to the server. Clients should not assume that the resource version has meaning across namespaces, different kinds of resources, or different servers. (see [concurrency control](#concurrency-control-and-consistency), below, for more details)
130130
* creationTimestamp: a string representing an RFC 3339 date of the date and time an object was created
131131
* deletionTimestamp: a string representing an RFC 3339 date of the date and time after which this resource will be deleted. This field is set by the server when a graceful deletion is requested by the user, and is not directly settable by a client. The resource will be deleted (no longer visible from resource lists, and not reachable by name) after the time in this field. Once set, this value may not be unset or be set further into the future, although it may be shortened or the resource may be deleted prior to this time.
132-
* labels: a map of string keys and values that can be used to organize and categorize objects (see [labels.md](labels.md))
133-
* annotations: a map of string keys and values that can be used by external tooling to store and retrieve arbitrary metadata about this object (see [annotations.md](annotations.md))
132+
* labels: a map of string keys and values that can be used to organize and categorize objects (see [user-guide/labels.md](user-guide/labels.md))
133+
* annotations: a map of string keys and values that can be used by external tooling to store and retrieve arbitrary metadata about this object (see [user-guide/annotations.md](user-guide/annotations.md))
134134

135135
Labels are intended for organizational purposes by end users (select the pods that match this label query). Annotations enable third-party automation and tooling to decorate objects with additional metadata for their own use.
136136

@@ -167,7 +167,7 @@ Status information that may be large (especially unbounded in size, such as list
167167

168168
#### References to related objects
169169

170-
References to loosely coupled sets of objects, such as [pods](pods.md) overseen by a [replication controller](replication-controller.md), are usually best referred to using a [label selector](labels.md). In order to ensure that GETs of individual objects remain bounded in time and space, these sets may be queried via separate API queries, but will not be expanded in the referring object's status.
170+
References to loosely coupled sets of objects, such as [pods](user-guide/pods.md) overseen by a [replication controller](user-guide/replication-controller.md), are usually best referred to using a [label selector](user-guide/labels.md). In order to ensure that GETs of individual objects remain bounded in time and space, these sets may be queried via separate API queries, but will not be expanded in the referring object's status.
171171

172172
References to specific objects, especially specific resource versions and/or specific fields of those objects, are specified using the `ObjectReference` type. Unlike partial URLs, the ObjectReference type facilitates flexible defaulting of fields from the referring object or other contextual information.
173173

@@ -234,7 +234,7 @@ Kubernetes by convention exposes additional verbs as new root endpoints with sin
234234
235235
These are verbs which change the fundamental type of data returned (watch returns a stream of JSON instead of a single JSON object). Support of additional verbs is not required for all object types.
236236
237-
Two additional verbs `redirect` and `proxy` provide access to cluster resources as described in [accessing-the-cluster.md](accessing-the-cluster.md).
237+
Two additional verbs `redirect` and `proxy` provide access to cluster resources as described in [user-guide/accessing-the-cluster.md](user-guide/accessing-the-cluster.md).
238238

239239
When resources wish to expose alternative actions that are closely coupled to a single resource, they should do so using new sub-resources. An example is allowing automated processes to update the "status" field of a Pod. The `/pods` endpoint only allows updates to "metadata" and "spec", since those reflect end-user intent. An automated process should be able to modify status for users to see by sending an updated Pod kind to the server to the "/pods/&lt;name&gt;/status" endpoint - the alternate endpoint allows different rules to be applied to the update, and access to be appropriately restricted. Likewise, some actions like "stop" or "scale" are best represented as REST sub-resources that are POSTed to. The POST action may require a simple kind to be provided if the action requires parameters, or function without a request body.
240240

@@ -324,7 +324,7 @@ labels:
324324

325325
## Idempotency
326326

327-
All compatible Kubernetes APIs MUST support "name idempotency" and respond with an HTTP status code 409 when a request is made to POST an object that has the same name as an existing object in the system. See [identifiers.md](identifiers.md) for details.
327+
All compatible Kubernetes APIs MUST support "name idempotency" and respond with an HTTP status code 409 when a request is made to POST an object that has the same name as an existing object in the system. See [user-guide/identifiers.md](user-guide/identifiers.md) for details.
328328

329329
Names generated by the system may be requested using `metadata.generateName`. GenerateName indicates that the name should be made unique by the server prior to persisting it. A non-empty value for the field indicates the name will be made unique (and the name returned to the client will be different than the name passed). The value of this field will be combined with a unique suffix on the server if the Name field has not been provided. The provided value must be valid within the rules for Name, and may be truncated by the length of the suffix required to make the value unique on the server. If this field is specified, and Name is not present, the server will NOT return a 409 if the generated name exists - instead, it will either return 201 Created or 504 with Reason `ServerTimeout` indicating a unique name could not be found in the time allotted, and the client should retry (optionally after the time indicated in the Retry-After header).
330330

docs/api.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ certainly want the docs that go with that version.</h1>
1414
<!-- END MUNGE: UNVERSIONED_WARNING -->
1515
# The Kubernetes API
1616

17-
Primary system and API concepts are documented in the [User guide](user-guide.md).
17+
Primary system and API concepts are documented in the [User guide](user-guide/user-guide.md).
1818

1919
Overall API conventions are described in the [API conventions doc](api-conventions.md).
2020

@@ -54,11 +54,11 @@ Changes to services are the most significant difference between v1beta3 and v1.
5454

5555
* The `service.spec.portalIP` property is renamed to `service.spec.clusterIP`.
5656
* The `service.spec.createExternalLoadBalancer` property is removed. Specify `service.spec.type: "LoadBalancer"` to create an external load balancer instead.
57-
* 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](services.md#external-services) for more info. If this is not sufficient for your use case, please file an issue or contact @thockin.
57+
* 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.
5858

5959
Some other difference between v1beta3 and v1:
6060

61-
* The `pod.spec.containers[*].privileged` and `pod.spec.containers[*].capabilities` properties are now nested under the `pod.spec.containers[*].securityContext` property. See [Security Contexts](security-context.md).
61+
* 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).
6262
* The `pod.spec.host` property is renamed to `pod.spec.nodeName`.
6363
* The `endpoints.subsets[*].addresses.IP` property is renamed to `endpoints.subsets[*].addresses.ip`.
6464
* 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.
@@ -79,7 +79,7 @@ Some important differences between v1beta1/2 and v1beta3:
7979
* The `labels` query parameter has been renamed to `labelSelector`.
8080
* The `fields` query parameter has been renamed to `fieldSelector`.
8181
* The container `entrypoint` has been renamed to `command`, and `command` has been renamed to `args`.
82-
* 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](compute-resources.md#specifying-resource-quantities) rather than fixed scales (e.g., milli-cores).
82+
* 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).
8383
* Restart policy is represented simply as a string (e.g., `"Always"`) rather than as a nested map (`always{}`).
8484
* Pull policies changed from `PullAlways`, `PullNever`, and `PullIfNotPresent` to `Always`, `Never`, and `IfNotPresent`.
8585
* The volume `source` is inlined into `volume` rather than nested.

docs/cluster-large.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ To avoid running into cluster addon resource issues, when creating a cluster wit
6868
* [FluentD with ElasticSearch Plugin](../cluster/saltbase/salt/fluentd-es/fluentd-es.yaml)
6969
* [FluentD with GCP Plugin](../cluster/saltbase/salt/fluentd-gcp/fluentd-gcp.yaml)
7070
71-
For directions on how to detect if addon containers are hitting resource limits, see the [Troubleshooting section of Compute Resources](compute-resources.md#troubleshooting).
71+
For directions on how to detect if addon containers are hitting resource limits, see the [Troubleshooting section of Compute Resources](user-guide/compute-resources.md#troubleshooting).
7272
7373
7474
<!-- BEGIN MUNGE: GENERATED_ANALYTICS -->

0 commit comments

Comments
 (0)