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

İçe aktarma yanıtları dosyası

Bazı değerleri hiçbir kaynak tutamaz: kendi kodunuzdan derlenen bir uygulamanın imajı, bir sahip hesabının e-postası, kaynağın adını vermediği bir model, bir Kubernetes Secret’ının adı. aggrega import bu tür her değeri, ne olduğunu söyleyen bir yorumun altında boş bir dize olarak taslağa yazar ve sizden bir kez alır — yanıtlar dosyasından veya bir terminaldeki bir sorudan. Yanıtlar, yanıtlar dosyası import-answers.yaml’da tutulur; böylece aynı kaynağın sonraki her içe aktarımı bunları oradan okur ve hiçbir şey sormaz.

Bu sayfa, dosyanın nerede bulunduğunu, neyi tuttuğunu, değerlerin ona nasıl girdiğini ve bir değer hâlâ eksikken bir içe aktarmanın ne yaptığını açıklar. Bir içe aktarmanın ne işe yaradığı ve bir kaynaktan bir derlemeye uzanan adım adım anlatımlar İçe aktarma sayfasındadır.

Hangi değerler bekleniyor

Taslak oluşturulduktan sonra içe aktarma, taslağı yazılmış her belgeyi kendi şemasına ve belgenin bildirdiği her Component, Feature ve bağlantının katalog şemasına göre okur. Bir değer, o şemanın bir değer gerektirdiği yerde hâlâ boşsa veya şemanın anahtarı bildirdiği ve hiçbir şeyin onu sağlamadığı yerdeyse beklenen bir değerdir. Beklenen her değer, şemanın kendi anahtar açıklamasıyla tanımlanır; şema açıklama vermiyorsa, taslağın anahtarın üstüne yazdığı yorumla.

Herhangi bir değer beklendiği sürece içe aktarma, taslağı yazılan Release’in bağımlılıklarını çekmez; her değer yanıtlandığında onları çeker (bkz. Yeniden çalıştırma ve --sync).

Dosyanın bulunduğu yer

KaynakYanıt dosyası
bir dosya isekaynak dosyayla aynı dizindeki import-answers.yaml
bir dizin isekaynak dizinin içindeki import-answers.yaml

--answers <file> başka bir dosyayı belirtir. Göreli bir yol, komutu çalıştırdığınız dizine göre çözümlenir. Taslaklarda eksik değerler varsa ve yanıt dosyası kaynağın yanındaki varsayılan dosya değilse, içe aktarmanın taslakların yanına yazdığı kayıt, .aggrega-import.json, bu dosyayı belirtir; böylece aynı dizine daha sonra yapılan bir aggrega import --sync onu yeniden belirtilmesine gerek kalmadan okur. Kayıt hiçbir zaman bir yanıt içermez.

Bir gizli değerin yanıtı, gizli değerin nereden geldiğinin adıdır, asla gizli değerin kendisi değildir (bkz. Gizli değerler); bu nedenle yanıt dosyası, kaynakla birlikte sürüm denetiminde tutulabilir.

Ne içerir

Dosya YAML biçimindedir. Üst düzey anahtarları, her birinin taslak olarak oluşturulduğu yola göre taslak dosyalardır. Her birinin altında bir anahtar, o belgedeki eksik bir değerin noktalı anahtar yoludur ve değeri yanıttır. Şemanın anahtar için verdiği açıklama, anahtarın üstüne yorum olarak yazılır. Boş olan ya da nokta, boşluk karakteri veya tırnak işareti içeren bir anahtar yolu parçası çift tırnak içinde yazılır. Bu yapıda okunamayan bir dosya, dosyayı ve nedenini belirterek içe aktarmayı durdurur ve hiçbir şey yazılmaz.

Örneğin, --target helm ile taslağı oluşturulan Google ADK içe aktarması, Release’inde iki eksik değer bırakır: projenizden derlediğiniz ajanın imajı ve ajanın Gemini API anahtarının nereden geldiği. İkisi de yanıtlandığında, support_agent/ kaynak dizinindeki yanıt dosyası şöyledir:

# Values the import could not draft from the source, keyed by the drafted file and the key path inside
# it. Write each one beside its key; an import of the same source, and a sync, read them from here and
# ask nothing. A secret is never written here: its key asks where the secret comes from — a variable
# name, ${NAME}, or the name of a Kubernetes Secret.
release.yaml:
# Container image running the application built on ADK, serving its API on infra.port on every
# interface.
spec.components.support-agent.infra.image: "ghcr.io/example/support-agent:1.0.0"
# The origin of the secret value, written by the operator in the Release. Read exactly as
# values.origin is. Write it here or in values.origin, never in both. A secret: name where it comes
# from, never the value.
spec.components.support-agent.uses.model.gemini-2-5-flash.features.credential.infra.origin: "google-api-key"

Her iki yanıt da size aittir: ghcr.io/example/support-agent:1.0.0, derleyip gönderdiğiniz imajı, google-api-key ise dağıttığınız ad alanında anahtarı tutan Kubernetes Secret’ının adını temsil eder.

Her yanıt tek bir değerdir ve içe aktarma onu boş olanın yerine taslağa bir dize olarak yazar, taslakta başka hiçbir şeyi değiştirmez. Taslağı oluşturulan bir Aggregate’e yazılan yanıt, {{ dahil, tam olarak yazdığınız gibi geri okunur. Boş bir yanıt, değeri eksik bırakır.

Değerler nasıl girilir

İçe aktarma, her eksik değeri önce yanıt dosyasından yanıtlar. Dosyanın yanıtsız bıraktığı her değer için size her seferinde tek bir soru sorar — ancak yalnızca standart girdi ve standart çıktının ikisi de bir terminal olduğunda ve --dry-run verilmediğinde:

  • her soru taslak dosyayı ve anahtar yolunu belirtir ve şemanın açıklamasından yola çıkarak ifade edilir;
  • sorular standart hataya yazılır, böylece standart çıktı yalnızca içe aktarmanın sonucunu taşır;
  • Enter tuşuna basmak değeri sonraya bırakır ve girdiyi sonlandırmak soru sormayı durdurur.

Verdiğiniz her yanıt taslaklara ve yanıt dosyasına yazılır ve yanıt dosyası yazılan dosyalar arasında belirtilir. Yanıt dosyasında hiçbir şeyi değiştirmeyen bir çalıştırma onu yeniden yazmaz.

Gizli bilgiler

Bir gizli bilginin değeri — şemasının hassas olarak işaretlediği bir değer — gizli bilginin kendisiyle asla yanıtlanmaz; gizli bilginin nereden geldiğiyle yanıtlanır. Sorusu bunu sorar ve yanıt şu adlardan biridir:

YanıtÖrnek
bir değişken adıOPENAI_API_KEY
bir değişkene başvuru${OPENAI_API_KEY}
bir Kubernetes Secret’ın adıopenai-api-key

İçe aktarma, yanıtın bu adlardan birinin biçiminde olup olmadığını denetler ve başka her şeyi reddeder:

  • bir terminalde yanıt reddedilir, nedeni gösterilir ve soru yeniden sorulur;
  • yanıt dosyasında içe aktarma durur; yanıt dosyasını, taslak dosyayı ve anahtarı belirtir — gizli bilginin kendisi olabileceği için yanıtı asla belirtmez — ve hiçbir şey yazmaz.

Denetim yanıtın biçimini okur, bu nedenle tesadüfen bir ada benzeyen gizli bilgi bir addan ayırt edilemez. Gizli bilginin kendisi adın işaret ettiği yerde kalır: değişkende veya Secret’ta.

Terminal olmadığında

Sürekli entegrasyonda, bir boru (pipe) üzerinden ve asistanın içe aktarma aracından (aggrega mcp) hiçbir şey sorulmaz; editörün içe aktarması da çalışırken hiçbir şey sormaz. Yanıt dosyası okunduktan sonra hâlâ eksik değerleri olan bir içe aktarma:

  • taslakları yazar ve her eksik değeri boş bırakır;
  • yanıt dosyasını, her eksik anahtar mevcut ve yanıtı boş olacak şekilde yazar;
  • her eksik değeri standart hatada, taslak dosyayı, anahtar yolunu ve açıklamasını belirten bir uyarı olarak bildirir;
  • taslak Release’in bağımlılıklarını çekmez;
  • 1 durum koduyla ve kaç değerin eksik olduğunu ve bunların nereye yazılacağını söyleyen bir cümleyle çıkar:
2 values the drafts leave empty are still owed, listed in the answers file <path>/support_agent/import-answers.yaml: write each beside its key there, then run the import again

Her yanıtı anahtarının yanına yazın, ardından aynı dizine aggrega import <source> --sync çalıştırın: önceki içe aktarmaya verilen hedef için taslak hazırlar, her yanıtı taslaklara yazar ve hiçbir şey sormaz. Taslak Aggregate’i zaten içeren bir dizine yapılan düz bir aggrega import, --sync seçeneğini belirterek durur ve hiçbir şey yazmaz. Yeni bir çıktı dizinine yapılan içe aktarma da yanıt dosyasını okur: varsayılanı veya --answers seçeneğinin belirttiğini.

Asistanın içe aktarma aracı yanıt dosyasını answers olarak alır; dosya çalışma alanı köküne göreli ya da mutlak olarak belirtilir. Hâlâ eksik değerleri olan bir çağrı bu cümleyle başarısız olur ve yanında, uyarılar dahil, içe aktarmanın sonucunu taşır. Düzenleyicinin içe aktarması da yanıt dosyasını alır ve aynı cümle onun tanılamalarını kapatır.

Her ikisi de hâlâ borçlu olunan her değeri veri olarak owed altında listeler: taslak dosya, anahtar listesi olarak anahtar yolu, soru, değerin bir gizli bilgiye ait olup olmadığı ve bir gizli bilgi için yanıtının ne olması gerektiği (düzenleyiciden secretAdvice, asistanın içe aktarma aracından secret_advice). Her yanıtı answered altında — taslak dosya, anahtar yolu ve yanıt — sync ile geri gönderin; içe aktarma onu denetler, yanıt dosyasında tutar ve taslaklara yazar, tıpkı bir terminalde yazılan bir yanıtla yaptığı gibi. Bir gizli bilginin ad olmayan yanıtı ne tutulur ne de yazılır: değer owed içinde kalır ve önerisinin yerinde neden yer alır.

Taslaklarını yazan bir içe aktarmadan sonra editör, hâlâ borçlu olunan her değeri kendi giriş kutusunda sormayı önerir ve yanıtları bu yolla geri gönderir; bir önizlemeden sonra hiçbir şey önermez, çünkü --dry-run altında hiçbir şey sorulmaz. Sorular Bir içe aktarmanın hâlâ borçlu olduğu değerleri yanıtlama bölümünde açıklanmıştır.

--dry-run altında hiçbir şey sorulmaz ve yanıt dosyası dahil hiçbir şey yazılmaz. Her eksik değer yine de standart hatada bildirilir ve çıkış durumu kuru çalıştırmanın kendi durumudur.

Yeniden çalıştırma ve --sync

aggrega import --sync, önceki içe aktarmayla aynı yanıt dosyasını okur: --answers seçeneğinin belirttiğini, yoksa taslakların yanındaki kaydın belirttiğini, o da yoksa kaynağın yanındaki varsayılanı. Her yanıtı boş değerin yerine taslaklara yazar ve yanıt dosyası tüm eksik değerleri yanıtlıyorsa hiçbir şey sormaz.

Hiçbir değer eksik kalmadığında ve çalışma alanı çevrimdışı olmadığında, içe aktarma taslak Release’in bağımlılıklarını aggrega pull gibi çeker ve release.lock dosyasını yazar; böylece aggrega validate ve aggrega build taslaklar üzerinde hemen çalışır. --offline altında hiçbir şey çekilmez ve içe aktarma sonraki adımda çalıştırılacak aggrega pull --release <path> komutunu belirtir.

Birden çok hedef için tek bir yanıt dosyası

Farklı hedefler için taslağı oluşturulan aynı kaynak farklı değerler gerektirebilir: yukarıdaki Google ADK Release’i --target compose ile taslağı oluşturulduğunda yalnızca imajı gerektirir; aynı Release --target helm ile oluşturulduğunda ise ajanın Gemini API anahtarının nereden geldiğini de gerektirir. Tek bir yanıt dosyası ikisine de hizmet eder:

  • içe aktarma, taslaklarının gerektirdiği anahtarları ekler ve kendisine verilen yanıtları ayarlar;
  • bu taslakların gerektirmediği bir anahtarın yanıtı dosyada tutulur ve uygulanmaz;
  • dosyadaki diğer tüm anahtarlar ve yorumlar olduğu gibi kalır.

Yanıt dosyası yalnızca taslakların bir değer borçlu olduğu yerde okunur. Borçlu olduklarında, standart hatadaki bir bilgi satırı tutulan ve uygulanmayan her yanıtı belirtir — burada --target compose ile taslağı hazırlanan Flowise içe aktarması için; bu içe aktarma yalnızca sahibin e-postasını borçludur ve aynı içe aktarmanın --target helm ile borçlu olduğu iki Kubernetes Secret’ını da belirten bir yanıt dosyasını okur:

info: the answers file <path>/import-answers.yaml also answers spec.components.flowise.features.owner_password.infra.origin in release.yaml, spec.components.flowise.uses.model.chatopenai-0.features.credential.infra.origin in release.yaml, which these drafts do not leave empty; those answers are kept there and not applied

Taslakların hiçbir şey borçlu olmadığı yerde — örneğin her gizli bilgiyi bir değişkenden okuyan, --target compose ile taslağı hazırlanan Langflow içe aktarması — yanıt dosyası okunmaz, böyle bir satır yazdırılmaz ve dosya olduğu gibi bırakılır.

Ayrıca bakınız

  • aggrega import — tüm bayraklar dahil komutun başvurusu.
  • İçe aktarma — bir içe aktarmanın neyin taslağını oluşturduğu ve her kaynak biçimi için adım adım bir anlatım.