Переменные окружения FAST-ноды

Для изменения настроек FAST-ноды используются различные параметры. Их значения можно изменять, задавая переменные окружения FAST-ноды с соответствующими именами.

Менять значения переменных окружения и передавать их FAST-ноде можно:

  • Через опцию -e:

      docker run --name <имя контейнера> \
      -e <переменная окружения 1>=<значение> \
      ... 
      -e <переменная окружения N>=<значение> \
      -p <порт для публикации>:8080 wallarm/fast
    
  • Через опцию --env-file, которой передается путь до файла с переменными окружения:

      docker run --name <имя> \
      --env-file=<файл с переменными среды окружения> \
      -p <порт для публикации>:8080 wallarm/fast
    

    Внутри файла переменные окружения перечисляются построчно:

      # Пример файла с переменными окружения
    
      WALLARM_API_TOKEN=token_Qwe12345            # Демонстрационное значение — используйте полученный вами токен
      ALLOWED_HOSTS=google-gruyere.appspot.com    # Хост, запросы к которому будут записываться в набор запросов
    

В таблице ниже приведены параметры, которые вы можете использовать.

Параметр Значение Обязателен
WALLARM_API_TOKEN Токен, полученный ранее в облаке Валарм. Да
WALLARM_API_HOST Адрес используемого API-сервера Валарм.
Возможные значения:
us1.api.wallarm.com — для американского облака;
api.wallarm.com — для европейского облака;
api.wallarm.ru — для российского облака.
Да
ALLOWED_HOSTS Перечень хостов целевого приложения, запросы к которым будут записаны в набор запросов.
По умолчанию записываются все запросы.
Подробнее здесь.
Нет
WALLARM_API_USE_SSL Использовать SSL-соединение при подключении к API Валарм.
Возможные значения: true, false.
По умолчанию: true.
Нет
WORKERS Количество потоков, извлекающих базовые запросы из набора запросов и выполняющих тесты безопасности.
По умолчанию: 10.
Нет
GIT_EXTENSIONS Ссылка на Git-репозиторий с DSL-расширениями (должен быть доступен из контейнера FAST-ноды) Нет
CI_MODE Режим работы FAST-ноды при внедрении в рабочие процеccы CI/CD.
Возможные значения:
recording — для режима записи;
testing — для режима тестирования.
Нет
BACKEND_HTTPS_PORTS Порт(ы) протокола HTTPS для целевого приложения, если используе(ю)тся нестандартный(е) порт(ы).
Доступно перечисление нескольких портов:
BACKEND_HTTPS_PORTS='443;3000;8091'
По умолчанию: 443
Нет
WALLARM_API_CA_VERIFY Производить валидацию API Валарм (проверка CA-сертификата).
Возможные значения: true, false.
По умолчанию: false.
Нет
CA_CERT Расположение CA-сертификата FAST-ноды.
По умолчанию: /etc/nginx/ssl/nginx.crt.
Нет
CA_KEY Расположение CA-ключа FAST-ноды.
По умолчанию: /etc/nginx/ssl/nginx.key.
Нет

Ограничение записываемых запросов

По умолчанию FAST-нода расценивает все поступившие запросы как базовые — она осуществляет их запись, создает и выполняет тестовые запросы на их основе. Однако через FAST-ноду при включенном проксировании может проходить большое количество запросов, не являющихся базовыми запросами к целевому приложению.

Вы можете ограничить количество записываемых запросов при помощи отсечения всех входящих запросов, не являющихся базовыми. Это позволит ускорить процесс тестирования с помощью FAST и снизить нагрузку на FAST-ноду и целевое приложение. Для этого вам необходимо знать, с какими хостами, относящимся к целевому приложению, взаимодействует источник запросов в процессе тестирования. Отсечь все не-базовые запросы, можно, задав значение переменной среды окружения ALLOWED_HOSTS.

Допустимые значения переменной ALLOWED_HOSTS

Переменная ALLOWED_HOSTS может принимать значения хостов в следующих форматах:

  • полные имена (например, node.example.local)
  • значение, начинающееся с точки (например, .example.local), которое распознается как множество всех поддоменов домена, указанного после первой точки
  • значение *, которому соответствует любой хост (в этом случае, все полученные запросы будут записаны FAST-нодой)
  • набор из нескольких значений, например: "(node.example.local|example.com)"
  • регулярное выражение в формате, описанном в документации NGINX

Более подробная информация о значениях переменной ALLOWED_HOSTS доступна по ссылке.

FAST-нода работает с переменной ALLOWED_HOSTS следующим образом:

  • Если заголовок Host поступившего запроса соответствует значению переменной ALLOWED_HOSTS, считать запрос базовым. Такой запрос записывается и проксируется.
  • Для всех других запросов: запись не выполняется, они только проксируются.

Пример использования переменной ALLOWED_HOSTS

Если переменная определена как ALLOWED_HOSTS=google-gruyere.appspot.com, то базовыми запросами будут считаться те запросы, которые предназначены для домена google-gruyere.appspot.com

results matching ""

    No results matching ""