Actualizar la versión de Apigee Hybrid

Actualizar a una versión nueva

Sigue estos pasos para actualizar Apigee hybrid a una nueva versión:

Descarga e instala una nueva versión de apigeectl.

apigeectl es la interfaz de línea de comandos (CLI) para instalar y gestionar Apigee Hybrid en un clúster de Kubernetes.

Descarga la versión de apigeectl a la que quieras actualizar:

  1. Descarga el paquete de lanzamiento para tu sistema operativo:

    Mac de 64 bits:

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/version_number/apigeectl_mac_64.tar.gz

    Linux de 64 bits

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/version_number/apigeectl_linux_64.tar.gz

    Mac de 32 bits:

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/version_number/apigeectl_mac_32.tar.gz

    Linux de 32 bits

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/version_number/apigeectl_linux_32.tar.gz
  2. Identifica el directorio de instalación base que se creó cuando se instaló originalmente Apigee hybrid. El directorio base es el directorio en el que se encuentra el directorio $APIGEEGTL_HOME. En el siguiente ejemplo, el directorio base es /Users/myhome/hybrid:

    echo $APIGEECTL_HOME
    /Users/myhome/hybrid/apigeectl
  3. Extrae el contenido del archivo gzip descargado en el directorio base de Apigee Hybrid:

    tar xvzf filename.tar.gz -C path-to-base-directory
  4. cd al directorio base.
  5. De forma predeterminada, el contenido de tar se descomprime en un directorio cuyo nombre incluye la versión y la plataforma. Por ejemplo: ./apigeectl_1.2.0-f7b96a8_linux_64.

  6. Cambia el nombre del directorio apigeectl actual. Por ejemplo, si la versión actual es 1.1.1, cambia el nombre del directorio apigeectl a apigeectl_1.1.1.
  7. Cambia el nombre del directorio de instalación recién extraído a apigeectl. Ahora, $APIGEECTL_HOME apunta a este entorno.
  8. Limpia las tareas completadas del espacio de nombres del tiempo de ejecución híbrido, donde namespace es el espacio de nombres especificado en el archivo de anulaciones, si has especificado alguno. Si no es así, el espacio de nombres predeterminado es apigee:
    kubectl delete job -n namespace \
      $(kubectl get job -n namespace -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  9. Limpia las tareas completadas del espacio de nombres apigee-system:
    kubectl delete job -n apigee-system \
      $(kubectl get job -n apigee-system -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  10. Limpia las tareas completadas del espacio de nombres istio-system:
    kubectl delete job -n istio-system \
      $(kubectl get job -n istio-system -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  11. cd al directorio ./hybrid-files:
  12. Inicializa apigeectl para la nueva versión:
    $APIGEECTL_HOME/apigeectl init -f my-overrides.yaml
  13. Comprueba cuándo se ha completado la inicialización:
    $APIGEECTL_HOME/apigeectl check-ready -f my-overrides.yaml
  14. Cuando pase check-ready, ejecuta apigeectl apply:
    $APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml
  15. Vuelve a ejecutar check-ready para determinar cuándo se ha completado la actualización.

Restaurar una versión anterior de una actualización

Sigue estos pasos para revertir una actualización anterior:

  1. Limpiar las tareas completadas:
    kubectl delete job -n namespace $(kubectl get job -n namespace -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  2. En el directorio raíz de la instalación a la que quieras volver, ejecuta apigeectl init y, a continuación, ejecuta apigeectl apply:
      $APIGEECTL_HOME/apigeectl init -f my-overrides.yaml
      $APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml