Menyesuaikan Kickstart Portal Developer Apigee di Cloud Marketplace

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Halaman ini menjelaskan opsi untuk menyesuaikan, mengelola, dan mengamankan solusi Kickstart 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 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 Apigee atau Apigee hybrid, 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

Dalam konfigurasi peluncuran deployment portal, Anda dapat memilih untuk mengonfigurasi HTTPS untuk portal. 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. 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. Memilih opsi ini menunjukkan persetujuan atas 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 Google-owned and Google-managed encryption keys. Untuk menggunakan kunci enkripsi yang dikelola pelanggan (CMEK) guna mengenkripsi data yang disimpan di instance CloudSQL, ikuti langkah-langkah yang diuraikan dalam Menggunakan kunci enkripsi yang dikelola pelanggan untuk mengonfigurasi kunci.

Mengelola Cloud SQL

Untuk mengelola instance Cloud SQL setelah deployment:

Mengonfigurasi dan mengupdate grup instance terkelola

Grup instance terkelola (MIG) adalah kumpulan instance virtual machine (VM) yang dapat Anda kelola sebagai satu entity. Anda dapat membuat beban kerja yang 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.

Mengaktifkan 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 mengetahui daftar mendetail langkah-langkah yang diperlukan.
  • Cloud Deployment Manager tidak didukung oleh Kontrol Layanan VPC. Untuk 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 untuk mencegah kehilangannya selama update pada image dasar Portal Developer Apigee Kickstart.

Misalnya, jika modul Drupal baru diinstal di instance Compute Engine, buat cadangan menggunakan langkah-langkah berikut:

  1. Jalankan /opt/apigee/scripts/export-code.sh untuk mengekspor perubahan.
  2. Skrip 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 secara otomatis mendeteksi apakah ada cadangan kode, memuat perubahan, memperbaiki izin file, dan menerapkan file settings.php.
  4. Perbarui 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 ke 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 Kickstart 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
  • Nonaktifkan IP publik database dan konfigurasikan IP Pribadi
  • Mengaktifkan pencadangan otomatis database
  • Mengaktifkan ketersediaan tinggi untuk database
Filestore
  • Mengaktifkan pencadangan untuk Filestore
Cloud Load Balancing
  • Mengaktifkan Cloud CDN untuk menyimpan konten statis ke dalam cache
  • Menambahkan sertifikat SSL kustom jika diinginkan
Grup Instance Terkelola
  • Sesuaikan jumlah minimum dan maksimum instance yang diperlukan untuk traffic produksi
Authentication
  • Hapus pembatasan akses Autentikasi Dasar HTTP 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 berikutnya

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