Halaman ini berlaku untuk Apigee dan Apigee Hybrid.
Baca dokumentasi Apigee Edge.
Saat membuat portal developer, secara default Anda diberi nama domain contoh Apigee untuk mengakses portal live Anda dalam format berikut:
https://orgname-portalname.apigee.io
Dengan orgname
adalah nama organisasi dan portalname
ditentukan menggunakan nama portal yang dikonversi menjadi semua huruf kecil serta menghapus spasi dan tanda hubung.
Sebelum meluncurkan portal developer, sebaiknya berikan nama domain kustom Anda sendiri. Misalnya, alternatif yang populer adalah:
https://developers.example.com
Untuk pertimbangan penggunaan domain kustom dengan penyedia identitas SAML, lihat Menggunakan domain kustom dengan penyedia identitas SAML.
Langkah-langkah untuk menyesuaikan domain Anda
Untuk menyesuaikan nama domain, lakukan langkah-langkah berikut:
- Daftarkan nama domain Anda.
- Buat sertifikat TLS untuk domain kustom Anda. Anda akan memerlukan sertifikat tersebut saat membuat load balancer.
- Tentukan nama host default untuk portal Anda.
- Buat grup endpoint jaringan Internet (NEG) untuk menentukan endpoint backend ke portal terintegrasi untuk load balancer.
- Buat load balancer yang mengarah ke NEG Internet dan mencadangkan IP untuk permintaan klien yang masuk.
- Konfigurasi domain kustom di portal Anda.
- Perbarui DNS untuk membuat data baru untuk host domain kustom.
Langkah 1: Daftarkan nama domain Anda
Jika Anda perlu mendaftarkan domain baru, ada banyak situs pendaftaran domain populer yang tersedia, seperti Google Domains. Anda bebas memilih situs pendaftaran domain.
Saat menentukan nama domain Anda, pertimbangkan bahwa URL yang mudah digunakan dan dapat dibaca manusia merupakan komponen penting dalam meningkatkan pengoptimalan mesin telusur, seperti yang dijelaskan dalam Menerapkan pengoptimalan mesin telusur (SEO).
Langkah 2: Buat sertifikat TLS untuk domain kustom
Buat sertifikat TLS untuk domain kustom Anda menggunakan alat pilihan, seperti Let's Encrypt. Untuk informasi selengkapnya, lihat:
Langkah 3: Tentukan nama host default untuk portal Anda
Untuk menentukan nama host default untuk portal Anda:
- Di UI Apigee, pilih Publish > Portals di menu navigasi samping. Daftar portal akan ditampilkan.
Salin konten di kolom Lokasi untuk portal yang domain kustomnya ingin Anda buat.
Anda akan memerlukan nilai ini di langkah berikutnya.
Langkah 4: Buat NEG Internet
Pada langkah ini, Anda akan membuat grup endpoint jaringan Internet (NEG) untuk menentukan endpoint backend ke portal terintegrasi untuk load balancer. Untuk mengetahui informasi selengkapnya, lihat Ringkasan grup endpoint jaringan internet.
Di konsol Google Cloud, buka halaman Dasbor dan pilih atau buat project Google Cloud.
Pilih Compute Engine > Grup endpoint jaringan di navigator.
Klik Create network endpoint group.
Konfigurasikan kolom berikut:
Kolom Nilai Nama Masukkan nama untuk NEG Internet. Jenis grup endpoint jaringan Pilih Grup endpoint jaringan (Internet). Endpoint jaringan baru - Add-through: Pilih Fully qualified domain name and port.
- Nama domain yang sepenuhnya memenuhi syarat: Masukkan nama domain default yang Anda salin di Langkah 3: Tentukan nama host default untuk portal Anda.
Anda dapat membiarkan kolom lainnya disetel ke default.
Klik Create.
NEG Internet dibuat.
Langkah 5: Membuat load balancer
Membuat load balancer yang mengarah ke NEG Internet dan mencadangkan IP untuk permintaan klien yang masuk.
Memulai konfigurasi Anda
Di Konsol Google Cloud, buka halaman Load balancing.
- Klik Create load balancer.
- Untuk Type of load balancer, pilih Application Load Balancer (HTTP/HTTPS) lalu klik Next.
- Untuk Public facing or internal, pilih Public facing (eksternal), lalu klik Next.
- Untuk Global or single region deployment, pilih Best for global Workload, lalu klik Next.
- Untuk Load balancer Generation, pilih Global external Application Load Balancer, lalu klik Next.
- Klik Konfigurasikan.
Mengonfigurasi load balancer
Klik setiap kategori dan konfigurasikan load balancer seperti yang dijelaskan dalam tabel berikut.
Kategori Langkah Konfigurasi frontend Cadangkan alamat IP untuk permintaan klien masuk dan upload sertifikat TLS yang dibuat di Langkah 2: Buat sertifikat TLS:
- Di bagian Create global external Application Load Balancer, posisikan kursor di atas Frontend configuration dan klik tanda panah.
- Masukkan nama untuk frontend di kolom Name.
- Pilih HTTPS dari menu drop-down Protocol.
- Di menu drop-down IP address, pilih Create IP address
Dialog Cadangkan alamat IP statis baru akan ditampilkan. - Masukkan nama untuk alamat IP statis di kolom Name.
- Jika perlu, masukkan deskripsi.
- Klik Reserve.
- Simpan alamat IP yang telah dicadangkan untuk digunakan saat menyiapkan data DNS.
- Pilih Buat sertifikat baru di drop-down Sertifikat.
Jendela Buat sertifikat baru akan terbuka. - Masukkan nama untuk sertifikat baru di kolom Name.
- Pilih Upload sertifikat saya di bagian Buat mode.
- Upload detail sertifikat TLS Anda, termasuk kunci publik, rantai sertifikat, dan kunci pribadi.
- Klik Create.
- Klik Done untuk membuat port dan IP frontend baru.
Konfigurasi backend Konfigurasikan konfigurasi backend untuk mengarahkan traffic masuk ke NEG Internet yang dibuat di Langkah 4: Buat grup endpoint jaringan Internet (NEG):
- Di bagian Create global external Application Load Balancer, posisikan kursor di atas Backend configuration lalu klik tanda panah.
- Di bagian Backend services & backend buckets, pilih Backend services > Create a backend service dari menu drop-down.
Jendela Create backend service akan terbuka. - Masukkan nama di kolom Name.
- Pilih Internet network endpoint group di drop-down Backend type.
- Pilih HTTPS sebagai protokol.
- Di bagian New backend, pilih Internet NEG yang Anda buat di Langkah 4: Create an Internet network endpoint group (NEG) pada menu drop-down Internet network endpoint group, dan klik Done.
- Hapus centang pada kotak Aktifkan Cloud CDN.
- Anda dapat membiarkan semua nilai lain disetel ke default.
- Klik Create.
Aturan host dan jalur Konfigurasikan aturan host dan jalur untuk menentukan cara traffic akan diarahkan:
- Di bagian Create global external Application Load Balancer, posisikan kursor di atas Host and path rules, lalu klik tanda panah.
- Klik Advanced host and path rule (URL redirect, URL draf) di bagian Mode.
- Di bagian New host and path rule:
- Pilih Route traffic to a single backend di drop-down Action.
- Luaskan Add-on action (penulisan ulang URL).
- Masukkan nama domain default yang Anda salin di Langkah 3: Tentukan nama host default untuk portal Anda di kolom penulisan ulang host.
- Pilih layanan backend yang Anda konfigurasi di drop-down Backend.
- Klik Done.
Klik Create di halaman Create global external Application Load Balancer.
Langkah 6: Konfigurasikan domain kustom di portal Anda
Untuk mengonfigurasi domain kustom di portal Anda:
- Di UI Apigee, pilih Publish > Portals di menu navigasi samping.
Daftar portal akan ditampilkan. - Pilih portal Anda dalam daftar.
- Pilih Setelan di halaman landing atau di drop-down pada menu navigasi atas.
- Klik tab Domains.
- Masukkan nama domain kustom Anda di kolom Domain.
- Klik Enable.
Uji apakah saat Anda mengakses domain kustom di browser, Anda akan diarahkan ke portal terintegrasi.
Lihat juga Mengedit domain kustom dan Menonaktifkan domain kustom.
Langkah 7: Update DNS
Di sistem DNS, buat data baru untuk host domain kustom.
Untuk membuat zona Cloud DNS, ikuti langkah-langkah yang dijelaskan dalam Mengelola Zona. Pastikan Anda mengonfigurasi kolom berikut seperti yang dijelaskan di bawah:
Kolom | Deskripsi |
---|---|
Jenis zona | Pilih Public. |
Nama zona | Masukkan nama yang bermakna untuk zona tersebut. Contoh: mycompany-zone
|
Nama DNS | Masukkan akhiran untuk zona menggunakan nama domain yang Anda miliki. Contoh: mycompany.com
|
Setelah membuat zona, di halaman detail Zona, klik Tambahkan kumpulan data, lalu ikuti langkah-langkah yang dijelaskan di Mengelola Data. Pastikan Anda mengonfigurasi kolom berikut seperti yang dijelaskan di bawah:
Kolom | Deskripsi |
---|---|
Nama DNS | Tentukan awalan untuk nama DNS Anda. Akhiran yang Anda tentukan untuk zona Cloud DNS juga ditampilkan, tetapi tidak dapat diedit. Contoh: developers.mycompany.com
|
Jenis Data Resource | Pilih A (default). |
TTL | Tetapkan ke nilai yang diinginkan atau biarkan tetapkan ke 5 (default). |
Unit TTL | Tetapkan ke nilai yang diinginkan atau biarkan disetel ke menit (default). |
Alamat IPv4 | Masukkan alamat IP eksternal yang Anda cadangkan saat membuat load balancer. |
Mengedit domain kustom di portal Anda
Untuk mengedit domain kustom di portal Anda:
- Di UI Apigee, pilih Publish > Portals di menu navigasi samping.
Daftar portal akan ditampilkan. - Pilih portal Anda dalam daftar.
- Pilih Setelan di menu drop-down pada menu navigasi atas atau di halaman landing.
- Klik tab Domains.
- Edit informasi domain kustom.
- Klik Save.
Menonaktifkan domain kustom di portal
Untuk menonaktifkan nama domain kustom di portal Anda:
- Di UI Apigee, pilih Publish > Portals di menu navigasi samping. Daftar portal akan ditampilkan.
- Pilih portal Anda dalam daftar.
- Pilih Setelan di menu drop-down pada menu navigasi atas atau di halaman landing.
- Klik tab Domains.
- Klik Disable.
- Klik Disable pada perintah untuk mengonfirmasi operasi.
Domain kustom dinonaktifkan dan kolom dihapus.