Как выполнить откат компонентов Apigee и NGINX

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

Выпуск исправлений за март 2021 г.

В пакетах RPM для мартовского исправления 2021 г. Edge для частного облака, которые были загружены в рабочий репозиторий Apigee, было непреднамеренное обновление зависимости для apigee-nginx-1.18. В результате мы удалили RPM-пакеты из репозитория и заменили их правильными. Недействительные пакеты RPM находились в репозитории 25 марта 2021 г. с 08:45 до 15:45 по тихоокеанскому стандартному времени. Если вы скачали и установили RPM-пакеты Edge в эту дату, вам может потребоваться выполнить откат следующих компонентов Apigee до предыдущих версий:

  • edge-gateway
  • edge-management-server
  • edge-message-processor
  • edge-postgres-server
  • edge-qpid-server
  • edge-router
  • nginx

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

Как узнать, нужно ли переходить на версию с ограниченной функциональностью

Чтобы узнать, нужно ли вам понизить версию компонентов Apigee или NGINX, выполните одну из следующих процедур в зависимости от того, используете ли вы Edge для частного облака 4.50.00 или 4.19.06.

Процедура для Edge 4.50.00

На каждом узле введите следующие команды, чтобы найти версию шлюза:

-- apigee-service edge-gateway version

Если номер версии edge-gateway:

  • Если значение меньше 20113, вам не нужно ничего делать.
  • Если значение равно 20113, вам нужно выполнить откат компонентов Apigee и NGINX.
  • Если значение больше 20113, введите следующую команду, чтобы узнать версию NGINX: 
    -- sudo yum list installed apigee-nginx

    Вот пример выходных данных команды:

    Installed Packages
apigee-nginx.x86_64 1.18.0-1.el7
@apigee-thirdparty

    Если версия NGINX apigee-nginx.x86_64 1.18.0-XXX, вам нужно только перейти на более раннюю версию NGINX.

Процедура для Edge 4.19.06

На каждом узле введите следующие команды, чтобы найти версию шлюза:

-- apigee-service edge-gateway version

Если номер версии edge-gateway:

  • Меньше 20114 – никаких действий не требуется.
  • Если значение равно 20114, вам нужно выполнить откат компонентов Apigee и выполнить откат NGINX.
  • Если значение больше 20114, введите следующую команду, чтобы узнать версию NGINX: 
    -- sudo yum list installed apigee-nginx

    Вот пример выходных данных команды:

    Installed Packages
apigee-nginx.x86_64 1.18.0-1.el7
@apigee-thirdparty

    Если версия NGINX apigee-nginx.x86_64 1.18.0-XXX, вам нужно только перейти на более раннюю версию NGINX.

    Компоненты, которые нужно перевести на более раннюю версию

    Если вы установили какие-либо RPM-пакеты из приведенных ниже списков, вам нужно перейти на предыдущую версию этих пакетов.

    Компоненты, которые нужно понизить до версии Edge for Private Cloud 4.50.00

    edge-gateway-4.50.00-0.0.20113.noarch.rpm
edge-management-server-4.50.00-0.0.20113.noarch.rpm
edge-message-processor-4.50.00-0.0.20113.noarch.rpm
edge-postgres-server-4.50.00-0.0.20113.noarch.rpm
edge-qpid-server-4.50.00-0.0.20113.noarch.rpm
edge-router-4.50.00-0.0.20113.noarch.rpm

    Компоненты, которые нужно понизить до версии Edge for Private Cloud 4.19.06

    edge-gateway-4.19.06-0.0.20114.noarch.rpm
edge-management-server-4.19.06-0.0.20114.noarch.rpm
edge-message-processor-4.19.06-0.0.20114.noarch.rpm
edge-postgres-server-4.19.06-0.0.20114.noarch.rpm
edge-qpid-server-4.19.06-0.0.20114.noarch.rpm
edge-router-4.19.06-0.0.20114.noarch.rpm

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

    -- apigee-service component version

    Как перейти на более раннюю версию компонентов Apigee

    Чтобы выполнить откат компонентов Apigee, следуйте приведенной ниже процедуре.

    На каждом узле, на котором установлен любой из следующих компонентов:

    • edge-gateway
    • edge-management-server
    • edge-message-processor
    • edge-postgres-server
    • edge-qpid-server
    • edge-router

    Остановить компонент, введя

    --apigee-service component stop

    Затем выполните следующие действия:

    -- sudo yum downgrade

    Вот несколько примеров:

    Если установлены шлюз и обработчик сообщений Edge:

    -- sudo yum downgrade edge-gateway edge-message-processor

    Если установлены шлюз и пограничный маршрутизатор:

    -- sudo yum downgrade edge-gateway edge-router

    Если вы настраиваете устройство "все в одном": 

    -- sudo yum downgrade edge-gateway edge-postgres-server edge-router edge-management-server edge-message-processor edge-qpid-server

    После этого выполните команду configure для каждого компонента и перезапустите его.

    --apigee-service  component configure
--apigee-service  component start

    Ниже указаны правильные версии RPM, которые будут установлены после перехода на более раннюю версию.

    Edge for Private Cloud 4.50.00

    edge-gateway-4.50.00-0.0.20110
Edge-management-server-4.50.00-0.0.20110
edge-message-processor-4.50.00-0.0.20110
edge-postgres-server-4.50.00-0.0.20110
edge-qpid-server-4.50.00-0.0.20110
edge-router-4.50.00-0.0.20110

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

    edge-gateway-4.19.06-0.0.20112
Edge-management-server-4.19.06-0.0.20112
edge-message-processor-4.19.06-0.0.20112
edge-postgres-server-4.19.06-0.0.20112
edge-qpid-server-4.19.06-0.0.20112
edge-router-4.19.06-0.0.20112

    Как перейти на более раннюю версию NGINX

    Чтобы выполнить откат до версии apigee-nginx, выполните следующие действия для пограничного маршрутизатора, по одному узлу за раз:

    1. Остановите маршрутизатор. 
      --apigee-service edge-router stop
    2. Переход на версию apigee-ngix. 
       -- sudo yum downgrade apigee-nginx
       Ожидаемая версия apigee-nginx после перехода на более раннюю версию: 
      -- yum list installed apigee-nginx
apigee-nginx.x86_64 -1.16.1-6.el7
    3. Настройте маршрутизатор. 
      apigee-service edge-router configure
    4. Запустите маршрутизатор. 
      apigee-service edge-router start