Какие объекты нужны чтобы задеплоить Node.js приложение в Kubernetes

Архитектура деплоя Node.js приложения в Kubernetes

Для эффективного деплоя Node.js приложения в Kubernetes требуется несколько ключевых объектов, которые образуют полноценную архитектуру развертывания. Вот основные компоненты с объяснениями и примерами:

1. Основные объекты Kubernetes

Pod

Минимальная и неделимая единица развертывания в Kubernetes. Для Node.js приложения Pod содержит один или несколько контейнеров.

apiVersion: v1
kind: Pod
metadata:
  name: nodejs-app
  labels:
    app: nodejs-app
spec:
  containers:
  - name: nodejs-container
    image: your-registry/nodejs-app:latest
    ports:
    - containerPort: 3000
    env:
    - name: NODE_ENV
      value: "production"

Deployment

Наиболее важный объект для управления развертыванием приложения. Обеспечивает декларативное обновление, масштабирование и откат приложений.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nodejs-deployment
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nodejs-app
  template:
    metadata:
      labels:
        app: nodejs-app
    spec:
      containers:
      - name: nodejs
        image: node:18-alpine
        command: ["node", "server.js"]
        ports:
        - containerPort: 3000
        resources:
          requests:
            memory: "256Mi"
            cpu: "250m"
          limits:
            memory: "512Mi"
            cpu: "500m"

2. Объекты для сетевого доступа

Service

Обеспечивает стабильную конечную точку для доступа к группе Pod. Существует несколько типов:

• ClusterIP (по умолчанию) - внутренний IP внутри кластера
• NodePort - делает приложение доступным через статический порт на каждом узле
• LoadBalancer - создает внешний балансировщик нагрузки в облачных провайдерах

apiVersion: v1
kind: Service
metadata:
  name: nodejs-service
spec:
  selector:
    app: nodejs-app
  ports:
  - protocol: TCP
    port: 80
    targetPort: 3000
  type: LoadBalancer

Ingress

Управляет внешним доступом к сервисам через HTTP/HTTPS, обеспечивает маршрутизацию, SSL-терминацию и виртуальные хосты.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nodejs-ingress
  annotations:
    nginx.ingress.kubernetes.io/rewrite-target: /
spec:
  rules:
  - host: app.yourdomain.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: nodejs-service
            port:
              number: 80

3. Объекты для конфигурации и хранения

ConfigMap

Позволяет отделить конфигурацию от образа приложения. Хранит конфигурационные данные в формате ключ-значение.

apiVersion: v1
kind: ConfigMap
metadata:
  name: nodejs-config
data:
  NODE_ENV: "production"
  LOG_LEVEL: "info"
  DATABASE_URL: "postgresql://user:pass@db:5432/app"

Secret

Аналогичен ConfigMap, но предназначен для хранения конфиденциальных данных (пароли, токены, ключи) в закодированном виде.

apiVersion: v1
kind: Secret
metadata:
  name: nodejs-secrets
type: Opaque
data:
  jwt-secret: c3VwZXItc2VjcmV0LWtleQ==  # base64 encoded
  api-key: YW5vdGhlci1zZWNyZXQ=

4. Дополнительные объекты для production-среды

HorizontalPodAutoscaler (HPA)

Автоматически масштабирует количество Pod'ов на основе метрик использования CPU, памяти или custom-метрик.

apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
  name: nodejs-hpa
spec:
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: nodejs-deployment
  minReplicas: 2
  maxReplicas: 10
  metrics:
  - type: Resource
    resource:
      name: cpu
      target:
        type: Utilization
        averageUtilization: 70

PersistentVolumeClaim (PVC)

Запрашивает хранилище для приложения, если Node.js приложению требуется постоянное хранение данных.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: nodejs-storage
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi

5. Лучшие практики и рекомендации

Структура манифестов:

• Используйте Kustomize или Helm для управления конфигурациями
• Разделяйте манифесты по окружениям (dev, staging, production)
• Применяйте labels и annotations для организации ресурсов

Безопасность:

• Используйте SecurityContext для ограничения прав контейнеров
• Настройте NetworkPolicies для контроля сетевого трафика
• Регулярно обновляйте базовые образы Node.js

Мониторинг и логирование:

• Добавьте livenessProbe и readinessProbe в контейнеры
• Интегрируйте с Prometheus для сбора метрик
• Настройте централизованное логирование через Fluentd или аналоги

Пример полной конфигурации Deployment с пробами:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nodejs-app
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nodejs-app
  template:
    metadata:
      labels:
        app: nodejs-app
    spec:
      containers:
      - name: nodejs
        image: your-registry/nodejs-app:v1.0.0
        ports:
        - containerPort: 3000
        envFrom:
        - configMapRef:
            name: nodejs-config
        - secretRef:
            name: nodejs-secrets
        livenessProbe:
          httpGet:
            path: /health
            port: 3000
          initialDelaySeconds: 30
          periodSeconds: 10
        readinessProbe:
          httpGet:
            path: /ready
            port: 3000
          initialDelaySeconds: 5
          periodSeconds: 5

Эта архитектура обеспечивает отказоустойчивость, масштабируемость и безопасность Node.js приложения в Kubernetes. Ключевые моменты: начинайте с базового Deployment и Service, добавляйте ConfigMap/Secret для конфигурации, используйте Ingress для внешнего доступа, и внедряйте HPA и пробы для production-готовности.