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

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

BerkasPeran
aggregate.yamlIntensi Developer: mengimpor modul tingkat baca Thanos (core/thanos).
manifest-helm-synth.yamlMemetakan 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.yamlCatatan 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:

Terminal window
aggrega scaffold --example thanos-stack

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

Terminal window
cd thanos-stack

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; --auto-pull menulis lockfile yang tidak dimiliki clone baru selama build:

Terminal window
aggrega build --release release-helm-synth.yaml --auto-pull

Artefak 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:10901

Penyimpanan 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; endpoint yang 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_key dan s3_secret_key, dan melampirkan Feature kredensial core/referenced-secret dengan masing-masing dua kali: ke slot access_key_id dan secret_access_key milik penyimpanan objek, dan sebagai credential_id dan credential dari 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 ke k8s-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 melalui aggregates.metrics.parameters, Release memenuhinya, dan Manifest memetakan Feature ke k8s-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.