Skip to main content

​
Deployment Overview

MCP Gateway supports deployment in Kubernetes clusters, suitable for large-scale production environments. K8s deployment has the following advantages:

High Availability

Supports multi-replica deployment with automatic failover

Elastic Scaling

Automatically adjusts instance count based on load

Service Discovery

Automatic service registration and load balancing

​
Deployment Architecture

Recommended to use microservice architecture for K8s deployment:

​
Quick Start

​
Deploy with kubectl

1

Download Deployment Files

Download all K8s related deployment files from GitHub:
# Clone project or download deployment file directory
git clone https://github.com/AmoyLab/Unla.git
cd Unla/deploy/k8s/multi
2

Create Namespace

kubectl apply -f .
3

Deploy Dependency Services

# Deploy database and other dependency services
kubectl apply -f deps
4

Deploy Application Base Services

# Deploy core application services
kubectl apply -f base
5

Deploy Gateway Service (Choose One)

Choose the appropriate gateway based on your environment:Using Traefik:
kubectl apply -f traefik
Or using Nginx Ingress:
kubectl apply -f ingress
This deployment method supports multi-replica high availability deployment. Other custom configurations can be adjusted in the downloaded YAML files.

​
Troubleshooting

​
Common Issues

Check if ConfigMap and Secret configurations are correct:
kubectl describe pod <pod-name> -n mcp-gateway
kubectl logs <pod-name> -n mcp-gateway
Verify database service and connection configuration:
kubectl get svc -n mcp-gateway
kubectl exec -it <pod-name> -n mcp-gateway -- nc -zv postgres 5432
Check Service and network policies:
kubectl get svc,endpoints -n mcp-gateway
kubectl describe networkpolicy -n mcp-gateway

​
Contribution Guide

We welcome community contributions to improve Kubernetes deployment documentation and configuration files! If you have experience or suggestions, please:
  1. Visit the GitHub project
  2. Submit Issues or Pull Requests
  3. Share your deployment experience
Your contributions will help more users successfully deploy MCP Gateway in K8s environments! ❤️
⌘I