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 internet protocol (IP) yang memadai untuk memungkinkan beban kerja Apigee diskalakan guna menangani peningkatan traffic API dan/atau 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 tidak membuat ulang instance 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 reguler yang akan memengaruhi layanan API.

Menentukan tanggal pembuatan instance

Untuk menentukan tanggal pembuatan instance Apigee:

  1. 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 keterangan:

    • 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"
        }
      ]
    }
  2. 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 apa pun lagi 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 downtime dan tanpa kehilangan data, Anda harus membuat instance baru di region baru (diperluas) terlebih dahulu dan mengarahkan traffic API ke instance baru tersebut. Kemudian, Anda dapat menghabiskan 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 akan memberikan link ke skrip nanti 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 Anda mengetahui detail tentang cara instance asli dikonfigurasi.
  • Anda harus berhak 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 sesuai, 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 memenuhi syarat untuk dua region atau lebih, sebaiknya Anda menghubungi kami untuk mendapatkan pengecualian sementara agar tidak menjalankan beban kerja produksi dengan instance yang dikurangi selama proses pembuatan ulang.
  • 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 tidak memilih, blok 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.

  1. Pastikan Anda telah memenuhi prasyarat.
  2. Download skrip dari GitHub.
  3. Ikuti langkah-langkah dalam file README repositori Git untuk membuat instance baru.
  4. Konfigurasi ulang koneksi northbound dan southbound agar mengarah ke instance Apigee baru. Lihat Tentang perubahan northbound dan Tentang perubahan southbound.

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) dari instance akan berubah untuk instance baru.

Skrip yang disediakan akan mengonfigurasi ulang backend load balancer untuk Anda. Jika rute jaringan instance dikonfigurasi dengan grup instance terkelola (MIG), skrip yang disediakan akan membuat ulang MIG yang melakukan proxy traffic ke endpoint Apigee, dan melampirkan MIG sebagai backend ke layanan backend yang ada. Jika pemilihan rute 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 data 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/izin di endpoint target. Salah satu skrip yang disediakan menangani konfigurasi ulang NAT ini untuk Anda, jika diperlukan.