4SO Labپلتفرم‌ها باید تکرارپذیر باشند
Blueprint، Template و Policy جای ساخت دستی و تنظیمات وابسته به افراد را می‌گیرند.
PLATFORM ENGINEERING / PRIVATE CLOUD
4SO Platform FactoryBuild, Import and Operate Application Platforms
Platform Factory سرورهای خام یا محیط‌های Kubernetes موجود را به پلتفرم‌های استاندارد و قابل‌اداره تبدیل می‌کند؛ Catalog، Fleet، Release، Policy، Delivery و بازیابی زیر یک Product Control Plane قرار می‌گیرند.
RKE2OKDExisting KubernetesCatalog & Fleet
اجزای 4SO Platform Factory: از زیرساخت خام تا پلتفرم‌های هدف
- ۱زیرساخت خامسرورهای خام یا Kubernetes موجود به‌عنوان هدف وارد چرخه‌ی عمر محصول می‌شوند.
- ۲Management Planeمستقل روی RKE2؛ Factory خودش را به پلتفرم هدف منتقل نمی‌کند.
- ۴Forgejo و Argo CDForgejo وضعیت مطلوب را نگه می‌دارد و Argo CD آن را اعمال و Drift را تشخیص می‌دهد.
- ۵zot OCI Registryمخزن کانونی Artifact؛ تحویل Disconnected با oc-mirror v2 و zot.
- ۶حلقه‌ی Reconciliationوضعیت مشاهده‌شده با وضعیت مطلوب مقایسه می‌شود؛ موفقیت UI جای شواهد Runtime را نمی‌گیرد.
- ۷RKE2 مدیریت‌شدهپلتفرم کاربردی استاندارد که Factory آن را می‌سازد و در چرخه‌ی عمر نگه می‌دارد.
- ۸OKDساخت آگاه از توزیع با openshift-install و oc؛ رفتار بومی OKD حفظ می‌شود.
- ۹Kubernetes موجودImport و Capability Discovery بدون نصب پشته‌ی تکراری پلتفرم.
۰۱PROBLEM & OUTCOME
مسئله‌ی محصول
Private Cloud از کنار هم‌چیدن ابزارها ساخته نمی‌شود.
Kubernetes، Registry، Identity، Monitoring، Backup، Policy، Upgrade و بازیابی اگر جداگانه اداره شوند، پیچیدگی از Developer به تیم Platform منتقل می‌شود. Factory این اجزا را پشت یک مدل محصولی واحد قرار می‌دهد.
Distribution یک Capability است
RKE2، OKD و Existing Kubernetes پشت یک مدل Target قرار می‌گیرند، بدون پاک‌کردن تفاوت‌های واقعی.
Fleet بعد از نصب زنده می‌ماند
Health، Drift، Maintenance، Upgrade، چرخه‌ی عمر نود و بازیابی از همان مدل محصول اداره می‌شوند.
Release باید قابل ردیابی باشد
Catalog، Artifact، Registry و وضعیت مطلوب با Identity و Provenance مشخص وارد محیط اجرا می‌شوند.
۰۲CAPABILITY SNAPSHOT
نمای قابلیت‌ها
از زیرساخت خام تا پلتفرم کاربردی.
Factory فقط یک نصب‌کننده نیست؛ چرخه‌ی کامل Platform Engineering را از ایجاد Target تا تحویل Workload و Day-2 Operations پوشش می‌دهد.
ساخت یا Import پلتفرم
راه‌اندازی Target مدیریت‌شده یا اتصال Kubernetes موجود به مرجع محصول.
Catalog و Blueprint
تعریف Platform Capability، Template و نسخه‌ی قابل‌استفاده برای تیم‌ها.
Fleet Operations
Health، Drift، Maintenance و چرخه‌ی عمر برای مجموعه‌ای از Targetها.
وضعیت مطلوب و Reconciliation
Forgejo تاریخچه‌ی وضعیت مطلوب را نگه می‌دارد و Argo CD آن را Reconcile می‌کند؛ هر دو زیر مرجع واحد محصول.
Registry و تحویل Disconnected
Artifact، Image و Provenance در مرزهای مشخص؛ Acquisition و Delivery برای محیط‌های متصل و مستقل از اینترنت.
Workload Delivery
Application Release و Environment Binding روی قابلیت‌های مشاهده‌شده‌ی Platform.
Backup و بازیابی
Policy، Backup Run، Restore و Drill برای Targetهای مدیریت‌شده.
Node و Upgrade
Drain، Replace، Maintenance و Upgrade آگاه از Distribution.
۰۳TARGET / DISTRIBUTION MODEL
مدل Target
یک Factory، چند نوع Platform Target.
Management Plane ثابت می‌ماند؛ تفاوت Distribution در Target boundary حل می‌شود تا هر محیط فقط Stack لازم خودش را دریافت کند.
| Target | روش ورود | Ownership | کاربرد |
|---|---|---|---|
| Managed RKE2 | ساخت توسط Factory | چرخه‌ی عمر پلتفرم زیر Product Control Plane | Private Cloud استاندارد و self-contained |
| Existing Kubernetes | Import و Discovery | محیط اجرا موجود + مرز چرخه‌ی عمر محصول | آوردن کلاسترهای موجود زیر مدیریت |
| Managed OKD | ساخت آگاه از Distribution | OKD مالک قابلیت‌های Native خودش | OpenShift-compatible platform روی زیرساخت مدیریت‌شده |
| Existing OKD | Import و Capability Discovery | Native OKD + فرایندهای محصول 4SO | مدیریت بدون تکرار پشته‌های داخلی OKD |
۰۴ARCHITECTURE
معماری
مرجع محصول، وضعیت مطلوب و محیط اجرا هرکدام یک نقش جدا دارند.
Factory مرزها را ادغام نمی‌کند: مرجع محصول تصمیم و چرخه‌ی عمر را نگه می‌دارد، تاریخچه‌ی وضعیت مطلوب ثبت می‌شود، Reconciler آن را اعمال می‌کند و محیط اجرای Target نتیجه را نشان می‌دهد.
EXPERIENCEOperator Console / API / MCPفرایندهای انسانی و اتوماسیون روی مرجع محصول مشترک.
↓
AUTHORITYPlatform Control PlaneOrganization، Project، Catalog، Template، Target و Durable Operation.
↓
DELIVERYFleet Agent / Reconciliation / Registryانتقال Intent و Artifact به Target با مرزهای مشخص.
↓
TARGETمحیط اجرای RKE2 / OKD / KubernetesPlatform و Workload واقعی؛ Health و Drift از همین محیط اجرا خوانده می‌شوند.
| لایه | Component / Authority | مسئولیت | مرز |
|---|---|---|---|
| Product Authority | PostgreSQL + Platform API | Org/Project، Catalog، Blueprint، Fleet، Release، Durable Operations و Audit | مرجع محصول و lifecycle؛ نه runtime target |
| Desired State | Forgejo | Desired configuration و release inputs نسخه‌دار | Desired state است؛ runtime truth نیست |
| Reconciliation | Argo CD | اعمال Desired State و تشخیص Drift | Reconciler است؛ Source of Truth مستقل نمی‌سازد |
| Artifact Plane | zot OCI Registry | Image/Artifact delivery، mirror و disconnected inventory | Artifact identity و provenance باید حفظ شود |
| Management Plane | Self-contained RKE2 | Control services، Identity، PostgreSQL، Git/Registry و Operator APIs | با Target distribution یکی نمی‌شود |
| Targets | RKE2 · OKD · Existing Kubernetes | Capability Discovery، workload runtime و day-2 lifecycle | Distribution-native capabilities حفظ می‌شوند؛ stack تکراری تحمیل نمی‌شود |
TECH
Target & Delivery Contract. Factory یک abstraction مبهم روی Kubernetes نمی‌سازد؛ authority محصول، desired state، reconciliation، artifact plane و distribution-native runtime مرزهای مستقل دارند.
| حوزه | Component / Mechanism | رفتار |
|---|---|---|
| Managed OKD | openshift-install / oc + Redfish Boot Media | Provisioning bare metal و Cluster lifecycle از Distribution contract خود OKD عبور می‌کند. |
| Disconnected OKD | oc-mirror v2 → zot | Acquisition، inventory و mirror قبل از install بسته و قابل‌بررسی می‌شوند. |
| Application runtime trait | Optional Dapr sidecar capability | Dapr می‌تواند برای service invocation/pubsub/bindings/resiliency استفاده شود، اما Product state/workflow/secret authority را تصاحب نمی‌کند. |
۰۵LIFECYCLE
چرخه‌ی عمر
چرخه‌ی عمر پلتفرم از Discover تا Recover ادامه دارد.
Target فقط ساخته نمی‌شود؛ کشف، برنامه‌ریزی، ساخت یا Import، بررسی قابلیت‌ها، تحویل، بهره‌برداری، ارتقا و بازیابی همه بخشی از چرخه‌ی عمر آن هستند.
۰۱کشفDiscover
۰۲برنامه‌ریزیPlan
۰۳ساخت یا ImportProvision / Import
۰۴بررسی قابلیت‌هاVerify
۰۵تحویلDeliver
۰۶بهره‌برداریOperate
۰۷ارتقاUpgrade
۰۸بازیابیRecover
۰۶PLATFORM PROFILES
پروفایل پلتفرم
Factory فقط Cluster نمی‌سازد؛ Distribution، Capability و Delivery Contract را به Platform Profile تبدیل می‌کند.
هر Profile ترکیبی از Distribution Identity، Capability Discovery، Policy، Supply Chain و چرخه‌ی عمر است؛ OKD و RKE2 عمداً به یک implementation مصنوعی تبدیل نمی‌شوند.
RKE2 PlatformMANAGED
پلتفرم Kubernetes سبک و self-contained.
- چرخه‌ی عمر مدیریت‌شده
- Catalog-driven add-ons
- Fleet operations
OKD PlatformDISTRIBUTION-AWARE
استفاده از قابلیت‌های Native خود OKD.
- OVN / OLM / SCC awareness
- No duplicate platform stacks
- Managed or imported
Imported KubernetesADOPT
Cluster موجود بدون بازسازی بی‌دلیل.
- Identity discovery
- Capability assessment
- پذیرش چرخه‌ی عمر
پلتفرم کاربردیWORKLOAD
لایه‌ی تحویل Application روی Target.
- Application Release
- Environment Binding
- شواهد استقرار مشاهده‌شده
DisconnectedSOVEREIGN
Acquire، Mirror و Install بدون وابستگی محیط اجرا به اینترنت.
- Controlled acquisition
- Local registry
- Verified inventory
FleetDAY-2
مدیریت مجموعه‌ی Targetها پس از ساخت.
- چرخه‌ی عمر نود
- Upgrade / maintenance
- Diagnostics / بازیابی
۰۷ACTION & WORKFLOW CONTRACT
فلو و Operation State
Operation از Plan تا Verification و Rollback یک state machine صریح دارد.
Operation Class، risk، sealed request payload، approval، retry policy و observed verification بخشی از مدل محصول‌اند؛ تغییر پرریسک از مسیر کوتاه و پنهان اجرا نمی‌شود.
۰۱PlanDRAFT → PLANNING
۰۲ApprovalAWAITING_APPROVAL
۰۳QueueAPPROVED → QUEUED
۰۴ExecuteRUNNING
۰۵RetryRETRY_WAIT
۰۶VerifyVERIFYING
۰۷SuccessSUCCEEDED
۰۸RecoveryROLLING_BACK / NEEDS_OPERATOR
APPROVAL GATE
Deploy با Plan و Human Gate
Action پرریسک تا Approval مستقل به Execution نمی‌رسد.
REQUEST
↓
PLAN
↓
APPROVAL?
EXECUTE
↙ ↘
BLOCKED
VERIFY
RECONCILIATION LOOP
Desired State ↔ Observed Runtime
Forgejo Intent و Argo Reconcile بدون ساخت Authority دوم.
FORGEJO
→
ARGO CD
↓
OBSERVE
↑
TARGET
←
DRIFT
DISCONNECTED SUPPLY CHAIN
Acquire → Verify → Mirror → Admit
Artifact identity قبل از نصب sealed می‌شود.
ACQUIRE
↓
DIGEST VERIFY
↓
OC-MIRROR V2
ZOT
TARGET ADMIT
Create Managed Platform
از زیرساخت خام تا Target ثبت‌شده و مشاهده‌شده.
01Provider Input02Plan03Preflight04Provision05Distribution Bootstrap06Runtime Verify
Failure / RecoveryPLAN_FAILED قبل از mutation می‌ماند؛ side effect نامعلوم نیازمند reconcile است.
Import Existing Cluster
Import به‌معنی بازسازی Cluster نیست.
01Credential Scope02Identity Discovery03Capability Discovery04Classify05Register06Eligibility
Failure / RecoveryCapability conflict یا identity mismatch به‌جای overwrite به Operator برمی‌گردد.
Application Release
Release به EnvironmentBinding و observed runtime متصل است.
01Artifact Admit02Policy03Desired State04Argo Reconcile05Runtime Observe06Release Evidence
Failure / RecoveryUnknown outcome خودکار redispatch نمی‌شود؛ ابتدا state واقعی خوانده می‌شود.
Disconnected OKD
Supply chain قبل از نصب بسته و قابل‌ردیابی می‌شود.
01Acquire02Verify Digest03Inventory04oc-mirror v205zot Mirror06Target Admit
Failure / RecoveryArtifact جایگزین یا download ناقص fail-closed است.
Upgrade / Node Replace
Day-2 روی Distribution semantics واقعی اجرا می‌شود.
01Admission02Drain / Stage03Mutation04Health Read-back05Capability Verify06Return to Fleet
Failure / RecoveryRollback فقط وقتی ادعا می‌شود که workflow و distribution آن را واقعاً پشتیبانی کنند.
ADDITIONAL OPERATIONAL FLOWS
فلوهای عملیاتی تکمیلی
Drift و Data Protection نیز باید مانند Provision مسیر قابل‌مشاهده داشته باشند.
Drift Reconciliation
تفاوت Desired و Observed بدون overwrite کردن مالکیت Native هر Distribution اصلاح می‌شود.
01Observe Target02Diff Desired / Observed03Classify Owner04Plan Reconcile05Argo / Native Apply06Capability Read-back07Close Drift
Failure / Recoveryاگر اختلاف متعلق به subsystem بومی Target باشد، Factory آن را به‌زور بازنویسی نمی‌کند و مسیر Operator/Native ownership حفظ می‌شود.
Backup / Restore Drill
Data Protection تا Restore ایزوله و Workload verification ادامه پیدا می‌کند.
01Protection Policy02Capability Check03Create Backup04Verify Artifact05Isolated Restore06Workload Verify07Record Evidence
Failure / RecoveryBackup بدون Artifact verification یا Restore بدون workload-level read-back به‌عنوان Recovery evidence پذیرفته نمی‌شود.
| Action / Flow | Admission / Preconditions | Execution / Lock | Success Criterion | Failure / Recovery |
|---|---|---|---|---|
| Create Platform | Distribution/Profile، provider/target inputs و Blueprint resolution باید قابل برنامه‌ریزی باشند | Request payload sealed؛ عملیات mutating/destructive با exact-target fence اجرا می‌شود | Target به desired profile همگرا و observed health از runtime خوانده شود | PLAN_FAILED قبل از اجرا؛ failure بعد از side effect وارد retry/rollback/operator path می‌شود |
| Import Existing Cluster | Identity discovery، access و capability inventory معتبر | Cluster بازسازی نمی‌شود؛ discovery/classification به Product authority متصل می‌شود | Target registered و capabilities مشاهده‌شده و lifecycle eligibility روشن | Import ناقص enrolled/ready تلقی نمی‌شود؛ conflict نیازمند operator resolution است |
| Application Deploy | Immutable ApplicationRelease + EnvironmentBinding + exact artifact admissible | approval-gated deploy با target RBAC و bounded executor | Deployment/Service observed evidence با binding/release مورد انتظار match کند | Unknown outcome خودکار redispatch نمی‌شود؛ recovery read-only ابتدا نتیجه واقعی را پیدا می‌کند |
| Node Replace | Target/node identity، failure-domain و safety admission | Lease/fence از اجرای هم‌زمان یا stale worker جلوگیری می‌کند | عضو جدید observed-ready و عضو قدیمی safely removed/drained | Lease loss یا conflict می‌تواند RETRY_WAIT یا NEEDS_OPERATOR ایجاد کند |
| Platform Upgrade | Compatibility/admission، backup/evidence و health اولیه | مرحله‌ای و distribution-aware؛ RKE2 و OKD semantics یکی فرض نمی‌شوند | Observed version/health و capability state پس از هر مرحله | Rollback فقط وقتی workflow underlying آن را پشتیبانی کند؛ در غیر این صورت recovery صریح |
| Disconnected Delivery | Source lock، inventory، digest و mirror inputs قبل از target mutation | acquire → verify → transfer/mirror → target admission | Artifact identity در zot/target mirror با inventory sealed برابر باشد | Mismatch/absence fail-closed؛ دانلود یا artifact جایگزین بی‌صدا مجاز نیست |
FLOW
Stateهای شکست شامل PLAN_FAILED / FAILED / ROLLBACK_FAILED / NEEDS_OPERATOR / CANCELLED هستند. Retry فقط برای failure classهای مجاز انجام می‌شود؛ rollback یک ادعای عمومی نیست و باید توسط همان workflow پشتیبانی شود.
۰۸OPERATIONS CATALOG
کاتالوگ عملیات
عملیات Platform در سطح Intent، نه دستورهای پراکنده.
اپراتور با Target، Blueprint، Release و چرخه‌ی عمر کار می‌کند؛ جزئیات ابزار زیرین پشت فرایند محصول باقی می‌مانند.
از Cluster Management عبور کنید؛ Platform Engineering را محصول کنید.
4SO Platform Factory برای ساخت پلتفرم‌هایی است که بعد از تحویل هم استاندارد، قابل‌مشاهده و قابل‌اداره می‌مانند.