Урок 6.1: Основы тестирования

Навигация: Обзор модуля Следующий урок: Модульное тестирование с envtest →

Введение

Тестирование операторов критически важно для надёжности и уверенности в продакшене. Операторы управляют критически важной инфраструктурой, поэтому исчерпывающее тестирование необходимо. Этот урок охватывает основы тестирования, стратегии тестирования и инструменты, которые вы будете использовать для тестирования операторов Kubernetes.

Зачем тестировать операторы?

Операторы управляют критически важными ресурсами:

graph TB
    OPERATOR[Operator] --> CRITICAL[Critical Resources]
    
    CRITICAL --> DATABASES[Databases]
    CRITICAL --> STORAGE[Storage]
    CRITICAL --> NETWORKING[Networking]
    CRITICAL --> SECURITY[Security]
    
    TESTING[Testing] --> CONFIDENCE[Confidence]
    TESTING --> RELIABILITY[Reliability]
    TESTING --> SAFETY[Safety]
    
    style OPERATOR fill:#FFB6C1
    style TESTING fill:#90EE90

Преимущества:

  • Ловить баги до продакшена
  • Обеспечивать корректность согласования
  • Проверять граничные случаи
  • Обеспечивать безопасный рефакторинг
  • Документировать ожидаемое поведение

Пирамида тестирования для операторов 

graph TB
    PYRAMID[Testing Pyramid]
    
    PYRAMID --> UNIT[Unit Tests<br/>Many, Fast]
    PYRAMID --> INTEGRATION[Integration Tests<br/>Some, Slower]
    PYRAMID --> E2E[End-to-End Tests<br/>Few, Slowest]
    
    UNIT --> LOGIC[Test Logic]
    UNIT --> FUNCTIONS[Test Functions]
    
    INTEGRATION --> CLUSTER[Test with Cluster]
    INTEGRATION --> RESOURCES[Test Resources]
    
    E2E --> SCENARIOS[Test Scenarios]
    E2E --> WORKFLOWS[Test Workflows]
    
    style UNIT fill:#90EE90
    style INTEGRATION fill:#FFE4B5
    style E2E fill:#FFB6C1

Стратегии тестирования

Стратегия 1: модульное тестирование

Тестируйте отдельные функции и логику:

flowchart LR
    UNIT[Unit Test] --> FUNCTION[Function]
    FUNCTION --> MOCK[Mock Dependencies]
    MOCK --> ASSERT[Assert Results]
    
    style UNIT fill:#90EE90

Используйте для:

  • Логики согласования
  • Вспомогательных функций
  • Логики валидации
  • Функций преобразования

Стратегия 2: интеграционное тестирование

Тестируйте с реальным API Kubernetes:

flowchart LR
    INTEGRATION[Integration Test] --> CLUSTER[Test Cluster]
    CLUSTER --> API[Kubernetes API]
    API --> RESOURCES[Create Resources]
    RESOURCES --> VERIFY[Verify State]
    
    style INTEGRATION fill:#FFE4B5

Используйте для:

  • Сквозных (end-to-end) рабочих процессов
  • Создания/обновления ресурсов
  • Поведения вебхуков
  • Взаимодействия контроллеров

Стратегия 3: сквозное тестирование (E2E)

Тестируйте полные сценарии:

flowchart LR
    E2E[E2E Test] --> SCENARIO[Scenario]
    SCENARIO --> OPERATOR[Run Operator]
    OPERATOR --> CLUSTER[Real Cluster]
    CLUSTER --> VERIFY[Verify Results]
    
    style E2E fill:#FFB6C1

Используйте для:

  • Полных пользовательских рабочих процессов
  • Сценариев, приближенных к продакшену
  • Тестирования производительности
  • Регрессионного тестирования

Инструменты тестирования

envtest

Назначение: легковесный API-сервер Kubernetes для модульного тестирования

graph TB
    ENVTEST[envtest]
    
    ENVTEST --> API[Kubernetes API Server]
    ENVTEST --> ETCD[etcd]
    
    API --> TEST[Your Tests]
    ETCD --> TEST
    
    style ENVTEST fill:#90EE90

Возможности:

  • Не нужен полноценный кластер
  • Быстрое выполнение тестов
  • Изолированная тестовая среда
  • Реальный API Kubernetes

Ginkgo и Gomega

Назначение: фреймворк тестирования в стиле BDD

graph TB
    GINKGO[Ginkgo/Gomega]
    
    GINKGO --> BDD[BDD Style]
    GINKGO --> MATCHERS[Rich Matchers]
    GINKGO --> STRUCTURE[Test Structure]
    
    style GINKGO fill:#90EE90

Возможности:

  • Описательная структура тестов
  • Богатая библиотека утверждений (assertions)
  • Параллельное выполнение тестов
  • Организация тестов

Отладчик Delve

Назначение: Go-отладчик для операторов

graph TB
    DELVE[Delve]
    
    DELVE --> BREAKPOINTS[Breakpoints]
    DELVE --> INSPECT[Inspect Variables]
    DELVE --> STEP[Step Through Code]
    
    style DELVE fill:#FFB6C1

Возможности:

  • Установка точек останова (breakpoints)
  • Просмотр переменных
  • Пошаговое выполнение кода
  • Отладка запущенных операторов

Структура теста

Базовая структура теста 

func TestReconcile(t *testing.T) {
    // Arrange: Set up test environment
    // Act: Execute the function
    // Assert: Verify results
}

Тесты, управляемые таблицей (table-driven) 

func TestReconcile(t *testing.T) {
    tests := []struct {
        name    string
        input   *Database
        want    ctrl.Result
        wantErr bool
    }{
        {
            name: "successful reconciliation",
            input: &Database{...},
            want: ctrl.Result{},
            wantErr: false,
        },
        // More test cases...
    }
    
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            // Test logic
        })
    }
}

Цели по покрытию тестами 

graph LR
    COVERAGE[Test Coverage]
    
    COVERAGE --> HIGH[High Coverage]
    COVERAGE --> CRITICAL[Critical Paths]
    COVERAGE --> EDGE[Edge Cases]
    
    HIGH --> 80[80%+]
    CRITICAL --> 100[100%]
    EDGE --> ALL[All Cases]
    
    style HIGH fill:#90EE90
    style CRITICAL fill:#FFB6C1

Целевые показатели:

  • Общее: покрытие 80%+
  • Критические пути: покрытие 100%
  • Граничные случаи: все покрыты
  • Пути ошибок: все протестированы

Ключевые выводы

  • Тестирование необходимо для надёжности оператора
  • Модульные тесты быстрые и проверяют логику
  • Интеграционные тесты тестируют с реальным API Kubernetes
  • E2E-тесты тестируют полные сценарии
  • envtest предоставляет легковесный API Kubernetes
  • Ginkgo/Gomega обеспечивают тестирование в стиле BDD
  • Delve позволяет отлаживать операторы
  • Тесты, управляемые таблицей, организуют тестовые случаи
  • Стремитесь к покрытию 80%+ со 100% на критических путях

Что нужно понимать для создания операторов

При тестировании операторов:

  • Пишите модульные тесты для всей логики
  • Используйте интеграционные тесты для рабочих процессов
  • Тестируйте случаи ошибок и граничные случаи
  • Используйте тесты, управляемые таблицей, для множества сценариев
  • Стремитесь к высокому покрытию
  • Тестируйте в изоляции, когда это возможно
  • Используйте реальный API Kubernetes для интеграционных тестов

Связанная лабораторная работа

Источники

Официальная документация

Дополнительное чтение

Смежные темы

Дальнейшие шаги

Теперь, когда вы понимаете основы тестирования, давайте настроим envtest и напишем модульные тесты.

Навигация: ← Обзор модуля Далее: Модульное тестирование с envtest →