Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Loki — server agregasi log Kubernetes

Contoh ini mengompilasi sebuah stack kecil yang nyata — sebuah server agregasi log Grafana Loki — dari satu Aggregate yang ditulis oleh Developer ke Kubernetes, didukung oleh Helm chart resmi Grafana Loki dalam bentuk single-binary-nya.

Loki adalah backend log: ia menerima aliran log melalui API push HTTP-nya, mengindeksnya berdasarkan label alih-alih berdasarkan konten teks lengkap, menyimpannya dalam penyimpanan objek chunk, dan menjawab permintaan kueri log dan rentang melalui API HTTP yang sama. Dalam bentuk single-binary, setiap subsistem Loki — distributor, ingester, querier, compactor — berjalan di dalam satu proses yang didukung oleh penyimpanan chunk lokal, sehingga seluruh server merupakan satu workload stateful. Pengirim log mendorong aliran ke Loki; server dasbor membacanya kembali melalui API kueri.

Berkas

BerkasPeran
aggregate.yamlIntent Developer: satu komponen logging (core/observability/loki) yang menyimpan log selama tujuh hari.
manifest.yamlMemetakan tipe komponen ke Recipe Loki yang bersumber dari luar (loki).
release.yamlCatatan operator untuk target Kubernetes: komputasi server dan ukuran volume penyimpanan chunk.

Apa yang didemonstrasikan

  • Satu permukaan penulisan. Satu Aggregate adalah sumber kebenaran tentang apa itu Loki; Manifest menyatakan bagaimana mewujudkannya.
  • Backend log single-binary. Recipe yang bersumber dari luar merender Loki sebagai satu StatefulSet dengan volume data, konfigurasinya dalam beberapa ConfigMap, beberapa Service yang mengekspos endpoint push-dan-kueri HTTP, serta sebuah ServiceAccount — satu workload mandiri, dengan jalur penskalaan terdistribusi dan layanan tambahan bawaan dinonaktifkan.
  • Retensi yang ditetapkan developer. retention_period dari developer diteruskan ke compactor dalam proses, yang menghapus aliran log tersimpan setelah usianya melewati batas tersebut.
  • Kontrak ingesti yang diekspor. Komponen mengekspor host dan port layanan dalam klusternya melalui topologi uses, sehingga pengirim log terhubung ke sana dan mendorong aliran ke sana.
  • Image yang dapat direproduksi. Recipe mematok image server Loki dan image sidecar config-reload ke tag yang dapat di-resolve sehingga workload yang dirender merujuk ke versi yang dipatok.

Membuat contoh

Anda dapat mem-build contoh ini dengan perintah di bawah, atau meminta asisten AI Anda mem-build-nya untuk Anda.

Tulis contoh ke folder baru yang dinamai sesuai contoh itu:

Terminal window
aggrega scaffold --example loki-logging

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd loki-logging

Build

Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registry hub, hub.aggrega.ai, dan flag katalog tidak diperlukan:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

Artefak yang dirender ditempatkan di bawah dist/. Build me-resolve chart upstream melalui referensi OCI saat aggrega pull dan mem-pin-nya dalam sebuah lockfile.

Dengan asisten AI

Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.

Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `loki-logging`, panggil alat `scaffold` sekali dengan `example` diatur ke `loki-logging` dan tanpa `dir`: alat ini menulis contoh ke folder `loki-logging` yang baru. Kemudian panggil alat `build` dengan `workspace_root` diatur ke `loki-logging`, `release` diatur ke `release.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh build; file tersebut berada di bawah `loki-logging/dist/`.

Apa yang dirender

Build menghasilkan server Loki sebagai satu set objek Kubernetes yang mandiri:

  • sebuah StatefulSet — proses Loki single-binary, dengan penyimpanan chunk-nya pada volume persisten,
  • beberapa ConfigMap — konfigurasi Loki dan konfigurasi runtime,
  • beberapa Service — mengekspos endpoint push-dan-kueri HTTP pada port 3100,
  • sebuah ServiceAccount untuk workload, beserta binding aksesnya.

Tidak ada workload read/write/backend terdistribusi, subchart penyimpanan objek, cache, maupun operator yang dirender — hasil render adalah satu workload Loki. Image server Loki dan sidecar config-reload dipatok ke tag rilisnya, sehingga workload merujuk ke image yang dipatok.