Memecahkan masalah webhook Google Distributed Cloud

Halaman ini menunjukkan cara menyelesaikan masalah terkait webhook yang bermasalah atau tidak aman di Google Distributed Cloud.

Jika Anda memerlukan bantuan tambahan, hubungi Cloud Customer Care.

Jenis webhook yang bermasalah

Webhook penerimaan, atau webhook di Kubernetes, adalah jenis pengontrol tiket masuk yang dapat digunakan di cluster Kubernetes untuk memvalidasi atau mengubah permintaan ke bidang kontrol sebelum permintaan dipertahankan. Umumnya aplikasi pihak ketiga menggunakan webhook yang beroperasi di resource dan namespace yang penting bagi sistem. Webhook yang tidak dikonfigurasi dengan benar dapat memengaruhi performa dan keandalan bidang kontrol. Misalnya, webhook tidak dikonfigurasi dengan benar aplikasi pihak ketiga dapat mencegah Google Distributed Cloud membuat dan mengubah resource dalam namespace kube-system terkelola, yang dapat menurunkan fungsionalitas cluster.

Webhook bermasalah mencakup jenis berikut:

• Webhook yang beroperasi, tetapi tidak memiliki endpoint yang tersedia. Ikuti petunjuk untuk memeriksa webhook tanpa endpoint yang tersedia.

• Webhook yang dianggap tidak aman karena beroperasi pada sistem yang penting resource dan namespace.

  Webhook berikut dianggap tidak aman:

  • Webhook yang mencegat Pod dan lease di namespace kube-system.
  • Webhook yang mencegat lease di namespace kube-node-lease.
  • Webhook yang mencegat Nodes, TokenReviews, SubjectAccessReviews, dan CertificateSigningRequests Google Cloud Platform.

  Ikuti petunjuk untuk memeriksa webhook yang dianggap tidak aman.

Webhook yang tidak memiliki endpoint yang tersedia

Jika webhook tidak memiliki endpoint yang tersedia, Layanan yang mendukung webhook endpoint memiliki satu atau beberapa Pod yang tidak berjalan. Untuk membuat webhook endpoint yang tersedia, ikuti petunjuk untuk menemukan dan memecahkan masalah Pod Layanan yang mendukung endpoint webhook ini:

1. Temukan Pod yang melakukan penayangan untuk Layanan yang terkait dengan webhook. Jalankan perintah berikut untuk mendeskripsikan Layanan:

   kubectl describe svc SERVICE_NAME -n SERVICE_NAMESPACE
   

   Ganti kode berikut:

   • SERVICE_NAME dengan nama Layanan.
   • SERVICE_NAMESPACE dengan nama namespace.

   Jika Anda tidak dapat menemukan nama Layanan tercantum di webhook, berarti nama tersebut tidak tersedia endpoint mungkin disebabkan oleh ketidakcocokan antara nama yang tercantum dalam dan nama Layanan yang sebenarnya. Untuk memperbaiki ketersediaan endpoint, perbarui nama Service di konfigurasi webhook agar cocok dengan objek Service yang benar.

2. Periksa Pod yang melakukan penayangan untuk Service ini. Mengidentifikasi Pod mana yang tidak berjalan dengan mencantumkan Deployment:

   kubectl get deployment -n SERVICE_NAMESPACE
   

   Atau, jalankan perintah berikut untuk membuat daftar Pod:

   kubectl get pods -n SERVICE_NAMESPACE -o wide
   

   Untuk Pod yang tidak berjalan, periksa log Pod untuk mengetahui alasan Pod tidak berjalan.

Webhook yang dianggap tidak aman

Jika webhook mencegat resource apa pun di namespace yang dikelola sistem, kami sebaiknya Anda memperbarui webhook untuk menghindari penyadapan resource ini.

1. Periksa konfigurasi webhook. Jalankan perintah kubectl berikut untuk dapatkan konfigurasi webhook:

   kubectl get validatingwebhookconfigurations CONFIGURATION_NAME -o yaml
   

   Ganti CONFIGURATION_NAME dengan nama konfigurasi webhook.

   Jika perintah ini tidak menampilkan apa pun, jalankan kembali perintah tersebut, dengan mengganti validatingwebhookconfigurations dengan mutatingwebhookconfigurations.

   Di bagian webhooks output, satu atau beberapa webhook akan tercantum.

2. Mengedit konfigurasi, bergantung pada alasan webhook dianggap tidak aman:

   Mengecualikan namespace kube-system dan kube-node-lease

   Webhook dianggap tidak aman jika scope adalah *, atau jika cakupannya Namespaced dan salah satu kondisi berikut terpenuhi:

   • Kondisi operator adalah NotIn dan values menghilangkan kube-system dan kube-node-lease, seperti dalam contoh berikut:

     webhooks:
     - admissionReviewVersions:
       ...
       namespaceSelector:
         matchExpressions:
         - key: kubernetes.io/metadata.name
           operator: NotIn
           values:
           - blue-system # add 'kube-system' and 'kube-node-lease' if `NotIn`
       objectSelector: {}
       rules:
       - apiGroups:
         ...
         scope: '*' # 'Namespaced'
       sideEffects: None
       timeoutSeconds: 3
     

     Pastikan scope ditetapkan ke Namespaced, bukan *, sehingga webhook hanya beroperasi di namespace tertentu. Jika operator adalah NotIn, pastikan kube-system, dan kube-node-lease disertakan dalam values.

   • Kondisi operator adalah In dan values menyertakan kube-system dan kube-node-lease, seperti dalam contoh berikut:

     namespaceSelector:
         matchExpressions:
         - key: kubernetes.io/metadata.name
           operator: In
           values:
           - blue-system
           - kube-system # remove as operator is `In`
           - kube-node-lease # remove as operator is `In`
     

     Pastikan scope ditetapkan ke Namespaced, bukan *, sehingga webhook hanya beroperasi di namespace tertentu. Jika operator adalah In, pastikan kube-system dan kube-node-lease tidak disertakan dalam values.

   Mengecualikan resource yang cocok

   Webhook juga dianggap tidak aman jika nodes, tokenreviews, subjectaccessreviews, atau certificatesigningrequests tercantum di bawah seperti pada contoh berikut:

   - admissionReviewVersions:
   ...
       resources:
       - 'pods' # keep, remove everything else
       - 'nodes'
       - 'tokenreviews'
       - 'subjectacessreviews'
       - 'certificatesigningrequests'
       scope: '*'
     sideEffects: None
     timeoutSeconds: 3
   

   Hapus nodes, tokenreviews, subjectaccessreviews, dan certificatesigningrequests dari bagian resource.

Langkah selanjutnya

Jika Anda memerlukan bantuan tambahan, hubungi Cloud Customer Care.