Menyesuaikan Permulaan 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 ini memberikan opsi konfigurasi dan panduan produksi khusus untuk solusi portal.

Terhubung 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 wajib diisi bagi 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 mengaktifkan TLS secara otomatis. TLS dapat dikonfigurasi secara manual setelah deployment menggunakan Cloud Load Balancing. Ini adalah opsi default.
Dicentang Paket deployment akan mengaktifkan TLS, menyediakan alamat IP, mengkonfigurasi nama domain, dan meminta sertifikat SSL menggunakan nip.io. Penggunaan nip.io tidak didukung oleh Google, tetapi ditawarkan sebagai opsi praktis untuk deployment pengujian. Memilih opsi ini menunjukkan persetujuan terhadap 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. Untuk menggunakan kunci enkripsi yang dikelola pelanggan (Customer-Managed Encryption Key/CMEK) untuk mengenkripsi data yang disimpan di instance CloudSQL, ikuti langkah-langkah yang diuraikan dalam Menggunakan kunci enkripsi yang dikelola pelanggan mengkonfigurasi 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 entity tunggal. 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 Memperbarui di MIG untuk mengganti atau memulai ulang instance di MIG agar dapat menggunakan gambar 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 mengetahui daftar mendetail yang berisi langkah-langkah yang diperlukan.
  • Cloud Deployment Manager tidak didukung oleh Kontrol Layanan VPC. Untuk mengaktifkan Deployment Manager bagi portal Anda deployment dalam Kontrol Layanan VPC, menambahkan 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 kehilangan selama update pada Kickstart Portal Developer Apigee image dasar.

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 ini menyalin file yang diekspor ke instance Filestore yang terpasang 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. Update inti dan modul Drupal menggunakan composer update. Update Apigee pada 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 tersebut.

Membuat cadangan

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

Mengonfigurasi portal untuk penggunaan produksi

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

Database Cloud SQL
  • Memverifikasi atau mengubah jenis mesin database
  • Nonaktifkan IP publik database dan mengonfigurasi IP Pribadi
  • Aktifkan pencadangan database otomatis
  • 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 khusus jika diinginkan
Grup Instance Terkelola
  • Menyesuaikan jumlah minimum dan maksimum instance yang diperlukan untuk traffic produksi
Authentication
  • Hapus pembatasan akses HTTP Basic Auth di situs Anda.

    Jalankan perintah berikut untuk membuat 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