Mengelola konfigurasi Logtail dengan CRD Kubernetes | SLS - Simple Log Service

Simple Log Service mendefinisikan dua CRD Kubernetes—AliyunPipelineConfig dan AliyunLogConfig—yang memungkinkan Anda mengelola konfigurasi Logtail sebagai CustomResources (CR).

Ikhtisar

CRD memperluas API Kubernetes untuk mendefinisikan tipe resource kustom. Setiap CR merupakan instans dari sebuah CRD. Perluas API Kubernetes dengan CustomResourceDefinitions.

Untuk mengelola konfigurasi Logtail menggunakan CR, hubungkan ke kluster Kubernetes Anda, lakukan autentikasi, lalu kirimkan file YAML ke kube-apiserver untuk membuat CR.

Peringatan

Jika Anda membuat konfigurasi Logtail melalui CR, selalu lakukan pembaruan melalui CR tersebut. Perubahan yang dilakukan di konsol SLS tidak disinkronkan kembali ke CR.

Implementasi pengelolaan konfigurasi Logtail berbasis CR

SLS membuat Deployment yang menginstal alibaba-log-controller, yang memantau perubahan pada CRD AliyunLogConfig.
Ketika Anda membuat, memperbarui, atau menghapus CR AliyunLogConfig melalui kubectl atau alat lainnya, alibaba-log-controller mendeteksi perubahan tersebut dan mengirimkan permintaan yang sesuai ke SLS—misalnya, memperbarui konfigurasi Logtail.

CRDs

SLS menyediakan dua CRD untuk mengelola konfigurasi Logtail di Kubernetes: AliyunPipelineConfig dan AliyunLogConfig. Tabel berikut membandingkan kemampuan keduanya.

Penting

AliyunPipelineConfig memerlukan Logtail versi 0.5.1 atau lebih baru.

CRD	AliyunPipelineConfig (direkomendasikan)	AliyunLogConfig
ApiGroup	telemetry.alibabacloud.com/v1alpha1	log.alibabacloud.com/v1alpha1
Nama resource CRD	ClusterAliyunPipelineConfig	AliyunLogConfig
Lingkup	Cluster	Namespace
Format konfigurasi Logtail	Setara dengan LogtailPipelineConfig	Setara dengan LogtailConfig
Kemampuan cross-region	Didukung	Didukung
Kemampuan cross-account	Didukung	Didukung
Verifikasi parameter terkait webhook	Didukung	Tidak didukung
Deteksi konflik konfigurasi	Didukung	Didukung (Logtail 0.5+)
Tingkat kesulitan konfigurasi	Relatif rendah	Relatif tinggi
Konfigurasi observabilitas	Bidang Status mencakup detail kesalahan, waktu pembaruan, konfigurasi Logtail yang diterapkan sebelumnya, dan kapan konfigurasi tersebut diterapkan.	Bidang Status berisi kode kesalahan dan pesan kesalahan.

Pemecahan masalah error 404 setelah CRD dihapus

Jika pembuatan atau pembaruan konfigurasi Logtail gagal dengan pesan no matches for kind "ClusterAliyunPipelineConfig" atau the server could not find the requested resource, kemungkinan CRD ClusterAliyunPipelineConfig telah terhapus secara tidak sengaja.

Langkah-langkah pemecahan masalah

Periksa apakah CRD masih ada:
```
kubectl get crd | grep ClusterAliyunPipelineConfig
```
Jika tidak ada output yang dikembalikan, berarti CRD telah dihapus.

Instal ulang LoongCollector untuk memulihkan CRD:

helm upgrade loongcollector loongcollector/loongcollector -n kube-system --reuse-values

Atau, terapkan langsung file YAML CRD:

kubectl apply -f crd.yaml

Verifikasi bahwa CRD telah dipulihkan:

kubectl get crd | grep ClusterAliyunPipelineConfig

Verifikasi bahwa Anda dapat membuat konfigurasi Logtail lagi:
```
kubectl apply -f your-pipeline-config.yaml
```

Catatan

CRD dikelola oleh direktori crds dalam Helm chart LoongCollector. Me-restart loongcollector-operator tidak akan membuat ulang CRD; Anda harus memulihkannya dengan helm upgrade atau kubectl apply. Menghapus CRD juga akan menghapus semua resource ClusterAliyunPipelineConfig yang ada.