Mengupgrade Apigee Hybrid

Melakukan upgrade ke versi baru

Ikuti langkah-langkah berikut untuk mengupgrade Apigee Hybrid ke versi baru:

Download dan instal apigeectl versi baru.

apigeectl adalah antarmuka command line (CLI) untuk menginstal dan mengelola Apigee Hybrid di cluster Kubernetes.

Download versi apigeectl yang ingin Anda upgrade:

  1. Download paket rilis untuk sistem operasi Anda:

    Mac 64 bit:

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

    Linux 64 bit

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

    Mac 32 bit:

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

    Linux 32 bit

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/version_number/apigeectl_linux_32.tar.gz
  2. Mengidentifikasi direktori penginstalan dasar yang dibuat saat Apigee Hybrid pertama kali diinstal. Tujuan direktori dasar adalah direktori tempat direktori $APIGEEGTL_HOME berada. Dalam contoh berikut, direktori dasarnya adalah /Users/myhome/hybrid:

    echo $APIGEECTL_HOME
    /Users/myhome/hybrid/apigeectl
  3. Ekstrak konten file gzip yang didownload ke direktori hybrid base Apigee:

    tar xvzf filename.tar.gz -C path-to-base-directory
  4. cd ke direktori dasar.
  5. Isi {i>tar<i} secara {i>default<i} diperluas menjadi direktori dengan versi dan platform atas namanya. Misalnya: ./apigeectl_1.2.0-f7b96a8_linux_64.

  6. Ganti nama direktori apigeectl saat ini. Misalnya, jika versi saat ini adalah 1.1.1, mengganti nama direktori apigeectl menjadi apigeectl_1.1.1.
  7. Ganti nama direktori penginstalan yang baru diekstrak menjadi apigeectl. Hal ini sekarang yang ditunjuk dengan lingkungan $APIGEECTL_HOME.
  8. Membersihkan tugas yang telah selesai untuk namespace runtime hybrid, dengan namespace adalah yang ditentukan dalam file pengganti, jika Anda menentukan namespace. Jika tidak, namespace default adalah apigee:
    kubectl delete job -n namespace \
      $(kubectl get job -n namespace -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  9. Bersihkan tugas yang sudah selesai untuk namespace apigee-system:
    kubectl delete job -n apigee-system \
      $(kubectl get job -n apigee-system -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  10. Bersihkan tugas yang sudah selesai untuk namespace istio-system:
    kubectl delete job -n istio-system \
      $(kubectl get job -n istio-system -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  11. cd ke direktori ./hybrid-files:
  12. Lakukan inisialisasi apigeectl untuk versi baru:
    $APIGEECTL_HOME/apigeectl init -f my-overrides.yaml
  13. Periksa untuk menentukan kapan inisialisasi selesai:
    $APIGEECTL_HOME/apigeectl check-ready -f my-overrides.yaml
  14. Setelah check-ready lulus, jalankan apigeectl apply:
    $APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml
  15. Jalankan kembali check-ready untuk menentukan kapan upgrade selesai.

Me-roll back upgrade

Ikuti langkah-langkah berikut untuk melakukan roll back upgrade sebelumnya:

  1. Membersihkan pekerjaan yang telah selesai:
    kubectl delete job -n namespace $(kubectl get job -n namespace -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
  2. Di direktori root penginstalan yang ingin Anda roll back, jalankan apigeectl init lalu menjalankan apigeectl apply:
      $APIGEECTL_HOME/apigeectl init -f my-overrides.yaml
      $APIGEECTL_HOME/apigeectl apply -f my-overrides.yaml