Thanos yığını — nesne depolama üzerinde bir metrik okuma katmanı, modül olarak oluşturulmuş
Bu örnek, küçük ve gerçek bir yığını — bir Thanos metrik sisteminin okuma/sorgu katmanını —
Developer tarafından yazılmış tek bir Aggregate’ten sentezlenmiş Kubernetes
manifestlerine derler.
Okuma katmanı tek bir bileşen değildir. Bir modüldür: tek iş yüklü üç bileşeni bir araya getiren, yeniden kullanılabilir bir alt aggregate —
- geçmiş metrik bloklarını bir birimde tutan ve bunları S3 API’si üzerinden sunan bir S3 uyumlu nesne deposu,
- bu blokları nesne deposundan okuyup StoreAPI’si üzerinden sorgulayıcılara sunan ve yalnızca geçici bir yerel önbellek tutan bir Store Gateway ve
- PromQL sorgularını yanıtlayan, istekleri Store Gateway’in StoreAPI’si üzerinden dağıtan ve kendine ait hiçbir durum tutmayan bir Query ön ucu.
Modül kendi iç kenarlarını bağlar — Store Gateway’i nesne deposuna ve Query’yi
Store Gateway’e — ve Query’yi genel uç noktası query olarak dışa aktarır. Üst düzey
Aggregate modülü adıyla içe aktarır ve oluşturulan yığını render eder; operatör
modülün iç bileşenlerini Release’te boyutlandırır.
Dosyalar
| Dosya | Rol |
|---|---|
aggregate.yaml | Developer niyeti: Thanos okuma katmanı modülünü (core/thanos) içe aktarır. |
manifest-helm-synth.yaml | Nesne deposu, Store Gateway ve Query türlerini synth helm Recipes’e, modülün eklediği kimlik bilgisi Feature’ını da modülün iki anahtar parametresinin her birinden bir Secret üreten gerçekleştirime eşler. |
release-helm-synth.yaml | Kubernetes hedefi için operatör kaydı. Modülün iç bileşenlerini modül kapsamlı kimlikleriyle boyutlandırır; şema varsayılanlarına bırakılan her şey kendi kendine yeterli olarak render edilir. |
Çalışma zamanı ön koşulu
Bu modül yalnızca okuma/sorgu katmanıdır. Nesne deposu, Store Gateway’in okuduğu thanos bucket’ını hizmet vermeden önce oluşturur; bu nedenle işlenen manifestlerin dışında, çalışma zamanında sağlanması gereken tek şey metrik blokları üreten bir yazıcıdır. Okuma katmanı blokları sunar; onları oluşturmaz. Bir yazıcı — bir Thanos Receive katmanı ya da Thanos sidecar’ı olan bir Prometheus örneği — metrik bloklarını aynı bucket’a göndermelidir. Bir yazıcı blok yükleyene kadar Store Gateway boş bir sonuç kümesi sunar.
Örneği oluşturun
Bu örneği aşağıdaki komutlarla derleyebilir ya da yapay zekâ asistanınıza sizin için derletebilirsiniz.
Örneği, adını taşıyan yeni bir klasöre yazın:
aggrega scaffold --example thanos-stackArdından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:
cd thanos-stackDerleme
Bu çalışma alanında .aggrega-config.yaml bulunmaz; bu nedenle standart kütüphane varlıkları hub kayıt defteri hub.aggrega.ai üzerinden çözümlenir ve katalog bayrağına gerek yoktur; --auto-pull, yeni bir klonda eksik olan kilit dosyasını derleme sırasında yazar:
aggrega build --release release-helm-synth.yaml --auto-pullİşlenen yapıtlar dist/ altına yerleşir. Kubernetes hedefi düz manifestleri
çevrimdışı işler — chart çekmek gerekmez.
Bir yapay zekâ asistanıyla
Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.
Yalnızca Aggrega araçlarını kullanın ve kendiniz hiçbir klasör oluşturmayın. Çalışma alanı klasöründe henüz bir `thanos-stack` klasörü yoksa `scaffold` aracını `example` değeri `thanos-stack` olarak ayarlanmış ve `dir` olmadan bir kez çağırın: örneği yeni bir `thanos-stack` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `thanos-stack`, `release` değeri `release-helm-synth.yaml`, `auto_pull` değeri true ve `write` değeri true olacak şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `thanos-stack/dist/` altındadır.Oluşturulan yığın nasıl görünür
Store Gateway, durumsuz bir Deployment ile StoreAPI gRPC bağlantı noktasını ve HTTP bağlantı noktasını açan bir ClusterIP Service olarak render edilir. Konteyneri thanos store ve değeri, nesne deposunun yayımladığı uç noktadan oluşturulan S3 bölümü olan tek bir satır içi --objstore.config bayrağıyla başlatılır — küme içi Service adı ve bağlantı noktası, bu uç nokta düz HTTP üzerinden sunulduğu için insecure: true ile birlikte. Bu yapılandırma AWS SDK kimlik bilgisi zincirini seçer, bu nedenle hiçbir gizli bilgi taşımaz; erişim anahtarının her iki yarısı da Secret’lardan okunan ortam değişkenleri olarak gelir:
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, durumsuz bir Deployment ile HTTP bağlantı noktasında bir ClusterIP Service
olarak render edilir. Konteyneri thanos query ile başlatılır ve store kenarından
oluşturulan uç noktada Store Gateway’in StoreAPI’sine bağlanır:
args: - query - --http-address - 0.0.0.0:10902 - --grpc-address - 0.0.0.0:10901 - --endpoint - metrics-zdstore-default:10901Nesne deposu, /data konumuna bağlanmış bir birim talebiyle tek kopyalı bir SeaweedFS StatefulSet’i, 8333 numaralı S3 bağlantı noktasında bir ClusterIP Service ve StatefulSet’in adlandırdığı headless Service olarak render edilir. Bir init konteyneri, sunucu hizmet vermeye başlamadan önce thanos bucket’ını oluşturur. Sunucunun hesabı aynı anahtar çiftidir ve kendine ait iki Secret’tan, metrics-zdobjstore-access-key-id ve metrics-zdobjstore-secret-access-key’ten okunur. Dört Secret iş yüklerinin yanında üretilir: ikisi nesne deposunun anahtar yuvaları, ikisi de Store Gateway’in s3 bağlantısının taşıdığı anahtar çifti için; her biri modülün geliştirme varsayılanını taşır.
Neyi gösteriyor
- Modül olarak bileşim. Çok iş yüklü bir yetenek — aslında bir nesne deposu, bir Store Gateway ve bir sorgu ön ucundan oluşan bir metrik okuma katmanı — tek parça bir bileşen olarak değil, tek iş yüklü üç bileşeni bir araya getiren bir alt aggregate olarak paketlenir. Modül adıyla içe aktarılır ve bir Thanos okuma katmanı gereken her yerde yeniden kullanılır.
- Sağlanan bir arka ucun yeniden kullanımı. Nesne deposu, olduğu gibi yeniden kullanılan standart kütüphane bileşeni
core/storage/s3-object-store’dur; okuma katmanı kendine ait hiçbir depolama mantığı eklemez. Manifest onun SeaweedFS gerçekleştirimini seçer; böylece depo, kümede okuma katmanının yanında çalışır. - Modül içindeki iç kenarlar. Store Gateway nesne deposunun kullanımını, Query de
Store Gateway’in kullanımını bildirir; nesne deposunun yayımladığı
endpointile Store Gateway’in yayımladığı ana makine ve bağlantı noktası her kenarda tüketiciye aktarılır ve her tüketicinin Recipe’i adresini bunlardan oluşturur. Derleyici dizeleri yorumlamadan yönlendirir. - Genel bir uç nokta. Modül Query’yi
queryolarak dışa aktarır; bu, bir tüketicinin bağlandığı, modülün iç bileşen adlarından ayrılmış kararlı genel addır. - Gizli bilgi içermeyen yapılandırma. Nesne deposu yapılandırması AWS SDK kimlik bilgisi zincirini seçer, bu nedenle render edilen yapılandırma hiçbir gizli bilgi taşımaz; kimlik bilgileri yalnızca ortam değişkenleri olarak akar.
- Başvuruyla alınan paylaşılan bir anahtar çifti. Store Gateway nesne deposunda deponun kendi hesabıyla kimlik doğrular, bu nedenle ikisi tek bir anahtar çiftini paylaşır. Modül her yarıyı bir parametre olarak,
s3_access_keyves3_secret_keybiçiminde alır ve her biriylecore/referenced-secretkimlik bilgisi Feature’ını iki kez ekler: nesne deposununaccess_key_idvesecret_access_keyyuvalarına ve Store Gateway’in nesne deposuna olan bağlantısının, yani ağ geçidinin onları sunduğu bağlantınıncredential_idvecredentialalanları olarak. Her iş yükü ikisini de satır içi taşımak yerine Secret’lardan okur. Modül bu Feature’ı eklediği için Manifest onu eşler. Bu örnek parametreleri modülün geliştirme varsayılanlarında bırakır ve Feature’ı, her değeri taşıyan bir Secret üretenk8s-secret-from-parameter’a eşler; böylece yığın kendi kendine yeterli çalışır. Gerçek trafik taşıyan bir Release için Aggregate kendi parametrelerini bildirir ve bunlarıaggregates.metrics.parametersüzerinden aşağı aktarır, Release onları karşılar ve Manifest Feature’ı, her parametreyi ad alanında zaten var olan bir Secret’ın adı olarak okuyank8s-existing-secret’a eşler. - Yeniden üretilebilir imajlar. Her bileşen açık bir imaj etiketi sabitler, böylece render edilen manifestler kararlı imajlara başvurur.