Skip to content

Commit 4164533

Browse files
authored
Merge pull request #98 from packagist/docs/kubernetes-troubleshooting-docs
Add reverse-proxy troubleshooting section to Kubernetes docs
2 parents b2a2e05 + 26d384b commit 4164533

File tree

1 file changed

+25
-0
lines changed

1 file changed

+25
-0
lines changed

docs/self-hosted/kubernetes-troubleshooting.md

+25
Original file line numberDiff line numberDiff line change
@@ -36,3 +36,28 @@ System.
3636
> a year. As Private Packagist only allows a time-drift of up to one (1) minute, we
3737
> recommend using TOTP devices that have the ability to stay synchronized with
3838
> the correct time (such as a phone, or re-programmable TOTP hardware devices).
39+
40+
#### Issues with Reverse-Proxy running in front of the Kubernetes Cluster
41+
42+
Please follow the instructions below, if you are experiencing problems with the reverse-proxy not being able to connect to
43+
the cluster and encountering errors like this:
44+
```
45+
Peer closed connection in SSL handshake (104: Connection reset by peer) while SSL handshaking to upstream
46+
```
47+
48+
The following examples assume you are using nginx as a reverse-proxy. Please consult the documentation of other
49+
reverse-proxy servers to achieve the same result.
50+
51+
Ensure that the SNI (Server Name Indication) TLS Extension is properly set for requests to the ingress controller of the Kubernetes Cluster.
52+
This is not the case when using IPs in `proxy_pass` and will result in an SSL handshake error.
53+
54+
To pass the SNI hostname from the incoming request to the upstream server, add the following directives to nginx:
55+
```
56+
proxy_ssl_name $host;
57+
proxy_ssl_server_name on;
58+
```
59+
60+
If you are using different hostnames on the upstream and on the reverse-proxy, set the value in the
61+
`proxy_ssl_name` directive to the corresponding hostname of the upstream server.
62+
63+

0 commit comments

Comments
 (0)