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

Grafana — tek Aggregate, iki hedef, isteğe bağlı yönetici kimlik bilgisi

Bu örnek, tek bir Grafana pano ve görselleştirme sunucusunu, geliştiricinin yazdığı tek bir Aggregate’ten iki gerçekleştirime derler:

  • yerel geliştirme için Docker Compose ve
  • resmî upstream grafana/grafana imajını doğrudan Kubernetes üzerinde çalıştıran sentezlenmiş helm Recipe (harici chart yok).

Sentezlenmiş helm Recipe, Kubernetes yoludur: üçüncü taraf bir chart yerine yalnızca resmî bir imaj etiketine bağlıdır ve işlenen kaynak kümesi tam olarak iş yükünün bildirdiği şeydir.

Her ikisini de aynı aggregate.yaml yönlendirir. Gerçekleştirime göre yalnızca Manifest’in seçtiği Recipe katmanı değişir. İki Aggregates daha, aynı sunucuyu isteğe bağlı bir yönetici parolası kimlik bilgisi eklenmiş olarak gösterir: Compose yolu için aggregate-auth.yaml (ortam değişkeni olarak sunulan, değer enjekte eden bir kimlik bilgisi) ve sentezlenmiş helm yolu için aggregate-helm-synth-auth.yaml (Kubernetes Secret olarak somutlaştırılan, başvurulabilir bir kimlik bilgisi).

Paketlenen Grafana sunucusu AGPL-3.0 lisanslıdır.

Dosyalar

DosyaRol
aggregate.yamlGeliştirici amacı: core/observability/grafana türünde tek bir dashboards bileşeni, kimlik bilgisi yok — yönetici hesabı Recipe’in deterministik geliştirme parolasını kullanır.
aggregate-auth.yamlBileşenin isteğe bağlı admin_password yuvasına yönetici parolası kimlik bilgisi eklenmiş aynı sunucu (Compose yolu).
aggregate-helm-synth-auth.yamlSentezlenmiş helm yolu için başvurulabilir bir kimlik bilgisi eklenmiş aynı sunucu — değer, Deployment’ın başvurduğu bir Kubernetes Secret olarak somutlaştırılır.
manifest-compose.yamlGrafana türünü Compose Recipe’ine (compose/grafana), kimlik bilgisini de dotenv-secret’e eşler.
manifest-helm-synth.yamlGrafana türünü sentezlenmiş helm Recipe’ine (helm/grafana), kimlik bilgisini de k8s-secret-from-parameter’e eşler.
release-compose.yaml / release-helm-synth.yamlİki gerçekleştirim için operatör kayıtları, ekli kimlik bilgisi yok.
release-compose-auth.yaml / release-helm-synth-auth.yamlKimlik doğrulamayı etkinleştiren operatör kayıtları.

Neyi gösteriyor

  • Tek yazım yüzeyi, birçok hedef. Tek bir Aggregate, yığının ne olduğu konusunda doğruluğun kaynağıdır. Her Manifest onun nasıl gerçekleştirileceğini söyler.
  • Kalıcı bir birimle desteklenen sunucu. Grafana durumunu — kullanıcılar, kayıtlı panolar, tercihler — diskte tutar; bu nedenle bileşen, boyutu infra.storage’dan alınan bir veri birimi bildirir. Kubernetes’te sentezlenmiş helm Recipe, /var/lib/grafana yoluna bağlanmış bir PersistentVolumeClaim ile bir Deployment işler; Compose’da ise hizmet aynı yola adlandırılmış bir birim bağlar.
  • Workload sentezi (Kubernetes). Sentezlenmiş helm Recipe, bir Workload bildirir — resmî grafana/grafana imajını çalıştıran bir Deployment ile bir ClusterIP Service — ve helm sağlayıcısı bunu harici chart olmadan Kubernetes manifestlerine çevirir. İşlenen kaynak kümesi tam olarak Workload’un bildirdiği şeydir. Hem bir Compose hem de bir sentezlenmiş helm Recipe grafana adını taşıdığından, Manifests bunlara sağlayıcı kapsamlı olarak compose/grafana ve helm/grafana biçiminde başvurur.
  • Deterministik bir yönetici parolası. Grafana yönetici hesabı her zaman vardır. Bu bileşen parolayı isteğe bağlı bir admin_password kimlik bilgisi yuvası üzerinden bağlar: kimlik bilgisi eklenmediğinde (temel Aggregate) Recipe deterministik bir geliştirme parolası ayarlar, böylece işleme çıktısı çalıştırmalar arasında bayt düzeyinde aynıdır; kimlik bilgisi eklendiğinde ise enjekte edilen değer yönetici parolası olur. Compose’da bu, GF_SECURITY_ADMIN_PASSWORD ortam değişkeni olarak sunulur; Kubernetes’te sentezlenmiş helm yolu bunu, Deployment’ın bir env secretKeyRef aracılığıyla başvurduğu bir Secret olarak somutlaştırır; böylece düz metin Deployment manifestinde hiçbir zaman görünmez.

Burada modellenmeyenler

Grafana bağımsız olarak dağıtılır. Bir metrik veya günlük kaynağını — örneğin bir Prometheus sunucusunu — Grafana’ya sağlanmış bir veri kaynağı olarak bağlamak modellenmemiştir: bileşen hiçbir uses soketi bildirmez.

Ö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 grafana-dashboards

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

Terminal window
cd grafana-dashboards

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
# Local development (Docker Compose), development admin password
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), development admin password
aggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabled
aggrega build --release release-compose-auth.yaml --auto-pull
aggrega build --release release-helm-synth-auth.yaml --auto-pull

İşlenen yapıtlar dist/ altına yerleşir.

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 klasör oluşturmayın. Çalışma alanı klasöründe henüz bir `grafana-dashboards` klasörü yoksa `scaffold` aracını `example` değeri `grafana-dashboards` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `grafana-dashboards` klasörüne yazar. Ardından `build` aracını her Release için bir kez, şu sırayla çağırın — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml`, `release-helm-synth-auth.yaml` — her seferinde `workspace_root` değeri `grafana-dashboards`, `release` değeri o dosya, `auto_pull` değeri true ve `write` değeri true olacak şekilde. Her derlemenin hangi dosyaları yazdığını bana söyleyin; dosyalar `grafana-dashboards/dist/` altındadır.

Kimlik bilgisi teslimi notu

Compose yolunda kimlik bilgisi, değer enjekte eden bir gizli değerdir (aggregate-auth.yaml): değeri bileşenin ortam hattı üzerinden teslim edilir ve GF_SECURITY_ADMIN_PASSWORD hizmet ortam değişkeni olur.

Sentezlenmiş helm yolu başvurulabilir bir kimlik bilgisi kullanır (aggregate-helm-synth-auth.yaml): değer bir Kubernetes Secret olarak somutlaştırılır ve Deployment buna GF_SECURITY_ADMIN_PASSWORD’a bağlı bir env secretKeyRef aracılığıyla başvurur. Bu nedenle düz metin parola Deployment manifestinde hiçbir zaman görünmez — yalnızca Secret’ta bulunur.

Kimlik doğrulamalı Aggregates içindeki origin değeri bir geliştirme yer tutucusudur; gerçek her dağıtım için kimlik bilgisi kaynağınız aracılığıyla gerçek bir değer sağlayın.

Çalıştırın (Compose)

Terminal window
aggrega build --release release-compose.yaml --auto-pull
docker compose -f dist/app/compose/docker-compose.yaml up -d

http://localhost:3000 adresini — Grafana web arayüzünü — açın ve geliştirme parolasıyla admin olarak oturum açın. Kaldırmak için docker compose -f dist/app/compose/docker-compose.yaml down komutunu kullanın.