คู่มือ

ส่วนคู่มือคือเอกสารอ้างอิงหลักสำหรับการนำ CephalonEngine มาใช้ ทุกหน้าในนี้เขียนสำหรับคนที่กำลังจะ ship แอปจริง — ไม่ใช่แค่ตัวอย่าง ไม่ใช่เดโม แต่เป็นแอปที่จะต้องดูแลกันยาว ๆ

ถ้ามีเวลาแค่ห้านาที ข้ามไปที่ เริ่มต้นด่วน ถ้ามีบ่ายให้ทั้งบ่าย อ่าน แนวคิด แล้วเลือก เป้าหมายการ deploy

5 นาที

เริ่มต้นด่วน

ติดตั้ง Cephalon.Cli, รัน cephalon doctor, สเกฟโฟลด์ host, และดูมันบูต

เริ่มเลย 15 นาที

การติดตั้ง

สิ่งที่ต้องเตรียม, ที่มาของแพ็กเกจ, วิธีติดตั้ง CLI และวิธีตรวจสอบสภาพแวดล้อม

ตั้งค่า toolchain 30 นาที

แนวคิด

เอ็นจิน โมดูล capability manifest และวิธีที่การประกอบถูกตัดสินใจ

เข้าใจโมเดล 45 นาที

สถาปัตยกรรม

สถาปัตยกรรมแบบ layered, มิติของ app model, transport surface, และ runtime contract

อ่านสถาปัตยกรรม Day 2

การ Deploy

Windows Service, IIS, Azure App Service, Azure Container Apps, Kubernetes, Linux systemd, Docker

เลือกเป้าหมาย ทุกวัน

Operations

Observability, dependency health, นโยบาย runtime failure, benchmarking, และ runbook

Operate อย่างมั่นใจ

โครงสร้างของคู่มือ

เริ่มต้นด่วน — เส้นทางที่สั้นที่สุดจากศูนย์ถึง host ที่กำลังรัน
การติดตั้ง — สิ่งที่ต้องเตรียมในเครื่องและวิธีตั้ง package feed สำหรับ air-gapped
แนวคิด — โมเดลที่เล็กที่สุดที่ต้องมีในหัวก่อนอ่านส่วนอื่น
สถาปัตยกรรม — เลเยอร์ app model และ runtime contract ที่เอ็นจินรับประกัน
คอนฟิก — โครงสร้าง Engine:* และวิธีที่ options ส่งต่อไปยังโมดูล
การ Deploy — host ที่รองรับและโฟลเดอร์ deploy/ ที่ generate มาให้
Operations — observability, health, runbook, นโยบาย runtime failure
ความเข้ากันได้ — เวอร์ชัน .NET ที่รองรับ, deployment mode, trim/AOT/single-file

ข้อตกลงที่ใช้ในคู่มือ

โค้ดบล็อก สามารถรันได้ ถ้า snippet ต้องใช้แพ็กเกจหรือ directive เฉพาะ จะคง using ไว้
PowerShell เป็น shell หลักสำหรับตัวอย่างบน Windows ผู้ใช้ Linux/macOS เปลี่ยนเป็น bash ได้
Callout บ่งบอกความเสี่ยง (warning), การเปลี่ยนแปลงแบบ breaking (danger), พฤติกรรมที่ยืนยันแล้ว (success), และจุดสำคัญในการนำไปใช้ (key)
ป้ายระดับความพร้อม ปรากฏทุกครั้งที่กล่าวถึงแพ็กเกจ ถ้าต่ำกว่า M4 ให้ระวังว่าอาจมีการเพิ่มเติม — รายละเอียดอยู่ใน maturity audit