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

Workload kütüphanesi içe aktarma — `$import` ile paylaşılan bir Workload gövdesi

Recipe’si Kubernetes Workload’unu satır içi bir gövde yerine paylaşılan bir kütüphane girdisinden sentezleyen tek bir durumsuz web hizmeti. Bu, bir Recipe üzerinde spec.workload için üçüncü yazım modudur:

  • Mod 1 (satır içi): doğrudan Recipe içinde yazılmış bir Go şablonu Workload.
  • Mod 2 (dosya içe aktarma): $import: ./relative/path.yaml — yerel bir dosya.
  • Mod 3 (kütüphane içe aktarma): $import: <Library>#/workloads/<Entry> — yalın ad kimliğiyle başvurulan bir WorkloadLibrary girdisi.

Buradaki web-service Recipe’si Mod 3’ü kullanır:

spec:
capability: helm
implements: example/compute/web-service
workload:
$import: BaseWorkloads#/workloads/StatelessService

Başvuruyu tek parça bir belirteç olarak yazın: kütüphane adından parçaya kadar içinde hiçbir yerde boşluk ya da satır sonu olmasın. Boşluk içeren bir başvuru kırpılmak yerine reddedilir ve derleme durur — bkz. errors/fatal-halts.md “A reference to a library entry carries whitespace” (Bir kütüphane girdisine yapılan başvuru boşluk içeriyor).

BaseWorkloads, hub kataloğunda (workloadlibrary/base-workloads) yayımlanmış bir WorkloadLibrary’dir. Onun StatelessService girdisi, bu Recipe’nin işleme bağlamında değerlendirilen bir Go şablonudur; bu nedenle .values.image (Component/Aggregate’ten) ve .infra.* (replika sayısı, port, işlem kaynağı — Release’ten) ona tıpkı satır içi bir gövdeye aktığı gibi akar. Workload’u bir kütüphaneye ayırmak, dağıtılan şeyde hiçbir şeyi değiştirmez: işlenen çıktı, eşdeğer satır içi Workload ile bayt düzeyinde aynıdır.

Kütüphanenin sürümü Release başına kilit dosyası tarafından sağlanır — başvuruda hiçbir kayıt defteri sunucusu yer almaz. aggrega pull sırasında BaseWorkloads, kilit dosyasının workload_libraries bölümünde sabitlenir; aggrega build sırasında sabitlenen kütüphane çözümlenir ve girdisi işlenir.

Ö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 workload-library-import

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

Terminal window
cd workload-library-import

Derleme

Terminal window
aggrega pull --release release.yaml # pins BaseWorkloads in release.lock
aggrega build --release release.yaml

Katalog, .aggrega-config.yaml içinde adı verilen hub kayıt defterinden (BaseWorkloads’u ve helm provider’ını sağlar) ve bu örneğin yerel catalog/ dizininden (web-service Component’i ve Recipe’si) çözümlenir. Manifests, dist/app/helm/ altına yerleşir — sınırın directory: değeri ve ardından provider yeteneği.

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 `workload-library-import` klasörü yoksa `scaffold` aracını `example` değeri `workload-library-import` olarak ayarlanmış ve `dir` olmadan bir kez çağırın: örneği yeni bir `workload-library-import` klasörüne yazar. Ardından `build` aracını `workspace_root` değeri `workload-library-import`, `release` değeri `release.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 `workload-library-import/dist/` altındadır.

Bayt düzeyinde aynılık iddiasını doğrulama

Recipe’deki workload: { $import: … } ifadesini, StatelessService gövdesini aynen içeren bir workload: | bloğuyla değiştirin, yeniden derleyin ve iki dist/ ağacını karşılaştırın. Tam olarak eşleşirler: kütüphane başvurusu aynı şablon metnine çözümlenir ve aynı işleme bağlamında değerlendirilir; bu nedenle içe aktarma, işlenen baytlar üzerinde hiçbir etkisi olmayan, yazım yüzeyinin bir ayrıştırılmasıdır.