Skip to content

Commit 4740c75

Browse files
docs: Adding faqs-gke.md
1 parent 44390f7 commit 4740c75

File tree

1 file changed

+48
-0
lines changed

1 file changed

+48
-0
lines changed
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
## Expose OpenMetadata to the internet with GKE Ingress
2+
To allow access from the internet into your OpenMetadata deployment, you will need to configure a GKE Ingress with proper timeout settings.
3+
4+
GKE Ingress has a default 30-second timeout for backend services. OpenMetadata operations like testing database connections and running ingestion workflows often exceed this limit, causing 502 Bad Gateway errors even though the operations complete successfully on the backend. A BackendConfig resource increases this timeout to prevent these errors.
5+
```
6+
apiVersion: cloud.google.com/v1
7+
kind: BackendConfig
8+
metadata:
9+
name: openmetadata-backendconfig
10+
spec:
11+
timeoutSec: 60 # prevents timeout for operations like test workflows and metadata ingestion
12+
```
13+
Apply the BackendConfig:
14+
```
15+
kubectl apply -f backendConfig.yaml --namespace <kubernetes_namespace>
16+
```
17+
18+
Update the `ingress` and `service.annotations.*` helm values for OpenMetadata to create the ingress and use the BackendConfig. With OpenMetadata Helm Charts, your Helm values would look something like this:
19+
```
20+
ingress:
21+
enabled: true
22+
hosts:
23+
- host: openmetadata.<your-domain>
24+
paths:
25+
- path: /
26+
pathType: Prefix
27+
tls:
28+
- secretName: <your-ssl-secret-name> # Replace with your TLS secret name and make sure it exists in the same namespace
29+
hosts:
30+
- openmetadata.<your-domain>
31+
service:
32+
annotations:
33+
cloud.google.com/backend-config: '{"default": "openmetadata-backendconfig"}'
34+
cloud.google.com/neg: '{"ingress": true}'
35+
```
36+
37+
Once you make the above changes to your helm values, run the below command to install/upgrade helm charts:
38+
```
39+
helm upgrade --install openmetadata-dependencies open-metadata/openmetadata-dependencies --values <path-to-values-file> --namespace <kubernetes_namespace>
40+
helm upgrade --install openmetadata open-metadata/openmetadata --values <path-to-values-file> --namespace <kubernetes_namespace>
41+
```
42+
43+
Wait for a minute and retrieve the IP of the ingress:
44+
```
45+
kubectl get ingress --namespace <kubernetes_namespace>
46+
```
47+
48+
Finally, add the IP to your DNS records.

0 commit comments

Comments
 (0)