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

Bu sayfalardaki çıktıyı okumak

Bu bölümdeki sayfaların çoğu size girdinin yanı sıra çıktıyı da gösterir: derlemenin dist/ altına yazdığı bir dosya, derlemenin terminalinize yazdırdığı metin ya da tofu gibi bir aracı derlemenin yazdıkları üzerinde çalıştırdığınızda aracın yazdırdıkları.

Bu bloklar elle yazılmamış, gerçek bir çalıştırmadan kopyalanmıştır. Örneği kendiniz derlerseniz kendi çıktınızı sayfayla satır satır karşılaştırabilirsiniz.

Çıktının burada bulunmasının nedeni de bu karşılaştırmadır. Bu sayfaların birçoğu sizden bir satırı değiştirip yeniden derlemenizi ya da işlenmiş bir dosyayı silip aracı yeniden çalıştırmanızı, ardından farkı okumanızı ister. Böyle bir talimat ancak karşılaştırdığınız blok birebir doğruysa izlenmeye değer; aksi hâlde sayfanın bulmanızı istediği bir farkı, sayfanın hiç değinmediği bir farktan ayırt etmenin yolu olmaz.

Bu yüzden çıktı gösteren bir blok her zaman iki durumdan birindedir, asla ikisinin arasında bir yerde değildir.

Eksiksiz

Blok, sayfanın adını verdiği şeyin tamamını gösterir. Giriş cümlesi web servisi dediğinde, o servisin her satırı oradadır. Bir dosyanın adını verdiğinde, dosyanın tamamı oradadır.

Atlanan yeri işaretlenmiş bir alıntı

Gerçek çıktı çoğu zaman uzundur ve tamamını yazdırmak, sayfanın öğrettiği tek satırı gömer. Satırlar atlandığında blok bunu, atlandıkları noktada, kendi satırında belirtir:

[… omitted: what was left out]

Kullanımı şöyledir. Bu, terraform-declared-sensitivity örneği için bir plandır; burada anlatılan nokta tek bir öznitelikle ilgilidir:

# module.store.terraform_data.reference will be created
+ resource "terraform_data" "reference" {
[… omitted: an id attribute, reported as known only after apply]
+ input = (sensitive value)
[… omitted: an output attribute, reported as known only after apply]
+ triggers_replace = [
+ "app-artifacts",
+ "AKIAEXAMPLE0001",
]
}

Sizin planınız bu iki özniteliği içerecektir. İşaret, bunların orada olması gerektiğini, yani derlemenizin farklı yaptığı bir şey değil, sayfanın yeniden yazdırmamayı seçtiği satırlar olduğunu anlamanızı sağlar. Satırların çıkarıldığı her yerde bir işaret bulunur; böylece konumları da yoklukları kadar okunabilir olur.

İşaret her zaman neyin çıkarıldığını söyler, asla yalnızca bir şeyin çıkarıldığını değil. “Yalnızca apply sonrasında bilinecek olarak bildirilen bir id özniteliği” ifadesi, o satırla karşılaştığınızda onu tanımanız için yeterlidir; çıplak bir üç nokta yeterli olmazdı.

Köşeli parantezler bilinçli olarak seçilmiştir. [… ile başlayan bir satır YAML, HCL, JSON ya da bu sayfaların yazdırdığı diğer biçimlerin hiçbirinde geçerli içerik değildir ve burada gösterilen araçların hiçbiri böyle bir satır yazdırmaz. Dolayısıyla böyle bir satır her zaman sayfanın sözüdür, asla derlemenin ürettiği bir şey değildir; ne çıktı sanılabilir ne de göz gezdirirken gözden kaçabilir.

Atlama sayılmayanlar

Dört şey, hiçbir şeyi dışarıda bırakmadan bir bloğun görünüşünü değiştirir ve hiçbiri işaret almaz:

  • Daha küçük bir kapsamı adlandırmak. “web servisi” diyen ve ardından o servisi gösteren bir sayfa, adını verdiği şeyden hiçbir şeyi dışarıda bırakmamıştır. Dosyanın geri kalanı kapsamdan eksik değil, kapsamın dışındadır.
  • Girinti. Derin iç içe geçmiş bir yapıdan alınan bir parça, kendi başına okunabilmesi için genellikle sol kenardan başlatılarak gösterilir. Satırlar üretilen satırlardır; yalnızca baştaki boşluklar değişmiştir.
  • Bir başlık ya da not. Satırların geldiği dosyayı adlandıran bir # satırı ya da bir değerin yanındaki kısa bir not, açıkça derlemenin değil sayfanın sözüdür.
  • Alıntılanan bir iletinin her satırındaki #. Bir sayfa bir komutu ve onun yazdırdığı iletiyi tek blokta gösterdiğinde, bloğun tamamı çalıştırılabilir kalsın diye ileti yorum satırına alınır. Yazdırılan tek bir uzun satır, bu genişlikte okunabilir kalması için birkaç # satırına bölünebilir. Her iki durumda da sözcükler, yazdırılan sırayla, yazdırılan sözcüklerdir.

İşaret, başka türlü fark edemeyeceğiniz tek durum için vardır: düpedüz orada olmayan satırlar.

Yeniden üretmek yerine örnekleyen bir blok

Buradaki birkaç sayfa, derleyebileceğiniz çalışma alanları değil, yazılı adım adım anlatımlardır; bir iki tanesi de bir yükün belirli bir çalıştırmasını değil biçimini gösterir. Böyle bir blok karşılaştırma yapabileceğiniz bir güvence taşımaz; bu yüzden bunu çevresindeki sözcüklerle belirtir ve asla sessizce gerçeğinin yerine geçmez. Bir blok bunu belirtmiyorsa, bir çalıştırmadan kopyalanmıştır ve yukarıdaki iki durum ona uygulanır.

Bu sayfalardan birini uyarlarsanız

Aynı iki durumu koruyun. Çıktı değiştiğinde (örneği değiştirdiğiniz için ya da daha yeni bir sürüm onu farklı işlediği için) bloğu elle düzenlemek yerine gerçek bir çalıştırmadan yenileyin ve dışarıda bıraktığınız her satırı işaretleyin. Doğru görünsün diye düzenlenmiş bir blok, bu uzlaşımın önlemeyi amaçladığı tek şeydir; çünkü denetlenmiş bir blokla tıpatıp aynı okunur.