Menyesuaikan domain

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Lihat dokumentasi Apigee Edge.

Saat membuat portal developer, secara default Anda akan diberi nama domain contoh Apigee untuk mengakses portal aktif dalam format berikut:

https://orgname-portalname.apigee.io

Dengan orgname adalah nama organisasi dan portalname ditentukan menggunakan nama portal yang dikonversi menjadi huruf kecil dan tanpa spasi serta tanda hubung.

Sebelum meluncurkan portal developer, sebaiknya Anda memberikan nama domain kustom Anda sendiri. Misalnya, alternatif 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 Anda, lakukan langkah-langkah berikut:

  1. Daftarkan nama domain Anda.
  2. Buat sertifikat TLS untuk domain kustom Anda. Anda akan memerlukan sertifikat saat membuat load balancer.
  3. Tentukan nama host default untuk portal Anda.
  4. Buat grup endpoint jaringan (NEG) Internet untuk menentukan endpoint backend ke portal terintegrasi Anda untuk load balancer.
  5. Buat load balancer yang mengarah ke NEG Internet dan mencadangkan IP untuk permintaan klien masuk Anda.
  6. Konfigurasi domain kustom di portal Anda.
  7. Perbarui DNS Anda untuk membuat data baru bagi 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 yang Anda inginkan.

Saat memutuskan nama domain, pertimbangkan bahwa URL yang mudah digunakan dan mudah dibaca manusia adalah komponen utama dalam meningkatkan pengoptimalan mesin telusur, seperti yang dijelaskan dalam Menerapkan pengoptimalan mesin telusur (SEO).

Langkah 2: Buat sertifikat TLS untuk domain kustom Anda

Buat sertifikat TLS untuk domain kustom Anda menggunakan alat pilihan Anda, 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:

  1. Menampilkan daftar portal:

    UI Konsol Cloud

    Di konsol Apigee di Cloud, buka halaman Distribution > Portals.

    Buka Portal

    UI Klasik

    Di UI Apigee, pilih Publish > Portals di menu navigasi samping. Daftar portal ditampilkan.

  2. Salin konten di kolom Lokasi untuk portal yang ingin Anda buat domain kustomnya. Contoh, apigee-gcp-prod1-helloworld.apigee.io.

    Anda akan memerlukan nilai ini pada langkah berikutnya.

Langkah 4: Buat NEG Internet

Pada langkah ini, Anda akan membuat grup endpoint jaringan (NEG) Internet untuk menentukan endpoint backend ke portal terintegrasi untuk load balancer. Untuk mengetahui informasi selengkapnya, lihat Ringkasan grup endpoint jaringan internet.

  1. Di Google Cloud konsol, buka halaman Dasbor, lalu pilih atau buat project Google Cloud .

    Buka halaman Dasbor

  2. Pilih Compute Engine > Network endpoint groups di navigator.

  3. Klik Create network endpoint group.

  4. Konfigurasi kolom berikut:

    Kolom Nilai
    Nama Masukkan nama untuk NEG Internet.
    Jenis grup endpoint jaringan Pilih Network endpoint group (Internet).
    Endpoint jaringan baru

  5. Anda dapat membiarkan kolom yang tersisa disetel ke default.

  6. Klik Buat.

NEG Internet dibuat.

Langkah 5: Buat load balancer

Buat load balancer yang mengarah ke NEG Internet dan mencadangkan IP untuk permintaan klien yang masuk.

Pilih jenis load balancer

  1. Di konsol Google Cloud , buka halaman Load balancing.

    Buka Load balancing

  2. Klik Create load balancer.
  3. Untuk Type of load balancer, pilih Application Load Balancer (HTTP/HTTPS), lalu klik Next.
  4. Untuk Public facing or internal, pilih Public facing (external), lalu klik Next.
  5. Untuk Global or single region deployment, pilih Best for global workloads, lalu klik Next.
  6. Untuk Load balancer generation, pilih Global external Application Load Balancer, lalu klik Next.
  7. Klik Configure.

Mengonfigurasi load balancer

  1. Klik setiap kategori dan konfigurasi 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:

    1. Di bagian Create global external Application Load Balancer, arahkan kursor ke Frontend configuration, lalu klik panah.
    2. Masukkan nama untuk frontend di kolom Name.
    3. Pilih HTTPS dari menu drop-down Protocol.
    4. Di menu drop-down IP address, pilih Create IP address
      Dialog Reserve a new static IP address akan ditampilkan.
    5. Masukkan nama untuk alamat IP statis di kolom Name.
    6. Masukkan deskripsi secara opsional.
    7. Klik Reserve.
    8. Simpan alamat IP yang telah dicadangkan untuk digunakan saat menyiapkan data DNS.
    9. Pilih Create a new certificate di drop-down Certificate.
      Jendela Buat sertifikat baru akan terbuka.
    10. Masukkan nama untuk sertifikat baru di kolom Nama.
    11. Pilih Upload sertifikat saya di bagian Create mode.
    12. Upload detail sertifikat TLS Anda, termasuk kunci publik, rantai sertifikat, dan kunci pribadi.
    13. Klik Buat.
    14. Klik Done untuk membuat IP dan port frontend baru.
    Konfigurasi backend

    Konfigurasi backend untuk mengarahkan traffic masuk ke NEG Internet yang dibuat di Langkah 4: Buat grup endpoint jaringan (NEG) Internet:

    1. Di bagian Create global external Application Load Balancer, posisikan kursor Anda di atas Backend configuration, lalu klik panah.
    2. Di bagian Backend services & backend buckets, pilih Backend services > Create a backend service dari drop-down.
      Jendela Create backend service akan terbuka.
    3. Masukkan nama di kolom Name.
    4. Pilih Internet network endpoint group di drop-down Backend type.
    5. Pilih HTTPS sebagai protokol.
    6. Di bagian New backend, pilih NEG Internet yang Anda buat di Langkah 4: Buat grup endpoint jaringan (NEG) Internet di menu drop-down Internet network endpoint group, lalu klik Done.
    7. Hapus centang pada kotak Enable Cloud CDN.
    8. Anda dapat membiarkan semua nilai lainnya ditetapkan ke defaultnya.
    9. Klik Buat.
    Aturan host dan jalur

    Konfigurasi aturan host dan jalur untuk menentukan cara pengarahan traffic Anda:

    1. Di bagian Create global external Application Load Balancer, posisikan kursor Anda di atas Host and path rules, lalu klik panah.
    2. Klik Aturan host dan jalur lanjutan (pengalihan URL, penulisan ulang URL) di bagian Mode.
    3. Di bagian New host and path rule:
      1. Pilih Rute traffic ke satu backend di drop-down Tindakan.
      2. Luaskan Tindakan add-on (penulisan ulang URL).
      3. Masukkan nama domain default yang Anda salin di Langkah 3: Tentukan nama host default untuk portal Anda di kolom Penulisan ulang host.
      4. Pilih layanan backend yang Anda konfigurasi di drop-down Backend.
      5. Klik Selesai.

  2. Klik Create di halaman Create global external Application Load Balancer.

Langkah 6: Konfigurasi domain kustom di portal Anda

Untuk mengonfigurasi domain kustom di portal Anda:

  1. Menampilkan daftar portal:

    UI Konsol Cloud

    Di konsol Apigee di Cloud, buka halaman Distribution > Portals.

    Buka Portal

    UI Klasik

    Di UI Apigee, pilih Publish > Portals di menu navigasi samping. Daftar portal ditampilkan.

  2. Pilih portal Anda dalam daftar.

  3. Pilih Setelan.

  4. Klik tab Domains.

  5. Masukkan nama domain kustom Anda di kolom Domain.

  6. Klik Enable.

Uji bahwa saat Anda mengakses domain kustom di browser, Anda akan diarahkan ke portal terintegrasi.

Lihat juga Mengedit domain kustom dan Menonaktifkan domain kustom.

Langkah 7: Perbarui DNS Anda

Di sistem DNS Anda, 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:

Kolom Deskripsi
Jenis zona Pilih Public.
Nama zona Masukkan nama yang bermakna untuk zona. 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 set data dan ikuti langkah-langkah yang dijelaskan dalam Mengelola Data. Pastikan Anda mengonfigurasi kolom berikut:

Kolom Deskripsi
Nama DNS Tentukan awalan untuk nama DNS Anda. Sufiks yang Anda tentukan untuk zona Cloud DNS juga ditampilkan, tetapi tidak dapat diedit. Contoh: developers.mycompany.com
Jenis Record Resource Pilih A (default).
TTL Tetapkan ke nilai yang diinginkan atau biarkan ditetapkan ke 5 (default).
Unit TTL Tetapkan ke nilai yang diinginkan atau biarkan ditetapkan 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:

  1. Menampilkan daftar portal:

    UI Konsol Cloud

    Di konsol Apigee di Cloud, buka halaman Distribution > Portals.

    Buka Portal

    UI Klasik

    Di UI Apigee, pilih Publish > Portals di menu navigasi samping. Daftar portal ditampilkan.

  2. Pilih portal Anda dalam daftar.

  3. Pilih Setelan.

  4. Klik tab Domains.

  5. Edit informasi domain kustom.

  6. Klik Simpan.

Menonaktifkan domain kustom di portal Anda

Untuk menonaktifkan nama domain kustom di portal Anda:

  1. Menampilkan daftar portal:

    UI Konsol Cloud

    Di konsol Apigee di Cloud, buka halaman Distribution > Portals.

    Buka Portal

    UI Klasik

    Di UI Apigee, pilih Publish > Portals di menu navigasi samping. Daftar portal ditampilkan.

  2. Pilih portal Anda dalam daftar.

  3. Pilih Setelan.

  4. Klik tab Domains.

  5. Klik Nonaktifkan.

  6. Klik Nonaktifkan pada perintah untuk mengonfirmasi operasi.

Domain kustom dinonaktifkan dan kolom dihapus.