Skip to content

Commit

Permalink
a few 'Walkthrough' typo fixes
Browse files Browse the repository at this point in the history
  • Loading branch information
amygdala committed Oct 28, 2014
1 parent 854af6b commit 4d9023c
Show file tree
Hide file tree
Showing 2 changed files with 9 additions and 9 deletions.
2 changes: 1 addition & 1 deletion examples/walkthrough/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Kubernetes 101 - Walkthrough

## Pods
The first atom of Kubernetes is a _pod_. A pod is a collection of containers that are symbiotically group.
The first atom of Kubernetes is a _pod_. A pod is a collection of containers that are symbiotically grouped.

See [pods](../../docs/pods.md) for more details.

Expand Down
16 changes: 8 additions & 8 deletions examples/walkthrough/k8s201.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ selector:
containerPort: 80
```
When created, each service is assigned a unique IP address. This address is tied to the lifespan of the Service, and will not change wile the Service is alive. Pods can be configured to talk to the service, and know that communication to the service will be automatically load-balanced out to some pod that is a member of the set identified by the label selector in the Service. Services are described in detail [elsewhere](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/services.md).
When created, each service is assigned a unique IP address. This address is tied to the lifespan of the Service, and will not change while the Service is alive. Pods can be configured to talk to the service, and know that communication to the service will be automatically load-balanced out to some pod that is a member of the set identified by the label selector in the Service. Services are described in detail [elsewhere](https://github.com/GoogleCloudPlatform/kubernetes/blob/master/docs/services.md).
### Health Checking
When I write code it never crashes, right? Sadly the [kubernetes issues list](https://github.com/GoogleCloudPlatform/kubernetes/issues) indicates otherwise...
Expand Down Expand Up @@ -107,22 +107,22 @@ lockTwo.Lock();
lockOne.Lock();
```

This is a classic example of a problem in computer science known as "Deadlock" from Docker's perspective your application is
This is a classic example of a problem in computer science known as "Deadlock". From Docker's perspective your application is
still operating, the process is still running, but from your application's perspective, your code is locked up, and will never
respond correctly.

To address this problem, Kubernetes supports user implemented application health-checks. These checks are performed by the
kubelet to ensure that your application is operating correctly for a definition of "correctly" that _you_ provide.

Currently there are three types of application health checks that you can choose from
Currently, there are three types of application health checks that you can choose from:

* HTTP Health Checks - The Kubelet will call a web hook. If it returns between 200 and 399, it is considered succes, failure otherwise.
* Container Exec - The Kubelet will execute a command inside your container. If it returns "ok" it will be considered a success
* HTTP Health Checks - The Kubelet will call a web hook. If it returns between 200 and 399, it is considered success, failure otherwise.
* Container Exec - The Kubelet will execute a command inside your container. If it returns "ok" it will be considered a success.
* TCP Socket - The Kubelet will attempt to open a socket to your container. If it can establish a connection, the container is considered healthy, if it can't it is considered a failure.

In all cases, if the Kubelet discovers a failure, the container is restarted.

The container health checks are configured in the "LivenessProbe" section of your container config, there you can also specify an "initialDelaySeconds" that is a grace period from when the container is started to when health checks are performed, to enable your container to perform an necessary initialization.
The container health checks are configured in the "LivenessProbe" section of your container config. There you can also specify an "initialDelaySeconds" that is a grace period from when the container is started to when health checks are performed, to enable your container to perform any necessary initialization.

Here is an example config for a pod with an HTTP health check:
```yaml
Expand All @@ -148,8 +148,8 @@ desiredState:
# an http probe
httpGet:
path: /_status/healthz
port: 8080
port: 8080
```
### What's next?
For a complete application see the [guestbook example](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/examples/guestbook)
For a complete application see the [guestbook example](https://github.com/GoogleCloudPlatform/kubernetes/tree/master/examples/guestbook).

0 comments on commit 4d9023c

Please sign in to comment.