File tree Expand file tree Collapse file tree 5 files changed +21
-1
lines changed Expand file tree Collapse file tree 5 files changed +21
-1
lines changed Original file line number Diff line number Diff line change @@ -107,6 +107,10 @@ can run the following command:
107
107
docker buildx imagetools inspect ghcr.io/nginxinc/nginx-kubernetes-gateway:edge --format ' {{ json (index .SBOM "linux/amd64").SPDX }}' | grype
108
108
```
109
109
110
+ ## Troubleshooting
111
+
112
+ For troubleshooting help, see the [ Troubleshooting] ( /docs/troubleshooting.md ) document.
113
+
110
114
## Contacts
111
115
112
116
We’d like to hear your feedback! If you experience issues with our Gateway Controller, please [ open a bug] [ bug ] in
Original file line number Diff line number Diff line change 72
72
periodSeconds : 1
73
73
{{- end }}
74
74
securityContext :
75
- allowPrivilegeEscalation : false
75
+ allowPrivilegeEscalation : {{ .Values.nginxGateway.securityContext.allowPrivilegeEscalation }}
76
76
capabilities :
77
77
add :
78
78
- KILL
Original file line number Diff line number Diff line change @@ -30,6 +30,10 @@ nginxGateway:
30
30
tag : edge
31
31
pullPolicy : Always
32
32
33
+ securityContext :
34
+ # # Some environments may need this set to true in order for the control plane to successfully reload NGINX.
35
+ allowPrivilegeEscalation : false
36
+
33
37
nginx :
34
38
# # The NGINX image to use
35
39
image :
Original file line number Diff line number Diff line change @@ -18,6 +18,7 @@ yourself.
18
18
- [ CLI Help] ( cli-help.md ) : Describes the commands available in the ` gateway ` binary of ` nginx-kubernetes-gateway `
19
19
container.
20
20
- [ Monitoring] ( monitoring.md ) : Information on monitoring NGINX Kubernetes Gateway using Prometheus metrics.
21
+ - [ Troubleshooting] ( troubleshooting.md ) : Troubleshooting guide for common or known issues.
21
22
22
23
### Directories
23
24
Original file line number Diff line number Diff line change
1
+ # Troubleshooting
2
+
3
+ This document contains common or known issues and how to troubleshoot them.
4
+
5
+ ## failed to reload NGINX: failed to send the HUP signal to NGINX main: operation not permitted
6
+
7
+ Depending on your environment's configuration, the control plane may not have the proper permissions to reload
8
+ NGINX. If NGINX configuration is not applied and you see the above error in the ` nginx-gateway ` logs, you will need
9
+ to set ` allowPrivilegeEscalation ` to ` true ` . If using Helm, you can set the
10
+ ` nginxGateway.securityContext.allowPrivilegeEscalation ` value.
11
+ If using the manifests directly, you can update this field under the ` nginx-gateway ` container's ` securityContext ` .
You can’t perform that action at this time.
0 commit comments