Stack Thanos — tingkat baca metrik di atas penyimpanan objek, disusun sebagai modul
Contoh ini mengompilasi sebuah stack kecil yang nyata — tingkat baca/kueri dari sistem metrik Thanos — menjadi manifest Kubernetes hasil sintesis dari satu
Aggregate yang ditulis oleh Developer.
Tingkat baca bukanlah satu komponen tunggal. Ia adalah sebuah modul: sub-aggregate yang dapat digunakan ulang dan menyusun tiga komponen ber-workload tunggal —
- sebuah penyimpanan objek yang kompatibel dengan S3 yang menyimpan blok metrik historis pada sebuah volume dan menyajikannya melalui API S3,
- sebuah Store Gateway yang membaca blok-blok tersebut dari penyimpanan objek dan menyajikannya kepada querier melalui StoreAPI-nya, dengan hanya menyimpan cache lokal sementara, dan
- sebuah front end Query yang menjawab PromQL dan menyebarkan permintaan melalui StoreAPI milik Store Gateway, tanpa menyimpan state sendiri.
Modul ini menghubungkan edge internalnya sendiri — Store Gateway ke penyimpanan objek,
dan Query ke Store Gateway — serta mengekspor Query sebagai endpoint publiknya
query. Aggregate tingkat atas mengimpor modul berdasarkan nama dan merender
stack yang tersusun; operator menentukan ukuran komponen internal modul di dalam
Release.
Berkas
| Berkas | Peran |
|---|---|
aggregate.yaml | Intensi Developer: mengimpor modul tingkat baca Thanos (core/thanos). |
manifest-helm-synth.yaml | Memetakan tipe penyimpanan objek, Store Gateway, dan Query ke Recipes helm sintesisnya, serta Feature kredensial yang dilampirkan modul ke realisasi yang menghasilkan Secret dari masing-masing dua parameter kunci modul. |
release-helm-synth.yaml | Catatan operator untuk target Kubernetes. Menentukan ukuran komponen internal modul berdasarkan ID yang dicakup modul; apa pun yang diserahkan ke default skema dirender secara mandiri. |
Prasyarat runtime
Modul ini hanya tingkat baca/kueri. Penyimpanan objek membuat bucket thanos yang dibaca Store Gateway sebelum mulai melayani, sehingga satu-satunya hal yang perlu disediakan saat runtime, di luar manifest yang dirender, adalah penulis yang menghasilkan blok metrik. Tingkat baca menyajikan blok; ia tidak membuatnya. Sebuah penulis — tingkat Thanos Receive atau instans Prometheus dengan sidecar Thanos — harus mengirimkan blok metrik ke bucket yang sama. Sampai penulis mengunggah blok, Store Gateway menyajikan himpunan hasil kosong.
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:
aggrega scaffold --example thanos-stackKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd thanos-stackBuild
Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registry hub, hub.aggrega.ai, dan flag katalog tidak diperlukan; --auto-pull menulis lockfile yang tidak dimiliki clone baru selama build:
aggrega build --release release-helm-synth.yaml --auto-pullArtefak yang dirender ditempatkan di bawah dist/. Target Kubernetes merender manifest
biasa secara offline — tidak diperlukan penarikan chart.
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 `thanos-stack`, panggil alat `scaffold` sekali dengan `example` diatur ke `thanos-stack` dan tanpa `dir`: alat ini menulis contoh ke folder `thanos-stack` yang baru. Lalu panggil alat `build` dengan `workspace_root` diatur ke `thanos-stack`, `release` diatur ke `release-helm-synth.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 `thanos-stack/dist/`.Seperti apa stack yang tersusun
Store Gateway dirender sebagai Deployment stateless ditambah Service ClusterIP yang mengekspos port gRPC StoreAPI dan port HTTP-nya. Kontainernya dijalankan dengan thanos store dan satu flag --objstore.config inline yang nilainya adalah stanza S3 yang dibangun dari endpoint yang dipublikasikan penyimpanan objek — nama Service dan port di dalam klaster, dengan insecure: true karena endpoint tersebut disajikan melalui HTTP biasa. Konfigurasi tersebut memilih rantai kredensial AWS SDK, sehingga tidak membawa secret; kedua bagian access key tiba sebagai variabel lingkungan yang dibaca dari Secret:
args: - store - --grpc-address - 0.0.0.0:10901 - --http-address - 0.0.0.0:10902 - --data-dir - /var/thanos/store - |- --objstore.config=type: S3 config: bucket: thanos endpoint: metrics-zdobjstore-default:8333 insecure: true aws_sdk_auth: true[… omitted: the container ports for the two addresses named in the args]env: - name: AWS_ACCESS_KEY_ID valueFrom: secretKeyRef: name: metrics-zdstore-s3.credential-id key: s3-access-key - name: AWS_SECRET_ACCESS_KEY valueFrom: secretKeyRef: name: metrics-zdstore-s3.credential key: s3-secret-key[… omitted: the container's resources and its liveness and readiness probes]Query dirender sebagai Deployment stateless ditambah Service ClusterIP pada port HTTP-nya.
Kontainernya dijalankan dengan thanos query dan menghubungi StoreAPI milik Store Gateway
pada endpoint yang disusun dari edge store:
args: - query - --http-address - 0.0.0.0:10902 - --grpc-address - 0.0.0.0:10901 - --endpoint - metrics-zdstore-default:10901Penyimpanan objek dirender sebagai StatefulSet SeaweedFS satu replika dengan volume claim yang di-mount di /data, Service ClusterIP pada port S3, 8333, dan headless Service yang disebut oleh StatefulSet. Sebuah init container membuat bucket thanos sebelum server mulai melayani. Akun server adalah pasangan kunci yang sama, dibaca dari dua Secret miliknya sendiri, metrics-zdobjstore-access-key-id dan metrics-zdobjstore-secret-access-key. Keempat Secret dihasilkan di samping workload, dua untuk slot kunci penyimpanan objek dan dua untuk pasangan kunci yang dibawa koneksi s3 milik Store Gateway, masing-masing membawa nilai default pengembangan modul.
Apa yang didemonstrasikan
- Komposisi sebagai modul. Sebuah kapabilitas multi-workload — tingkat baca metrik yang sebenarnya adalah penyimpanan objek ditambah Store Gateway ditambah front end kueri — dikemas sebagai sub-aggregate yang menyusun tiga komponen ber-workload tunggal, bukan sebagai satu komponen monolitik. Modul diimpor berdasarkan nama dan digunakan ulang di mana pun tingkat baca Thanos diperlukan.
- Penggunaan ulang backend bawaan. Penyimpanan objek adalah komponen pustaka standar
core/storage/s3-object-store, digunakan ulang apa adanya; tingkat baca tidak menambahkan logika penyimpanan sendiri. Manifest memilih realisasi SeaweedFS-nya, sehingga penyimpanan berjalan di klaster di samping tingkat baca. - Edge internal di dalam modul. Store Gateway mendeklarasikan penggunaan
penyimpanan objek dan Query mendeklarasikan penggunaan Store Gateway;
endpointyang dipublikasikan penyimpanan objek serta host dan port yang dipublikasikan Store Gateway dialirkan ke konsumen pada setiap edge, dan Recipe setiap konsumen membangun alamatnya dari nilai-nilai tersebut. Compiler merutekan string tanpa menafsirkannya. - Endpoint publik. Modul mengekspor Query sebagai
query, nama publik yang stabil tempat konsumen terhubung — terpisah dari nama komponen internal modul. - Konfigurasi bebas secret. Konfigurasi penyimpanan objek memilih rantai kredensial AWS SDK, sehingga konfigurasi yang dirender tidak membawa secret; kredensial hanya mengalir sebagai variabel lingkungan.
- Pasangan kunci bersama, diambil melalui referensi. Store Gateway melakukan autentikasi ke penyimpanan objek dengan akun milik penyimpanan itu sendiri, sehingga keduanya berbagi satu pasangan kunci. Modul mengambil setiap bagian sebagai parameter,
s3_access_keydans3_secret_key, dan melampirkan Feature kredensialcore/referenced-secretdengan masing-masing dua kali: ke slotaccess_key_iddansecret_access_keymilik penyimpanan objek, dan sebagaicredential_iddancredentialdari koneksi Store Gateway ke penyimpanan objek, yaitu koneksi tempat gateway menyajikannya. Setiap workload membaca keduanya dari Secret alih-alih membawanya secara inline. Karena modul melampirkan Feature tersebut, Manifest memetakannya. Contoh ini membiarkan parameter pada nilai default pengembangan modul dan memetakan Feature kek8s-secret-from-parameter, yang menghasilkan Secret yang membawa setiap nilai, sehingga stack berjalan secara mandiri. Untuk Release yang melayani lalu lintas nyata, Aggregate mendeklarasikan parameternya sendiri dan meneruskannya melaluiaggregates.metrics.parameters, Release memenuhinya, dan Manifest memetakan Feature kek8s-existing-secret, yang membaca setiap parameter sebagai nama Secret yang sudah ada di namespace. - Image yang dapat direproduksi. Setiap komponen menetapkan tag image secara eksplisit, sehingga manifest yang dirender mereferensikan image yang stabil.