Menyiapkan integrasi dengan Direktori Layanan
Panduan ini mengasumsikan bahwa Anda memiliki deployment Cloud Service Mesh yang berjalan dan telah mendaftarkan setidaknya satu layanan dengan Direktori Layanan. Petunjuk penyiapan berlaku baik Anda menggunakan Envoy atau gRPC tanpa proxy.
Untuk menggunakan Direktori Layanan dan Cloud Service Mesh, langkah pertamanya adalah memublikasikan layanan Anda ke Direktori Layanan. Lihat informasi cara memublikasikan layanan ke Direktori Layanan atau dokumentasi Direktori Layanan untuk mengetahui informasi ringkasan umum.
Setelah layanan didaftarkan ke Direktori Layanan, Anda harus membuat binding layanan menggunakan resource API Cloud Service Mesh. Anda membuat layanan backend yang dikhususkan untuk integrasi dengan Direktori Layanan, karena layanan backend yang mereferensikan binding layanan tidak dapat memiliki backend atau health check terkait.
Aturan penerusan Cloud Service Mesh dan persyaratan aturan host dengan API load balancing
Saat Anda mengonfigurasi Cloud Service Mesh untuk digunakan dengan Direktori Layanan dan Anda menggunakan API load balancing lama, ikuti panduan berikut:
- Pastikan aturan penerusan Cloud Service Mesh menggunakan alamat IP virtual (VIP)
0.0.0.0
. - Jika Anda memiliki zona pribadi, pastikan aturan host di peta URL cocok dengan nama DNS yang dikonfigurasi oleh Direktori Layanan di zona pribadi Cloud DNS Anda.
Jika Anda tidak mengikuti panduan ini, permintaan keluar dari aplikasi Anda mungkin akan gagal.
Menetapkan endpoint API network-services
Sebelum Anda membuat dan menggunakan layanan backend, pastikan endpoint API network-services
telah ditetapkan sehingga resource binding layanan pada resource network-services
direferensikan dengan benar. Tetapkan endpoint API network-services
menggunakan perintah berikut.
export CLOUDSDK_API_ENDPOINT_OVERRIDES_NETWORKSERVICES="https://networkservices.googleapis.com/"
Persyaratan peran dan izin
Pastikan Anda memiliki izin dan peran berikut sebelum membuat deployment Cloud Service Mesh.
Peran dan izin binding layanan
Bagian ini tidak membahas izin Pemilik, Editor, dan Viewer level project. Panduan ini menjelaskan izin dan peran yang diperlukan untuk membuat, membaca, mengupdate, dan menghapus resource.
Tindakan | Izin | Peran |
---|---|---|
Membuat binding layanan. | networkservices.serviceBindings.create |
Network Admin |
Mendapatkan binding layanan. | networkservices.serviceBindings.get |
Admin Jaringan, Penampil Jaringan |
Mencantumkan binding layanan di project Google Cloud. | networkservices.serviceBindings.list |
Admin Jaringan, Penampil Jaringan |
Mengupdate binding layanan. | networkservices.serviceBindings.update |
Network Admin |
Menghapus binding layanan. | networkservices.serviceBindings.delete |
Network Admin |
Izin layanan Direktori Layanan
Administrator Direktori Layanan harus memberikan izin
servicedirectory.services.bind
ke akun layanan yang mencoba
melampirkan binding layanan ke layanan Direktori Layanan. Hal ini
memungkinkan akun layanan menggunakan layanan Direktori Layanan, yang berarti
akun tersebut dapat mereferensikan layanan Direktori Layanan dalam
binding layanan.
Penerapan izin
Pemeriksaan izin IAM dilakukan saat Anda mengonfigurasi Cloud Service Mesh. Anda harus memiliki izin yang diperlukan untuk membuat binding layanan, dan untuk mengaitkan binding layanan dengan layanan Direktori Layanan tertentu. Jika izin yang benar sudah ada, Anda dapat mengonfigurasi klien mesh untuk mempelajari dan mengirim traffic ke layanan Direktori Layanan.
Karena pemeriksaan ini terjadi pada waktu konfigurasi, penghapusan izin binding pada layanan Direktori Layanan yang ada tidak akan mengganggu alur traffic. Setelah binding layanan dibuat, penghapusan izin tidak akan memengaruhi apakah klien mesh dapat mempelajari dan mengirim traffic ke layanan Direktori Layanan.
Untuk menghentikan klien mesh berkomunikasi dengan layanan Direktori Layanan, Anda dapat menggunakan mekanisme lain:
- Membatasi akses ke layanan Direktori Layanan. Misalnya, Anda dapat menggunakan aturan firewall.
- Menghapus layanan Direktori Layanan.
- Perbarui konfigurasi Cloud Service Mesh Anda, misalnya, dengan menghapus binding layanan dari layanan backend.
Praktik terbaik
- Meskipun Direktori Layanan mengizinkan pendaftaran endpoint menggunakan Service Directory API, sebaiknya gunakan integrasi yang secara otomatis mendaftar ke Direktori Layanan jika tersedia. Untuk mengetahui informasi selengkapnya tentang integrasi ini, lihat Ringkasan Layanan Direktori untuk GKE dan Ringkasan Direktori Layanan dan Cloud Load Balancing.
- Sebaiknya gunakan namespace dan layanan yang sama untuk layanan logis tertentu, bahkan saat layanan tersebut di-deploy di berbagai region.
Menggunakan Direktori Layanan untuk penemuan layanan
Diagram berikut memberikan ringkasan status akhir prosedur penyiapan ini, termasuk konfigurasi, cara berbagai sistem berinteraksi, dan cara permintaan diselesaikan ke endpoint layanan. Contoh ini mengasumsikan bahwa Anda sudah memiliki layanan yang terdaftar dengan Direktori Layanan.
Menyediakan layanan Direktori Layanan untuk Cloud Service Mesh terdiri dari langkah-langkah berikut.
- Buat layanan backend baru di Cloud Service Mesh dan jangan membuat backend untuk layanan backend.
- Buat binding layanan global untuk layanan Direktori Layanan.
Ikat layanan Direktori Layanan ke layanan backend ini. Jika ingin, tetapkan kolom dan kebijakan tambahan pada layanan backend.
Buat konfigurasi perutean baru, atau perbarui konfigurasi yang ada, sehingga permintaan klien dapat dirutekan ke layanan backend baru.
Anda tidak dapat menetapkan health check pada layanan backend yang merujuk ke service binding. Layanan backend juga tidak bisa memiliki backend.
Membuat integrasi
Gunakan petunjuk berikut untuk mengintegrasikan Cloud Service Mesh dengan Direktori Layanan.
Buat layanan backend
Gunakan petunjuk berikut untuk membuat layanan backend di deployment Cloud Service Mesh Anda.
Buat layanan backend untuk digunakan dengan layanan Direktori Layanan.
gcloud compute backend-services create td-sd-demo-service \ --global \ --load-balancing-scheme=INTERNAL_SELF_MANAGED
Buat binding layanan yang mereferensikan layanan Direktori Layanan.
gcloud beta network-services service-bindings create my-sd-binding \ --location global \ --service-directory-region us-east1 \ --service-directory-namespace my-namespace \ --service-directory-service my-service
Ikat layanan ke layanan backend.
gcloud beta compute backend-services update td-sd-demo-service \ --global \ --service-bindings my-sd-binding
Setelah Anda membuat layanan backend dan mengikat satu atau beberapa layanan Direktori Layanan, Cloud Service Mesh akan mulai melacak endpoint yang terkait dengan layanan Direktori Layanan. Titik akhir adalah pasangan IP:port yang berbeda. Agar layanan ini dapat dirutekan, Anda perlu mengonfigurasi perutean.
Mengonfigurasi pemilihan rute
Gunakan petunjuk berikut untuk memperbarui konfigurasi pemilihan rute.
API pemilihan rute layanan
Contoh berikut mengasumsikan bahwa Anda memiliki resource Mesh
yang disebut sidecar-
mesh
. Anda membuat resource HTTPRoute
dengan nama host yang ditetapkan ke
myservice.example.com
dan tujuan yang ditetapkan ke layanan backend
td-sd-demo-service
yang Anda buat di bagian sebelumnya.
Buat spesifikasi
HTTPRoute
dan simpan dalam file bernamahttproute.yaml
.name: td-sd-demo-route hostnames: ‐ myservice.example.com meshes: ‐ projects/PROJECT_NUMBER/locations/global/meshes/sidecar-mesh rules: ‐ action: destinations: ‐ serviceName: "projects/PROJECT_NUMBER/locations/global/backendServices/td-sd-demo-service"
Impor spesifikasi
HTTPRoute
.gcloud network-services httproutes import td-sd-demo-route \ --source=httproute.yaml \ --location=global
API load balacing
Contoh berikut mengasumsikan bahwa Anda sudah memiliki konfigurasi perutean dasar, termasuk peta URL yang disebut my-url-map
.
- Pertama, Anda membuat pencocok jalur untuk peta URL ini. Pencocok jalur
tidak rumit. Saat digunakan, metode ini akan me-resolve ke
td-sd-demo-service
, yang Anda buat di langkah sebelumnya. - Selanjutnya, Anda menambahkan aturan host ke peta URL. Aturan host ini menyebabkan pencocok
jalur digunakan jika permintaan menentukan nama host
myservice.example.com
.
Buat pencocok jalur sederhana yang mengarah ke layanan backend Anda.
gcloud compute url-maps add-path-matcher my-url-map \ --global \ --default-service td-sd-demo-service \ --path-matcher-name my-path-matcher
Petakan layanan backend ke aturan host baru di peta URL yang ada.
gcloud compute url-maps add-host-rule my-url-map \ --global \ --path-matcher-name=my-path-matcher \ --hosts=myservice.example.com
Melampirkan layanan yang sama dari beberapa region
Cloud Service Mesh memungkinkan Anda mengikat beberapa layanan Direktori Layanan ke layanan backend yang sama. Misalnya, Anda mungkin memiliki dua layanan Direktori Layanan, yang masing-masing identik, tetapi dengan endpoint di region atau zona Google Cloud yang berbeda.
Dengan kata lain, satu layanan backend global dapat memiliki dua binding layanan
global, yang satu mengarah ke layanan di us-east1
dan yang lainnya mengarah
ke layanan di us-west1
.
Buat layanan backend untuk layanan Direktori Layanan yang diimpor.
gcloud compute backend-services create td-sd-demo-service \ --global \ --load-balancing-scheme=INTERNAL_SELF_MANAGED
Buat binding layanan ke layanan Direktori Layanan di
us-east1
.gcloud beta network-services service-bindings create us-east1-binding \ --location global \ --service-directory-region us-east1 \ --service-directory-namespace my-namespace \ --service-directory-service my-service \
Buat binding layanan ke layanan Direktori Layanan di
us-west1
.gcloud beta network-services service-bindings create us-west1-binding \ --location global --service-directory-region us-west1 \ --service-directory-namespace my-namespace \ --service-directory-service my-service \
Ikat layanan
us-east1
danus-west1
ke layanan backend.gcloud compute backend-services update td-sd-demo-service \ --global \ --service-bindings us-east1-binding,us-west1-binding
Menerapkan kebijakan pengelolaan traffic lanjutan
Di bagian sebelumnya, Anda telah menggunakan Cloud Service Mesh untuk menyiapkan kebijakan perutean pada layanan Direktori Layanan yang ada. Anda dapat menerapkan pola ini ke skenario pengelolaan traffic yang lebih canggih.
Pertimbangkan skenario ini. Anda memiliki layanan pengujian yang ada di luar mesh Cloud Service Mesh. Layanan pengujian adalah backend untuk
Load Balancer Aplikasi internal. Anda ingin memutar ulang beberapa traffic produksi
yang berasal dari mesh Cloud Service Mesh ke layanan eksternal ini.
Cloud Service Mesh dapat melakukannya menggunakan RequestMirrorPolicy
, yang dapat mengirim traffic ke layanan backend lain saat permintaan diproses. Proses ini juga disebut membayangi permintaan, dan memungkinkan Anda memeriksa traffic tanpa memengaruhi layanan produksi.
Anda dapat mengaktifkan klien Envoy untuk membayangi traffic ke layanan pengujian dengan menambahkan atau menghapus endpoint layanan pengujian secara manual ke mesh Cloud Service Mesh. Namun, prosesnya menjadi lebih sederhana jika Anda menggunakan integrasi Direktori Layanan.
Dalam contoh ini, Anda memulai dengan mengarahkan layanan backend ke pendaftaran Direktori Layanan untuk layanan pengujian pembayaran. Kemudian, Anda akan menambahkan kebijakan pencerminan permintaan ke layanan di Cloud Service Mesh.
Buat layanan backend untuk kebijakan pencerminan permintaan.
gcloud compute backend-services create payments-test-bes \ --global \ --load-balancing-scheme=INTERNAL_SELF_MANAGED
Buat binding layanan yang mereferensikan layanan Direktori Layanan.
gcloud beta network-services service-bindings create my-sd-binding \ --location global \ --service-directory-region us-east1 \ --service-directory-namespace my-namespace \ --service-directory-service my-service \
Ikat layanan Direktori Layanan ke layanan backend pengujian.
gcloud beta compute backend-services update payments-test-bes \ --global \ --service-bindings my-sd-binding
Mengedit peta URL untuk mencerminkan permintaan ke layanan pengujian.
gcloud compute url-maps edit my-url-map \ --region=global
Setelah konfigurasi peta URL dimuat ke editor, tambahkan kebijakan pencerminan permintaan untuk mencerminkan permintaan ke layanan Direktori Layanan yang ada.
defaultService: my-project/global/default-service hostRules: - hosts: - '*' pathMatcher: path-matcher-one pathMatchers: - defaultService: my-project/global/default-service name: path-matcher-one pathRules: - paths: - /payments/ service: my-project/global/default-service requestMirrorPolicy: backendService: myproject/global/payments-test-bes
Menghapus binding layanan dari layanan backend
Untuk menghapus binding layanan dari layanan backend, teruskan
daftar binding layanan baru ke perintah
gcloud compute backend-services update
. Daftar baru tidak boleh menyertakan binding layanan yang ingin
Anda hapus:
- Untuk menghapus semua binding layanan, tetapkan flag
--no-service-bindings
. - Untuk menghapus satu atau beberapa binding layanan: teruskan daftar binding layanan baru
yang menghilangkan binding layanan yang ingin dihapus ke
tanda
--service-bindings
.
Menambahkan atau menghapus binding layanan
Perintah bind-service
menambahkan binding layanan ke kumpulan binding layanan yang ada di
layanan backend.
gcloud compute backend-services bind-service BACKEND_SERVICE_NAME \ --service-binding-name SERVICE_BINDING_URL \ --global
Perintah unbind-service
menghapus binding layanan dari rangkaian binding
layanan yang ada di layanan backend.
gcloud compute backend-services unbind-service BACKEND_SERVICE_NAME \ --service-binding-name SERVICE_BINDING_URL \ --global
Perintah bind-service
dan unbind-service
adalah konstruksi Google Cloud CLI. Model tersebut
bukan konstruksi level API.
Langkah selanjutnya
- Untuk mengetahui informasi tentang kemampuan observasi dengan integrasi ini, lihat Kemampuan observasi dan proses debug dengan Direktori Layanan.