Apigee Edge 4.19.06 롤백

Edge 4.19.06으로 업데이트하는 중에 오류가 발생하면 오류를 일으킨 구성요소를 롤백한 후 업데이트를 다시 시도할 수 있습니다.

Edge 4.19.06을 다음 기능 출시 버전으로 롤백할 수 있습니다.

  • 버전 4.19.01
  • 버전 4.18.05
  • 버전 4.18.01

롤백을 수행해야 할 수 있는 두 가지 시나리오는 다음과 같습니다.

  1. 이전 기능 출시로 롤백 예를 들어 4.19.06에서 4.18.05까지입니다.
  2. 동일한 출시에서 이전 업데이트 버전으로 롤백합니다. 예: 4.19.01.02부터 4.19.01.01까지

자세한 내용은 Apigee Edge 출시 프로세스를 참조하세요.

롤백을 실행할 수 있는 사용자

롤백을 실행하는 사용자는 원래 Edge를 업데이트한 사용자 또는 root로 실행 중인 사용자와 동일해야 합니다.

기본적으로 Edge 구성요소는 'apigee' 사용자로 실행됩니다. 경우에 따라 Edge 구성요소를 다른 사용자로 실행할 수 있습니다. 예를 들어 라우터가 권한이 있는 포트(예: 1000 미만의 포트)에 액세스해야 하는 경우 라우터를 루트로 실행하거나 이러한 포트에 액세스할 수 있는 사용자로 실행해야 합니다. 또는 한 구성요소는 한 사용자로, 다른 구성요소는 다른 사용자로 실행할 수도 있습니다.

공통 코드가 있는 구성요소

다음 Edge 구성요소는 공통 코드를 공유합니다. 따라서 노드에서 이러한 구성요소 중 하나를 롤백하려면 해당 노드에 있는 이러한 구성요소를 모두 롤백해야 합니다.

  • edge-management-server (관리 서버)
  • edge-message-processor (메시지 프로세서)
  • edge-router (라우터)
  • edge-postgres-server (Postgres 서버)
  • edge-qpid-server (Qpid 서버)

예를 들어 노드에 관리 서버, 라우터, 메시지 프로세서가 설치된 경우, 그중 하나를 롤백하려면 세 가지 모두를 롤백해야 합니다.

이전 기능 출시로 롤백

이전 기능 출시로 롤백하려면 구성요소를 호스팅하는 각 노드에서 다음을 수행합니다.

  1. 롤백하려는 버전의 bootstrap.sh 파일을 다운로드합니다.

    • 4.19.01로 롤백하려면 bootstrap_4.19.01.sh를 다운로드하세요.
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh 
    • 4.18.05로 롤백하려면 bootstrap_4.18.05.sh를 다운로드하세요.
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh 
    • 4.18.01로 롤백하려면 bootstrap_4.18.01.sh를 다운로드하세요.
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh 
  2. 구성요소를 중지하여 롤백합니다.
    1. 노드에서 공통 코드가 있는 구성요소를 롤백하려면 다음 예와 같이 모두 중지해야 합니다.
      /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. 노드의 기타 구성요소를 롤백하려면 해당 구성요소만 중지합니다.
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. 수익 창출을 롤백하는 경우 모든 관리 서버 및 메시지 프로세서 노드에서 수익 창출을 제거합니다.
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. 구성요소를 제거하여 노드에서 롤백합니다.
    1. 노드에서 공통 코드가 있는 구성요소를 롤백하려면 다음 예와 같이 edge-gateway 구성요소 그룹을 제거하여 모두 제거해야 합니다.
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. 노드의 다른 구성요소를 롤백하려면 다음 예와 같이 해당 구성요소만 제거합니다.
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      여기서 component은 구성요소 이름입니다.

    3. Edge Router를 롤백하려면 edge-gateway 구성요소 그룹을 제거한 것 외에도 /opt/nginx/conf.d 파일의 콘텐츠(
      cd /opt/nginx/conf.d
      rm -rf *
      )를 삭제해야 합니다.
  5. apigee-setup의 4.19.06 버전을 제거합니다.
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. apigee-service 유틸리티의 4.19.01, 4.18.05 또는 4.18.01 버전과 종속 항목을 설치합니다. 다음 예에서는 apigee-service의 4.18.01 버전을 설치합니다.
    sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

    여기서 uNamepWord는 Apigee에서 받은 사용자 이름과 비밀번호입니다. pWord를 생략하면 입력하라는 메시지가 표시됩니다.

    오류가 발생하면 1단계에서 bootstrap.sh 파일을 다운로드했는지 확인합니다.

  7. apigee-setup을 설치합니다.
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. 이전 버전의 구성요소를 설치합니다.
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    여기서 component는 설치할 구성요소이고 configFile는 이전 버전의 구성 파일입니다.

  9. Qpid를 롤백하는 경우 iptables를 플러시합니다.
    sudo iptables -F
  10. 롤백하는 구성요소를 호스팅하는 각 노드에 대해 이 프로세스를 반복합니다.

이전 업데이트 버전으로 롤백

구성요소를 출시의 특정 버전으로 롤백하려면 구성요소를 호스팅하는 각 노드에서 다음을 실행합니다.

  1. 구체적인 구성요소 버전(
    /opt/apigee/apigee-service/bin/apigee-service component_version install
    )을 다운로드합니다.

    여기서 component_version은 설치할 구성요소 및 업데이트 버전입니다. 예:

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

    Apigee 온라인 저장소를 사용하는 경우

    yum --showduplicates list comp
    명령어를 사용하여 사용 가능한 구성요소 버전을 확인할 수 있습니다.

    예를 들면 다음과 같습니다.

    yum --showduplicates list edge-ui
  2. apigee-setup를 사용하여 구성요소를 설치합니다.
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    예를 들면 다음과 같습니다.

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

    구성요소를 설치할 때는 버전이 아닌 구성요소 이름만 지정합니다.

  3. 롤백하는 구성요소를 호스팅하는 각 노드에 대해 이 프로세스를 반복합니다.