Halaman ini diterjemahkan oleh Cloud Translation API.

Mengupgrade Apigee Hybrid

Mengupgrade ke versi 1.2.0

Ikuti langkah-langkah berikut untuk mengupgrade Apigee hybrid ke versi 1.2.0:

Langkah 1: Mengupgrade Kubernetes dan mendownload paket rilis

Upgrade platform Kubernetes Anda sebagai berikut. Ikuti dokumentasi platform Anda jika Anda memerlukan bantuan:

Platform	Mengupgrade ke versi
GKE	1.14.x
Anthos	1,2
AKS	1.14.x

Download paket rilis untuk sistem operasi Anda:

Mac 64-bit:

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

Linux 64 bit

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

Mac 32 bit:

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

Linux 32 bit

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

Langkah 2: Konfigurasi ulang direktori penginstalan

Identifikasi direktori penginstalan dasar yang dibuat saat Apigee hybrid diinstal pertama kali. Direktori dasar adalah direktori tempat direktori $APIGEEGTL_HOME berada. Pada contoh berikut, direktori dasarnya adalah /Users/myhome/hybrid:
```
echo $APIGEECTL_HOME
/Users/myhome/hybrid/apigeectl
```
Ekstrak konten file gzip yang didownload ke direktori dasar Apigee Hybrid:
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
cd ke direktori dasar.
Secara default, konten tar diperluas ke dalam direktori dengan versi dan platform dalam namanya. Misalnya: ./apigeectl_1.2.0-f7b96a8_linux_64.
Ganti nama direktori apigeectl saat ini. Misalnya, jika versi saat ini adalah 1.1.1, ganti nama direktori apigeectl menjadi apigeectl_1.1.1.
Ganti nama direktori penginstalan yang baru diekstrak menjadi apigeectl. Ini sekarang adalah tempat $APIGEECTL_HOME lingkungan mengarah.

Langkah 3: Perbarui file penggantian

Buat salinan file penggantian, dan simpan file lama dengan hati-hati jika Anda perlu melakukan rollback. Pada langkah-langkah berikut, Anda akan membuat perubahan yang diperlukan pada file penggantian sebelum menerapkannya ke cluster.
CATATAN: Untuk mengupgrade ke versi 1.2.0, Anda harus membuat perubahan pada file penggantian yang tidak kompatibel dengan versi sebelumnya. Perubahan file penggantian yang dijelaskan di langkah berikutnya diperlukan.

Perbarui file penggantian Anda dengan perubahan yang dijelaskan di bawah:

Berikut adalah ringkasan perubahan konfigurasi yang harus Anda buat pada file penggantian. Contoh lengkap diberikan dalam tabel setelah ringkasan. Seperti yang akan Anda lihat, properti envs[] telah berubah secara signifikan dari versi sebelumnya:

Properti envs[].hostAlias telah dihapus dan diganti dengan properti baru virtualhosts.hostAliases[].
CATATAN: Jika Anda menggunakan satu karakter pengganti '*' untuk alias host lingkungan di versi sebelumnya, di versi 1.2.0, Anda HARUS menggunakan nama DNS yang sepenuhnya memenuhi syarat atau karakter pengganti subdomain dalam konfigurasi alias host virtual. Contoh: *.mydomain.com. Konfigurasi karakter pengganti tunggal hostAliases['*'] tidak lagi didukung.
Anda harus menambahkan properti konfigurasi baru yang diperlukan virtualhosts.
Anda harus memindahkan properti envs[].sslCertPath dan envs[].sslKeyPath dari envs ke virtualhosts.
Anda harus menambahkan stanza konfigurasi virtualhosts.routingRules. Properti virtualhosts.routingRules menggantikan properti envs[].paths sebelumnya. Jika memiliki envs[].paths dalam file penggantian, Anda harus menghapusnya. Untuk informasi selengkapnya tentang konfigurasi host virtual, lihat Mengonfigurasi host virtual.

Tabel di bawah ini menggambarkan perbedaan antara file penggantian 1.1.1 dan file versi 1.2.0. Contoh ini dimaksudkan untuk menyoroti jenis perubahan yang perlu Anda buat untuk versi 1.2.0:

Konfigurasi v1.1.x	Konfigurasi v1.2.0
envs: - name: test1 hostAlias: "api.example.com" sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.pem serviceAccountPaths: synchronizer: ./sa/sync.json udca: ./sa/udca.json paths: uri: prefixes: - /orders - /items - name: test2 hostAlias: "api.example.com" sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.pem serviceAccountPaths: synchronizer: ./sa/sync.json udca: ./sa/udca.json paths: uri: prefixes: - /v0/hello - /httpbin	virtualhosts: - name: default hostAliases: ["api.example.com"] sslCertPath: ./certs/fullchain.pem sslKeyPath: ./certs/privkey.pem routingRules: - paths: - /orders - /items env: test1 - paths: - /v0/hello - /httpbin env: test2 envs: - name: test1 serviceAccountPaths: synchronizer: ./sa/synchronizer.json udca: ./sa/udca.json - name: test2 serviceAccountPaths: synchronizer: ./sa/synchronizer.json udca: ./sa/udca.json

Konfigurasi v1.1.x

Konfigurasi v1.2.0

envs:
  - name: test1
    hostAlias: "api.example.com"
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    serviceAccountPaths:
      synchronizer: ./sa/sync.json
      udca: ./sa/udca.json
    paths:
      uri:
        prefixes:
          - /orders
          - /items
  - name: test2
    hostAlias: "api.example.com"
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    serviceAccountPaths:
      synchronizer: ./sa/sync.json
      udca: ./sa/udca.json
    paths:
      uri:
        prefixes:
          - /v0/hello
          - /httpbin

virtualhosts:
  - name: default
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - paths:
        - /orders
        - /items
        env: test1
      - paths:
        - /v0/hello
        - /httpbin
        env: test2

envs:
  - name: test1
    serviceAccountPaths:
      synchronizer: ./sa/synchronizer.json
      udca: ./sa/udca.json
  - name: test2
    serviceAccountPaths:
      synchronizer: ./sa/synchronizer.json
      udca: ./sa/udca.json

CATATAN: Jika tidak menentukan envs[].paths (seperti ditunjukkan dalam tabel di atas), Anda dapat menghilangkan properti virtualhosts[].routingRules.paths[] dalam upgrade. Secara default, jalurnya adalah "/". Misalnya, jika ingin menggunakan jalur default "/", Anda dapat mengonfigurasi virtualhosts[].routingRules seperti ini:

virtualhosts:
  - name: default
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: test1
  - name: prod
    hostAliases: ["api.example.com"]
    sslCertPath: ./certs/fullchain.pem
    sslKeyPath: ./certs/privkey.pem
    routingRules:
      - env: test2

Langkah 4: Terapkan upgrade ke cluster

Jika mengaktifkan Apigee Connect dalam penginstalan versi 1.1.1, Anda harus menghapus deployment:
1. Pertama, cantumkan Deployment Apigee:
```
kubectl -n namespace get ad
```
2. Hapus deployment Apigee Connect:
```
kubectl -n namespace delete ad apigee-connect-name
```
Mencantumkan pod:
```
kubectl get pods -n namespace
```
Hapus pod apigee-cps-setup dari cluster. Gunakan nama lengkap pod, yang menyertakan nama organisasi Anda, seperti yang ditampilkan dalam perintah sebelumnya. Contoh:
```
kubectl -n namespace delete pod apigee-cps-setup-org
```

Hapus pod apigee-cps-create-user di namespace yang sama:

kubectl -n namespace delete pod apigee-cps-create-user

Bersihkan tugas yang telah selesai untuk namespace runtime campuran, dengan namespace adalah namespace yang ditentukan dalam file penggantian, jika Anda menentukan namespace. Jika tidak, namespace defaultnya adalah apigee:
```
kubectl delete job -n namespace \
  $(kubectl get job -n namespace -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
```

Bersihkan tugas yang telah 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}')

Bersihkan tugas yang telah 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}')

cd ke direktori ./hybrid-files:

Lakukan inisialisasi apigeectl untuk versi baru:

$APIGEECTL_HOME/apigeectl init -f overrides/overrides-file.yaml

Periksa untuk menentukan kapan inisialisasi selesai:

$APIGEECTL_HOME/apigeectl check-ready -f overrides/overrides-file.yaml

Saat check-ready membalas dengan "Semua penampung siap", Anda dapat mencoba penginstalan "uji coba". Jalankan perintah apply dengan flag --dry-run=true. Dengan melakukan pengujian kering, Anda dapat memeriksa error sebelum perubahan apa pun dilakukan pada cluster:
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides-file.yaml --dry-run=true
```
Jika tidak ada error, Anda dapat menerapkan komponen runtime khusus Apigee ke cluster:
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides-file.yaml
```
Jalankan ulang check-ready untuk menentukan kapan upgrade selesai.

Me-roll back upgrade

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

Bersihkan tugas yang telah selesai untuk namespace runtime campuran, dengan namespace adalah namespace yang ditentukan dalam file penggantian, jika Anda menentukan namespace. Jika tidak, namespace defaultnya adalah apigee:
```
kubectl delete job -n namespace \
  $(kubectl get job -n namespace -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
```

Bersihkan tugas yang telah 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}')

Bersihkan tugas yang telah 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}')

Hapus deployment Apigee Operators. Operasi ini tidak akan memengaruhi traffic runtime Anda:
```
kubectl -n apigee-system delete deployment apigee-controller-manager
```
Ubah variabel $APIGEECTL_HOME agar mengarah ke direktori yang berisi versi asli apigeectl. Contoh:
```
export APIGEECTL_HOME=path-to-original-apigeectl-directory
```
Di direktori root penginstalan yang ingin Anda roll back, jalankan apigeectl init, lalu jalankan apigeectl apply. Pastikan untuk menggunakan file penggantian asli untuk versi yang ingin Anda rollback:
```
  $APIGEECTL_HOME/apigeectl init -f overrides/original-overrides.yaml
  $APIGEECTL_HOME/apigeectl apply -f overrides/original-overrides.yaml
```