Genyleap/Docs
زیرساخت

معماری بدون افشای عملیات داخلی.

این بخش قراردادهای یکپارچه‌سازی، الگوهای استقرار و مرزهای اعتماد را مستند می‌کند. hostnameهای داخلی، چیدمان فایل‌سیستم، پورت‌های خصوصی و endpointهای عملیاتی عمداً حذف شده‌اند.

قرارداد مستندسازی

مستندات عمومی زیرساخت باید interfaceهای لازم برای یکپارچه‌سازی توسعه‌دهندگان را توضیح دهد و topology خصوصی و جزئیات مخصوص اپراتور را خارج از سطح عمومی نگه دارد.

مثال‌ها، نه مختصات محیط عملیاتی

hostnameها، پورت‌ها و مسیرهای نمایش‌داده‌شده در راهنماها باید placeholder باشند، مگر اینکه عمداً شناسهٔ عمومی محصول باشند.

عملیات راه‌دور

ابزارهای مدیریتی باید پشت یک control plane احرازشده با scopeهای صریح، audit logging و دسترسی حداقلی قرار بگیرند. مدل یکپارچه‌سازی را منتشر کنید؛ endpoint واقعی اپراتور را مگر با دلیل مشخص خصوصی نگه دارید.