Operations¶
This section covers operational aspects of running the Cloudflare Tunnel Gateway Controller in production.
Overview¶
Operating the controller effectively requires understanding:
- Common issues and how to troubleshoot them
- Metrics and alerting for proactive monitoring
- Alternative installation methods for special environments
Sections¶
-
Troubleshooting
Common issues, debugging techniques, and solutions.
-
Metrics & Alerting
Prometheus metrics reference and alerting rules.
-
Manual Installation
Installation without Helm for special requirements.
Quick Diagnostics¶
Check controller health:
# Controller logs
kubectl logs --selector app.kubernetes.io/name=cloudflare-tunnel-gateway-controller \
--namespace cloudflare-tunnel-system
# Gateway status
kubectl get gateway cloudflare-tunnel --namespace cloudflare-tunnel-system \
--output jsonpath='{.status.conditions}'
# HTTPRoute status
kubectl get httproute --all-namespaces \
--output custom-columns='NAMESPACE:.metadata.namespace,NAME:.metadata.name,ACCEPTED:.status.parents[*].conditions[?(@.type=="Accepted")].status'
Production Checklist¶
- Leader election enabled for HA deployments
- Resource limits configured
- Prometheus ServiceMonitor deployed
- Alerting rules configured
- Log aggregation set up
- Backup strategy for GatewayClassConfig secrets