whentimeslows/website
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Elaborate the scheme field in httpGet (#5386)

Browse Source
This commit is contained in:
Qiu Jian
2017-09-11 23:58:47 +08:00
committed by Steve Perry
parent 010449ee60
commit be8ea1e37c
1 changed files with 8 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/tasks/configure-pod-container/configure-liveness-readiness-probes.md
+8 -7
View File
@@ -268,7 +268,7 @@ have additional fields that can be set on `httpGet`:
* `host`: Host name to connect to, defaults to the pod IP. You probably want to * `host`: Host name to connect to, defaults to the pod IP. You probably want to
set "Host" in httpHeaders instead. set "Host" in httpHeaders instead.
* `scheme`: Scheme to use for connecting to the host. Defaults to HTTP. * `scheme`: Scheme to use for connecting to the host (HTTP or HTTPS). Defaults to HTTP.
* `path`: Path to access on the HTTP server. * `path`: Path to access on the HTTP server.
* `httpHeaders`: Custom headers to set in the request. HTTP allows repeated headers. * `httpHeaders`: Custom headers to set in the request. HTTP allows repeated headers.
* `port`: Name or number of the port to access on the container. Number must be * `port`: Name or number of the port to access on the container. Number must be
@@ -276,12 +276,13 @@ in the range 1 to 65535.
For an HTTP probe, the kubelet sends an HTTP request to the specified path and For an HTTP probe, the kubelet sends an HTTP request to the specified path and
port to perform the check. The kubelet sends the probe to the container’s IP address, port to perform the check. The kubelet sends the probe to the container’s IP address,
unless the address is overridden by the optional `host` field in `httpGet`. unless the address is overridden by the optional `host` field in `httpGet`. If
In most scenarios, you do not want to set the `host` field. Here's one scenario `scheme` field is set to `HTTPS`, the kubelet sends an HTTPS request skipping the
where you would set it. Suppose the Container listens on 127.0.0.1 and the Pod's certificate verification. In most scenarios, you do not want to set the `host` field.
`hostNetwork` field is true. Then `host`, under `httpGet`, should be set to 127.0.0.1. Here's one scenario where you would set it. Suppose the Container listens on 127.0.0.1
If your pod relies on virtual hosts, which is probably the more common case, and the Pod's `hostNetwork` field is true. Then `host`, under `httpGet`, should be set
you should not use `host`, but rather set the `Host` header in `httpHeaders`. to 127.0.0.1. If your pod relies on virtual hosts, which is probably the more common
case, you should not use `host`, but rather set the `Host` header in `httpHeaders`.
{% endcapture %} {% endcapture %}