مختبر 4SOمنصات قابلة للتكرار
Blueprints وProfiles تستبدل التجميع اليدوي.
PLATFORM ENGINEERING / PRIVATE CLOUD
4SO Platform Factoryبناء واستيراد وتشغيل منصات التطبيقات
يحوّل الخوادم الخام أو بيئات Kubernetes الحالية إلى منصات RKE2 وOKD أو Kubernetes مستوردة مع Catalog وFleet وRelease وPolicy وDisconnected Delivery وعمليات Day‑2.
RKE2OKDExisting KubernetesCatalog & Fleet
مكوّنات 4SO Platform Factory: من البنية الخام إلى المنصّات المستهدفة
- 1البنية الخامتدخل الخوادم الخام أو بيئات Kubernetes القائمة دورة حياة المنتج كأهداف.
- 2Management Planeمستقل على RKE2؛ لا ينقل Factory نفسه إلى التوزيعة المستهدفة.
- 4Forgejo وArgo CDيحمل Forgejo الحالة المطلوبة ويطبّقها Argo CD ويكتشف الانحراف.
- 5سجل zot OCIمستوى الحزم المرجعي، بما في ذلك التسليم المعزول عبر oc-mirror v2 وzot.
- 6حلقة المطابقةتُقارن الحالة المرصودة بالحالة المطلوبة؛ ولا يحلّ نجاح الواجهة محل دليل Runtime.
- 7RKE2 مُدارمنصّة تطبيقات قياسية يبنيها Factory ويُبقيها ضمن دورة الحياة.
- 8OKDبناء واعٍ بالتوزيعة عبر openshift-install وoc؛ مع الحفاظ على سلوك OKD الأصلي.
- 9Kubernetes قائماستيراد واكتشاف للقدرات دون تثبيت حِزم منصّة مكرّرة.
01PROBLEM & OUTCOME
مشكلة المنتج
Private Cloud ليست مجموع أدوات منفصلة.
Kubernetes وRegistry وIdentity وPolicy وMonitoring وUpgrade وRecovery تصبح عبئاً جديداً إذا جُمعت بلا دورة حياة منتج واحدة.
الحفاظ على السلوك الأصلي
RKE2 وOKD والـ imported clusters تتشارك حد المنتج بلا fake symmetry.
Day‑2 بعد التثبيت
Health وDrift وNode lifecycle وUpgrade ضمن Fleet operations.
Release قابل للتتبع
Desired state وArtifacts تحتفظ بالهوية وProvenance.
02CAPABILITY SNAPSHOT
القدرات
من قبول البنية التحتية إلى تسليم Workload.
Factory يملك دورة حياة المنصة بينما تحتفظ Target distributions بقدراتها الأصلية.
Target lifecycle
بناء منصة مُدارة أو إدخال Cluster موجود.
Profiles وBlueprints
قدرات Platform قابلة للإصدار.
Health وDrift
تشغيل عدة Targets ضمن نموذج منتج واحد.
Desired state
Forgejo يسجل Intent وArgo CD يصالحه.
Artifact plane وOffline delivery
zot يحافظ على هوية OCI canonical؛ وoc-mirror v2 + zot لاكتساب مُحكم.
Workload delivery
Application Release وEnvironment Binding على قدرات Platform المرصودة.
حماية البيانات
Policy وBackup Run وRestore وDrill للـ Targets المُدارة.
Node وUpgrade
Drain وReplace وMaintenance وUpgrade واعٍ بالتوزيعة.
03TOPOLOGY / DEPLOYMENT MODEL
نموذج النشر
Management Plane والتوزيعات المستهدفة تبقى منفصلة.
Factory لا ينقل نفسه إلى التوزيعة المستهدفة. تبقى Management Plane على RKE2 مستقلة بينما RKE2 وOKD وKubernetes المستوردة هويات Target مختلفة.
| Target | مسار الدخول | الملكية | الاستخدام |
|---|---|---|---|
| Managed RKE2 | Factory build | Platform lifecycle تحت Product Control Plane | منصة تطبيقات خاصة قياسية |
| Existing Kubernetes | Import + discovery | Existing runtime + 4SO lifecycle boundary | إدارة Clusters قائمة |
| Managed OKD | Distribution-aware build | OKD تملك CVO/MCO/OVN/OLM/SCC | OpenShift-compatible target |
| Existing OKD | Import + capability discovery | Native OKD + 4SO workflows | إدارة بلا تكرار stacks داخلية |
04ARCHITECTURE
المعمارية
Product authority وDesired State وReconciliation وRuntime طبقات مختلفة.
المعمارية تمنع Git أو Argo أو Target Cluster من أن تصبح مصدر حقيقة ثانياً للمنتج.
AUTHORITYPostgreSQL + Platform APIOrg/Project وCatalog وFleet وRelease وDurable Operations وAudit.
DESIRED STATEForgejoDesired configuration وrelease inputs بإصدارات.
RECONCILIATIONArgo CDتطبيق desired state واكتشاف drift.
RUNTIMERKE2 / OKD / existing Kubernetesسلوك Serving وقدرات distribution-native.
| الحد | الآلية | العقد التشغيلي |
|---|---|---|
| Artifact plane | zot | Canonical OCI registry للـ connected/disconnected delivery. |
| Managed OKD install | openshift-install / oc + scoped Redfish | Bootstrap bare metal وفق عقد التوزيعة. |
| Disconnected OKD | oc-mirror v2 → zot | Acquisition وinventory وmirror identity قبل التثبيت. |
| Dapr | Optional application runtime trait | لا يستبدل 4SO state/workflow/lock/secret authority. |
| المجال | Component / Mechanism | السلوك |
|---|---|---|
| Product authority | PostgreSQL + Platform API | تبقى Org/Project وCatalog وBlueprint وFleet وRelease وDurable Operation مرجع المنتج. |
| Desired state | Forgejo | تُحفظ Desired configuration وRelease inputs بإصدارات؛ Git لا تصبح Runtime Truth. |
| Reconciliation | Argo CD | تطبّق Desired State وتلاحظ Drift من دون إنشاء State Authority مستقلة. |
05LIFECYCLE
دورة الحياة
دورة حياة المنصة تمتد بعد إنشاء Cluster.
Target يبقى Resource مُداراً عبر capability discovery وreleases وتغيير العقد والترقية والاستعادة.
01Discoverprovider / cluster identity
02Planprofile · blueprint · capability
03Provision / Importcreate or enroll target
04Verifyobserved capability state
05Delivercatalog · release · reconcile
06Operatehealth · drift · maintenance
07Upgradedistribution-aware edges
08Recoverretry · rollback where valid · operator action
06PLATFORM PROFILES
ملفات المنصة
يحوّل Factory هوية التوزيعة والقدرات وعقد Delivery إلى Platform Profiles.
يجمع كل Profile بين Distribution Identity وCapability Discovery وPolicy وSupply Chain ودورة الحياة. ولا يتم إجبار OKD وRKE2 على تماثل اصطناعي.
RKE2 PlatformMANAGED
منصة Kubernetes خفيفة وSelf-contained.
- Managed lifecycle
- Catalog-driven add-ons
- Fleet operations
OKD PlatformDISTRIBUTION-AWARE
استخدام قدرات OKD الأصلية بدلاً من تكرارها.
- OVN / OLM / SCC awareness
- No duplicate platform stacks
- Managed or imported
Imported KubernetesADOPT
تبنّي Cluster قائم دون إعادة بنائه بلا حاجة.
- Identity discovery
- Capability assessment
- Lifecycle admission
Application PlatformWORKLOAD
طبقة Delivery للتطبيق فوق Target مُدار.
- Application Release
- Environment Binding
- Observed deployment evidence
DisconnectedSOVEREIGN
Acquire وMirror وInstall بلا اعتماد Runtime على الإنترنت.
- Controlled acquisition
- Local registry
- Verified inventory
FleetDAY-2
تشغيل Targets بعد إنشائها.
- Node lifecycle
- Upgrade / maintenance
- Diagnostics / recovery
07ACTION & WORKFLOW CONTRACT
الحالة والتدفقات
العمليات تملك حالات Plan وRecovery صريحة.
Risk وApproval وRetry policy وRuntime verification جزء من Operation model، لا Runbook جانبي.
01PlanDRAFT → PLANNING
02ApprovalAWAITING_APPROVAL
03QueueAPPROVED → QUEUED
04ExecuteRUNNING
05RetryRETRY_WAIT
06VerifyVERIFYING
07SuccessSUCCEEDED
08RecoveryROLLING_BACK / NEEDS_OPERATOR
APPROVAL GATE
Deploy عبر Plan وHuman Approval
الإجراء عالي الخطورة لا يصل إلى Execution بلا Approval مستقل.
REQUEST
↓
PLAN
↓
APPROVAL?
EXECUTE
↙ ↘
BLOCKED
VERIFY
RECONCILIATION LOOP
Desired State ↔ Observed Runtime
Forgejo Intent وArgo Reconciliation لا ينشئان Product Authority ثانية.
FORGEJO
→
ARGO CD
↓
OBSERVE
↑
TARGET
←
DRIFT
DISCONNECTED SUPPLY CHAIN
Acquire → Verify → Mirror → Admit
تُغلق Artifact Identity قبل تثبيت Target.
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
إدخال بلا إعادة بناء Cluster.
01Credential Scope02Identity Discovery03Capability Discovery04Classify05Register06Eligibility
Failure / RecoveryIdentity أو capability conflict يعود للمشغل.
Application Release
Release تربط Desired State بـ Observed Runtime.
01Artifact Admit02Policy03Desired State04Argo Reconcile05Runtime Observe06Evidence
Failure / RecoveryUnknown outcome يُقرأ قبل redispatch.
Disconnected OKD
Supply chain تُغلق قبل التثبيت.
01Acquire02Verify Digest03Inventory04oc-mirror v205zot Mirror06Target Admit
Failure / RecoveryArtifact مفقود أو مُستبدل يفشل مغلقاً.
Upgrade / Node Replace
Day‑2 يبقى distribution-aware.
01Admission02Drain / Stage03Mutation04Health Read-back05Capability Verify06Return to Fleet
Failure / RecoveryRollback فقط عندما يدعمه workflow الحقيقي.
ADDITIONAL OPERATIONAL FLOWS
تدفقات تشغيلية إضافية
Drift وData Protection تحتاجان أيضاً إلى مسارات Lifecycle مرئية.
Drift Reconciliation
إصلاح الفرق بين Desired وObserved من دون كسر ملكية Distribution الأصلية.
01Observe Target02Diff Desired / Observed03Classify Owner04Plan Reconcile05Argo / Native Apply06Capability Read-back07Close Drift
Failure / Recoveryإذا كان الفرق مملوكاً لـ subsystem أصلي في Target، لا يفرض Factory تناظراً مصطنعاً.
Backup / Restore Drill
Data Protection تستمر حتى Restore معزولة والتحقق من Workload.
01Protection Policy02Capability Check03Create Backup04Verify Artifact05Isolated Restore06Workload Verify07Record Evidence
Failure / RecoveryArtifact غير متحقق أو Restore بلا workload read-back لا تُقبل كـ Recovery evidence.
| الإجراء | شروط القبول | مالك التنفيذ | معيار النجاح | الفشل / الاستعادة |
|---|---|---|---|---|
| Create Platform | Profile قابل للحل + provider/target inputs | Factory operation executor | Observed target يطابق desired profile | PLAN_FAILED / retry / recovery |
| Import Cluster | Identity + access + discovery | Import workflow | Registered target + observed capabilities | Conflict يحتاج operator |
| Deploy Application | Immutable release + binding + policy | Forgejo/Argo + bounded executor | Observed deployment/service evidence | Unknown result لا يُعاد عمياناً |
| Replace Node | Exact node identity + safety admission | Leased/fenced operation | Replacement ready + old node removed | Lease loss → retry wait/operator |
| Upgrade | Compatibility + health + evidence gate | Distribution-aware workflow | Observed version/capability health | Rollback فقط حيث حقيقي |
| Disconnected Delivery | Source lock + digest + inventory | acquire/mirror workflow | Artifact identity يطابق inventory | Mismatch fails closed |
FLOW
حالات الفشل: PLAN_FAILED / FAILED / ROLLBACK_FAILED / NEEDS_OPERATOR / CANCELLED. لا تُعاد المحاولة إلا لفئات الفشل المسموح بها؛ ولا يُدّعى Rollback إلا حيث يدعمه الـ workflow.
08OPERATIONS CATALOG
سطح المشغل
Platform Engineering يصبح Surface منتج مضبوطاً.
المشغل يعمل مع Targets وFleet وReleases ودورة الحياة بدلاً من إجراءات مختلفة لكل Cluster.
Create / import platform
Managed RKE2 أو OKD أو Kubernetes موجود.
Capability discovery
قراءة Distribution identity والقدرات الأصلية.
Publish profile
قدرة Platform قابلة لإعادة الاستخدام.
Deploy application
ربط immutable release ببيئة.
Drain / replace
تغيير Membership بأمان.
Upgrade target
Admission وVerification واعيان بالتوزيعة.
Mirror artifacts
oc-mirror v2 وzot.
Backup / Restore
Policy وRun وDrill واستعادة على Target.
Repair target
مصالحة Observed State وإظهار الحالات التي تحتاج مشغلاً.
وحّد المنصة من دون مسح هوية التوزيعة.
4SO تملك دورة حياة المنتج؛ Target تحتفظ بالدلالات الأصلية التي تجعلها موثوقة.