Cofanie zmian w Apigee Edge 4.19.06

Jeśli podczas aktualizowania do Edge 4.19.06 wystąpi błąd, możesz przywrócić komponent, który spowodował błąd, i spróbować jeszcze raz przeprowadzić aktualizację.

Możesz przywrócić Edge 4.19.06 do jednej z tych wersji funkcji:

  • Wersja 4.19.01
  • Wersja 4.18.05
  • Wersja 4.18.01

Możesz wykonać cofnięcie zmian w 2 sytuacjach:

  1. Przywrócić poprzednią wersję funkcji. Na przykład z 4.19.06 na 4.18.05.
  2. Przywróć poprzednią wersję aktualizacji w tej samej wersji. Na przykład z 4.19.01.02 na 4.19.01.01.

Więcej informacji znajdziesz w artykule Proces publikowania Apigee Edge.

Kto może cofnąć zmiany

Użytkownik wykonujący wycofanie powinien być tym samym użytkownikiem, który pierwotnie zaktualizował Edge, lub użytkownikiem działającym jako root.

Domyślnie komponenty Edge działają jako użytkownik „apigee”. W niektórych przypadkach komponenty Edge mogą być uruchamiane jako różne użytkownicy. Jeśli na przykład router musi mieć dostęp do portów z podwyższonymi uprawnieniami, takich jak porty poniżej 1000, musisz go uruchomić jako użytkownik root lub użytkownik z dostępem do tych portów. Możesz też uruchomić jeden komponent jako jeden użytkownik, a inny jako inny użytkownik.

Komponenty z kodem wspólnym

Te komponenty Edge korzystają z wspólnego kodu. Dlatego aby cofnąć zmiany w dowolnym z tych komponentów na węźle, musisz cofnąć zmiany we wszystkich komponentach na tym węźle.

  • edge-management-server (serwer zarządzania)
  • edge-message-processor (system przetwarzania wiadomości)
  • edge-router (Router)
  • edge-postgres-server (serwer Postgres)
  • edge-qpid-server (Qpid Server)

Jeśli na przykład w węźle masz zainstalowane: serwer zarządzania, router i procesor wiadomości, aby przywrócić którykolwiek z nich, musisz przywrócić wszystkie trzy z nich.

Przywracanie poprzedniej wersji funkcji

Aby przywrócić poprzednią wersję funkcji, wykonaj te czynności na każdym węźle, na którym znajduje się komponent:

  1. Pobierz plik bootstrap.sh dla wersji, do której chcesz przywrócić:

    • Aby przywrócić wersję 4.19.01, pobierz bootstrap_4.19.01.sh:
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh 
    • Aby przywrócić wersję 4.18.05, pobierz bootstrap_4.18.05.sh:
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh 
    • Aby przywrócić wersję 4.18.01, pobierz bootstrap_4.18.01.sh:
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh 
  2. Zatrzymaj komponent do wycofania:
    1. Aby cofnąć dowolny z komponentów z kodem wspólnym w węźle, musisz je wszystkie zatrzymać, jak w tym przykładzie:
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-router stop
      /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. Aby cofnąć dowolny inny komponent na węźle, zatrzymaj tylko ten komponent:
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Jeśli chcesz przywrócić poprzednią wersję funkcji Monetyzacja, odinstaluj ją ze wszystkich węzłów serwera zarządzania i procesora wiadomości:
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. Odinstaluj komponent, aby cofnąć zmiany na węźle:
    1. Aby wycofać dowolny z komponentów z kodem wspólnym w węźle, musisz odinstalować wszystkie komponenty, odinstalowując grupę komponentów edge-gateway, jak pokazano w tym przykładzie:
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. Aby przywrócić dowolny inny komponent w węźle, odinstaluj tylko ten komponent, jak w przykładzie poniżej:
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      Gdzie component to nazwa komponentu.

    3. Aby przywrócić router Edge, musisz oprócz odinstalowania grupy komponentów edge-gateway usunąć zawartość pliku /opt/nginx/conf.d:
      cd /opt/nginx/conf.d
      rm -rf *
  5. Odinstaluj wersję apigee-setup 4.19.06:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. Zainstaluj wersję 4.19.01, 4.18.05 lub 4.18.01 narzędzia apigee-service wraz z zależnościami. W tym przykładzie instalowana jest wersja 4.18.01 pakietu apigee-service:
    sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    Gdzie uNamepWord to nazwa użytkownika i hasło otrzymane z Apigee. Jeśli pominiesz pWord, pojawi się prośba o jego podanie.

    Jeśli pojawi się błąd, sprawdź, czy plik bootstrap.sh został pobrany w kroku 1.

  7. Zainstaluj aplikację apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Zainstaluj starszą wersję komponentu:
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    Gdzie component to instalowany komponent, a configFile to plik konfiguracji starszej wersji.

  9. Jeśli wycofujesz zmiany Qpid, usuń pliki iptables:
    sudo iptables -F
  10. Powtórz tę procedurę dla każdego węzła, który hostuje komponent, który chcesz cofnąć.

Przywracanie poprzedniej wersji

Aby przywrócić komponent do określonej wersji wersji, wykonaj te czynności na każdym węźle, na którym jest on hostowany:

  1. Pobierz wersję konkretnego komponentu:
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    Gdzie component_version to komponent i wersja do zainstalowania. Przykład:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.01-0.0.3749 install

    Jeśli korzystasz z repozytorium online Apigee, możesz określić dostępne wersje komponentu, korzystając z tego polecenia:

    yum --showduplicates list comp

    Na przykład:

    yum --showduplicates list edge-ui
  2. Użyj apigee-setup, aby zainstalować komponent:
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    Na przykład:

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

    Pamiętaj, że podczas instalacji podajesz tylko nazwę komponentu, a nie jego wersję.

  3. Powtórz tę procedurę dla każdego węzła, który hostuje komponent, który chcesz cofnąć.