Genyleap/Docs
Altyapı

Operasyonları açığa çıkarmadan mimari.

Bu bölüm entegrasyon sözleşmelerini, dağıtım kalıplarını ve güven sınırlarını belgeler. İç hostname’ler, dosya sistemi düzenleri, private port’lar ve operasyon endpoint’leri bilinçli olarak dışarıda tutulur.

Dokümantasyon sözleşmesi

Herkese açık altyapı dokümantasyonu, geliştiricilerin entegrasyon için ihtiyaç duyduğu arayüzleri açıklarken private topolojiyi ve yalnızca operatöre ait ayrıntıları herkese açık yüzeyden uzak tutmalıdır.

Örnekler, üretim koordinatları değil

Rehberlerde gösterilen hostname, port ve yollar, özellikle herkese açık ürün tanımlayıcıları değillerse placeholder olmalıdır.

Uzaktan operasyonlar

Yönetim araçları; açık scope’lar, audit logging ve least-privilege erişim sağlayan kimliği doğrulanmış bir control plane arkasında bulunmalıdır. Entegrasyon modelini yayımlayın; bilinçli bir neden yoksa gerçek operatör endpoint’ini private tutun.