IKuznetsov: Новая страница: «Контейнер АктивногоШлюза можно настроить в некоторой степени с помощью методов, специф...»

2025-05-25T21:19:43Z

Новая страница: «Контейнер АктивногоШлюза можно настроить в некоторой степени с помощью методов, специф...»

Новая страница

Контейнер АктивногоШлюза можно настроить в некоторой степени с помощью методов, специфичных для контейнера, через переменные или секреты. Более продвинутые настройки требуют предоставления файла АктивногоШлюза <code>custom.properties</code>.

См. '''Расширенная конфигурация''' (ниже), чтобы узнать, как использовать механизмы '''Kubernetes''', например, сопоставить <code>ConfigMap</code> с <code>custom.properties</code>.
{| class="wikitable"
|Конфиденциальная информация
Для обеспечения безопасности необходимо передать конфиденциальную информацию в контейнер АктивногоШлюза в файле, содержащем секрет.
|}

== Конфигурация среды ==
Образ контейнера АктивногоШлюза не содержит никакой конфигурации, связанной с вашей средой.

Ниже приведены обязательные параметры конфигурации, необходимые для работы контейнера АктивногоШлюза.

=== Конечные точки связи ===
Это разделенный запятыми список конечных точек связи, которые АктивныйШлюз будет использовать для отправки данных в вашу среду Ключ-АСТРОМ.

Чтобы определить конечные точки, используйте информацию о подключении '''GET''' для АктивногоШлюза в API Ключ-АСТРОМ.

'''необходимо''' Переменная окружения - <code>KA_SERVER</code>

=== Идентификатор среды ===
Идентификатор среды Ключ-АСТРОМ.

'''необходимо''' Переменная окружения - <code>KA_TENANT</code>

=== Токен ===
Токен используется ЕдинымАгентом и АктивнымШлюзом для передачи данных в Ключ-АСТРОМ.

Ключ-АСТРОМ автоматически генерирует токен для вашего АктивногоШлюза.

Чтобы определить токен, используйте информацию о подключении '''GET''' для АктивногоШлюза в API Ключ-АСТРОМ.

'''необходимо''' Секрет файл - <code>/var/lib/astromkey/secrets/tokens/tenant-token</code>

=== Токен АктивногоШлюза ===
Для авторизации в кластере Ключ-АСТРОМ АктивномуШлюзу требуется уникальный токен АктивногоШлюза.

'''необходимо''' Секрет файл - <code>/var/lib/astromkey/secrets/tokens/auth-token</code>

== Настройки развертывания ==

=== Группа активации ===
Определяет группу АктивногоШлюза, к которой принадлежит АктивныйШлюз.

АктивныйШлюз может принадлежать только к одной группе. Имя группы АктивногоШлюза представляет собой строку из буквенно-цифровых символов, дефисов (<code>-</code>), подчеркиваний (<code>_</code>) и точек (<code>.</code>). Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени группы. Длина строки ограничена 256 символами. Вы можете использовать группы АктивныхШлюзов для выполнения массовых действий на ваших АктивныхШлюзах, таких как управление '''расширениями 2.0,''' работающими на АктивныхШлюзах.
{| class="wikitable"
!Переменная окружения
!Пример
|-
|<code>KA_GROUP</code>
|<code>myGroup</code>
|}

=== Сетевая зона ===
Определяет сетевую зону, к которой принадлежит АктивныйШлюз.

АктивныйШлюз может принадлежать только к одной сетевой зоне. Имя сетевой зоны представляет собой строку из буквенно-цифровых символов, дефисов (<code>-</code>), подчеркиваний (<code>_</code>) и точек (<code>.</code>). Точки используются в качестве разделителей, поэтому вы не должны использовать точку в качестве первого символа имени сетевой зоны. Длина строки ограничена 256 символами.
{| class="wikitable"
!Переменная окружения
!Пример
|-
|<code>KA_NETWORK_ZONE</code>
|<code>myNetworkZone</code>
|}

== Включенные модули ==
Контейнеризованный АктивныйШлюз не включает никаких функций по умолчанию. Включенные модули должны быть указаны с помощью переменной окружения <code>KA_CAPABILITIES</code>. Добавьте разделенный запятыми список имен модулей в качестве значения переменной.
{| class="wikitable"
!Переменная окружения
!Пример
|-
|<code>KA_CAPABILITIES</code>
|<code>azure_monitoring,MSGrouter</code>
|}
Обычно следует ссылаться на имена разделов <code>custom.properties</code> как на имена модулей, например, <code>cloudfoundry_monitoring</code>.

Исключением из этого правила являются следующие модули, которые хранятся в разделе <code>[collector]</code>.

* <code>MSGrouter</code>— Включает маршрутизацию сообщений
* <code>restInterface</code>— Включает модуль REST API
* <code>java-script-agent-servlet</code>— Включает агент JavaScript

{| class="wikitable"
|'''Не все модули поддерживаются'''

Не все модули поддерживаются в развернутых контейнерах.
|}

== Настройки сети ==

=== Прокси ===
Прокси-сервер, используемый для связи с кластером Ключ-АСТРОМ, на который АктивныйШлюз отправляет данные.
{| class="wikitable"
!Секрет файл
!Описание
|-
|<code>/var/lib/astromkey/secrets/internal-proxy/host</code>
|Адрес сервера.
|-
|<code>/var/lib/astromkey/secrets/internal-proxy/port</code>
|'''необязательный''' Порт. Если оставить пустым, будет использоваться порт по умолчанию 8080.
|-
|<code>/var/lib/astromkey/secrets/internal-proxy/scheme</code>
|<code>АктивныйШлюз версии 1.289+</code>

'''необязательный''' Схема. Если оставить пустым, будет использоваться схема <code>http</code> по умолчанию. Это относится к наиболее распространенной настройке, когда соединение с прокси инициируется с помощью HTTP и автоматически обновляется до защищенного. Все дальнейшие коммуникации АктивногоШлюза через прокси защищены с помощью '''SSL/TLS'''.

Необходимо установить <code>https</code> для прокси-серверов, которые вообще не поддерживают HTTP.
|-
|<code>/var/lib/astromkey/secrets/internal-proxy/username</code>
|'''необязательный''' Имя пользователя.
|-
|<code>/var/lib/astromkey/secrets/internal-proxy/password</code>
|'''необязательный''' Пароль см. в разделе Требования к паролю прокси-сервера (ниже).
|}

==== Расширенные сценарии ====
Для более сложных сценариев, где один или несколько прокси используются для средств, отличных от связи с кластером Ключ-АСТСТРОМ, см. [[Настройка прокси АктивногоШлюза|Настройка прокси для АктивногоШлюза]]. После создания необходимой конфигурации вы можете предоставить ее контейнеру АктивногоШлюза в виде файла '''custom.properties'''.

==== Требования к паролю прокси-сервера ====
Пароль прокси-сервера должен соответствовать следующим требованиям.
{| class="wikitable"
!Требования
!Соответствующие символы
|-
|Разрешенные символы
|[А-За-з0-9]

<nowiki>! " # $ ( ) * - . / : ; < > ? @ [ ] ^ _ { | }</nowiki>
|-
|Недопустимые символы
|пробел

' ` , & = + % \
|}

=== Балансировщик нагрузки между АктивнымШлюзом и ЕдинымАгентом ===
ЕдиныйАгент Ключ-АСТРОМ обращается к АктивномуШлюзу через список автоматически обнаруженных конечных точек. Если на пути от ЕдиногоАгента к АктивномуШлюзу размещен балансировщик нагрузки, например '''Kubernetes Service''', вам необходимо указать конечную точку, которая будет использоваться ЕдинымАгентом.
{| class="wikitable"
!Переменная окружения
!Пример значения
|-
|<code>KA_DNS_ENTRY_POINT</code>
|<code><nowiki>https://sg1.mydomain.com:9999</nowiki></code>
|}

=== Балансировщик нагрузки между АктивнымШлюзом и кластером Клюбч-АСТРОМ ===
Обратный прокси или балансировщик нагрузки можно разместить на пути от АктивногоШлюза к кластеру Ключ-АСТРОМ. Это позволяет вашему АктивномуШлюзу подключаться к любому доступному узлу кластера, распределяя нагрузку между узлами.

Для этого вам необходимо:

* Указать адрес обратного прокси-сервера/балансировщика нагрузки.
* Убедиться, что АктивныйШлюз будет игнорировать любую дальнейшую информацию о целевом адресе, отправленную из кластера Ключ-АСТРОМ, и, таким образом, будет подключаться только к указанному вами адресу.

[[Файл:Rev-proxy-001-1000-f7d875625b.png|граница]]

В этом сценарии вам необходимо установить следующие переменные среды.
{| class="wikitable"
!Переменная окружения
!Пример значения
|-
|<code>KA_SERVER</code>
|<code><nowiki>https://load.balancer.com:9999</nowiki></code>
|-
|<code>KA_IGNORE_CLUSTER_RUNTIME_INFO</code>
|<code>true</code>
|}

== Настройки SSL ==

=== Пользовательский SSL-сертификат ===
АктивныйШлюз будет обслуживать пользовательский сертификат вместо сертификата по умолчанию. Для настройки вам понадобится файл в формате <code>PKCS#12</code>, содержащем закрытый ключ и соответствующую ему цепочку сертификатов. Для получения дополнительной информации см. [[Конфигурация АктивногоШлюза|Пользовательский сертификат SSL для АктивногоШлюза]].
{| class="wikitable"
!Секрет файл
!Описание
|-
|<code>/var/lib/astromkey/secrets/tls/server.p12</code>
|Файл сертификата
|-
|<code>/var/lib/astromkey/secrets/tls/password</code>
|'''необязательно''' Пароль сертификата
|-
|<code>/var/lib/astromkey/secrets/tls/alias</code>
|'''необязательно''' Название сертификата. Значение должно быть указано в нижнем регистре.
|}

=== Доверенные корневые сертификаты ===
АктивныйШлюз может использовать дополнительные доверенные корневые сертификаты. Для настройки вам понадобится файл в формате <code>PEM</code>, содержащем список сертификатов, которые необходимо включить в хранилище доверия. Для получения дополнительной информации см. [[Доверенные корневые сертификаты для АктивногоШлюза]].
{| class="wikitable"
!Секрет файл
!Описание
|-
|<code>/var/lib/astromkey/secrets/rootca/rootca.pem</code>
|Файл сертификата
|}

=== HTTP-порт ===
Контейнер АктивногоШлюза по умолчанию открывает порт '''HTTPS''' <code>9999</code>. Если вам необходимо, чтобы ваш АктивныйШлюз взаимодействовал по простому HTTP, вам необходимо указать этот порт HTTP.
{| class="wikitable"
!Переменная окружения
!Пример
|-
|<code>KA_HTTP_PORT</code>
|<code>8888</code>
|}

== Расширенная конфигурация ==
Помимо параметров конфигурации, передаваемых через переменные среды или файлы, вы можете настроить все остальные параметры конфигурации, указав содержимое файла <code>custom.properties</code>.

# Определять <code>ConfigMap</code>. <code>kind: ConfigMap</code> <code>apiVersion: v1</code> <code>data:</code> <code> custom.properties: |-</code> <code> [vmware_monitoring]</code> <code> vmware_monitoring_enabled = true</code> <code>metadata:</code> <code> name: vmware-config</code> <code> namespace: astromkey</code>
# Ссылка <code>ConfigMap</code> в вашем файле развертывания. <code>[...]</code> <code> volumeMounts:</code> <code> [...]</code> <code> - name: ag-conf</code> <code> mountPath: /var/lib/astromkey/gateway/config_template/custom.properties</code> <code> subPath: custom.properties</code> <code>[...]</code> <code> volumes:</code> <code> - name: ag-conf</code> <code> configMap:</code> <code> name: vmware-config</code> <code> items:</code> <code> - key: custom.properties</code> <code> path: custom.properties</code>

Конфигурация АктивныхШлюзов - История изменений

IKuznetsov: Новая страница: «Контейнер АктивногоШлюза можно настроить в некоторой степени с помощью методов, специф...»