16.4.05 — Примечания к выпуску Edge для частного облака

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X.
информация

Во вторник, 31 мая 2016 г., мы выпустили новую версию Apigee Edge для частного облака.

Со времени предыдущего выпуска функции Edge for Private Cloud (4.16.01) были выпущены следующие выпуски, которые включены в этот выпуск функции:

См. раздел «Нумерация выпусков» , чтобы понять, как определить, включен ли конкретный облачный выпуск в вашу версию Edge для частного облака.

Новые функции и улучшения

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

Дополнительные сведения и инструкции см. в документации Edge for Private Cloud.

Руководства по установке и эксплуатации перенесены в Интернет

Теперь вы можете получить доступ к руководству по установке и эксплуатации Edge для частного облака в версии 4.18.01 .

Обновления программного обеспечения

В выпуск включены следующие обновления программного обеспечения:

  • Java JDK 1.8 . Чтобы воспользоваться преимуществами новейших функций Java, этот выпуск совместим с Java 1.8. В вашей среде требуется Oracle JDK 1.8 или OpenJDK 8.
    В рамках обновления Java 8 некоторые шифры TLS больше не доступны в Oracle JDK 1.8. Полный список см. в разделе «Наборы шифров, отключенные по умолчанию» http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html .
  • Кассандра 2.1.13 — обновление Кассандры 2.0.15.

Установка, обновление, откат

Ниже приведен список изменений в установке, обновлении и связанных сценариях. Информацию об использовании см. в документации Edge for Private Cloud.

  • Новый процесс обновления с 4.16.01 . В этом выпуске утилита apigee-migrate заменяется утилитой update.sh для обновления вашей установки с 4.16.01 по 4.16.05. См. раздел Обновление Apigee Edge с 4.16.01 по 4.16.05 .
  • Бутстрап
    • bootstrap.sh (версия 4.16.01) теперь называется bootstrap_4.16.05.sh в версии 4.16.05.
    • Вам больше не нужно указывать uname:pword для загрузки bootstrap_4.16.05.sh .
  • Откат — для отката обновления до 4.16.05 необходимо удалить версию компонента 4.16.05 и переустановить предыдущую версию. Предыдущая rollback.sh была удалена. См. 4.16.05 Процесс отката .
  • setup.sh и update.sh могут записывать файл журнала в /tmp . По умолчанию утилиты setup.sh и update.sh записывают информацию журнала в /opt/apigee/var/log/apigee-setup . Если пользователь, запускающий утилиту, не имеет доступа к этому каталогу, он записывает журнал в каталог /tmp . Если у пользователя нет доступа к /tmp , утилита не сработает.
  • Процедура обновления API BaaS . В выпуске 4.16.01 вам пришлось переустановить API BaaS для его миграции. Новая утилита update.sh поддерживает обновление API BaaS на месте. См. раздел Обновление Apigee Edge с 4.16.01 по 4.16.05 .

Администрация

Ниже приведены новые функции администрирования и настройки частного облака.

  • Проверка установки . Утилита apigee-validate используемая для проверки установки Edge Private Cloud, теперь может быть запущена с сервера управления. Раньше сценарий нужно было запускать на процессоре сообщений. См. Проверка установки .
  • Имя региона . Имя региона может быть любым. В предыдущих выпусках имя имело форму «dc-#», где # — целочисленное значение.
  • Модули шлюза . Модули шлюза могут иметь любое имя. В предыдущих выпусках модуль должен был называться «шлюз».
  • Администрирование на основе сценариев . Новая утилита командной строки apigee-adminapi.sh позволяет выполнять те же задачи настройки Edge, которые вы выполняете, вызывая API управления Edge. См. Использование утилиты apigee-adminapi.sh .
  • Тихая настройка SSL виртуального хоста . При создании организации или среды вы теперь можете передавать свойства для настройки SSL на виртуальном хосте. См. раздел Регистрация в организации .

API-сервисы

Ниже приведены новые функции Edge API Services, которые были реализованы в предыдущих облачных версиях продукта.

Префикс фиксированной длины для регистрации сообщений системного журнала (Cloud 16.03.30)

Политика ведения журнала сообщений имеет новый элемент <FormatMessage> в конфигурации системного журнала. Если установить <FormatMessage>true</FormatMessage> , сообщения системного журнала начинаются с фиксированного количества символов, что позволяет фильтровать данные, вставленные Apigee. Дополнительные сведения см. в разделе Политика ведения журнала сообщений . (АПИРТ-1398)

Подстановочный знак в базовом пути прокси API (пользовательский интерфейс Cloud 16.03.09)

Пользовательский интерфейс управления поддерживает использование одного или нескольких подстановочных знаков /*/ в базовых путях прокси-сервера API. Например, базовый путь /team/*/members позволяет клиентам вызывать ваш прокси-сервер с помощью https://[host]/team/blue/members или https://[host]/team/green/members без вашего участия. создать новый прокси для поддержки новых команд. Обратите внимание, что /**/ не допускается. (МГМТ-3154)

Цепочка прокси-серверов API (облако 16.03.02, пользовательский интерфейс Cloud 16.03.09)

Edge поддерживает локальную цепочку прокси-серверов API, что позволяет одному прокси-серверу API вызывать другой прокси-сервер API, развернутый в вашей организации Edge, без дополнительных сетевых затрат. Раньше для цепочки прокси-серверов API требовался вызов http(s) к другому прокси-серверу API, который перенаправлял запрос через балансировщик нагрузки, маршрутизатор и обработчик сообщений.

Новые элементы LocalTargetConnection доступны в TargetEndpoint прокси-сервера API, что позволяет указать имя прокси-сервера API, имя определенной точки ProxyEndpoint в прокси-сервере API или просто базовый путь к локальному ресурсу прокси-сервера API (например, /v1/myresource). . Пользовательский интерфейс редактора прокси также предоставляет эти параметры при добавлении или обновлении TargetEndpoint.

Цепочка прокси-серверов также доступна в политиках вызова службы.

Дополнительную информацию см. в разделе Объединение прокси-серверов API в цепочку . Новые элементы LocalTargetConnection также перечислены в схеме XML здесь: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd . (МГМТ-3049, МГМТ-3050)

Исправлены ошибки

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

Edge для частного облака 4.16.05

Идентификатор проблемы Описание
КНР-770 Установщику 16.01 не удается зарегистрировать резервный сервер Postgres в axgroup
КНР-758 Пользователь с ролью пользователя может редактировать пользовательские отчеты.
КНР-883 Обновление на сервере Postgres с конфигурацией «главный-резервный» не выполняется.

Облако 16.03.30

Идентификатор проблемы Описание
СЕКЕНГ-584 Проверка проверки новой строки между сертификатами в цепочке сертификатов вызывает проблемы с некоторыми сертификатами в производстве.
МГМТ-3217 Вызовы API управления завершаются неудачей, если имя KVMap заканчивается на «ключи».
МГМТ-3214 Конфликты классов могут возникнуть во время JavaCallouts, что приведет к сбою кода Java клиента.
МГМТ-3185 Ошибка при добавлении администраторов в организацию
ЭДГЕУИ-127 Получение недостаточных разрешений с новым редактором прокси
ЭДГЕУИ-119 Проблема с тайм-аутом сеанса пользовательского интерфейса
КОРЕСЕРВ-671 Видим ошибки «Нет настроенных звонков; невозможно инициализировать службу cps».
АКСАПП-2345 Проблема с отображением пользовательских отчетов AX для клиентов, не использующих cps.
АКСАПП-2302 Сводка Daily Apigee Analytics показывает ноль при внедрении разработчиками
АПИРТ-2750 Высокий уровень сбоев трафика в конкретной организации
АПИРТ-2516 Ошибки времени выполнения в вызовах JavaScript указывают неправильные номера строк
АПИРТ-2508 Ошибка выхода при вызове экспресс-прослушивания в обратном вызове хранилища
АПИРТ-2336 Проблема Gzip с Node.js
АПИРТ-1975 Конфигурации маски не работают для message.content

Облако 16.03.16 Интерфейс

Идентификатор проблемы Описание
МГМТ-3142 Графики не загружаются на панели анализа ошибок (обновленное исправление)

Облако 16.03.09 Интерфейс

Идентификатор проблемы Описание
МГМТ-3158 Недостаточно разрешений в пользовательском интерфейсе, когда RBAC на отдельных прокси устанавливается через API.
МГМТ-3142 Графики не загружаются на панели анализа ошибок
МГМТ-3118 Пользовательский интерфейс отображает неверную конфигурацию виртуального хоста SSL для параметра clientAuthEnabled.
ДЕВРТ-2344 Определения однодневных отчетов не загружают транзакции в пользовательский интерфейс.

Облако 16.03.02

Идентификатор проблемы Описание
МГМТ-3083 Автоматическое обновление журналов Node.js слишком подробное с сообщениями журнала.
ДЕВРТ-2275 Тарифные планы с пользовательскими атрибутами отображают только 5 атрибутов вместо разрешенных 10.
ДЕВРТ-1275 Не все разработчики показаны в раскрывающемся меню Тарифного плана.
ДЕВРТ-1074 Разработчик по предоплате с нулевым балансом выдает исключение NullpointerException при применении кредита

Облако 16.02.17

Идентификатор проблемы Описание
МГМТ-3083 Автоматическое обновление журналов Node.js слишком подробное с сообщениями журнала.
МГМТ-3077 Пользовательский интерфейс генерирует недопустимый пакет прокси-сервера из WSDL, который использует пространство имен по умолчанию.
МГМТ-1642 Пользовательской роли пользователя не хватает разрешения «получить» для приложений разработчика.

Известные проблемы

В этом выпуске имеются следующие известные проблемы.

Идентификатор проблемы Описание
АПИРТ-2978

Маршрутизатор не запускается Nginx или маршрутизатор не запускается

Если Edge Router не запускает Nginx или вообще не запускается, как показано в файле /opt/apigee/var/log/edge-router/logs/system.log , удалите все файлы в каталоге /opt/nginx/. conf.d и перезапустите маршрутизатор:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
АПИРТ-3364

Процессор сообщений выполняет поиск DNS на IPv4 и IPv6.

Если вы установили и включили NSCD (демон кэша службы имен), вы можете заметить, что процессоры сообщений выполняют два поиска DNS: один для IPv4 и один для IPv6.

Чтобы отключить поиск DNS на IPv6:

  1. На каждом узле процессора сообщений отредактируйте /etc/nscd.conf .
  2. Установите следующее свойство:

    включить кэш хостов нет
КНР-1118

Ошибка при запуске команды «apigee-service apigee-postgresql pg-data-purge»

Если вы запустите команду «apigee-service apigee-postgresql pg-data-purge» и увидите ошибку вида:

ОШИБКА: должен быть владельцем отношения

Отредактируйте /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge и установите для следующего свойства значение apigee:

POSTGRES_USER=апигей

ДОК-1687 Из-за известного конфликта зависимостей пакетов агент Katello, используемый в Satellite Server 6, не будет правильно установлен на хостах Apigee Edge, на которых работает демон Qpid.

Полезные данные JSON в политиках «Назначить сообщение», «Вызов Java» и «Вызвать ошибку»

Политики «Назначить сообщение», «Вызов Java» и «Вызвать ошибку» позволяют генерировать содержимое сообщения с помощью элемента <Set><Payload> . В состав этих сообщений вы можете включать переменные, значения которых автоматически заполняются во время выполнения. Например, если вы хотите вывести дату из заголовка HTTP, вы можете вставить {message.header.date} в свое сообщение.

Если формат сообщения — JSON, оно будет выглядеть примерно так:

{"The date is: " : "{message.header.date}"}

Однако вы можете видеть, что это искаженный JSON. Чтобы обойти эту проблему, у вас есть два варианта:

  • Экранируйте открывающую фигурную скобку обратной косой чертой:
    \{"The date is: " : "{message.header.date}"}
    
  • В конфигурации элемента полезных данных используйте variablePrefix variableSuffix , чтобы указать переменную в полезных данных JSON. Например:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>
    

В следующем выпуске функции Edge for Private Cloud вы сможете без проблем использовать фигурные скобки для переменных в сообщениях JSON. (АПИРТ-1160)

Маршрутизатор не запускается Nginx или маршрутизатор не запускается

Если Edge Router не запускает Nginx или вообще не запускается, как показано в файле /opt/apigee/var/log/edge-router/logs/system.log , удалите все файлы в каталоге /opt/nginx/. conf.d и перезапустите маршрутизатор:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
,

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X.
информация

Во вторник, 31 мая 2016 г., мы выпустили новую версию Apigee Edge для частного облака.

Со времени предыдущего выпуска функции Edge for Private Cloud (4.16.01) были выпущены следующие выпуски, которые включены в этот выпуск функции:

См. раздел «Нумерация выпусков» , чтобы понять, как определить, включен ли конкретный облачный выпуск в вашу версию Edge для частного облака.

Новые функции и улучшения

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

Дополнительные сведения и инструкции см. в документации Edge для частного облака.

Руководства по установке и эксплуатации перенесены в Интернет

Теперь вы можете получить доступ к руководству по установке и эксплуатации Edge для частного облака в версии 4.18.01 .

Обновления программного обеспечения

В выпуск включены следующие обновления программного обеспечения:

  • Java JDK 1.8 . Чтобы воспользоваться преимуществами новейших функций Java, этот выпуск совместим с Java 1.8. В вашей среде требуется Oracle JDK 1.8 или OpenJDK 8.
    В рамках обновления Java 8 некоторые шифры TLS больше не доступны в Oracle JDK 1.8. Полный список см. в разделе «Наборы шифров, отключенные по умолчанию» http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html .
  • Кассандра 2.1.13 — обновление Кассандры 2.0.15.

Установка, обновление, откат

Ниже приведен список изменений в установке, обновлении и связанных сценариях. Информацию об использовании см. в документации Edge for Private Cloud.

  • Новый процесс обновления с 4.16.01 . В этом выпуске утилита apigee-migrate заменяется утилитой update.sh для обновления вашей установки с 4.16.01 по 4.16.05. См. раздел Обновление Apigee Edge с 4.16.01 по 4.16.05 .
  • Бутстрап
    • bootstrap.sh (версия 4.16.01) теперь называется bootstrap_4.16.05.sh в версии 4.16.05.
    • Вам больше не нужно указывать uname:pword для загрузки bootstrap_4.16.05.sh .
  • Откат — для отката обновления до 4.16.05 необходимо удалить версию компонента 4.16.05 и переустановить предыдущую версию. Предыдущая rollback.sh была удалена. См. 4.16.05 Процесс отката .
  • setup.sh и update.sh могут записывать файл журнала в /tmp . По умолчанию утилиты setup.sh и update.sh записывают информацию журнала в /opt/apigee/var/log/apigee-setup . Если пользователь, запускающий утилиту, не имеет доступа к этому каталогу, он записывает журнал в каталог /tmp . Если у пользователя нет доступа к /tmp , утилита не сработает.
  • Процедура обновления API BaaS . В выпуске 4.16.01 вам пришлось переустановить API BaaS для его миграции. Новая утилита update.sh поддерживает обновление API BaaS на месте. См. Обновление Apigee Edge с 4.16.01 по 4.16.05 .

Администрация

Ниже приведены новые функции администрирования и настройки частного облака.

  • Проверка установки . Утилита apigee-validate используемая для проверки установки Edge Private Cloud, теперь может быть запущена с сервера управления. Раньше сценарий нужно было запускать на процессоре сообщений. См. Проверка установки .
  • Имя региона . Имя региона может быть любым. В предыдущих выпусках имя имело форму «dc-#», где # — целочисленное значение.
  • Модули шлюза . Модули шлюза могут иметь любое имя. В предыдущих выпусках модуль должен был называться «шлюз».
  • Администрирование на основе сценариев . Новая утилита командной строки apigee-adminapi.sh позволяет выполнять те же задачи настройки Edge, которые вы выполняете, вызывая API управления Edge. См. Использование утилиты apigee-adminapi.sh .
  • Тихая настройка SSL виртуального хоста . При создании организации или среды вы теперь можете передавать свойства для настройки SSL на виртуальном хосте. См. раздел Регистрация в организации .

API-сервисы

Ниже приведены новые функции Edge API Services, которые были реализованы в предыдущих облачных версиях продукта.

Префикс фиксированной длины для регистрации сообщений системного журнала (Cloud 16.03.30)

Политика ведения журнала сообщений имеет новый элемент <FormatMessage> в конфигурации системного журнала. Если установить <FormatMessage>true</FormatMessage> , сообщения системного журнала начинаются с фиксированного количества символов, что позволяет фильтровать данные, вставленные Apigee. Дополнительные сведения см. в разделе Политика ведения журнала сообщений . (АПИРТ-1398)

Подстановочный знак в базовом пути прокси API (пользовательский интерфейс Cloud 16.03.09)

Пользовательский интерфейс управления поддерживает использование одного или нескольких подстановочных знаков /*/ в базовых путях прокси-сервера API. Например, базовый путь /team/*/members позволяет клиентам вызывать ваш прокси-сервер с помощью https://[host]/team/blue/members или https://[host]/team/green/members без вашего участия. создать новый прокси для поддержки новых команд. Обратите внимание, что /**/ не допускается. (МГМТ-3154)

Цепочка прокси-серверов API (облако 16.03.02, пользовательский интерфейс Cloud 16.03.09)

Edge поддерживает локальную цепочку прокси-серверов API, что позволяет одному прокси-серверу API вызывать другой прокси-сервер API, развернутый в вашей организации Edge, без дополнительных сетевых затрат. Раньше для цепочки прокси-серверов API требовался вызов http(s) к другому прокси-серверу API, который перенаправлял запрос через балансировщик нагрузки, маршрутизатор и обработчик сообщений.

Новые элементы LocalTargetConnection доступны в TargetEndpoint прокси-сервера API, что позволяет указать имя прокси-сервера API, имя определенной точки ProxyEndpoint в прокси-сервере API или просто базовый путь к локальному ресурсу прокси-сервера API (например, /v1/myresource). . Пользовательский интерфейс редактора прокси также предоставляет эти параметры при добавлении или обновлении TargetEndpoint.

Цепочка прокси-серверов также доступна в политиках вызова службы.

Дополнительную информацию см. в разделе Объединение прокси-серверов API в цепочку . Новые элементы LocalTargetConnection также перечислены в схеме XML здесь: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd . (МГМТ-3049, МГМТ-3050)

Исправлены ошибки

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

Edge для частного облака 4.16.05

Идентификатор проблемы Описание
КНР-770 Установщику 16.01 не удается зарегистрировать резервный сервер Postgres в axgroup
КНР-758 Пользователь с ролью пользователя может редактировать пользовательские отчеты.
КНР-883 Обновление на сервере Postgres с конфигурацией «главный-резервный» не выполняется.

Облако 16.03.30

Идентификатор проблемы Описание
СЕКЕНГ-584 Проверка проверки новой строки между сертификатами в цепочке сертификатов вызывает проблемы с некоторыми сертификатами в производстве.
МГМТ-3217 Вызовы API управления завершаются неудачей, если имя KVMap заканчивается на «ключи».
МГМТ-3214 Конфликты классов могут возникнуть во время JavaCallouts, что приведет к сбою кода Java клиента.
МГМТ-3185 Ошибка при добавлении администраторов в организацию
ЭДГЕУИ-127 Получение недостаточных разрешений с новым редактором прокси
ЭДГЕУИ-119 Проблема с тайм-аутом сеанса пользовательского интерфейса
КОРЕСЕРВ-671 Видим ошибки «Нет настроенных звонков; невозможно инициализировать службу cps».
АКСАПП-2345 Проблема с отображением пользовательских отчетов AX для клиентов, не использующих cps.
АКСАПП-2302 Сводка Daily Apigee Analytics показывает ноль при внедрении разработчиками
АПИРТ-2750 Высокий уровень сбоев трафика в конкретной организации
АПИРТ-2516 Ошибки времени выполнения в вызовах JavaScript указывают неправильные номера строк
АПИРТ-2508 Ошибка выхода при вызове экспресс-прослушивания в обратном вызове хранилища
АПИРТ-2336 Проблема Gzip с Node.js
АПИРТ-1975 Конфигурации маски не работают для message.content

Облако 16.03.16 Интерфейс

Идентификатор проблемы Описание
МГМТ-3142 Графики не загружаются на панели анализа ошибок (обновленное исправление)

Облако 16.03.09 Интерфейс

Идентификатор проблемы Описание
МГМТ-3158 Недостаточно разрешений в пользовательском интерфейсе, когда RBAC на отдельных прокси устанавливается через API.
МГМТ-3142 Графики не загружаются на панели анализа ошибок
МГМТ-3118 Пользовательский интерфейс отображает неверную конфигурацию виртуального хоста SSL для параметра clientAuthEnabled.
ДЕВРТ-2344 Определения однодневных отчетов не загружают транзакции в пользовательский интерфейс.

Облако 16.03.02

Идентификатор проблемы Описание
МГМТ-3083 Автоматическое обновление журналов Node.js слишком подробное с сообщениями журнала.
ДЕВРТ-2275 Тарифные планы с пользовательскими атрибутами отображают только 5 атрибутов вместо разрешенных 10.
ДЕВРТ-1275 Не все разработчики показаны в раскрывающемся меню Тарифного плана.
ДЕВРТ-1074 Разработчик по предоплате с нулевым балансом выдает исключение NullpointerException при применении кредита

Облако 16.02.17

Идентификатор проблемы Описание
МГМТ-3083 Автоматическое обновление журналов Node.js слишком подробное с сообщениями журнала.
МГМТ-3077 Пользовательский интерфейс генерирует недопустимый пакет прокси-сервера из WSDL, который использует пространство имен по умолчанию.
МГМТ-1642 Пользовательской роли пользователя не хватает разрешения «получить» для приложений разработчика.

Известные проблемы

В этом выпуске имеются следующие известные проблемы.

Идентификатор проблемы Описание
АПИРТ-2978

Маршрутизатор не запускается Nginx или маршрутизатор не запускается

Если Edge Router не запускает Nginx или вообще не запускается, как показано в файле /opt/apigee/var/log/edge-router/logs/system.log , удалите все файлы в каталоге /opt/nginx/. conf.d и перезапустите маршрутизатор:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
АПИРТ-3364

Процессор сообщений выполняет поиск DNS на IPv4 и IPv6.

Если вы установили и включили NSCD (демон кэша службы имен), вы можете заметить, что процессоры сообщений выполняют два поиска DNS: один для IPv4 и один для IPv6.

Чтобы отключить поиск DNS на IPv6:

  1. На каждом узле процессора сообщений отредактируйте /etc/nscd.conf .
  2. Установите следующее свойство:

    включить кэш хостов нет
КНР-1118

Ошибка при запуске команды «apigee-service apigee-postgresql pg-data-purge»

Если вы запустите команду «apigee-service apigee-postgresql pg-data-purge» и увидите ошибку вида:

ОШИБКА: должен быть владельцем отношения

Отредактируйте /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge и установите для следующего свойства значение apigee:

POSTGRES_USER=апигей

ДОК-1687 Из-за известного конфликта зависимостей пакетов агент Katello, используемый в Satellite Server 6, не будет правильно установлен на хостах Apigee Edge, на которых работает демон Qpid.

Полезные данные JSON в политиках «Назначить сообщение», «Вызов Java» и «Вызвать ошибку»

Политики «Назначить сообщение», «Вызов Java» и «Вызвать ошибку» позволяют генерировать содержимое сообщения с помощью элемента <Set><Payload> . В состав этих сообщений вы можете включать переменные, значения которых автоматически заполняются во время выполнения. Например, если вы хотите вывести дату из заголовка HTTP, вы можете вставить {message.header.date} в свое сообщение.

Если формат сообщения — JSON, оно будет выглядеть примерно так:

{"The date is: " : "{message.header.date}"}

Однако вы можете видеть, что это искаженный JSON. Чтобы обойти эту проблему, у вас есть два варианта:

  • Экранируйте открывающую фигурную скобку обратной косой чертой:
    \{"The date is: " : "{message.header.date}"}
    
  • В конфигурации элемента полезных данных используйте variablePrefix variableSuffix , чтобы указать переменную в полезных данных JSON. Например:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>
    

В следующем выпуске функции Edge for Private Cloud вы сможете без проблем использовать фигурные скобки для переменных в сообщениях JSON. (АПИРТ-1160)

Маршрутизатор не запускается Nginx или маршрутизатор не запускается

Если Edge Router не запускает Nginx или вообще не запускается, как показано в файле /opt/apigee/var/log/edge-router/logs/system.log , удалите все файлы в каталоге /opt/nginx/. conf.d и перезапустите маршрутизатор:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
,

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X.
информация

Во вторник, 31 мая 2016 г., мы выпустили новую версию Apigee Edge для частного облака.

Со времени предыдущего выпуска функции Edge for Private Cloud (4.16.01) были выпущены следующие выпуски, которые включены в этот выпуск функции:

См. раздел «Нумерация выпусков» , чтобы понять, как определить, включен ли конкретный облачный выпуск в вашу версию Edge для частного облака.

Новые функции и улучшения

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

Дополнительные сведения и инструкции см. в документации Edge для частного облака.

Руководства по установке и эксплуатации перенесены в Интернет

Теперь вы можете получить доступ к руководству по установке и эксплуатации Edge для частного облака в версии 4.18.01 .

Обновления программного обеспечения

В выпуск включены следующие обновления программного обеспечения:

  • Java JDK 1.8 . Чтобы воспользоваться преимуществами новейших функций Java, этот выпуск совместим с Java 1.8. В вашей среде требуется Oracle JDK 1.8 или OpenJDK 8.
    В рамках обновления Java 8 некоторые шифры TLS больше не доступны в Oracle JDK 1.8. Полный список см. в разделе «Наборы шифров, отключенные по умолчанию» http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html .
  • Кассандра 2.1.13 — обновление Кассандры 2.0.15.

Установка, обновление, откат

Ниже приведен список изменений в установке, обновлении и связанных сценариях. Информацию об использовании см. в документации Edge for Private Cloud.

  • Новый процесс обновления с 4.16.01 . В этом выпуске утилита apigee-migrate заменяется утилитой update.sh для обновления вашей установки с 4.16.01 по 4.16.05. См. раздел Обновление Apigee Edge с 4.16.01 по 4.16.05 .
  • Бутстрап
    • bootstrap.sh (версия 4.16.01) теперь называется bootstrap_4.16.05.sh в версии 4.16.05.
    • Вам больше не нужно указывать uname:pword для загрузки bootstrap_4.16.05.sh .
  • Откат — для отката обновления до 4.16.05 необходимо удалить версию компонента 4.16.05 и переустановить предыдущую версию. Предыдущая rollback.sh была удалена. См. 4.16.05 Процесс отката .
  • setup.sh и update.sh могут записывать файл журнала в /tmp . По умолчанию утилиты setup.sh и update.sh записывают информацию журнала в /opt/apigee/var/log/apigee-setup . Если пользователь, запускающий утилиту, не имеет доступа к этому каталогу, он записывает журнал в каталог /tmp . Если у пользователя нет доступа к /tmp , утилита не сработает.
  • Процедура обновления API BaaS . В выпуске 4.16.01 вам пришлось переустановить API BaaS для его миграции. Новая утилита update.sh поддерживает обновление API BaaS на месте. См. раздел Обновление Apigee Edge с 4.16.01 по 4.16.05 .

Администрация

Ниже приведены новые функции администрирования и настройки частного облака.

  • Проверка установки . Утилита apigee-validate используемая для проверки установки Edge Private Cloud, теперь может быть запущена с сервера управления. Раньше сценарий нужно было запускать на процессоре сообщений. См. Проверка установки .
  • Имя региона . Имя региона может быть любым. В предыдущих выпусках имя имело форму «dc-#», где # — целочисленное значение.
  • Модули шлюза . Модули шлюза могут иметь любое имя. В предыдущих выпусках модуль должен был называться «шлюз».
  • Администрирование на основе сценариев . Новая утилита командной строки apigee-adminapi.sh позволяет выполнять те же задачи настройки Edge, которые вы выполняете, вызывая API управления Edge. См. Использование утилиты apigee-adminapi.sh .
  • Тихая настройка SSL виртуального хоста . Теперь при создании организации или среды вы можете передавать свойства для настройки SSL на виртуальном хосте. См. раздел Регистрация в организации .

API-сервисы

Ниже приведены новые функции Edge API Services, которые были реализованы в предыдущих облачных версиях продукта.

Префикс фиксированной длины для регистрации сообщений системного журнала (Cloud 16.03.30)

Политика ведения журнала сообщений имеет новый элемент <FormatMessage> в конфигурации системного журнала. Если установить <FormatMessage>true</FormatMessage> , сообщения системного журнала начинаются с фиксированного количества символов, что позволяет фильтровать данные, вставленные Apigee. Дополнительные сведения см. в разделе Политика ведения журнала сообщений . (АПИРТ-1398)

Подстановочный знак в базовом пути прокси API (пользовательский интерфейс Cloud 16.03.09)

Пользовательский интерфейс управления поддерживает использование одного или нескольких подстановочных знаков /*/ в базовых путях прокси-сервера API. Например, базовый путь /team/*/members позволяет клиентам вызывать ваш прокси-сервер с помощью https://[host]/team/blue/members или https://[host]/team/green/members без вашего участия. создать новый прокси для поддержки новых команд. Обратите внимание, что /**/ не допускается. (МГМТ-3154)

Цепочка прокси-серверов API (облако 16.03.02, пользовательский интерфейс Cloud 16.03.09)

Edge поддерживает локальную цепочку прокси-серверов API, что позволяет одному прокси-серверу API вызывать другой прокси-сервер API, развернутый в вашей организации Edge, без дополнительных сетевых затрат. Раньше для цепочки прокси-серверов API требовался вызов http(s) к другому прокси-серверу API, который перенаправлял запрос через балансировщик нагрузки, маршрутизатор и обработчик сообщений.

Новые элементы LocalTargetConnection доступны в TargetEndpoint прокси-сервера API, что позволяет указать имя прокси-сервера API, имя определенной точки ProxyEndpoint в прокси-сервере API или просто базовый путь к локальному ресурсу прокси-сервера API (например, /v1/myresource). . Пользовательский интерфейс редактора прокси также предоставляет эти параметры при добавлении или обновлении TargetEndpoint.

Цепочка прокси-серверов также доступна в политиках вызова службы.

Дополнительную информацию см. в разделе Объединение прокси-серверов API в цепочку . Новые элементы LocalTargetConnection также перечислены в схеме XML здесь: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd . (МГМТ-3049, МГМТ-3050)

Исправлены ошибки

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

Edge для частного облака 4.16.05

Идентификатор проблемы Описание
КНР-770 Установщику 16.01 не удается зарегистрировать резервный сервер Postgres в axgroup
КНР-758 Пользователь с ролью пользователя может редактировать пользовательские отчеты.
КНР-883 Обновление на сервере Postgres с конфигурацией «главный-резервный» не выполняется.

Облако 16.03.30

Идентификатор проблемы Описание
СЕКЕНГ-584 Проверка проверки новой строки между сертификатами в цепочке сертификатов вызывает проблемы с некоторыми сертификатами в производстве.
МГМТ-3217 Вызовы API управления завершаются неудачей, если имя KVMap заканчивается на «ключи».
МГМТ-3214 Конфликты классов могут возникнуть во время JavaCallouts, что приведет к сбою кода Java клиента.
МГМТ-3185 Ошибка при добавлении администраторов в организацию
ЭДГЕУИ-127 Получение недостаточных разрешений с новым редактором прокси
ЭДГЕУИ-119 Проблема с тайм-аутом сеанса пользовательского интерфейса
КОРЕСЕРВ-671 Видим ошибки «Нет настроенных звонков; невозможно инициализировать службу cps».
АКСАПП-2345 Проблема с отображением пользовательских отчетов AX для клиентов, не использующих cps.
АКСАПП-2302 Сводка Daily Apigee Analytics показывает ноль при внедрении разработчиками
АПИРТ-2750 Высокий уровень сбоев трафика в конкретной организации
АПИРТ-2516 Ошибки времени выполнения в вызовах JavaScript указывают неправильные номера строк
АПИРТ-2508 Ошибка выхода при вызове экспресс-прослушивания в обратном вызове хранилища
АПИРТ-2336 Проблема Gzip с Node.js
АПИРТ-1975 Конфигурации маски не работают для message.content

Облако 16.03.16 Интерфейс

Идентификатор проблемы Описание
МГМТ-3142 Графики не загружаются на панели анализа ошибок (обновленное исправление)

Облако 16.03.09 Интерфейс

Идентификатор проблемы Описание
МГМТ-3158 Недостаточно разрешений в пользовательском интерфейсе, когда RBAC на отдельных прокси устанавливается через API.
МГМТ-3142 Графики не загружаются на панели анализа ошибок
МГМТ-3118 Пользовательский интерфейс отображает неверную конфигурацию виртуального хоста SSL для параметра clientAuthEnabled.
ДЕВРТ-2344 Определения однодневных отчетов не загружают транзакции в пользовательский интерфейс.

Облако 16.03.02

Идентификатор проблемы Описание
МГМТ-3083 Автоматическое обновление журналов Node.js слишком подробное с сообщениями журнала.
ДЕВРТ-2275 Тарифные планы с пользовательскими атрибутами отображают только 5 атрибутов вместо разрешенных 10.
ДЕВРТ-1275 Не все разработчики показаны в раскрывающемся меню Тарифного плана.
ДЕВРТ-1074 Разработчик по предоплате с нулевым балансом выдает исключение NullpointerException при применении кредита

Облако 16.02.17

Идентификатор проблемы Описание
МГМТ-3083 Автоматическое обновление журналов Node.js слишком подробное с сообщениями журнала.
МГМТ-3077 Пользовательский интерфейс генерирует недопустимый пакет прокси-сервера из WSDL, который использует пространство имен по умолчанию.
МГМТ-1642 Пользовательской роли пользователя не хватает разрешения «получить» для приложений разработчика.

Известные проблемы

В этом выпуске имеются следующие известные проблемы.

Идентификатор проблемы Описание
АПИРТ-2978

Маршрутизатор не запускается Nginx или маршрутизатор не запускается

Если Edge Router не запускает Nginx или вообще не запускается, как показано в файле /opt/apigee/var/log/edge-router/logs/system.log , удалите все файлы в каталоге /opt/nginx/. conf.d и перезапустите маршрутизатор:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
АПИРТ-3364

Процессор сообщений выполняет поиск DNS на IPv4 и IPv6.

Если вы установили и включили NSCD (демон кэша службы имен), вы можете заметить, что процессоры сообщений выполняют два поиска DNS: один для IPv4 и один для IPv6.

Чтобы отключить поиск DNS на IPv6:

  1. На каждом узле процессора сообщений отредактируйте /etc/nscd.conf .
  2. Установите следующее свойство:

    включить кэш хостов нет
КНР-1118

Ошибка при запуске команды «apigee-service apigee-postgresql pg-data-purge»

Если вы запустите команду «apigee-service apigee-postgresql pg-data-purge» и увидите ошибку вида:

ОШИБКА: должен быть владельцем отношения

Отредактируйте /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge и установите для следующего свойства значение apigee:

POSTGRES_USER=апигей

ДОК-1687 Из-за известного конфликта зависимостей пакетов агент Katello, используемый в Satellite Server 6, не будет правильно установлен на хостах Apigee Edge, на которых работает демон Qpid.

Полезные данные JSON в политиках «Назначить сообщение», «Вызов Java» и «Вызвать ошибку»

Политики «Назначить сообщение», «Вызов Java» и «Вызвать ошибку» позволяют генерировать содержимое сообщения с помощью элемента <Set><Payload> . В состав этих сообщений вы можете включать переменные, значения которых автоматически заполняются во время выполнения. Например, если вы хотите вывести дату из заголовка HTTP, вы можете вставить {message.header.date} в свое сообщение.

Если формат сообщения — JSON, оно будет выглядеть примерно так:

{"The date is: " : "{message.header.date}"}

Однако вы можете видеть, что это искаженный JSON. Чтобы обойти эту проблему, у вас есть два варианта:

  • Экранируйте открывающую фигурную скобку обратной косой чертой:
    \{"The date is: " : "{message.header.date}"}
    
  • В конфигурации элемента полезных данных используйте variablePrefix variableSuffix , чтобы указать переменную в полезных данных JSON. Например:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>
    

В следующем выпуске функции Edge for Private Cloud вы сможете без проблем использовать фигурные скобки для переменных в сообщениях JSON. (АПИРТ-1160)

Маршрутизатор не запускается Nginx или маршрутизатор не запускается

Если Edge Router не запускает Nginx или вообще не запускается, как показано в файле /opt/apigee/var/log/edge-router/logs/system.log , удалите все файлы в каталоге /opt/nginx/. conf.d и перезапустите маршрутизатор:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart