Membuat ulang instance Apigee tanpa periode nonaktif

Halaman ini berlaku untuk Apigee, tetapi tidak untuk Apigee Hybrid.

Dokumen ini menjelaskan cara membuat ulang instance Apigee tanpa menyebabkan periode nonaktif pengelolaan API atau kehilangan data.

Pengantar

Instance Apigee yang dibuat sebelum 25 Januari 2022 tidak memiliki ruang alamat protokol internet (IP) yang cukup sehingga beban kerja Apigee tidak dapat diskalakan untuk menangani peningkatan traffic API dan/atau untuk memungkinkan Anda menambahkan lebih dari 10 lingkungan ke sebuah instance.

Pada 24 Januari 2022, Apigee memperkenalkan peningkatan untuk mengatasi masalah ini. Peningkatan ini mengurangi rentang IP yang diperlukan untuk melakukan peering jaringan VPC dengan Apigee dan menggunakan IP publik yang digunakan secara pribadi (PUPI) agar workload dapat diskalakan ke batas yang lebih tinggi.

Yang perlu dilakukan

Jika Anda memiliki instance Apigee yang dibuat sebelum 25 Januari 2022, Apigee merekomendasikan agar Anda menggantinya dengan instance baru, seperti yang dijelaskan dalam dokumen ini. Jika Anda tidak membuat ulang instance yang lebih lama, Anda mungkin mengalami masalah penskalaan dan jumlah lingkungan yang dapat Anda tambahkan ke instance akan terus dibatasi hingga 10. Selain itu, instance Anda mungkin akan berhenti mendapatkan update rutin yang akan memengaruhi layanan API.

Menentukan tanggal pembuatan instance

Untuk menentukan tanggal pembuatan instance Apigee:

Cantumkan detail untuk semua instance Apigee di organisasi Anda:

AUTH="Authorization: Bearer $(gcloud auth print-access-token)"

curl -i -X GET -H "$AUTH" \
"https://apigee.googleapis.com/v1/organizations/PROJECT_ID/instances"

Dengan keterangan:

AUTH adalah header Authentication dengan token pemilik. Pastikan project default untuk gcloud ditetapkan ke PROJECT_ID.
PROJECT_ID adalah project ID Cloud yang Anda buat saat menyediakan Apigee.

Contoh output:

{
  "instances": [
    {
      "name": "us-west1",
      "location": "us-west1",
      "host": "10.117.200.2",
      "port": "443",
      "createdAt": "1642698826000",
      "lastModifiedAt": "1655745226000",
      "diskEncryptionKeyName": "projects/myproject/locations/us-west1/keyRings/my-key-ring/cryptoKeys/my-key",
      "state": "ACTIVE",
      "peeringCidrRange": "SLASH_22",
      "runtimeVersion": "1-8-0-apigee-33",
      "ipRange": "10.117.200.0/22,10.81.174.192/28",
      "consumerAcceptList": [
        "myproject"
      ],
      "serviceAttachment": "projects/z11f28c6f3104980e-tp/regions/us-west1/serviceAttachments/apigee-us-west1-lbko"
    }
  ]
}

Untuk setiap instance, periksa nilai kolom createdAt dengan mendekode stempel waktu Unix untuk mendapatkan tanggal.
- Jika instance dibuat pada atau setelah 25 Januari 2022, Anda tidak perlu melakukan apa pun untuk instance tersebut.
- Jika instance dibuat sebelum 25 Januari 2022, sebaiknya ganti instance tersebut, seperti yang dibahas dalam dokumen ini.

Tentang prosedur pembuatan ulang

Untuk membuat ulang instance tanpa periode nonaktif dan tanpa kehilangan data, pertama-tama Anda harus membuat instance baru di region baru (diperluas) dan mengarahkan traffic API ke instance baru tersebut. Kemudian, Anda dapat menghabiskan instance yang ada, menghapusnya, dan membuatnya ulang di region yang sama dengan yang Anda hapus.

Apigee telah menyediakan serangkaian skrip yang menjalankan semua langkah yang diperlukan untuk membuat ulang dan mengonfigurasi sebuah instance. Kami menyediakan link ke skrip tersebut nanti dalam dokumen ini.

Prasyarat

Sebelum memulai langkah-langkah pembuatan ulang instance:

Anda harus memahami cara instance Apigee dibuat sejak awal. Langkah-langkah untuk membuat ulang instance bergantung pada Anda mengetahui detail tentang cara instance asli dikonfigurasi.
Anda harus berhak menyediakan Apigee di setidaknya dua region. Jika tidak yakin apakah Anda memiliki hak yang memadai, ikuti langkah-langkah untuk membuat instance di region baru. Jika Anda tidak memiliki hak yang tepat, upaya akan gagal dengan error batas. Dalam hal ini, hubungi dukungan Apigee untuk mendapatkan pengecualian sementara guna meningkatkan batas region Anda. Jika Anda sudah berhak mendapatkan dua region atau lebih, sebaiknya hubungi kami untuk mendapatkan pengecualian sementara agar beban kerja produksi Anda tidak dijalankan dengan instance yang dikurangi selama proses pembuatan ulang.
Proses pembuatan ulang instance mencakup penghapusan instance lama. Jika tidak mengikuti langkah untuk membuat instance baru di region yang diperluas, Anda akan mengalami periode nonaktif dan kehilangan data runtime, termasuk KVM, data cache, data kuota, dan data KMS. Oleh karena itu, perluasan region bersifat wajib untuk membuat ulang instance tanpa periode nonaktif atau kehilangan data.
Anda harus memiliki ruang dalam project untuk rentang IP tambahan blok /22 dan /28 guna membuat instance baru. Lihat juga Menentukan ukuran jaringan. Anda dapat merilis rentang ini saat region tambahan dihapus setelah pembuatan ulang instance selesai. Perlu diperhatikan bahwa blok /22 dapat Anda konfigurasi. Anda dapat memilih blok /28 yang akan digunakan oleh Apigee, atau jika tidak memilihnya, blok tersebut akan ditetapkan secara otomatis oleh Apigee dari blok mana pun yang tersedia.

Membuat ulang instance

Apigee telah menyediakan serangkaian skrip yang menjalankan semua langkah yang diperlukan untuk membuat ulang sebuah instance.

Pastikan Anda telah memenuhi prasyarat.
Download skrip dari GitHub.
Ikuti langkah-langkah dalam file README repositori Git untuk membuat instance baru.
Konfigurasi ulang koneksi arah utara dan selatan agar mengarah ke instance Apigee baru. Lihat Tentang perubahan ke arah utara dan Tentang perubahan ke arah selatan.

Tentang perubahan ke arah utara

Arah utara merujuk ke traffic API dari klien eksternal atau internal ke Apigee melalui load balancer. Saat instance dihapus dan dibuat ulang, alamat IP arah utara dan ID lampiran layanan Private Service Connect (PSC) dari instance akan berubah untuk instance baru.

Skrip yang disediakan mengonfigurasi ulang backend load balancer untuk Anda. Jika perutean jaringan instance dikonfigurasi dengan grup instance terkelola (MIG), skrip yang disediakan akan membuat ulang MIG yang mem-proxy traffic ke endpoint Apigee, dan memasang MIG sebagai backend ke layanan backend yang ada. Jika perutean dikonfigurasi dengan koneksi layanan pribadi (PSC), skrip akan membuat ulang grup endpoint jaringan (NEG) ke lampiran endpoint layanan Apigee dan melampirkan NEG baru sebagai backend ke layanan backend yang ada.

Perhatikan bahwa Anda tidak perlu mengubah data nama host di grup lingkungan apa pun yang terkait dengan instance lama.

Perubahan arah selatan

Arah Selatan merujuk ke traffic API dari Apigee ke layanan target proxy API Anda.

Saat instance dihapus dan dibuat ulang, setiap alamat IP NAT khusus selatan akan dirilis. Jadi, Anda harus mencadangkan dan mengaktifkan alamat IP baru untuk NAT serta mengonfigurasi ulang firewall/allowlisting pada endpoint target. Salah satu skrip yang disediakan menangani konfigurasi ulang NAT ini untuk Anda, jika diperlukan.