From 98eeadb66e1042ce1ab6c1e75fbb69db00e334a8 Mon Sep 17 00:00:00 2001 From: Daniel Smith Date: Thu, 16 Jul 2015 14:54:28 -0700 Subject: [PATCH] (mostly) auto fixed links --- docs/admin/accessing-the-api.md | 3 +-- docs/admin/cluster-large.md | 6 +++--- docs/admin/high-availability.md | 2 +- docs/design/event_compression.md | 6 +++--- docs/devel/cli-roadmap.md | 6 +++--- docs/devel/client-libraries.md | 2 +- docs/getting-started-guides/aws.md | 14 +++++++------- docs/getting-started-guides/cloudstack.md | 2 +- docs/getting-started-guides/locally.md | 2 +- docs/getting-started-guides/rackspace.md | 4 ++-- docs/getting-started-guides/scratch.md | 6 ++---- docs/user-guide/accessing-the-cluster.md | 2 +- docs/user-guide/container-environment.md | 2 +- docs/user-guide/downward-api/README.md | 2 +- docs/user-guide/limitrange/README.md | 2 +- docs/user-guide/secrets/README.md | 2 +- docs/user-guide/services.md | 2 +- docs/user-guide/update-demo/README.md | 2 +- examples/cassandra/README.md | 4 ++-- examples/cluster-dns/README.md | 2 +- examples/guestbook/README.md | 6 +++--- examples/hazelcast/README.md | 2 +- examples/k8petstore/README.md | 2 +- examples/rethinkdb/README.md | 2 +- 24 files changed, 41 insertions(+), 44 deletions(-) diff --git a/docs/admin/accessing-the-api.md b/docs/admin/accessing-the-api.md index 68752b3ef8896..195f73e8da146 100644 --- a/docs/admin/accessing-the-api.md +++ b/docs/admin/accessing-the-api.md @@ -89,8 +89,7 @@ variety of uses cases: - Scheduler and Controller-manager will use the Secure Port too. They will then be able to run on different machines than the apiserver. - A general mechanism will be provided for [giving credentials to - pods]( - https://github.com/GoogleCloudPlatform/kubernetes/issues/1907). + pods](https://github.com/GoogleCloudPlatform/kubernetes/issues/1907). - Clients, like kubectl, will all support token-based auth, and the Localhost will no longer be needed, and will not be the default. However, the localhost port may continue to be an option for diff --git a/docs/admin/cluster-large.md b/docs/admin/cluster-large.md index 537c0a7768b45..06f46f4b8d64b 100644 --- a/docs/admin/cluster-large.md +++ b/docs/admin/cluster-large.md @@ -23,11 +23,11 @@ certainly want the docs that go with that version. # Kubernetes Large Cluster ## Support -At v1.0, Kubernetes supports clusters up to 100 nodes with 30-50 pods per node and 1-2 container per pod (as defined in the [1.0 roadmap](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/roadmap.md#reliability-and-performance)). +At v1.0, Kubernetes supports clusters up to 100 nodes with 30-50 pods per node and 1-2 container per pod (as defined in the [1.0 roadmap](../../docs/roadmap.md#reliability-and-performance)). ## Setup -Normally the number of nodes in a cluster is controlled by the the value `NUM_MINIONS` in the platform-specific `config-default.sh` file (for example, see [GCE's `config-default.sh`](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/cluster/gce/config-default.sh)). +Normally the number of nodes in a cluster is controlled by the the value `NUM_MINIONS` in the platform-specific `config-default.sh` file (for example, see [GCE's `config-default.sh`](../../cluster/gce/config-default.sh)). Simply changing that value to something very large, however, may cause the setup script to fail for many cloud providers. A GCE deployment, for example, will run in to quota issues and fail to bring the cluster up. @@ -49,7 +49,7 @@ To avoid running into cloud provider quota issues, when creating a cluster with * Gating the setup script so that it brings up new node VMs in smaller batches with waits in between, because some cloud providers limit the number of VMs you can create during a given period. ### Addon Resources -To prevent memory leaks or other resource issues in [cluster addons](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/cluster/addons/) from consuming all the resources available on a node, Kubernetes sets resource limits on addon containers to limit the CPU and Memory resources they can consume (See PR [#10653](https://github.com/GoogleCloudPlatform/kubernetes/pull/10653/files) and [#10778](https://github.com/GoogleCloudPlatform/kubernetes/pull/10778/files)). +To prevent memory leaks or other resource issues in [cluster addons](../../cluster/addons/) from consuming all the resources available on a node, Kubernetes sets resource limits on addon containers to limit the CPU and Memory resources they can consume (See PR [#10653](https://github.com/GoogleCloudPlatform/kubernetes/pull/10653/files) and [#10778](https://github.com/GoogleCloudPlatform/kubernetes/pull/10778/files)). For example: ```YAML diff --git a/docs/admin/high-availability.md b/docs/admin/high-availability.md index 767c8a98b12cd..a745a05a7d54e 100644 --- a/docs/admin/high-availability.md +++ b/docs/admin/high-availability.md @@ -35,7 +35,7 @@ certainly want the docs that go with that version. ## Introduction This document describes how to build a high-availability (HA) Kubernetes cluster. This is a fairly advanced topic. Users who merely want to experiment with Kubernetes are encouraged to use configurations that are simpler to set up such as -the simple [Docker based single node cluster instructions](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/getting-started-guides/docker.md), +the simple [Docker based single node cluster instructions](../../docs/getting-started-guides/docker.md), or try [Google Container Engine](https://cloud.google.com/container-engine/) for hosted Kubernetes. Also, at this time high availability support for Kubernetes is not continuously tested in our end-to-end (e2e) testing. We will diff --git a/docs/design/event_compression.md b/docs/design/event_compression.md index 32e52607df00a..294d3f41da2ab 100644 --- a/docs/design/event_compression.md +++ b/docs/design/event_compression.md @@ -35,7 +35,7 @@ Each binary that generates events (for example, ```kubelet```) should keep track Event compression should be best effort (not guaranteed). Meaning, in the worst case, ```n``` identical (minus timestamp) events may still result in ```n``` event entries. ## Design -Instead of a single Timestamp, each event object [contains](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/pkg/api/types.go#L1111) the following fields: +Instead of a single Timestamp, each event object [contains](../../pkg/api/types.go#L1111) the following fields: * ```FirstTimestamp util.Time``` * The date/time of the first occurrence of the event. * ```LastTimestamp util.Time``` @@ -47,7 +47,7 @@ Instead of a single Timestamp, each event object [contains](https://github.com/G Each binary that generates events: * Maintains a historical record of previously generated events: - * Implemented with ["Least Recently Used Cache"](https://github.com/golang/groupcache/blob/master/lru/lru.go) in [```pkg/client/record/events_cache.go```](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/pkg/client/record/events_cache.go). + * Implemented with ["Least Recently Used Cache"](https://github.com/golang/groupcache/blob/master/lru/lru.go) in [```pkg/client/record/events_cache.go```](../../pkg/client/record/events_cache.go). * The key in the cache is generated from the event object minus timestamps/count/transient fields, specifically the following events fields are used to construct a unique key for an event: * ```event.Source.Component``` * ```event.Source.Host``` @@ -59,7 +59,7 @@ Each binary that generates events: * ```event.Reason``` * ```event.Message``` * The LRU cache is capped at 4096 events. That means if a component (e.g. kubelet) runs for a long period of time and generates tons of unique events, the previously generated events cache will not grow unchecked in memory. Instead, after 4096 unique events are generated, the oldest events are evicted from the cache. - * When an event is generated, the previously generated events cache is checked (see [```pkg/client/record/event.go```](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/pkg/client/record/event.go)). + * When an event is generated, the previously generated events cache is checked (see [```pkg/client/record/event.go```](../../pkg/client/record/event.go)). * If the key for the new event matches the key for a previously generated event (meaning all of the above fields match between the new event and some previously generated event), then the event is considered to be a duplicate and the existing event entry is updated in etcd: * The new PUT (update) event API is called to update the existing event entry in etcd with the new last seen timestamp and count. * The event is also updated in the previously generated events cache with an incremented count, updated last seen timestamp, name, and new resource version (all required to issue a future event update). diff --git a/docs/devel/cli-roadmap.md b/docs/devel/cli-roadmap.md index fe8d5b0f22cb0..f2b9f8c178f1f 100644 --- a/docs/devel/cli-roadmap.md +++ b/docs/devel/cli-roadmap.md @@ -23,9 +23,9 @@ certainly want the docs that go with that version. # Kubernetes CLI/Configuration Roadmap See also issues with the following labels: -* [area/config-deployment](https://github.com/GoogleCloudPlatform/kubernetes/labels/area%2Fconfig-deployment) -* [component/CLI](https://github.com/GoogleCloudPlatform/kubernetes/labels/component%2FCLI) -* [component/client](https://github.com/GoogleCloudPlatform/kubernetes/labels/component%2Fclient) +* [area/app-config-deployment](https://github.com/GoogleCloudPlatform/kubernetes/labels/area/app-config-deployment) +* [component/CLI](https://github.com/GoogleCloudPlatform/kubernetes/labels/component/CLI) +* [component/client](https://github.com/GoogleCloudPlatform/kubernetes/labels/component/client) 1. Create services before other objects, or at least before objects that depend upon them. Namespace-relative DNS mitigates this some, but most users are still using service environment variables. [#1768](https://github.com/GoogleCloudPlatform/kubernetes/issues/1768) 1. Finish rolling update [#1353](https://github.com/GoogleCloudPlatform/kubernetes/issues/1353) diff --git a/docs/devel/client-libraries.md b/docs/devel/client-libraries.md index b7529a0157f6c..ef9a1f69e9466 100644 --- a/docs/devel/client-libraries.md +++ b/docs/devel/client-libraries.md @@ -23,7 +23,7 @@ certainly want the docs that go with that version. ## kubernetes API client libraries ### Supported - * [Go](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/pkg/client) + * [Go](../../pkg/client/) ### User Contributed *Note: Libraries provided by outside parties are supported by their authors, not the core Kubernetes team* diff --git a/docs/getting-started-guides/aws.md b/docs/getting-started-guides/aws.md index 7ae53ac6a9c61..093bd83a7b4ae 100644 --- a/docs/getting-started-guides/aws.md +++ b/docs/getting-started-guides/aws.md @@ -51,16 +51,16 @@ export KUBERNETES_PROVIDER=aws; wget -q -O - https://get.k8s.io | bash export KUBERNETES_PROVIDER=aws; curl -sS https://get.k8s.io | bash ``` -NOTE: This script calls [cluster/kube-up.sh](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/cluster/kube-up.sh) -which in turn calls [cluster/aws/util.sh](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/cluster/aws/util.sh) -using [cluster/aws/config-default.sh](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/cluster/aws/config-default.sh). +NOTE: This script calls [cluster/kube-up.sh](../../cluster/kube-up.sh) +which in turn calls [cluster/aws/util.sh](../../cluster/aws/util.sh) +using [cluster/aws/config-default.sh](../../cluster/aws/config-default.sh). This process takes about 5 to 10 minutes. Once the cluster is up, the IP addresses of your master and node(s) will be printed, as well as information about the default services running in the cluster (monitoring, logging, dns). User credentials and security tokens are written in `~/.kube/kubeconfig`, they will be necessary to use the CLI or the HTTP Basic Auth. By default, the script will provision a new VPC and a 4 node k8s cluster in us-west-2a (Oregon) with `t2.micro` instances running on Ubuntu. -You can override the variables defined in [config-default.sh](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/cluster/aws/config-default.sh) to change this behavior as follows: +You can override the variables defined in [config-default.sh](../../cluster/aws/config-default.sh) to change this behavior as follows: ```bash export KUBE_AWS_ZONE=eu-west-1c @@ -93,10 +93,10 @@ sudo cp kubernetes/platforms/darwin/amd64/kubectl /usr/local/bin/kubectl sudo cp kubernetes/platforms/linux/amd64/kubectl /usr/local/bin/kubectl ``` -An up-to-date documentation page for this tool is available here: [kubectl manual](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/kubectl.md) +An up-to-date documentation page for this tool is available here: [kubectl manual](../../docs/user-guide/kubectl/kubectl.md) By default, `kubectl` will use the `kubeconfig` file generated during the cluster startup for authenticating against the API. -For more information, please read [kubeconfig files](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/kubeconfig-file.md) +For more information, please read [kubeconfig files](../../docs/user-guide/kubeconfig-file.md) ### Examples See [a simple nginx example](../../docs/user-guide/simple-nginx.md) to try out your new cluster. @@ -114,7 +114,7 @@ cluster/kube-down.sh ``` ## Further reading -Please see the [Kubernetes docs](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/docs) for more details on administering +Please see the [Kubernetes docs](../../docs/) for more details on administering and using a Kubernetes cluster. diff --git a/docs/getting-started-guides/cloudstack.md b/docs/getting-started-guides/cloudstack.md index 51d0708db077a..a5f51d2a3127c 100644 --- a/docs/getting-started-guides/cloudstack.md +++ b/docs/getting-started-guides/cloudstack.md @@ -48,7 +48,7 @@ This [Ansible](http://ansibleworks.com) playbook deploys Kubernetes on a CloudSt $ sudo pip install ansible $ sudo pip install cs -[_cs_](http://github.com/exoscale/cs) is a python module for the CloudStack API. +[_cs_](https://github.com/exoscale/cs) is a python module for the CloudStack API. Set your CloudStack endpoint, API keys and HTTP method used. diff --git a/docs/getting-started-guides/locally.md b/docs/getting-started-guides/locally.md index 608f910fce35c..490b2373a744a 100644 --- a/docs/getting-started-guides/locally.md +++ b/docs/getting-started-guides/locally.md @@ -150,7 +150,7 @@ hack/local-up-cluster.sh One or more of the kubernetes daemons might've crashed. Tail the logs of each in /tmp. #### The pods fail to connect to the services by host names -The local-up-cluster.sh script doesn't start a DNS service. Similar situation can be found [here](https://github.com/GoogleCloudPlatform/kubernetes/issues/6667). You can start a manually. Related documents can be found [here](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/cluster/addons/dns#how-do-i-configure-it) +The local-up-cluster.sh script doesn't start a DNS service. Similar situation can be found [here](https://github.com/GoogleCloudPlatform/kubernetes/issues/6667). You can start a manually. Related documents can be found [here](../../cluster/addons/dns/#how-do-i-configure-it) diff --git a/docs/getting-started-guides/rackspace.md b/docs/getting-started-guides/rackspace.md index 7424254313c84..d864794bd6d70 100644 --- a/docs/getting-started-guides/rackspace.md +++ b/docs/getting-started-guides/rackspace.md @@ -44,8 +44,8 @@ These scripts should be used to deploy development environments for Kubernetes. NOTE: The rackspace scripts do NOT rely on `saltstack` and instead rely on cloud-init for configuration. The current cluster design is inspired by: -- [corekube](https://github.com/metral/corekube/) -- [Angus Lees](https://github.com/anguslees/kube-openstack/) +- [corekube](https://github.com/metral/corekube) +- [Angus Lees](https://github.com/anguslees/kube-openstack) ## Prerequisites 1. Python2.7 diff --git a/docs/getting-started-guides/scratch.md b/docs/getting-started-guides/scratch.md index e581999003116..5105aa4145d39 100644 --- a/docs/getting-started-guides/scratch.md +++ b/docs/getting-started-guides/scratch.md @@ -174,8 +174,7 @@ A Kubernetes binary release includes all the Kubernetes binaries as well as the You can use a Kubernetes binary release (recommended) or build your Kubernetes binaries following the instructions in the [Developer Documentation](../devel/README.md). Only using a binary release is covered in this guide. -Download the [latest binary release]( -https://github.com/GoogleCloudPlatform/kubernetes/releases/latest) and unzip it. +Download the [latest binary release](https://github.com/GoogleCloudPlatform/kubernetes/releases/latest) and unzip it. Then locate `./kubernetes/server/kubernetes-server-linux-amd64.tar.gz` and unzip *that*. Then, within the second set of unzipped files, locate `./kubernetes/server/bin`, which contains all the necessary binaries. @@ -188,8 +187,7 @@ we recommend that you run these as containers, so you need an image to be built. You have several choices for Kubernetes images: 1. Use images hosted on Google Container Registry (GCR): - e.g `gcr.io/google_containers/kube-apiserver:$TAG`, where `TAG` is the latest - release tag, which can be found on the [latest releases page]( - https://github.com/GoogleCloudPlatform/kubernetes/releases/latest). + release tag, which can be found on the [latest releases page](https://github.com/GoogleCloudPlatform/kubernetes/releases/latest). - Ensure $TAG is the same tag as the release tag you are using for kubelet and kube-proxy. - Build your own images. - Useful if you are using a private registry. diff --git a/docs/user-guide/accessing-the-cluster.md b/docs/user-guide/accessing-the-cluster.md index d57f1ece8ad26..a426bd0ac5353 100644 --- a/docs/user-guide/accessing-the-cluster.md +++ b/docs/user-guide/accessing-the-cluster.md @@ -126,7 +126,7 @@ with future high-availability support. There are [client libraries](../devel/client-libraries.md) for accessing the API from several languages. The Kubernetes project-supported -[Go](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/pkg/client) +[Go](../../pkg/client/) client library can use the same [kubeconfig file](kubeconfig-file.md) as the kubectl CLI does to locate and authenticate to the apiserver. diff --git a/docs/user-guide/container-environment.md b/docs/user-guide/container-environment.md index f16be11c641be..8787e4eea52d8 100644 --- a/docs/user-guide/container-environment.md +++ b/docs/user-guide/container-environment.md @@ -68,7 +68,7 @@ FOO_SERVICE_HOST= FOO_SERVICE_PORT= ``` -Services have dedicated IP address, and are also surfaced to the container via DNS (If [DNS addon](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/cluster/addons/dns) is enabled).  Of course DNS is still not an enumerable protocol, so we will continue to provide environment variables so that containers can do discovery. +Services have dedicated IP address, and are also surfaced to the container via DNS (If [DNS addon](../../cluster/addons/dns/) is enabled).  Of course DNS is still not an enumerable protocol, so we will continue to provide environment variables so that containers can do discovery. ## Container Hooks *NB*: Container hooks are under active development, we anticipate adding additional hooks as the Kubernetes container management system evolves.* diff --git a/docs/user-guide/downward-api/README.md b/docs/user-guide/downward-api/README.md index e3b849caedbb9..d242360d2fcf7 100644 --- a/docs/user-guide/downward-api/README.md +++ b/docs/user-guide/downward-api/README.md @@ -23,7 +23,7 @@ certainly want the docs that go with that version. # Downward API example Following this example, you will create a pod with a containers that consumes the pod's name and -namespace using the [downward API](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/downward_api.md). +namespace using the [downward API](../downward-api.md). ## Step Zero: Prerequisites diff --git a/docs/user-guide/limitrange/README.md b/docs/user-guide/limitrange/README.md index 13c74680b8e79..1fe91d7e4b216 100644 --- a/docs/user-guide/limitrange/README.md +++ b/docs/user-guide/limitrange/README.md @@ -47,7 +47,7 @@ This example demonstrates how limits can be applied to a Kubernetes namespace to min/max resource limits per pod. In addition, this example demonstrates how you can apply default resource limits to pods in the absence of an end-user specified value. -For a detailed description of the Kubernetes resource model, see [Resources](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/resources.md) +For a detailed description of the Kubernetes resource model, see [Resources](../../../docs/user-guide/compute-resources.md) Step 0: Prerequisites ----------------------------------------- diff --git a/docs/user-guide/secrets/README.md b/docs/user-guide/secrets/README.md index 5ddaccc1122c3..f0b611dd7cab1 100644 --- a/docs/user-guide/secrets/README.md +++ b/docs/user-guide/secrets/README.md @@ -23,7 +23,7 @@ certainly want the docs that go with that version. # Secrets example Following this example, you will create a secret and a pod that consumes that secret in a volume. -You can learn more about secrets [Here](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/secrets.md). +You can learn more about secrets [Here](../secrets.md). ## Step Zero: Prerequisites diff --git a/docs/user-guide/services.md b/docs/user-guide/services.md index d07928219316e..075b2e68910ec 100644 --- a/docs/user-guide/services.md +++ b/docs/user-guide/services.md @@ -282,7 +282,7 @@ variables and DNS. When a `Pod` is run on a `Node`, the kubelet adds a set of environment variables for each active `Service`. It supports both [Docker links compatible](https://docs.docker.com/userguide/dockerlinks/) variables (see -[makeLinkVariables](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/pkg/kubelet/envvars/envvars.go#L49)) +[makeLinkVariables](../../pkg/kubelet/envvars/envvars.go#L49)) and simpler `{SVCNAME}_SERVICE_HOST` and `{SVCNAME}_SERVICE_PORT` variables, where the Service name is upper-cased and dashes are converted to underscores. diff --git a/docs/user-guide/update-demo/README.md b/docs/user-guide/update-demo/README.md index e80c9ab622f7c..4819b0749d36e 100644 --- a/docs/user-guide/update-demo/README.md +++ b/docs/user-guide/update-demo/README.md @@ -53,7 +53,7 @@ $ ./cluster/kube-up.sh You can use bash job control to run this in the background (note that you must use the default port -- 8001 -- for the following demonstration to work properly). This can sometimes spew to the output so you could also run it in a different terminal. You have to run `kubectl proxy` in the root of the Kubernetes repository. Otherwise you will get "404 page not found" errors as the paths will not match. You can find more information about `kubectl proxy` -[here](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/kubectl_proxy.md). +[here](../../../docs/user-guide/kubectl/kubectl_proxy.md). ``` $ kubectl proxy --www=examples/update-demo/local/ & diff --git a/examples/cassandra/README.md b/examples/cassandra/README.md index d4771206eff2c..b3bbb4a9a24e7 100644 --- a/examples/cassandra/README.md +++ b/examples/cassandra/README.md @@ -27,7 +27,7 @@ The following document describes the development of a _cloud native_ [Cassandra] This document also attempts to describe the core components of Kubernetes: _Pods_, _Services_, and _Replication Controllers_. ### Prerequisites -This example assumes that you have a Kubernetes cluster installed and running, and that you have installed the ```kubectl``` command line tool somewhere in your path. Please see the [getting started](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/docs/getting-started-guides) for installation instructions for your platform. +This example assumes that you have a Kubernetes cluster installed and running, and that you have installed the ```kubectl``` command line tool somewhere in your path. Please see the [getting started](../../docs/getting-started-guides/) for installation instructions for your platform. This example also has a few code and configuration files needed. To avoid typing these out, you can ```git clone``` the Kubernetes repository to you local computer. @@ -78,7 +78,7 @@ spec: There are a few things to note in this description. First is that we are running the ```kubernetes/cassandra``` image. This is a standard Cassandra installation on top of Debian. However it also adds a custom [```SeedProvider```](https://svn.apache.org/repos/asf/cassandra/trunk/src/java/org/apache/cassandra/locator/SeedProvider.java) to Cassandra. In Cassandra, a ```SeedProvider``` bootstraps the gossip protocol that Cassandra uses to find other nodes. The ```KubernetesSeedProvider``` discovers the Kubernetes API Server using the built in Kubernetes discovery service, and then uses the Kubernetes API to find new nodes (more on this later) -You may also note that we are setting some Cassandra parameters (```MAX_HEAP_SIZE``` and ```HEAP_NEWSIZE```) and adding information about the [namespace](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/namespaces.md). We also tell Kubernetes that the container exposes both the ```CQL``` and ```Thrift``` API ports. Finally, we tell the cluster manager that we need 0.5 cpu (0.5 core). +You may also note that we are setting some Cassandra parameters (```MAX_HEAP_SIZE``` and ```HEAP_NEWSIZE```) and adding information about the [namespace](../../docs/user-guide/namespaces.md). We also tell Kubernetes that the container exposes both the ```CQL``` and ```Thrift``` API ports. Finally, we tell the cluster manager that we need 0.5 cpu (0.5 core). In theory could create a single Cassandra pod right now but since `KubernetesSeedProvider` needs to learn what nodes are in the Cassandra deployment we need to create a service first. diff --git a/examples/cluster-dns/README.md b/examples/cluster-dns/README.md index 1a6b2c2a50ea1..e75192683f61e 100644 --- a/examples/cluster-dns/README.md +++ b/examples/cluster-dns/README.md @@ -26,7 +26,7 @@ This is a toy example demonstrating how to use kubernetes DNS. ### Step Zero: Prerequisites -This example assumes that you have forked the repository and [turned up a Kubernetes cluster](../../docs/getting-started-guides/). Make sure DNS is enabled in your setup, see [DNS doc](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/cluster/addons/dns). +This example assumes that you have forked the repository and [turned up a Kubernetes cluster](../../docs/getting-started-guides/). Make sure DNS is enabled in your setup, see [DNS doc](../../cluster/addons/dns/). ```shell $ cd kubernetes diff --git a/examples/guestbook/README.md b/examples/guestbook/README.md index 4cf437fabd6f0..99710c1a2103e 100644 --- a/examples/guestbook/README.md +++ b/examples/guestbook/README.md @@ -232,9 +232,9 @@ The traffic flow from slaves to masters can be described in two steps, like so: Kubernetes supports two primary modes of finding a service— environment variables and DNS. -The services in a Kubernetes cluster are discoverable inside other containers [via environment variables](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/services.md#environment-variables). +The services in a Kubernetes cluster are discoverable inside other containers [via environment variables](../../docs/user-guide/services.md#environment-variables). -An alternative is to use the [cluster's DNS service](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/services.md#dns), if it has been enabled for the cluster. This lets all pods do name resolution of services automatically, based on the service name. +An alternative is to use the [cluster's DNS service](../../docs/user-guide/services.md#dns), if it has been enabled for the cluster. This lets all pods do name resolution of services automatically, based on the service name. We'll use the DNS service for this example. E.g., you can see the service name, `redis-master`, accessed as a `host` value in the PHP script in [Step 5](#step-five-create-the-frontend-replicated-pods). **Note**: **If your cluster does not have the DNS service enabled, then this example will not work out of the box.** You will need to edit `examples/guestbook/php-redis/index.php` to use environment variables for service discovery instead, then rebuild the container image from the `Dockerfile` in that directory. (However, this is unlikely to be necessary. You can check for the DNS service in the list of the clusters' services.) @@ -496,7 +496,7 @@ redis-slave name=redis-slave name=redis-sla You'll want to set up your guestbook service so that it can be accessed from outside of the internal Kubernetes network. Above, we introduced one way to do that, using the `type: LoadBalancer` spec. -More generally, Kubernetes supports two ways of exposing a service onto an external IP address: `NodePort`s and `LoadBalancer`s , as described [here](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/services.md#external-services). +More generally, Kubernetes supports two ways of exposing a service onto an external IP address: `NodePort`s and `LoadBalancer`s , as described [here](../../docs/user-guide/services.md#external-services). If the `LoadBalancer` specification is used, it can take a short period for an external IP to show up in `kubectl get services` output, but you should shortly see it listed as well, e.g. like this: diff --git a/examples/hazelcast/README.md b/examples/hazelcast/README.md index c5e792aeadab9..d93d6e6f70ba1 100644 --- a/examples/hazelcast/README.md +++ b/examples/hazelcast/README.md @@ -29,7 +29,7 @@ Any topology changes are communicated and handled by Hazelcast nodes themselves. This document also attempts to describe the core components of Kubernetes: _Pods_, _Services_, and _Replication Controllers_. ### Prerequisites -This example assumes that you have a Kubernetes cluster installed and running, and that you have installed the `kubectl` command line tool somewhere in your path. Please see the [getting started](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/docs/getting-started-guides) for installation instructions for your platform. +This example assumes that you have a Kubernetes cluster installed and running, and that you have installed the `kubectl` command line tool somewhere in your path. Please see the [getting started](../../docs/getting-started-guides/) for installation instructions for your platform. ### A note for the impatient This is a somewhat long tutorial. If you want to jump straight to the "do it now" commands, please see the [tl; dr](#tl-dr) at the end. diff --git a/examples/k8petstore/README.md b/examples/k8petstore/README.md index 1f259612f5aed..ff4fee846e2e5 100644 --- a/examples/k8petstore/README.md +++ b/examples/k8petstore/README.md @@ -116,7 +116,7 @@ So, to run this app in Kubernetes, simply run [The all in one k8petstore.sh shel Note that at the top of the script there are a few self explanatory parameters to set, among which the Public IPs parameter is where you can checkout the web ui (at $PUBLIC_IP:3000), which will show a plot and read outs of transaction throughput. -In the mean time, because the public IP will be deprecated in Kubernetes v1, we provide other 2 scripts k8petstore-loadbalancer.sh and k8petstore-nodeport.sh. As the names suggest, they rely on LoadBalancer and NodePort respectively. More details can be found [here](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/services.md#external-services). +In the mean time, because the public IP will be deprecated in Kubernetes v1, we provide other 2 scripts k8petstore-loadbalancer.sh and k8petstore-nodeport.sh. As the names suggest, they rely on LoadBalancer and NodePort respectively. More details can be found [here](../../docs/user-guide/services.md#external-services). ## Future diff --git a/examples/rethinkdb/README.md b/examples/rethinkdb/README.md index f67ff37e81d31..af1df36900761 100644 --- a/examples/rethinkdb/README.md +++ b/examples/rethinkdb/README.md @@ -144,7 +144,7 @@ since the ui is not stateless when playing with Web Admin UI will cause `Connect * `gen_pod.sh` is using to generate pod templates for my local cluster, the generated pods which is using `nodeSelector` to force k8s to schedule containers to my designate nodes, for I need to access persistent data on my host dirs. Note that one needs to label the node before 'nodeSelector' can work, see this [tutorial](../../docs/user-guide/node-selection/) - * see [antmanler/rethinkdb-k8s](https://github.com/antmanler/rethinkdb-k8s) for detail + * see [/antmanler/rethinkdb-k8s](https://github.com/antmanler/rethinkdb-k8s) for detail