Halaman ini diterjemahkan oleh Cloud Translation API.

Membuat ulang instance Apigee tanpa periode nonaktif

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

Lihat dokumentasi Apigee Edge.

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 memadai untuk memungkinkan workload Apigee diskalakan guna menangani peningkatan traffic API dan/atau untuk memungkinkan Anda menambahkan lebih dari 10 lingkungan ke instance.

Pada 24 Januari 2022, Apigee memperkenalkan peningkatan untuk mengatasi masalah ini. Peningkatan ini mengurangi rentang IP yang diperlukan untuk melakukan peering jaringan VPC Anda dengan Apigee dan menggunakan IP publik yang digunakan secara pribadi (PUPI) untuk memungkinkan workload 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 ditambahkan ke instance akan terus dibatasi hingga 10. Selain itu, instance Anda mungkin berhenti mendapatkan update rutin yang akan memengaruhi layanan API.

Menentukan tanggal pembuatan instance

Untuk menentukan tanggal pembuatan instance Apigee:

Mencantumkan 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:

AUTH adalah header Autentikasi 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 tindakan lebih lanjut untuk instance tersebut.
- Jika instance dibuat sebelum 25 Januari 2022, sebaiknya ganti instance, seperti yang dibahas dalam dokumen ini.

Tentang prosedur pembuatan ulang

Untuk membuat ulang instance dengan zero downtime dan tanpa kehilangan data, Anda harus membuat instance baru terlebih dahulu di region baru (yang diperluas) dan mengarahkan traffic API ke instance baru tersebut. Kemudian, Anda dapat menghentikan instance yang ada, menghapusnya, dan membuatnya ulang di region yang sama dengan instance yang Anda hapus.

Apigee telah menyediakan serangkaian skrip yang melakukan semua langkah yang diperlukan untuk membuat ulang dan mengonfigurasi instance. Kami menyediakan link ke skrip tersebut di bagian selanjutnya dalam dokumen ini.

Prasyarat

Sebelum Anda memulai langkah-langkah pembuatan ulang instance:

Anda harus memahami cara pembuatan instance Apigee sejak awal. Langkah-langkah untuk membuat ulang instance bergantung pada pengetahuan Anda tentang detail cara instance asli dikonfigurasi.
Anda harus memiliki hak untuk menyediakan Apigee di setidaknya dua region. Jika Anda 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 tersebut akan gagal dengan error batas. Dalam hal ini, hubungi dukungan Apigee untuk mendapatkan pengecualian sementara guna meningkatkan batas wilayah Anda. Jika Anda sudah memiliki hak atas dua atau beberapa region, sebaiknya hubungi kami untuk mendapatkan pengecualian sementara agar tidak menjalankan workload produksi dengan instance yang lebih kecil selama proses pembuatan ulang.
Proses pembuatan ulang instance mencakup penghapusan instance lama. Jika Anda tidak mengikuti langkah-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 wajib dilakukan untuk membuat ulang instance tanpa periode nonaktif atau kehilangan data.
Anda harus memiliki ruang di project untuk rentang IP tambahan blok /22 dan /28 untuk membuat instance baru. Lihat juga Penentuan ukuran jaringan. Anda dapat melepaskan rentang ini saat region tambahan dihapus setelah pembuatan ulang instance selesai. Perhatikan bahwa blok /22 dapat dikonfigurasi oleh Anda. Anda dapat memilih blok /28 yang akan digunakan Apigee, atau jika Anda tidak memilih, blok tersebut akan ditetapkan secara otomatis oleh Apigee dari blok yang tersedia.

Membuat ulang instance

Apigee telah menyediakan serangkaian skrip yang melakukan semua langkah yang diperlukan untuk membuat ulang 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 utara dan selatan untuk mengarah ke instance Apigee yang baru. Lihat Tentang perubahan ke utara dan Tentang perubahan ke selatan.

Tentang perubahan northbound

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

Skrip yang disediakan akan 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 memproksi traffic ke endpoint Apigee, dan melampirkan MIG sebagai backend ke layanan backend yang ada. Jika perutean dikonfigurasi dengan Private Service Connect (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 catatan nama host di grup lingkungan yang terkait dengan instance lama.

Perubahan ke arah selatan

Southbound mengacu pada traffic API dari Apigee ke layanan target proxy API Anda.

Saat instance dihapus dan dibuat ulang, semua alamat IP NAT southbound khusus akan dirilis. Jadi, Anda harus mencadangkan dan mengaktifkan alamat IP baru untuk NAT dan mengonfigurasi ulang firewall/daftar yang diizinkan di endpoint target. Salah satu skrip yang disediakan menangani rekonfigurasi NAT ini untuk Anda, jika diperlukan.