Как настроить Эдж

Чтобы настроить Edge после установки, вы используете комбинацию файлов .properties и утилит Edge. Например, чтобы настроить TLS/SSL в пользовательском интерфейсе Edge, вы редактируете файлы .properties , чтобы задать необходимые свойства. Изменения в файлах .properties требуют перезапуска затронутого компонента Edge.

Apigee называет технику редактирования файлов .properties кодом с конфигурацией (иногда сокращенно CwC). По сути, код с конфигурацией — это инструмент поиска ключей и значений, основанный на настройках в файлах .properties . В коде с конфигурацией ключи называются токенами . Поэтому для настройки Edge вы устанавливаете токены в файлах .properties .

Код с конфигурацией позволяет компонентам Edge устанавливать значения по умолчанию, которые поставляются с продуктом, позволяет команде установки переопределять эти параметры на основе топологии установки, а затем позволяет клиентам переопределять любые выбранные ими свойства.

Если рассматривать это как иерархию, то настройки расположены следующим образом: настройки клиента имеют наивысший приоритет и переопределяют любые настройки команды установщиков или Apigee:

1. Клиент
2. Установщик
3. Компонент

Определить текущую стоимость токена

Прежде чем установить новое значение токена в файле .properties , вам следует сначала определить его текущее значение с помощью следующей команды:

/opt/apigee/apigee-service/bin/apigee-service component_name configure -search token

Где component_name — это имя компонента, а token — это токен для проверки.

Эта команда выполняет поиск в иерархии файлов .properties компонента, чтобы определить текущее значение токена.

В следующем примере проверяется текущее значение токена conf_http_HTTPRequest.line.limit для маршрутизатора:

/opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

Вы должны увидеть вывод, который выглядит следующим образом:

Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties

Если значение токена начинается с # , оно закомментировано, и для его изменения необходимо использовать специальный синтаксис. Дополнительные сведения см. в разделе Установка токена, который в данный момент закомментирован .

Если вы не знаете полное имя токена, используйте такой инструмент, как grep для поиска по имени свойства или ключевому слову. Дополнительные сведения см. в разделе Поиск токена .

Файлы свойств

Существуют редактируемые и нередактируемые файлы конфигурации компонентов. В этом разделе описаны эти файлы.

Редактируемые файлы конфигурации компонентов

В следующей таблице перечислены компоненты Apigee и файлы свойств, которые вы можете редактировать для настройки этих компонентов:

Если вы хотите установить свойство в одном из этих файлов конфигурации компонента, но оно не существует, вы можете создать его в указанном выше месте.

Кроме того, вы должны убедиться, что файл свойств принадлежит пользователю «apigee»:

chown apigee:apigee /opt/apigee/customer/application/configuration_file.properties

Нередактируемые файлы конфигурации компонентов

Помимо редактируемых файлов конфигурации компонентов, существуют также файлы конфигурации, которые редактировать нельзя.

Информационные (нередактируемые) файлы включают в себя следующее:

/opt/apigee/token

/opt/apigee/component_name/conf

Установите значение токена

Вы можете изменять файлы .properties только в каталоге /opt/apigee/customer/application . Каждый компонент имеет свой собственный файл .properties в этом каталоге. Например, router.properties и management-server.properties . Полный список файлов свойств см. в разделе Расположение файлов .properties .

Чтобы создать файл .properties :

1. Создайте новый текстовый файл в редакторе. Имя файла должно соответствовать списку файлов клиентов, приведенному в таблице выше.
2. Измените владельца файла на «apigee:apigee», как показано в следующем примере:

   chown apigee:apigee /opt/apigee/customer/application/router.properties

   Если вы изменили пользователя, который запускает службу Edge, с пользователя «apigee», используйте chown , чтобы изменить владельца на пользователя, который запускает службу Edge.

При обновлении Edge считываются файлы .properties в каталоге /opt/apigee/customer/application . Это означает, что при обновлении будут сохранены все свойства, которые вы установили для компонента.

Чтобы установить значение токена:

1. Отредактируйте файл .properties компонента.
2. Добавьте или измените значение токена. В следующем примере для свойства conf_http_HTTPRequest.line.limit устанавливается значение «10k»:

   conf_http_HTTPRequest.line.limit=10k

   Если токен принимает несколько значений, разделите каждое значение запятой, как показано в следующем примере:

   conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*

   Чтобы добавить новое значение в такой список, вы обычно добавляете новое значение в конец списка.

3. Перезапустите компонент:

   /opt/apigee/apigee-service/bin/apigee-service component_name restart

   Где component_name является одним из следующих:

   • apigee-cassandra (Кассандра)
   • apigee-openldap (OpenLDAP)
   • apigee-postgresql (база данных PostgreSQL)
   • apigee-qpidd (Qpidd)
   • apigee-sso (Edge SSO)
   • apigee-zookeeper (ZooKeeper)
   • edge-management-server (Сервер управления)
   • edge-management-ui (новый пользовательский интерфейс Edge)
   • edge-message-processor (процессор сообщений)
   • edge-postgres-server (сервер Postgres)
   • edge-qpid-server (сервер Qpid)
   • edge-router (Edge Router)
   • edge-ui (классический пользовательский интерфейс)

   Например, после редактирования router.properties перезапустите Маршрутизатор:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart

4. (Необязательно) Убедитесь, что для токена установлено новое значение, используя параметр configure -search . Например:

   /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

   Дополнительные сведения о configure -search см. в разделе Определение текущего значения токена .

Найдите токен

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

Например, если вы знаете, что в предыдущей версии Edge вы установили свойство session.maxAge и хотите узнать значение токена, использованное для его установки, grep это свойство в каталоге /opt/apigee/edge-ui/source :

grep -ri "session.maxAge" /opt/apigee/edge-ui/source

Вы должны увидеть результат в следующем виде:

/opt/apigee/component_name/source/conf/application.conf:property_name={T}token_name{/T}

В следующем примере показано значение токена session.maxAge пользовательского интерфейса:

/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}

Строка между тегами {T}{/T} — это имя токена, который вы можете установить в файле .properties пользовательского интерфейса.

Установите токен, который в данный момент закомментирован

Некоторые токены закомментированы в файлах конфигурации Edge. Если вы попытаетесь установить токен, который закомментирован в файле установки или конфигурации компонента, ваш параметр будет проигнорирован.

Чтобы установить значение токена, закомментированного в файле конфигурации Edge, используйте специальный синтаксис в следующей форме:

conf/filename+propertyName=propertyValue

Например, чтобы установить свойство с именем HTTPClient.proxy.host в процессоре сообщений, сначала grep для свойства, чтобы определить его токен:

grep -ri /opt/apigee/edge-message-processor/ -e "HTTPClient.proxy.host"

Команда grep возвращает результаты, включающие имя токена. Обратите внимание, как имя свойства закомментировано, на что указывает префикс # :

source/conf/http.properties:#HTTPClient.proxy.host={T}conf_http_HTTPClient.proxy.host{/T}
token/default.properties:conf_http_HTTPClient.proxy.host=
conf/http.properties:#HTTPClient.proxy.host=

Чтобы установить значение этого свойства, отредактируйте /opt/apigee/customer/application/message-processor.properties , но используйте специальный синтаксис, как показано в следующем примере:

conf/http.properties+HTTPClient.proxy.host=myhost.name.com

В этом случае вы должны добавить к имени свойства префикс conf/http.properties+ . Это расположение и имя файла конфигурации, содержащего свойство, за которым следует знак «+».

После перезапуска процессора сообщений проверьте файл /opt/apigee/edge-message-processor/conf/http.properties :

cat /opt/apigee/edge-message-processor/conf/http.properties

В конце файла вы увидите набор свойств в виде:

conf/http.properties:HTTPClient.proxy.host=myhost.name.com

Чтобы настроить Edge после установки, вы используете комбинацию файлов .properties и утилит Edge. Например, чтобы настроить TLS/SSL в пользовательском интерфейсе Edge, вы редактируете файлы .properties , чтобы задать необходимые свойства. Изменения в файлах .properties требуют перезапуска затронутого компонента Edge.

Apigee называет технику редактирования файлов .properties кодом с конфигурацией (иногда сокращенно CwC). По сути, код с конфигурацией — это инструмент поиска ключ/значение на основе настроек в файлах .properties . В коде с конфигурацией ключи называются токенами . Поэтому для настройки Edge вы устанавливаете токены в файлах .properties .

Код с конфигурацией позволяет компонентам Edge устанавливать значения по умолчанию, которые поставляются с продуктом, позволяет команде установки переопределять эти параметры на основе топологии установки, а затем позволяет клиентам переопределять любые выбранные ими свойства.

Если рассматривать это как иерархию, то настройки расположены следующим образом: настройки клиента имеют наивысший приоритет и переопределяют любые настройки команды установщиков или Apigee:

1. Клиент
2. Установщик
3. Компонент

Определить текущую стоимость токена

Прежде чем установить новое значение токена в файле .properties , вам следует сначала определить его текущее значение с помощью следующей команды:

/opt/apigee/apigee-service/bin/apigee-service component_name configure -search token

Где component_name — это имя компонента, а token — это токен для проверки.

Эта команда выполняет поиск в иерархии файлов .properties компонента, чтобы определить текущее значение токена.

В следующем примере проверяется текущее значение токена conf_http_HTTPRequest.line.limit для маршрутизатора:

/opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

Вы должны увидеть вывод, который выглядит следующим образом:

Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties

Если значение токена начинается с # , оно закомментировано, и для его изменения необходимо использовать специальный синтаксис. Дополнительные сведения см. в разделе Установка токена, который в данный момент закомментирован .

Если вы не знаете полное имя токена, используйте такой инструмент, как grep для поиска по имени свойства или ключевому слову. Дополнительные сведения см. в разделе Поиск токена .

Файлы свойств

Существуют редактируемые и нередактируемые файлы конфигурации компонентов. В этом разделе описаны эти файлы.

Редактируемые файлы конфигурации компонентов

В следующей таблице перечислены компоненты Apigee и файлы свойств, которые вы можете редактировать для настройки этих компонентов:

Если вы хотите установить свойство в одном из этих файлов конфигурации компонента, но оно не существует, вы можете создать его в указанном выше месте.

Кроме того, вы должны убедиться, что файл свойств принадлежит пользователю «apigee»:

chown apigee:apigee /opt/apigee/customer/application/configuration_file.properties

Нередактируемые файлы конфигурации компонентов

Помимо редактируемых файлов конфигурации компонентов, существуют также файлы конфигурации, которые редактировать нельзя.

Информационные (нередактируемые) файлы включают в себя следующее:

/opt/apigee/token

/opt/apigee/component_name/conf

Установите значение токена

Вы можете изменять файлы .properties только в каталоге /opt/apigee/customer/application . Каждый компонент имеет свой собственный файл .properties в этом каталоге. Например, router.properties и management-server.properties . Полный список файлов свойств см. в разделе Расположение файлов .properties .

Чтобы создать файл .properties :

1. Создайте новый текстовый файл в редакторе. Имя файла должно соответствовать списку файлов клиентов, приведенному в таблице выше.
2. Измените владельца файла на «apigee:apigee», как показано в следующем примере:

   chown apigee:apigee /opt/apigee/customer/application/router.properties

   Если вы изменили пользователя, который запускает службу Edge, с пользователя «apigee», используйте chown , чтобы изменить владельца на пользователя, который запускает службу Edge.

При обновлении Edge считываются файлы .properties в каталоге /opt/apigee/customer/application . Это означает, что при обновлении будут сохранены все свойства, которые вы установили для компонента.

Чтобы установить значение токена:

1. Отредактируйте файл .properties компонента.
2. Добавьте или измените значение токена. В следующем примере для свойства conf_http_HTTPRequest.line.limit устанавливается значение «10k»:

   conf_http_HTTPRequest.line.limit=10k

   Если токен принимает несколько значений, разделите каждое значение запятой, как показано в следующем примере:

   conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*

   Чтобы добавить новое значение в такой список, вы обычно добавляете новое значение в конец списка.

3. Перезапустите компонент:

   /opt/apigee/apigee-service/bin/apigee-service component_name restart

   Где component_name является одним из следующих:

   • apigee-cassandra (Кассандра)
   • apigee-openldap (OpenLDAP)
   • apigee-postgresql (база данных PostgreSQL)
   • apigee-qpidd (Qpidd)
   • apigee-sso (Edge SSO)
   • apigee-zookeeper (ZooKeeper)
   • edge-management-server (Сервер управления)
   • edge-management-ui (новый пользовательский интерфейс Edge)
   • edge-message-processor (процессор сообщений)
   • edge-postgres-server (сервер Postgres)
   • edge-qpid-server (сервер Qpid)
   • edge-router (Edge Router)
   • edge-ui (классический пользовательский интерфейс)

   Например, после редактирования router.properties перезапустите Маршрутизатор:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart

4. (Необязательно) Убедитесь, что для токена установлено новое значение, используя параметр configure -search . Например:

   /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

   Дополнительные сведения о configure -search см. в разделе Определение текущего значения токена .

Найдите токен

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

Например, если вы знаете, что в предыдущей версии Edge вы установили свойство session.maxAge и хотите узнать значение токена, использованное для его установки, grep это свойство в каталоге /opt/apigee/edge-ui/source :

grep -ri "session.maxAge" /opt/apigee/edge-ui/source

Вы должны увидеть результат в следующем виде:

/opt/apigee/component_name/source/conf/application.conf:property_name={T}token_name{/T}

В следующем примере показано значение токена session.maxAge пользовательского интерфейса:

/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}

Строка между тегами {T}{/T} — это имя токена, который вы можете установить в файле .properties пользовательского интерфейса.

Установите токен, который в данный момент закомментирован

Некоторые токены закомментированы в файлах конфигурации Edge. Если вы попытаетесь установить токен, закомментированный в файле установки или конфигурации компонента, ваш параметр будет проигнорирован.

Чтобы установить значение токена, закомментированного в файле конфигурации Edge, используйте специальный синтаксис в следующей форме:

conf/filename+propertyName=propertyValue

Например, чтобы установить свойство с именем HTTPClient.proxy.host в процессоре сообщений, сначала grep для свойства, чтобы определить его токен:

grep -ri /opt/apigee/edge-message-processor/ -e "HTTPClient.proxy.host"

Команда grep возвращает результаты, включающие имя токена. Обратите внимание, как имя свойства закомментировано, на что указывает префикс # :

source/conf/http.properties:#HTTPClient.proxy.host={T}conf_http_HTTPClient.proxy.host{/T}
token/default.properties:conf_http_HTTPClient.proxy.host=
conf/http.properties:#HTTPClient.proxy.host=

Чтобы установить значение этого свойства, отредактируйте /opt/apigee/customer/application/message-processor.properties , но используйте специальный синтаксис, как показано в следующем примере:

conf/http.properties+HTTPClient.proxy.host=myhost.name.com

В этом случае вы должны добавить к имени свойства префикс conf/http.properties+ . Это расположение и имя файла конфигурации, содержащего свойство, за которым следует знак «+».

После перезапуска процессора сообщений проверьте файл /opt/apigee/edge-message-processor/conf/http.properties :

cat /opt/apigee/edge-message-processor/conf/http.properties

В конце файла вы увидите набор свойств в виде:

conf/http.properties:HTTPClient.proxy.host=myhost.name.com