API Gateway: архитектура и лучшие практики

# Установка Kong
docker pull kong:latest

# Запуск Kong
docker run -d --name kong-database \
  -p 5432:5432 \
  -e "POSTGRES_USER=kong" \
  -e "POSTGRES_PASSWORD=kong" \
  postgres:13

docker run -d --name kong \
  --link kong-database:kong-database \
  -e "KONG_DATABASE=postgres" \
  -e "KONG_PG_HOST=kong-database" \
  -p 8000:8000 \
  -p 8443:8443 \
  -p 8001:8001 \
  kong:latest

# Создание Service
curl -i -X POST http://localhost:8001/services/ \
  --data "name=user-service" \
  --data "url=http://user-service:3000"

# Создание Route
curl -i -X POST http://localhost:8001/services/user-service/routes \
  --data "hosts[]=api.example.com" \
  --data "paths[]=/api/users"

# Добавление плагина Rate Limiting
curl -i -X POST http://localhost:8001/services/user-service/plugins \
  --data "name=rate-limiting" \
  --data "config.minute=100"

# nginx.conf
upstream user_service {
    server user-service-1:3000;
    server user-service-2:3000;
}

upstream order_service {
    server order-service:3000;
}

server {
    listen 80;
    server_name api.example.com;

    # Rate limiting
    limit_req_zone $binary_remote_addr zone=api_limit:10m rate=10r/s;

    location /api/users {
        limit_req zone=api_limit burst=20;
        
        # Аутентификация через заголовки
        auth_request /auth;
        
        proxy_pass http://user_service;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }

    location /api/orders {
        limit_req zone=api_limit burst=20;
        proxy_pass http://order_service;
    }

    # Аутентификация
    location = /auth {
        internal;
        proxy_pass http://auth-service:3000/validate;
        proxy_pass_request_body off;
        proxy_set_header Content-Length "";
        proxy_set_header X-Original-URI $request_uri;
    }
}

{
  "swagger": "2.0",
  "info": {
    "title": "User API",
    "version": "1.0"
  },
  "paths": {
    "/users": {
      "get": {
        "x-amazon-apigateway-integration": {
          "type": "http_proxy",
          "httpMethod": "GET",
          "uri": "http://user-service:3000/users",
          "responses": {
            "default": {
              "statusCode": "200"
            }
          }
        }
      },
      "post": {
        "x-amazon-apigateway-integration": {
          "type": "http_proxy",
          "httpMethod": "POST",
          "uri": "http://user-service:3000/users"
        }
      }
    }
  }
}

# Структура BFF
mobile-api.example.com → Mobile BFF → Микросервисы
web-api.example.com    → Web BFF    → Микросервисы
admin-api.example.com  → Admin BFF  → Микросервисы

// Клиент делает один запрос
GET /api/user-profile/123

// API Gateway запрашивает данные из нескольких сервисов
// и агрегирует их
{
  user: await userService.getUser(123),
  orders: await orderService.getOrders(123),
  preferences: await prefService.getPreferences(123)
}

# nginx.conf с Mock API
server {
    listen 80;
    server_name api.example.com;

    # Режим разработки - используем Mock API
    set $use_mock "false";
    if ($arg_mode = "mock") {
        set $use_mock "true";
    }

    location /api/users {
        if ($use_mock = "true") {
            proxy_pass http://mock-api:3000/api/users;
            break;
        }
        proxy_pass http://user-service:3000/users;
    }
}

# Kong с Mock API
curl -i -X POST http://localhost:8001/services/ \
  --data "name=mock-user-service" \
  --data "url=http://mock-api:3000/api/users"

# Переключение между реальным и mock сервисом
# через переменные окружения или флаги
if (process.env.USE_MOCK === 'true') {
  routeToMockService();
} else {
  routeToRealService();
}