Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X. Информация
25 октября 2023 г. мы выпустили новую версию Apigee Edge для частного облака.
Примечание. Эта версия будет поддерживаться до 25 октября 2024 г.
Как обновить
В этом разделе описано, как установить этот выпуск, если вы обновляете предыдущий выпуск Edge для частного облака. Если вам нужно обновить более раннюю версию, ознакомьтесь с разделом Как применить несколько версий исправлений.
После обновления этой версии будут обновлены компоненты в следующих RPM-пакетах:
- edge-gateway-4.52.00-0.0.60200.noarch.rpm
- edge-management-server-4.52.00-0.0.60200.noarch.rpm
- edge-message-processor-4.52.00-0.0.60200.noarch.rpm
- edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
- edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
- edge-router-4.52.00-0.0.60200.noarch.rpm
- apigee-sso-4.52.00-0.0.21316.noarch.rpm
- edge-analytics-4.52.00-0.0.40100.noarch.rpm
- edge-management-ui-4.52.00-0.0.20029.noarch.rpm
- edge-ui-4.52.00-0.0.20233.noarch.rpm
- apigee-service-4.52.00-0.0.1500.noarch.rpm
- apigee-mirror-4.52.00-0.0.1032.noarch.rpm
- apigee-tomcat-9.0.82-0.0.939.noarch.rpm
- apigee-configutil-4.52.00-0.0.624.noarch.rpm
Чтобы проверить, нужно ли обновить установленные версии RPM, введите:
apigee-all version
Чтобы обновить установку, выполните следующие действия на узлах Edge:
-
На всех узлах Edge:
- Очистите репозитории Yum:
sudo yum clean all
- Скачайте последний файл Edge 4.52.00
bootstrap_4.52.00.shв папку/tmp/bootstrap_4.52.00.sh:curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
- Установите утилиту Edge 4.52.00
apigee-serviceи зависимости:sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
где uName и pWord – имя пользователя и пароль, полученные от Apigee. Если вы не укажете pWord, вам будет предложено ввести его.
- Чтобы выполнить скрипт apigee-service.sh, используйте команду
source:source /etc/profile.d/apigee-service.sh
- Очистите репозитории Yum:
- На всех пограничных узлах выполните скрипт
update.shдля пограничного процесса:/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Выполните скрипт
update.shдля SSO на всех узлах: - На всех узлах интерфейса выполните скрипт
update.shдля интерфейса:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- Если вы используете новый интерфейс Edge, выполните следующую команду:
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
Устранены проблемы с безопасностью
Ниже перечислены известные проблемы безопасности, которые были устранены в этой версии. Чтобы избежать этих проблем, установите последнюю версию Edge для частного облака.| Идентификатор проблемы | Описание |
|---|---|
| 279065506 | В URL переадресации для OAuth2 улучшена энтропия параметра состояния, чтобы сделать его непредсказуемым и избежать уязвимости межсайтового запроса (CSRF)". |
| 279065586 | Добавлены политики безопасности контента в заголовке, чтобы обеспечить дополнительный уровень защиты сайтов от клиентских атак. |
Изменения в поддерживаемом ПО
Добавлена поддержка следующих версий ПО:
- Red Hat Enterprise Linux (Intel 64-bit): версия 8.8
- Oracle Linux (Intel 64-bit): версии 7.9, 8.7 и 8.8.
- Rocky Linux 8
- Tomcat 9.0.82
Полный список поддерживаемого ПО приведен в разделе Поддерживаемое ПО для Edge Private Cloud.
Прекращение поддержки
В этом выпуске нет новых объявлений об устаревании или прекращении поддержки.
Новые функции
В этом выпуске представлены следующие новые функции:
Как задать максимальное количество символов для названий организаций и сред
В этом выпуске можно ограничить максимальное количество символов в названиях организаций и сред при их создании. Значение по умолчанию для максимального количества символов – 255. Чтобы задать более низкое максимальное значение, укажите следующие свойства в соответствующих файлах свойств:
- В файле свойств организации задайте значение
org.name.max.length. - В файле свойств организации задайте значение
env.name.max.length.
Если для какого-либо из этих свойств задано значение меньше 0 или больше 255, система будет использовать максимальное значение 1 или 255 соответственно.
Как задать срок действия токенов доступа
В этом выпуске вы можете задать срок действия токенов доступа, указав нужное время в миллисекундах в свойстве conf_keymanagement_oauth_access_token_expiry_time_in_millis. По умолчанию эта функция отключена. Чтобы включить эту функцию, задайте для параметра conf_keymanagement_oauth_access_token_is_apply_limit значение true в Message Processor.
Эта функция позволяет администраторам Apigee лучше контролировать срок действия токенов доступа, созданных в Apigee.
Исправлены ошибки.
В этом разделе перечислены ошибки личного облака, исправленные в этой версии.
| Идентификатор проблемы | Описание |
|---|---|
| 290242749 |
Если переменная |
| 260397807 |
Проблема с шаблонами писем, из-за которой в письмах не отправлялись многобайтовые символы. Теперь эта неполадка устранена. |
| 234544436 |
Исправлена проблема, из-за которой при переключении между организациями в новом интерфейсе Edge исчезало меню слева. Теперь эта неполадка устранена. |
| 293268203 |
Зависимости Аналитики не обновлялись автоматически на узлах сервера управления. Теперь эта неполадка устранена. |
| 261616264 |
Добавлена проверка начальной загрузки, чтобы убедиться, что postgresql не удаляется в процессе обновления. |
| 279065586 |
В URL переадресации для OAuth2 улучшена энтропия параметра состояния, чтобы сделать его непредсказуемым и избежать уязвимости подделки межсайтовых запросов (CSRF). |
| 283310836 |
Улучшено сообщение об ошибке при обработке больших XML-файлов. |
| 245936798 |
Из-за проблемы с названиями организаций и сред выполнения запросы Postgresql <code<create< code="" dir="ltr" translate="no">не выполнялись.</code<create<> Эта проблема была устранена за счет улучшения обработки конфликтов названий индексов postgres для длинных названий организаций и сред. |
| 293733533 |
Сторонняя библиотека Spring в компонентах шлюза Edge обновлена с версии 5.3.20 до версии 5.3.27. |
| 294363158 |
Из-за регрессии в раскрывающихся меню на страницах аналитики и мониторинга интерфейса Edge появлялись дополнительные параметры. Теперь эта неполадка устранена. |
| 297889765 |
Артефакты, созданные с помощью apigee-mirror, теперь имеют правильного владельца. |
| 294989027 |
Улучшена производительность некоторых API статистики. |
Известные проблемы
Полный список известных проблем с Edge для частного облака можно найти в этой статье.
Как применить несколько версий исправлений
В этом разделе описано, как применить несколько версий исправлений, если вы обновляете более раннюю версию Edge для частного облака, чем предыдущая версия исправлений.
Каждый патч содержит обновления для определенных компонентов Edge для частного облака, например:
edge-management-server.
Чтобы применить несколько версий исправлений, необходимо обновить каждый компонент Edge, который был включен в выпуск исправлений позже установленной версии. Чтобы найти эти компоненты, ознакомьтесь с примечаниями к выпуску Edge для частного облака для всех версий, более поздних, чем ваша текущая, и проверьте список RPM для этих выпусков. Ссылки на все примечания к выпуску Edge для частного облака можно найти в примечаниях к выпуску Apigee.
Примечание. Каждый компонент нужно обновить только один раз, установив RPM для последней версии компонента, включенной в выпуски исправлений. Чтобы обновить компонент, следуйте инструкциям в примечаниях к выпуску этой версии.
Примечание. При обновлении компонента автоматически устанавливается последняя версия исправления. Если вы хотите перейти на версию исправления, которая не является последней, вам нужно создать собственную копию репозитория Apigee в формате tarball с помощью зеркала Apigee и использовать это зеркало для установки Apigee. Дополнительную информацию можно найти в статье Как использовать локальный репозиторий Edge для поддержки версии Edge.