Аргументы командной строки#
ANIC поддерживает ряд аргументов командной строки. Способ указания этих аргументов зависит от того, как вы устанавливаете ANIC:
Если вы используете манифесты Kubernetes (Deployment или DaemonSet) для установки ANIC, измените эти манифесты соответствующим образом, чтобы задать аргументы командной строки. См. документацию по установке с манифестами.
Если вы используете Helm для установки ANIC, измените параметры диаграммы Helm, соответствующие аргументам командной строки. См. документацию по установке с помощью Helm.
Ниже в алфавитном порядке перечислены доступные аргументы командной строки: Ресурс ConfigMap для настройки конфигурации Angie. Если ConfigMap задан,
но ANIC не может получить его из API Kubernetes, то
ANIC не запустится. Формат: Включает отладку для Angie. Использует бинарник angie-debug. Требуется
'error-log-level: debug' в ConfigMap. Время ожидания в миллисекундах, в течение которого ANIC
будет ожидать успешной перезагрузки Angie после изменения конфигурации
или при начальном запуске. Значение по умолчанию - 60000. Включает Angie stub_status. По умолчанию Добавляет блоки IP/CIDR в список разрешений для Angie stub_status. Несколько IP или CIDR разделяются запятыми. (По умолчанию
Задает порт, на котором доступен Angie stub_status. Формат: Включает или отключает выдачу статистики Angie в формате Prometheus. Формат: Добавляет блоки IP/CIDR в список разрешений для
статистики Angie в формате Prometheus. Несколько IP или CIDR разделяются запятыми. (По умолчанию
Позволяет менять путь для публикации статистики Angie в формате Prometheus. По умолчанию используется Задает порт, на котором доступна статистика Angie в формате Prometheus. Формат: Секрет с сертификатом TLS и ключом для TLS-терминации на сервере по
умолчанию. Если значение не задано, используются сертификат и ключ в файле
Если Если секрет установлен, но ANIC не может получить его
из API Kubernetes, или же не установлен, и ANIC не
удается прочитать файл Формат: Явно отключает прослушиватели IPV6 для узлов, которые не поддерживают
стек IPV6. По умолчанию Включает автоматическое управление сертификатами x509 для ресурсов
VirtualServer с помощью cert-manager (cert-manager.io). Требует
-enable-custom-resources. Включает пользовательские ресурсы. По умолчанию Включает интеграцию с ExternalDNS для настройки общедоступных записей
DNS у ресурсов VirtualServer с использованием
ExternalDNS. Требует наличия
-enable-custom-resources. Включает функцию аутентификации JWT в ресурсах Policy. По умолчанию Позволяет выбирать лидера, чтобы избежать ситуации, когда несколько
реплик контроллера сообщают о статусе ресурсов Ingress, VirtualServer и
VirtualServerRoute; сообщать о статусе будет только одна реплика. По
умолчанию См. флаг -report-ingress-status. Включает функцию аутентификации по OpenID Connect в ресурсах Policy. По умолчанию Позволяет публиковать метрики Angie в формате Prometheus. Публикует конечную точку Service Insight для ANIC. Включает пользовательские фрагменты конфигурации Angie в ресурсах
Ingress, VirtualServer, VirtualServerRoute и TransportServer. По умолчанию Включает сквозную передачу данных по протоколу TLS на порту 443. Требует наличия
-enable-custom-resources. Указывает имя сервиса с типом LoadBalancer, через который поды ANIC
делаются доступными извне. Внешний адрес сервиса используется
для отчетов о состоянии ресурсов Ingress, VirtualServer и
VirtualServerRoute. Только для ресурсов Ingress: требует наличия
-report-ingress-status. Ресурс GlobalConfiguration для глобальной настройки ANIC. Формат: Требует наличия
-enable-custom-resources. Добавляет местоположение "/angie-health" к серверу по умолчанию.
Местоположение отвечает кодом статуса 200 на любой запрос. Это полезно для внешней проверки работоспособности ANIC. Задает URI местоположения проверки работоспособности на сервере по
умолчанию. Требует наличия
-health-status. По умолчанию Класс ANIC. Должен быть развернут соответствующий ресурс IngressClass с именем,
равным классу. В противном случае ANIC не запустится.
ANIC обрабатывает только те ресурсы, которые принадлежат
его классу, т. е. имеют ресурс поля ANIC обрабатывает все ресурсы, у которых нет поля
По умолчанию Указывает имя ресурса IngressLink, через который предоставляется доступ
к подам ANIC через систему BIG-IP. IP-адрес системы BIG-IP
используется для отчетов о состоянии ресурсов Ingress, VirtualServer и
VirtualServerRoute. Только для ресурсов Ingress: требует наличия
-report-ingress-status. Путь к шаблону конфигурации Ingress Angie для ресурса Ingress. По
умолчанию для Angie используется Указывает в том же пространстве имен, где находится контроллер, имя
ConfigMap, используемое для блокировки при выборе лидера. Требует наличия
-enable-leader-election. Путь к основному шаблону конфигурации Angie. По умолчанию для Angie используется Задает порт, на котором публикуются метрики Prometheus. Формат: Секрет с сертификатом TLS и ключом для TLS-терминации конечной точки
метрик Prometheus. Если аргумент не задан, конечная точка Prometheus не будет
использовать TLS-соединение. Если аргумент задан, но ANIC не может получить секрет
из API Kubernetes, то ANIC не запустится. Задает использование прокси-сервера для подключения к API Kubernetes,
запускаемого командой "kubectl proxy". Только в целях тестирования. ANIC не запускает Angie и не записывает на диск никакие
сгенерированные файлы конфигурации Angie. Включает конечную точку готовности По умолчанию HTTP-порт для конечной точки готовности. Формат: Обновляет поле адреса в статусе ресурсов Ingress. Требуется флаг -external-service или
-ingresslink, либо ключ Задает порт, на котором публикуется Service Insight. Формат: Секрет с сертификатом TLS и ключом для TLS-терминации конечной точки
Service Insight. Если аргумент не задан, конечная точка Service Insight не будет
использовать TLS-соединение. Если аргумент задан, но ANIC не может получить секрет
из API Kubernetes, то ANIC не запустится. Формат: Задает порт для сквозной передачи данных по протоколу TLS. Формат:
Требует включить
-enable-custom-resources. Путь к шаблону конфигурации TransportServer Angie для ресурса
TransportServer. По умолчанию для Angie используется Уровень детализации записи логов. Значение по умолчанию — Выводит версию, хэш git-коммита и дату сборки, затем завершает работу. Путь к шаблону конфигурации VirtualServer Angie для ресурса
VirtualServer. По умолчанию для Angie используется Разделенный запятыми список параметров pattern=N для ведения журнала с
фильтрацией файлов. Разделенный запятыми список пространств имен, за ресурсами которых
должен следить ANIC. По умолчанию ANIC
отслеживает все пространства имен. Нельзя использовать вместе с
"watch-namespace-label". Настраивает в ANIC просмотр только пространств имен с
меткой foo=bar. По умолчанию ANIC отслеживает все
пространства имен. Нельзя использовать вместе с "watch-namespace". Разделенный запятыми список пространств имен, за которыми ANIC
должен следить на предмет наличия секретов. Если этот
параметр не настроен, ANIC отслеживает одни и те же
пространства имен для всех ресурсов. См. также "watch-namespace" и
"watch-namespace-label". Секрет с сертификатом TLS и ключом для TLS-терминации каждого узла
Ingress или VirtualServer, для которого включена TLS-терминация, но
секрет не указан. Если аргумент не задан, для таких узлов Ingress и VirtualServer Angie
прервет любую попытку установить TLS-соединение. Если аргумент задан, но ANIC не может получить секрет
из API Kubernetes, то ANIC не запустится. Формат: -angie-configmaps
<строка>#<пространство имен>/<имя>-angie-debug#
-angie-reload-timeout
<значение>#-angie-status#
true.-angie-status-allow-cidrs
<строка>#127.0.0.1,::1)-angie-status-port
<int>#[1024 - 65535] (по умолчанию 8080)-angie-status-prometheus
<bool>#false или true (по умолчанию true)-angie-status-prometheus-allow-cidrs#
127.0.0.1,::1)-angie-status-prometheus-path
<строка>#/p8s.-angie-status-prometheus-port
<int>#[1024 - 65535] (по умолчанию 8083)-default-server-tls-secret
<строка>#/etc/angie/secrets/default./etc/angie/secrets/default не существует, ANIC
настроит в Angie отклонение TLS-подключений к серверу по умолчанию./etc/angie/secrets/default, то ANIC
не запустится.<пространство имен>/<имя>-disable-ipv6#
false.-enable-cert-manager#
-enable-custom-resources#
true.-enable-external-dns#
-enable-jwt#
false.-enable-leader-election#
true.-enable-oidc#
false.-enable-prometheus-metrics#
-enable-service-insight#
-enable-snippets#
false.-enable-tls-passthrough#
-external-service
<строка>#-global-configuration
<строка>#<пространство имен>/<имя>-health-status#
-health-status-uri
<строка>#/angie-health.-ingress-class
<строка>#ingressClassName, равный классу.ingressClassName.angie.-ingresslink
<строка>#-ingress-template-path
<строка>#angie.ingress.tmpl.-leader-election-lock-name
<строка>#-main-template-path
<строка>#angie.ingress.tmpl.-prometheus-metrics-listen-port
<int>#[1024 - 65535] (по умолчанию 9113)-prometheus-tls-secret
<строка>#-proxy
<строка>#-ready-status#
/angie-ready. Конечная точка
возвращает код успеха, когда Angie загрузил всю конфигурацию после
запуска.true.-ready-status-port#
[1024 - 65535] (по умолчанию 8081)-report-ingress-status#
external-status-address
в ConfigMap.-service-insight-listen-port
<int>#[1024 - 65535] (по умолчанию 9114)-service-insight-tls-secret
<строка>#<пространство имен>/<имя>-tls-passthrough-port
<int>#[1024 - 65535] (по умолчанию 443)-transportserver-template-path
<строка>#angie.transportserver.tmpl.-v
<значение>#1, при этом значении записывается минимальное количество логов. Значение 3 полезно для устранения неполадок.-version#
-virtualserver-template-path
<строка>#angie.ingress.tmpl.-vmodule
<значение>#-watch-namespace
<строка>#-watch-namespace-label
<строка>#-watch-secret-namespace
<строка>#-wildcard-tls-secret
<строка>#<пространство имен>/<имя>