İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

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

DosyaRol
aggregate.yamlDeveloper niyeti: Thanos okuma katmanı modülünü (core/thanos) içe aktarır.
manifest-helm-synth.yamlNesne 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.yamlKubernetes 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:

Terminal window
aggrega scaffold --example thanos-stack

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd thanos-stack

Derleme

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:

Terminal window
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:10901

Nesne 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ığı endpoint ile 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 query olarak 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_key ve s3_secret_key biçiminde alır ve her biriyle core/referenced-secret kimlik bilgisi Feature’ını iki kez ekler: nesne deposunun access_key_id ve secret_access_key yuvalarına ve Store Gateway’in nesne deposuna olan bağlantısının, yani ağ geçidinin onları sunduğu bağlantının credential_id ve credential alanları 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 üreten k8s-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 okuyan k8s-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.