From 968160bdd0764a588886596f07df9a6d880b4674 Mon Sep 17 00:00:00 2001 From: Sebastiaan van Steenis Date: Tue, 5 Mar 2019 00:49:39 +0100 Subject: [PATCH] Fixes for Configure Health Checks --- .../en/v1.6-migration/monitor-apps/_index.md | 64 +++++-------------- 1 file changed, 15 insertions(+), 49 deletions(-) diff --git a/content/rancher/v2.x/en/v1.6-migration/monitor-apps/_index.md b/content/rancher/v2.x/en/v1.6-migration/monitor-apps/_index.md index 538c60f370b..4a909f91451 100644 --- a/content/rancher/v2.x/en/v1.6-migration/monitor-apps/_index.md +++ b/content/rancher/v2.x/en/v1.6-migration/monitor-apps/_index.md @@ -5,7 +5,7 @@ weight: 400 Rancher v1.6 provided TCP and HTTP health checks on your nodes and services using its own health check microservice. These health checks monitored your containers to confirm they're operating as intended. If a container failed a health check, Rancher would destroy the unhealthy container and then replicates a healthy one to replace it. -For Rancher v2.x, we've replaced the heath check microservice, leveraging instead Kubernete's native health check support. +For Rancher v2.x, we've replaced the health check microservice, leveraging instead Kubernetes' native health check support. Use this document to correct Rancher v2.x workloads and services that list `health_check` in `output.txt`. You can correct them by configuring a liveness probe (i.e., a health check). @@ -20,9 +20,9 @@ For example, for the image below, we would configure liveness probes for the `we -- [Rancher v1.6 Health Checks](#rancher-v16-health-checks) -- [Rancher v2.x Health Checks](#rancher-v2x-health-checks) -- [Configuring Probes in Rancher v2.x](#configuring-probes-in-rancher-v2x) +- [Rancher v1.6 Health Checks](#rancher-v1-6-health-checks) +- [Rancher v2.x Health Checks](#rancher-v2-x-health-checks) +- [Configuring Probes in Rancher v2.x](#configuring-probes-in-rancher-v2-x) @@ -87,22 +87,21 @@ Configure probes by using the **Health Check** section while editing deployments ![Health Check Section]({{< baseurl >}}/img/rancher/health-check-section.png) -### Configuring Readiness Checks +### Configuring Checks - -While you create a workload using Rancher v2.x, we recommend configuring a readiness check that monitors the health of the deployment's pods. +While you create a workload using Rancher v2.x, we recommend configuring a check that monitors the health of the deployment's pods. {{% tabs %}} -{{% tab "TCP Readiness Check" %}} +{{% tab "TCP Check" %}} -TCP readiness checks monitor your deployment's health by attempting to open a connection to the pod over a specified port. If the probe can open the port, it's considered healthy. Failure to open it is considered unhealthy, which notifies Kubernetes that it should kill the pod and then replace it according to its [restart policy](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy). +TCP checks monitor your deployment's health by attempting to open a connection to the pod over a specified port. If the probe can open the port, it's considered healthy. Failure to open it is considered unhealthy, which notifies Kubernetes that it should kill the pod and then replace it according to its [restart policy](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#restart-policy). (this applies to Liveness probes, for Readiness probes, it will mark the pod as Unready). You can configure the probe along with values for specifying its behavior by selecting the **TCP connection opens successfully** option in the **Health Check** section. For more information, see [Deploying Workloads]({{< baseurl >}}/rancher/v2.x/en/k8s-in-rancher/workloads/deploy-workloads/). For help setting probe timeout and threshold values, see [Health Check Parameter Mappings](#health-check-parameter-mappings). -![TCP Readiness Check]({{< baseurl >}}/img/rancher/readiness-check-tcp.png) +![TCP Check]({{< baseurl >}}/img/rancher/readiness-check-tcp.png) -When you configure a readiness check using Rancher v2.x, the `readinessProbe` directive and the values you've set are added to the deployment's Kubernetes manifest. Configuring a readiness check also automatically adds a liveness check to the deployment. +When you configure a readiness check using Rancher v2.x, the `readinessProbe` directive and the values you've set are added to the deployment's Kubernetes manifest. Configuring a readiness check also automatically adds a liveness check (`livenessProbe`) to the deployment. +![HTTP Check]({{< baseurl >}}/img/rancher/readiness-check-http.png) +When you configure a readiness check using Rancher v2.x, the `readinessProbe` directive and the values you've set are added to the deployment's Kubernetes manifest. Configuring a readiness check also automatically adds a liveness check (`livenessProbe`) to the deployment. {{% /tab %}} @@ -208,4 +174,4 @@ Rancher v1.6 Compose Parameter | Rancher v2.x Kubernetes Parameter `initializing_timeout` | `initialDelaySeconds` `strategy` | `restartPolicy` -### [Next: Schedule Your Services]({{< baseurl >}}/rancher/v2.x/en/v1.6-migration/schedule-workloads/) \ No newline at end of file +### [Next: Schedule Your Services]({{< baseurl >}}/rancher/v2.x/en/v1.6-migration/schedule-workloads/)