Halaman ini menyediakan terminologi utama yang berlaku untuk Direktori Layanan. Tinjau istilah-istilah ini untuk lebih memahami cara kerja Direktori Layanan.
- Endpoint
Endpoint adalah pasangan IP/port individu yang berada di depan layanan yang dapat menangani permintaan. Setiap layanan tertentu dapat memiliki nol atau beberapa endpoint. Endpoint dapat berupa VM, penampung, load balancer, atau entitas lain yang mampu menangani permintaan. Contohnya adalah cluster server Redis yang dikelola pengguna.
Endpoint dapat memiliki anotasi opsional, dalam bentuk pasangan nilai kunci, yang dapat digunakan klien. Misalnya, layanan Redis mungkin memiliki anotasi seperti
replica:server. Anotasi dapat digunakan untuk menyimpan URL. Anda dapat menggunakan alat seperti jq untuk mengambil URL baru dari respons.Untuk Direktori Layanan, endpoint hanya dapat ada dalam layanan dan diidentifikasi dengan nama endpoint yang merupakan ID string yang unik untuk layanan tersebut.
- Layanan
Layanan adalah kumpulan endpoint (IP/port) yang menyediakan kumpulan perilaku. Klien mencari layanan berdasarkan namanya, lalu terhubung ke endpoint yang menyediakan layanan tersebut. Layanan juga dapat memiliki anotasi opsional (pasangan nilai kunci) yang terkait dengannya (misalnya,
use_https:true).Layanan harus termasuk dalam namespace. Setiap nama layanan harus unik dalam namespace tersebut.
- Namespace
Namespace menyimpan sekumpulan nama layanan beserta informasi endpoint-nya. Namespace adalah cara untuk mengelompokkan layanan agar lebih mudah dikelola.
Namespace adalah resource regional dan merupakan bagian dari project. Nama ruang nama harus unik untuk project dan region tersebut.
Meskipun namespace adalah resource regional, layanan yang termasuk dalam namespace tersebut dapat ada di mana saja dan dikueri dari mana saja. Sebaiknya pelanggan memilih region yang dipetakan ke tempat endpoint mereka berjalan.
- Klien HTTP/gRPC
Direktori Layanan mendukung pencarian nama layanan menggunakan HTTP/gRPC. Tidak ada persyaratan bahwa layanan dan klien harus berada di jaringan yang sama.
Operasi pencarian melalui gRPC dikontrol oleh IAM.
- Zona Direktori Layanan
Zona Direktori Layanan adalah jenis tertentu dari zona pribadi Cloud DNS yang sumber informasinya lengkap dan otoritatif adalah namespace Direktori Layanan. Dengan demikian, Anda dapat mencari data Direktori Layanan menggunakan permintaan DNS.
Jika namespace dilampirkan ke zona Direktori Layanan, semua layanan dalam namespace tersebut akan terlihat oleh semua jaringan yang diizinkan untuk membuat kueri zona.