Pelajari cara mengakses layanan penayangan Knative di cluster Anda untuk tujuan pengujian sebelum Anda memilih untuk memetakan domain kustom.
Secara default, layanan yang Anda deploy ke cluster penayangan Knative ditetapkan ke domain dasar nip.io. Oleh karena itu, jika menggunakan nama yang direkomendasikan untuk gateway masuk, Anda dapat langsung menguji layanan dan mengirim permintaan tanpa konfigurasi tambahan. Contoh: http://{SERVICE_NAME}.{NAMESPACE}.kuberun.{EXTERNAL_IP}.nip.io.
Perhatikan bahwa mungkin ada masalah terkait keandalan permintaan saat menggunakan karakter pengganti DNS, termasuk domain nip.io, yang adalah layanan karakter pengganti DNS gratis. Sebaliknya, menyiapkan dan menggunakan domain kustom untuk pengujian dapat menawarkan keandalan yang lebih tinggi.
Jika ingin, Anda juga dapat mengakses layanan melalui alamat IP eksternal.
Menggunakan domain pengujian nip.io
Untuk mengakses layanan menggunakan domain dasar nip.io default, Anda dapat menemukan URL dari dalam Konsol Google Cloud atau membuat URL secara manual.
Konsol
Di konsol Google Cloud, buka halaman Knative serving.
Dalam daftar, klik layanan yang URL-nya ingin Anda dapatkan.
URL ditampilkan di dekat bagian atas halaman.
Contoh:
http://my-service.default.kuberun.11.111.11.111.nip.ioDengan my-service adalah nama layanan penayangan Knative, default adalah namespace, dan 11.111.11.111 adalah alamat IP load balancer eksternal Anda.
Secara manual
Untuk membuat URL ke layanan secara manual, Anda menggunakan nama layanan, namespace tempat layanan tersebut berjalan, dan alamat IP load balancer:
http://SERVICE.NAMESPACE.kuberun.EXTERNAL_IP.nip.io
Ganti:
- SERVICE_NAME dengan nama layanan Anda.
- NAMESPACE dengan namespace tempat Anda men-deploy layanan. Secara default, layanan di-deploy ke namespace
default. - EXTERNAL_IP dengan alamat IP eksternal load balancer Anda.
Misalnya, jika Anda memiliki layanan bernama hello di namespace default
dan alamat IP eksternal Anda adalah 12.345.67.890, URL-nya mungkin terlihat seperti:
http://hello.default.kuberun.12.345.67.890.nip.io
Menggunakan alamat IP eksternal
Atau, Anda dapat menggunakan alamat IP eksternal load balancer untuk mengakses layanan melalui perintah cURL atau dengan mengonfigurasi layanan karakter pengganti DNS alternatif secara manual.
Sebelum memulai
Pastikan alat command line Google Cloud CLI dan kubectl Anda diinstal dan terbaru:
Anda harus memiliki setidaknya peran Identity and Access Management Kubernetes Engine Developer atau izin yang setara.
Mendapatkan alamat IP eksternal
Saat cluster GKE Enterprise Anda dibuat, pengontrol ingress Istio akan membuat Load Balancer Jaringan Google Cloud dengan alamat IP yang tersedia secara publik.
Untuk mengonfigurasi akses ke layanan dengan cURL atau layanan DNS, Anda harus terlebih dahulu mendapatkan alamat IP eksternal layanan load balancer:
Konsol
Untuk mendapatkan alamat IP eksternal load balancer dari konsol Google Cloud:- Buka halaman GKE di konsol Google Cloud:
Buka GKE - Klik Layanan dan traffic masuk.
- Identifikasi layanan yang merupakan ingress Istio
cluster Anda. Type layanan akan menjadi External load
balancer, dan Name akan menjadi
istio-ingressgateway. - Setelah menemukan layanan ingress Istio cluster, salin
Endpoint-nya. Ini akan menjadi alamat IP tanpa nomor
port. Misalnya, Anda mungkin melihat
00.000.000.000:11tercantum sebagai endpoint, tetapi Anda hanya perlu menyalin00.000.000.000.
kubectl
Untuk mendapatkan IP eksternal untuk Load Balancer, jalankan perintah berikut:
kubectl get svc istio-ingressgateway -n ASM-INGRESS-NAMESPACE
Ganti ASM-INGRESS-NAMESPACE dengan namespace tempat
ingress Cloud Service Mesh Anda berada. Tentukan istio-system jika Anda
menginstal Cloud Service Mesh menggunakan konfigurasi defaultnya.
Output yang dihasilkan akan terlihat mirip dengan berikut ini:
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) istio-ingressgateway LoadBalancer XX.XX.XXX.XX pending 80:32380/TCP,443:32390/TCP,32400:32400/TCP
dengan nilai EXTERNAL-IP adalah alamat IP eksternal Load Balancer Anda.
Setelah mendapatkan alamat IP eksternal load balancer, Anda dapat menggunakannya dalam perintah cURL atau dengan layanan karakter pengganti DNS untuk mengakses layanan penayangan Knative.
Menggunakan cURL
Anda dapat menggunakan perintah cURL dengan domain dasar nip.io default untuk mengirim permintaan ke layanan Anda.
Anda menentukan alamat IP eksternal load balancer beserta nama layanan dan namespace dalam perintah cURL:
curl --header 'Host: SERVICE_NAME.NAMESPACE.kuberun.EXTERNAL_IP.nip.io' EXTERNAL_IP
Ganti:
- SERVICE_NAME dengan nama layanan penayangan Knative Anda.
- NAMESPACE dengan namespace tempat layanan Anda berjalan.
- EXTERNAL_IP dengan alamat IP eksternal load balancer Anda.
Contoh:
curl --header 'Host: my-service.default.kuberun.12.345.67.890.nip.io' http://12.345.67.890
Menggunakan layanan karakter pengganti DNS lainnya
Secara default, layanan penayangan Knative Anda menggunakan layanan karakter pengganti DNS nip.io. Namun, Anda dapat memilih untuk menggunakan layanan lain seperti sslip.io. Untuk mengonfigurasi layanan karakter pengganti DNS lainnya, Anda harus terlebih dahulu mendapatkan alamat IP eksternal load balancer, lalu menggunakan alamat IP tersebut untuk mengonfigurasi layanan karakter pengganti DNS.
Mengonfigurasi domain cluster
Penayangan Knative menggunakan ConfigMap config-domain untuk menentukan domain dasar yang digunakan oleh semua layanan penayangan Knative yang Anda deploy. Anda dapat
memperbarui ConfigMap tersebut melalui konsol Google Cloud atau dengan perintah kubectl.
Konsol
Untuk mengubah domain dasar default dari nip.io menjadi salah satu layanan karakter pengganti DNS di konsol Google Cloud:
Buka halaman Pemetaan domain penayangan Knative di konsol Google Cloud:
Pilih Tambahkan pemetaan > Tambahkan domain default cluster
Centang kotak di samping "Terapkan pemetaan domain ini ke semua layanan penayangan Knative yang di-deploy ke cluster ini".
Pilih cluster Anda dari menu drop-down.
Di kolom Domain, masukkan situs DNS karakter pengganti yang ingin Anda gunakan. Misalnya:
sslip.io
kubectl
Untuk mengubah domain dasar default dari nip.io menjadi salah satu situs karakter pengganti DNS, gunakan perintah:
kubectl patch configmap config-domain --namespace knative-serving --patch \ '{"data": {"kuberun.EXTERNAL_IP.nip.io": null, "DNS_SERVICE": ""}}'
Ganti
- EXTERNAL_IP dengan alamat IP eksternal Load Balancer.
- DNS_SERVICE dengan situs DNS karakter pengganti yang Anda gunakan. Misalnya:
sslip.io
Layanan Anda kini tersedia di
http://{SERVICE_NAME}.{NAMESPACE}.kuberun.{EXTERNAL_IP}.{DNS_SERVICE}.