Документация Тестовой Среды: Руководство по Конфигурации, Зависимостям и Управлению

# Спецификация Инфраструктуры Тестовой Среды
# Среда: STAGING
# Последнее Обновление: Октябрь 2025

инфраструктура:
  облачный_провайдер: AWS
  регион: us-east-1
  зоны_доступности:
    - us-east-1a
    - us-east-1b

  вычисления:
    веб_серверы:
      тип: EC2
      тип_инстанса: t3.large
      количество: 2
      ос: Amazon Linux 2
      авто_масштабирование:
        мин: 2
        макс: 6
        целевой_cpu: 70%

    серверы_приложений:
      тип: ECS Fargate
      cpu: 2048
      память: 4096
      задачи: 4
      образ_контейнера: app-staging:latest

    пакетная_обработка:
      тип: EC2
      тип_инстанса: m5.xlarge
      количество: 1
      расписание: "0 2 * * *"  # 2 часа ночи ежедневно

  хранилище:
    база_данных:
      тип: RDS PostgreSQL
      версия: 13.7
      класс_инстанса: db.r5.large
      хранилище: 500GB SSD
      multi_az: true
      срок_хранения_бэкапов: 7 дней

    объектное_хранилище:
      тип: S3
      бакеты:
        - имя: staging-uploads
          версионирование: включено
          жизненный_цикл: 90 дней
        - имя: staging-reports
          шифрование: AES256

    кэш:
      тип: ElastiCache Redis
      версия: 6.2
      тип_узла: cache.m5.large
      узлы: 2
      режим_кластера: включен

  сеть:
    vpc:
      cidr: 10.0.0.0/16
      подсети:
        публичные:
          - 10.0.1.0/24
          - 10.0.2.0/24
        приватные:
          - 10.0.10.0/24
          - 10.0.11.0/24

    балансировщик_нагрузки:
      тип: Application Load Balancer
      схема: internet-facing
      ssl_сертификат: arn:aws:acm:staging-cert

    cdn:
      провайдер: CloudFront
      поведения:
        - путь: /api/*
          кэш: отключен
        - путь: /static/*
          кэш: 86400  # 24 часа

{
  "среда": "staging",
  "приложение": {
    "название": "система-управления-заказами",
    "версия": "2.3.1",
    "фреймворк": "Spring Boot 2.7",
    "версия_java": "11",
    "инструмент_сборки": "Maven 3.8"
  },
  "конфигурации": {
    "сервер": {
      "порт": 8080,
      "контекстный_путь": "/api",
      "таймаут_сессии": 1800,
      "макс_потоков": 200,
      "таймаут_соединения": 30000
    },
    "база_данных": {
      "url": "jdbc:postgresql://staging-db.aws.com:5432/заказы",
      "размер_пула": 20,
      "таймаут_простоя": 600000,
      "таймаут_соединения": 30000,
      "порог_обнаружения_утечек": 60000
    },
    "обмен_сообщениями": {
      "брокер": "rabbitmq://staging-mq.aws.com",
      "очереди": [
        "заказ.создан",
        "заказ.обработан",
        "инвентарь.обновлен"
      ],
      "предвыборка": 10,
      "попытки_повтора": 3
    },
    "кэш": {
      "провайдер": "Redis",
      "ttl": 3600,
      "макс_записей": 10000
    },
    "логирование": {
      "уровень": "INFO",
      "паттерн": "%d{ISO8601} [%thread] %-5level %logger{36} - %msg%n",
      "файл": "/var/log/app/application.log",
      "макс_размер": "100MB",
      "макс_история": 30
    },
    "мониторинг": {
      "эндпоинт_метрик": "/actuator/metrics",
      "эндпоинт_здоровья": "/actuator/health",
      "prometheus_включен": true,
      "пользовательские_метрики": [
        "заказ.время.обработки",
        "платеж.коэффициент.успеха"
      ]
    }
  }
}

# Интеграция со Сторонними Сервисами

## Платежный Шлюз (Stripe)
- **Эндпоинт**: https://api.stripe.com/v1
- **Аутентификация**: Bearer токен (Секретный Ключ)
- **Тестовые Учетные Данные**:
  - Публичный Ключ: pk_test_51H4kL9...
  - Секретный Ключ: sk_test_51H4kL9...
- **Тестовые Карты**:
  - Успех: 4242 4242 4242 4242
  - Отклонение: 4000 0000 0000 0002
  - 3D Secure: 4000 0027 6000 3184
- **Вебхуки**:
  - URL: https://staging.app.com/webhooks/stripe
  - События: payment_intent.succeeded, payment_intent.failed
- **Лимиты Запросов**: 100 запросов/секунду
- **Мониторинг**: https://dashboard.stripe.com/test/logs

## Email Сервис (SendGrid)
- **SMTP Сервер**: smtp.sendgrid.net:587
- **API Эндпоинт**: https://api.sendgrid.com/v3
- **Аутентификация**: API Ключ
- **Тестовые Учетные Данные**:
  - API Ключ: SG.test_key_staging_environment
- **Шаблоны**:
  - Подтверждение Заказа: d-template-001
  - Сброс Пароля: d-template-002
- **Лимиты Запросов**: 100 email/секунду
- **Обработка Отказов**: Вебхук на /webhooks/sendgrid
- **Мониторинг**: https://app.sendgrid.com/statistics

## SMS Шлюз (Twilio)
- **API Эндпоинт**: https://api.twilio.com/2010-04-01
- **Account SID**: AC_test_staging_account
- **Auth Токен**: auth_token_staging
- **Тестовые Номера**:
  - От: +1234567890
  - Магические номера для тестирования:
    - +15005550001: Недействительный
    - +15005550006: Действительный
- **Лимиты Запросов**: 1 сообщение/секунду
- **Callback URL**: https://staging.app.com/webhooks/twilio

# Контроль Доступа к Тестовой Среде

## Уровни Доступа

### Уровень 1: Только Чтение
- Просмотр логов приложения
- Мониторинг дашбордов
- Запросы чтения к базе данных
- Не может изменять никакие данные

### Уровень 2: Разработчик
- Все разрешения Уровня 1
- Развертывание кода приложения
- Изменение конфигурации приложения
- Выполнение исправлений данных (с одобрением)

### Уровень 3: Администратор
- Все разрешения Уровня 2
- Перезапуск сервисов
- Изменение инфраструктуры
- Прямая запись в базу данных

## Назначения Доступа по Командам

| Команда | Среда | Уровень Доступа | Требуется VPN | Требуется MFA |
|---------|-------|-----------------|---------------|---------------|
| Разработка | DEV | Администратор | Нет | Нет |
| Разработка | INT | Разработчик | Да | Нет |
| Разработка | STAGING | Только Чтение | Да | Да |
| QA | DEV | Разработчик | Нет | Нет |
| QA | INT | Администратор | Да | Нет |
| QA | STAGING | Разработчик | Да | Да |
| DevOps | ВСЕ | Администратор | Да | Да |
| Поддержка | STAGING | Только Чтение | Да | Да |
| Управление | STAGING | Только Чтение | Да | Да |

## Процесс Запроса Доступа

1. Отправить тикет в JIRA (шаблон ENV-ACCESS)
2. Указать: Среда, Требуемый Уровень, Бизнес-Обоснование
3. Требуется одобрение менеджера для Уровня 2+
4. Проверка командой безопасности для доступа к STAGING
5. Автоматическая выдача прав после одобрения
6. Доступ проверяется ежеквартально
7. Автоматический отзыв после 90 дней неактивности

#!/bin/bash
# Скрипт Ротации Учетных Данных
# Запускать ежемесячно или по требованию

# Расположение Учетных Данных Среды Staging
# AWS Secrets Manager: arn:aws:secretsmanager:staging-secrets

# Учетные Данные Базы Данных
DB_SECRET="staging/rds/postgresql/master"
aws secretsmanager rotate-secret --secret-id $DB_SECRET

# API Ключи Приложения
declare -a API_KEYS=(
  "staging/stripe/api-key"
  "staging/sendgrid/api-key"
  "staging/twilio/auth-token"
  "staging/datadog/api-key"
)

for key in "${API_KEYS[@]}"; do
  echo "Ротация: $key"
  aws secretsmanager rotate-secret --secret-id $key
  sleep 5  # Избежать ограничения скорости
done

# Ротация SSH Ключей
ssh-keygen -t rsa -b 4096 -f ~/.ssh/staging_new -N ""
# Развертывание нового публичного ключа на серверы
ansible-playbook -i staging rotate-ssh-keys.yml

# Проверка Обновления Сертификата
openssl x509 -enddate -noout -in /certs/staging.crt
# Автоматическое обновление, если истекает в течение 30 дней

echo "Ротация учетных данных завершена: $(date)"

-- Процедура Обновления Тестовых Данных
-- Выполнять во время окна обслуживания

-- Шаг 1: Резервное копирование текущих тестовых данных
CALL backup_schema('staging_backup_20251008');

-- Шаг 2: Санитизация производственных данных
CREATE TEMP TABLE санитизированные_клиенты AS
SELECT
  клиент_id,
  CONCAT('Test_', SUBSTRING(MD5(email), 1, 8)) as email,
  CONCAT('Пользователь_', клиент_id) as имя,
  '555-0100' as телефон,
  DIGEST(ssn, 'sha256') as ssn_hash,
  дата_создания,
  статус
FROM производство.клиенты
WHERE дата_создания > CURRENT_DATE - INTERVAL '90 days'
LIMIT 10000;

-- Шаг 3: Маскировка чувствительных финансовых данных
UPDATE санитизированные_клиенты
SET кредитная_карта = CONCAT('****-****-****-', RIGHT(кредитная_карта, 4));

-- Шаг 4: Генерация синтетических транзакций
INSERT INTO staging.заказы (клиент_id, дата_заказа, итого, статус)
SELECT
  клиент_id,
  CURRENT_DATE - (random() * 30)::int,
  (random() * 1000 + 50)::numeric(10,2),
  CASE
    WHEN random() < 0.7 THEN 'завершен'
    WHEN random() < 0.9 THEN 'обрабатывается'
    ELSE 'отменен'
  END
FROM санитизированные_клиенты
CROSS JOIN generate_series(1, 5);

-- Шаг 5: Проверка целостности данных
SELECT
  'Клиенты' as сущность,
  COUNT(*) as количество_записей,
  COUNT(DISTINCT клиент_id) as количество_уникальных
FROM staging.клиенты
UNION ALL
SELECT
  'Заказы',
  COUNT(*),
  COUNT(DISTINCT заказ_id)
FROM staging.заказы;

# Стандартные Наборы Тестовых Данных

наборы_тестовых_данных:
  дымовой_тест:
    описание: "Минимальные данные для дымового тестирования"
    клиенты: 10
    продукты: 50
    заказы: 100
    время_загрузки: "< 1 минуты"

  регрессионный_тест:
    описание: "Полные данные для регрессионного тестирования"
    клиенты: 1000
    продукты: 500
    заказы: 10000
    исторические_месяцы: 6
    время_загрузки: "10 минут"

  тест_производительности:
    описание: "Большой набор данных для тестирования производительности"
    клиенты: 100000
    продукты: 10000
    заказы: 1000000
    исторические_месяцы: 12
    время_загрузки: "2 часа"
    включает:
      - Сценарии пиковой нагрузки
      - Симуляции параллельных пользователей
      - Обработка больших пакетов

  граничные_случаи:
    описание: "Специальные сценарии и граничные случаи"
    сценарии:
      - Unicode символы в именах
      - Максимальные длины полей
      - Null/пустые значения
      - Специальные символы в адресах
      - Границы часовых поясов
      - Даты високосного года
      - Пределы точности валюты

# Конфигурация Мониторинга - Среда Staging

мониторинг:
  prometheus:
    эндпоинт: http://prometheus-staging:9090
    интервал_сбора: 30s
    хранение: 15d

  grafana:
    url: https://grafana-staging.internal
    дашборды:
      - Обзор Инфраструктуры
      - Метрики Приложения
      - Производительность Базы Данных
      - Времена Ответа API

  оповещения:
    - название: Высокое Использование CPU
      условие: использование_cpu > 80%
      продолжительность: 5m
      серьезность: предупреждение
      уведомить: [slack, email]

    - название: Пул Подключений БД Исчерпан
      условие: доступные_соединения < 2
      продолжительность: 1m
      серьезность: критический
      уведомить: [pagerduty, slack]

    - название: Деградация Времени Ответа API
      условие: p95_время_ответа > 3s
      продолжительность: 10m
      серьезность: предупреждение
      уведомить: [slack]

    - название: Мало Дискового Пространства
      условие: использованный_диск_процент > 85%
      продолжительность: 5m
      серьезность: предупреждение
      уведомить: [email]

проверки_работоспособности:
  приложение:
    эндпоинт: /health
    интервал: 30s
    таймаут: 5s
    ожидаемый_статус: 200

  база_данных:
    запрос: "SELECT 1"
    интервал: 60s
    таймаут: 3s

  кэш:
    команда: "PING"
    интервал: 30s
    ожидаемый_ответ: "PONG"

  внешние_сервисы:
    - название: Платежный Шлюз
      эндпоинт: https://api.stripe.com/health
      интервал: 5m

    - название: Email Сервис
      эндпоинт: https://api.sendgrid.com/health
      интервал: 5m

<!DOCTYPE html>
<html>
<head>
    <title>Статус Среды Staging</title>
    <style>
        .сетка-статуса {
            display: grid;
            grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
            gap: 20px;
            padding: 20px;
        }
        .карточка-сервиса {
            border: 1px solid #ddd;
            border-radius: 8px;
            padding: 15px;
        }
        .статус-здоровый { color: green; }
        .статус-деградированный { color: orange; }
        .статус-недоступен { color: red; }
        .метрика {
            display: flex;
            justify-content: space-between;
            margin: 5px 0;
        }
    </style>
</head>
<body>
    <h1>Дашборд Статуса Среды Staging</h1>

    <div class="сетка-статуса">
        <div class="карточка-сервиса">
            <h3>Сервер Приложения</h3>
            <div class="статус-здоровый">● Здоровый</div>
            <div class="метрика">
                <span>Использование CPU:</span><span>45%</span>
            </div>
            <div class="метрика">
                <span>Память:</span><span>2.8/4.0 ГБ</span>
            </div>
            <div class="метрика">
                <span>Активные Потоки:</span><span>127/200</span>
            </div>
            <div class="метрика">
                <span>Время Ответа:</span><span>234мс</span>
            </div>
        </div>

        <div class="карточка-сервиса">
            <h3>База Данных</h3>
            <div class="статус-здоровый">● Здоровый</div>
            <div class="метрика">
                <span>Соединения:</span><span>15/20</span>
            </div>
            <div class="метрика">
                <span>Время Запроса:</span><span>12мс сред</span>
            </div>
            <div class="метрика">
                <span>Использовано Хранилища:</span><span>287/500 ГБ</span>
            </div>
            <div class="метрика">
                <span>Задержка Репликации:</span><span>0.3с</span>
            </div>
        </div>

        <div class="карточка-сервиса">
            <h3>Очередь Сообщений</h3>
            <div class="статус-деградированный">● Деградирован</div>
            <div class="метрика">
                <span>Глубина Очереди:</span><span>1,247</span>
            </div>
            <div class="метрика">
                <span>Скорость Обработки:</span><span>120/сек</span>
            </div>
            <div class="метрика">
                <span>Частота Ошибок:</span><span>0.2%</span>
            </div>
            <div class="метрика">
                <span>Задержка Потребителя:</span><span>5 мин</span>
            </div>
        </div>
    </div>

    <script>
        // Автообновление каждые 30 секунд
        setTimeout(() => location.reload(), 30000);
    </script>
</body>
</html>

# Чек-лист Развертывания Staging

## Перед Развертыванием
- [ ] Код-ревью завершено и одобрено
- [ ] Все тесты проходят в CI/CD конвейере
- [ ] Миграции базы данных проверены DBA
- [ ] Сканирование безопасности завершено (нет критических уязвимостей)
- [ ] Оценено влияние на производительность
- [ ] План отката документирован
- [ ] Стейкхолдеры уведомлены об окне развертывания

## Шаги Развертывания
1. [ ] Создать резервную копию текущего развертывания
   ```bash
   kubectl create backup staging-backup-$(date +%Y%m%d)

SELECT query, calls, mean_time, max_time
FROM pg_stat_statements
ORDER BY mean_time DESC LIMIT 10;

jmap -heap <pid>
jstat -gcutil <pid> 1000 10

rabbitmqctl list_queues name messages_ready messages_unacknowledged