Menyesuaikan Permulaan Portal Developer Apigee di Cloud Marketplace

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Halaman ini menjelaskan opsi untuk menyesuaikan, memelihara, dan mengamankan solusi Memulai Portal Developer Apigee Anda. Setelah di-deploy, semua komponen layanan Cloud yang digunakan oleh portal umumnya dapat disesuaikan dengan mengikuti dokumentasi Google Cloud standar. Bagian di bawah ini memberikan opsi konfigurasi dan panduan produksi khusus untuk solusi portal.

Menghubungkan ke Apigee atau Apigee Hybrid

Untuk menggunakan solusi Kickstart Portal Developer Apigee dengan organisasi hybrid Apigee atau Apigee, portal harus di-deploy ke project Google Cloud yang digunakan selama penyediaan Apigee. Selama deployment, akun layanan dibuat dengan peran Apigee Developer Admin. Peran ini diperlukan untuk pemanggil akun layanan ke Apigee API.

Mengonfigurasi HTTPS untuk portal

Di konfigurasi peluncuran deployment portal, Anda dapat memilih untuk mengonfigurasi HTTPS bagi portal Anda. Opsi konfigurasi kotak centang mencakup:

Tidak dicentang Skrip deployment tidak akan otomatis mengaktifkan TLS. TLS dapat dikonfigurasi secara manual setelah deployment menggunakan Cloud Load Balancing. Opsi ini adalah opsi default.
Dicentang Paket deployment akan mengaktifkan TLS, menyediakan alamat IP, mengonfigurasi nama domain, dan meminta sertifikat SSL menggunakan nip.io. Penggunaan nip.io tidak didukung oleh Google, tetapi ditawarkan sebagai opsi praktis untuk menguji deployment. Jika opsi ini dipilih, berarti Anda menyetujui persyaratan dan ketentuan untuk nip.io.

Menggunakan Cloud SQL dengan CMEK

Instance Cloud SQL untuk portal dibuat di region yang Anda pilih selama konfigurasi peluncuran. Secara default, Google mengenkripsi data dalam penyimpanan menggunakan kunci enkripsi yang dikelola Google. Agar dapat menggunakan kunci enkripsi yang dikelola pelanggan (CMEK) untuk mengenkripsi data yang tersimpan di instance CloudSQL, ikuti langkah-langkah yang diuraikan dalam artikel Menggunakan kunci enkripsi yang dikelola pelanggan untuk mengonfigurasi kunci.

Mengelola Cloud SQL

Untuk mengelola instance Cloud SQL setelah deployment:

Mengonfigurasi dan memperbarui grup instance terkelola

Grup instance terkelola (MIG) adalah kumpulan instance virtual machine (VM) yang dapat dikelola sebagai satu entitas. Anda dapat membuat workload Anda skalabel dan sangat tersedia dengan memanfaatkan layanan MIG otomatis, termasuk: penskalaan otomatis, autohealing, deployment regional (beberapa zona), dan update otomatis.

Untuk mengonfigurasi MIG setelah deployment:

Image VM baru untuk solusi Kickstart Portal Developer Apigee akan dirilis secara berkala. Pelanggan dapat menggunakan langkah-langkah yang dijelaskan dalam Mengupdate instance di MIG untuk mengganti atau memulai ulang instance di MIG agar dapat menggunakan image terbaru.

Aktifkan IP pribadi dengan Kontrol Layanan VPC

Untuk mengaktifkan alamat IP pribadi untuk instance Cloud SQL Anda:

  • Pastikan akses layanan pribadi tersedia di jaringan VPC Anda. Lihat Mengonfigurasi akses layanan pribadi untuk melihat daftar mendetail langkah-langkah yang diperlukan.
  • Cloud Deployment Manager tidak didukung oleh Kontrol Layanan VPC. Guna mengaktifkan Deployment Manager untuk deployment portal Anda dalam Kontrol Layanan VPC, tambahkan akun layanan Cloud Deployment Manager untuk mengizinkan panggilan ke API yang dilindungi oleh Kontrol Layanan VPC.

Menyesuaikan kode portal

Jika penyesuaian dilakukan pada kode portal atau skrip startup setelah deployment, perubahan tersebut harus diekspor dan dicadangkan di Filestore agar tidak hilang selama update pada image dasar Apigee Developer Portal Kickstart.

Misalnya, jika modul Drupal baru diinstal pada instance Compute Engine, buat cadangan dengan mengikuti langkah-langkah berikut:

  1. Jalankan /opt/apigee/scripts/export-code.sh untuk mengekspor perubahan.
  2. Skrip ini menyalin file yang diekspor ke instance Filestore yang dipasang di /mnt/fileshare/portalname/.
  3. Mulai ulang instance dalam grup instance terkelola untuk memicu pengambilan perubahan di seluruh grup. Skrip startup akan otomatis mendeteksi apakah ada cadangan kode, memuat perubahan, memperbaiki izin file, dan menerapkan file settings.php.
  4. Mengupdate inti dan modul Drupal menggunakan composer update. Update Apigee ke image dasar hanya menyediakan update OS, patch PHP, dan update NGINX. Semua update inti dan modul Drupal dikelola oleh pelanggan dan harus diterapkan secara manual.

Untuk menambahkan penyesuaian pada skrip startup, buat skrip di /mnt/fileshare/$PORTAL_NAME/custom-startup-script.sh.

Jika menginstal paket PHP, jalankan perintah service supervisor restart untuk menerapkan perubahan.

Membuat cadangan

Pembuatan cadangan reguler direkomendasikan sebagai praktik terbaik untuk solusi Memulai Portal Developer Apigee Anda. Untuk mengetahui langkah-langkah mendetail, lihat:

Mengonfigurasi portal untuk penggunaan produksi

Untuk mengonfigurasi portal Anda untuk penggunaan produksi, sebaiknya ikuti langkah-langkah berikut:

Database Cloud SQL
  • Memverifikasi atau mengubah jenis mesin database
  • Menonaktifkan IP publik database dan mengonfigurasi IP Pribadi
  • Mengaktifkan pencadangan otomatis database
  • Mengaktifkan ketersediaan tinggi untuk database
Filestore
  • Mengaktifkan cadangan untuk Filestore
Cloud Load Balancing
  • Aktifkan Cloud CDN untuk menyimpan konten statis ke dalam cache
  • Tambahkan sertifikat SSL kustom jika diinginkan
Grup Instance Terkelola
  • Sesuaikan jumlah minimum dan maksimum instance yang diperlukan untuk traffic produksi
Authentication
  • Hapus batasan akses HTTP Basic Auth di situs Anda.

    Jalankan perintah berikut agar situs portal Anda dapat diakses secara publik:

    gcloud beta runtime-config configs variables set site_basic_auth/enabled 0 \
  --is-text --config-name=PORTAL_NAME --project=GCP_PROJECT_NAME
    gcloud beta compute instance-groups managed rolling-action \
  replace INSTANCE_GROUP_ID --region=GCP_REGION \
  --replacement-method=substitute --project=GCP_PROJECT_NAME

Langkah selanjutnya

  • Pelajari lebih lanjut Resource dukungan untuk solusi Apigee Developer Portal Kickstart.