Mendaftarkan Load Balancer Jaringan passthrough eksternal regional

Halaman ini memberikan informasi tentang cara mengonfigurasi a Load Balancer Jaringan passthrough eksternal regional sehingga otomatis terdaftar di Direktori Layanan.

Saat membuat load balancer, Anda dapat mendaftarkannya sebagai endpoint di namespace dan layanan Direktori Layanan yang ada dan Anda pilih. Aplikasi klien kemudian dapat menggunakan Direktori Layanan (menggunakan HTTP atau gRPC) untuk me-resolve alamat layanan Load Balancer Jaringan passthrough eksternal regional dan terhubung langsung ke layanan tersebut.

Batasan

Integrasi Direktori Layanan dengan Load Balancer Jaringan passthrough eksternal regional memiliki batasan berikut:

  • Pendaftaran otomatis hanya mendukung load balancer eksternal Lapisan 4. Anda dapat mendaftarkan layanan load balancing Google Kubernetes Engine menggunakan integrasi GKE. Anda dapat mendaftarkan load balancer eksternal lainnya, load balancer global, serta ingress dan gateway Google Kubernetes Engine dengan memanggil Service Directory API.
  • Anda hanya dapat menggunakan pendaftaran otomatis pada saat pembuatan aturan penerusan. Pendaftaran otomatis menggunakan update Google Cloud CLI untuk aturan penerusan yang sudah ada tidak tersedia.
  • Direktori Layanan tidak menyediakan konektivitas, yang berarti meskipun Direktori Layanan menyimpan alamat IP virtual Load Balancer Jaringan passthrough eksternal regional, mencari Load Balancer Jaringan passthrough eksternal regional di Direktori Layanan tidak menjamin bahwa Anda dapat terhubung ke alamat IP virtual.

Sebelum memulai

Petunjuk ini memerlukan hal berikut:

  • Anda harus sudah memiliki namespace dan layanan Direktori Layanan. Jika belum, buat namespace dan layanan menggunakan prosedur di Mengonfigurasi Direktori Layanan.

    Namespace dan layanan Direktori Layanan harus berada di project dan region yang sama dengan aturan penerusan Load Balancer Jaringan passthrough eksternal regional yang Anda buat.

  • Anda harus sudah menyiapkan resource yang diperlukan untuk membuat aturan penerusan Load Balancer Jaringan passthrough eksternal regional.

    Untuk mengetahui informasi tentang cara membuat Load Balancer Jaringan passthrough eksternal regional, lihat Menyiapkan Load Balancer Jaringan passthrough eksternal regional.

Menyiapkan aturan penerusan untuk mendaftarkan Load Balancer Jaringan passthrough eksternal regional di Direktori Layanan

Anda harus menyiapkan aturan penerusan untuk mendaftarkan Load Balancer Jaringan passthrough eksternal regional di Direktori Layanan. Untuk mendaftarkan Load Balancer Jaringan passthrough eksternal regional, lihat bagian berikut.

Mendaftarkan Load Balancer Jaringan passthrough eksternal regional

Untuk mendaftarkan Load Balancer Jaringan passthrough eksternal regional, jalankan perintah gcloud compute forwarding-rules create command dan tetapkan flag service-directory-registration:

gcloud beta compute forwarding-rules create FORWARDING_RULE_NAME \
    --region=REGION \
    --load-balancing-scheme=EXTERNAL \
    --address=RESERVED_IP_ADDRESS \
    --ip-protocol=PROTOCOL_TYPE \
    --ports=PORT_NUMBER \
    --backend-service=BACKEND_SERVICE_NAME \
    --backend-service-region=REGION \
    --service-directory-registration=SD_SERVICE_NAME

Ganti kode berikut:

  • FORWARDING_RULE_NAME: nama untuk aturan penerusan yang ingin Anda buat
  • REGION: region tempat membuat aturan penerusan
  • RESERVED_IP_ADDRESS: alamat IP yang dilayani oleh aturan penerusan
  • PROTOCOL_TYPE: protokol IP yang akan dilayani oleh aturan
  • PORT_NUMBER: daftar port yang dipisahkan koma
  • BACKEND_SERVICE_NAME: layanan backend target yang menerima traffic
  • SD_SERVICE_NAME: nama yang sepenuhnya memenuhi syarat dari layanan Direktori Layanan tempat Anda ingin mendaftarkan endpoint. Layanan ini harus berada di project dan region yang sama dengan aturan penerusan yang dibuat. Misalnya: projects/PROJECT/locations/REGION/namespaces/NAMESPACE_NAME/services/SERVICE_NAME.

Memverifikasi endpoint

Endpoint Direktori Layanan yang dibuat saat Anda mendaftarkan Load Balancer Jaringan passthrough eksternal regional memiliki karakteristik berikut:

  • Endpoint memiliki nama yang sama dengan nama aturan penerusan dengan nomor port yang ditentukan (<forwarding rule name>-<port>). Misalnya, jika Anda membuat aturan penerusan RULE dengan --port=8080, Anda akan mendapatkan endpoint bernama RULE-8080. Untuk aturan yang sama, jika Anda menentukan dua port --port=8080, 8081, Anda akan mendapatkan dua endpoint, RULE-8080 dan RULE-8081. Jika Anda menentukan --port=ALL, endpoint Direktori Layanan akan didaftarkan dengan port 0. Jika Anda adalah pemilik Load Balancer Jaringan passthrough eksternal regional, Anda harus memastikan bahwa pemanggil API mengetahui port yang akan digunakan untuk terhubung.
  • Anda tidak dapat mengubah atau menghapus endpoint menggunakan Service Directory API publik. Endpoint hanya akan dihapus secara otomatis saat Anda menghapus aturan penerusan. Artinya, Anda tidak dapat menghapus layanan dan namespace tempat endpoint berada selama aturan penerusan ada.
  • Endpoint itu sendiri tidak ditagih, meskipun detail harga normal berlaku untuk panggilan API apa pun ke endpoint.

Untuk mengonfirmasi bahwa endpoint dibuat, selesaikan layanan di Direktori Layanan. Anda akan melihat endpoint dengan nama yang sama dengan nama aturan penerusan dengan nomor port yang ditentukan.

Untuk menyelesaikan layanan di Direktori Layanan, jalankan perintah gcloud service-directory services resolve:

gcloud service-directory services resolve SD_SERVICE_NAME \
    --namespace=SD_NAMESPACE_NAME \
    --location=REGION

Ganti kode berikut:

  • SD_SERVICE_NAME: nama layanan Direktori Layanan yang akan diselesaikan. Layanan ini harus berada di nama namespace Direktori Layanan.
  • SD_NAMESPACE_NAME: nama yang Anda berikan ke namespace yang berisi layanan Anda.
  • REGION: region yang berisi namespace. Google Cloud Region ini harus sama dengan region tempat Anda membuat aturan penerusan.

Pembersihan

Untuk menghapus resource yang Anda buat, ikuti langkah-langkah berikut.

  1. Untuk menghapus aturan penerusan, jalankan gcloud compute forwarding-rules delete perintah:

    gcloud compute forwarding-rules delete FORWARDING_RULE_NAME \
  --region=REGION

    Ganti kode berikut:

    • FORWARDING_RULE_NAME: nama aturan penerusan yang Anda buat
    • REGION: region untuk aturan penerusan

    Untuk mengetahui detail selengkapnya, lihat Menghapus aturan penerusan.

    Untuk mengonfirmasi bahwa penghapusan aturan penerusan telah otomatis menghapus endpoint dari Direktori Layanan, jalankan gcloud service-directory services resolve perintah yang dijelaskan di bagian Memverifikasi endpoint pada layanan Direktori Layanan Anda.

  2. Untuk menghapus namespace dan layanan Direktori Layanan, lihat Menghapus resource.

Langkah berikutnya