ثبّت Stella Ops

1 · قائمة التحقق قبل البدء

2 · التثبيت باستخدام Docker Compose

1. 1

   فك ضغط الحزمة

   فك ضغط أرشيف الإصدار وادخل المجلد. يسجّل release-manifest.yaml النسخة المعتمدة — وإن خالفت اسم الملف فاعتمد البيان.

2. 2

   تحقق قبل التشغيل

   افحص توقيع البيان بواسطة Cosign?أداة توقيع الحاويات من مشروع Sigstore لتوقيع والتحقق من صور الحاويات والمخرجات، ثم شغّل tools/verify-bundle.py للتحقق من sha256 كل ملف وdigest كل صورة. تعيد سكربتات التثبيت فحص مجاميع التحقق في كل تشغيل وتتوقف عند أي اختلاف.

3. 3

   شغّل المثبّت

   يتحقق ./install.sh (أو .\install.ps1) من الحزمة، ويولّد كل الأسرار والشهادات، ويسحب الصور، ويشغّل المكدس وينتظر استقراره. يسحب التشغيل الأول عدة غيغابايتات وينفّذ الترحيلات — من عشر إلى عشرين دقيقة أمر طبيعي.

4. 4

   سجّل الدخول

   افتح https://127.0.0.1:8443/ وسجّل الدخول باسم admin بكلمة المرور التي يطبعها المثبّت مرة واحدة — لا توجد كلمة مرور افتراضية. تقدّم البوابة شهادة موقعة ذاتيًا فيحذّر المتصفح مرة واحدة. غيّر كلمة المرور بعد أول دخول.

$ curl -fsSLO https://get.stella-ops.org/releases/v1.0.0-RC1/stellaops-bundle-v1.0.0-RC1.tar.gz
$ curl -fsSL https://get.stella-ops.org/releases/v1.0.0-RC1/SHA256SUMS \
    | sha256sum --check --ignore-missing
$ tar xzf stellaops-bundle-v1.0.0-RC1.tar.gz && cd stellaops-bundle-v1.0.0-RC1
$ cosign verify-blob --insecure-ignore-tlog=true --key release-signing.pub \
    --signature release-manifest.yaml.sig release-manifest.yaml
$ python tools/verify-bundle.py --require-signature --require-digests
$ ./install.sh
  Console    https://127.0.0.1:8443/
  Username   admin
  Password   <generated, shown once>

تفضّل تنفيذ كل خطوة بنفسك؟ انسخ .env.example إلى .env واستبدل كل قيمة CHANGE_ME وGENERATED_ — يرفض المكدس الإقلاع عند غياب سر بدل التراجع إلى قيمة افتراضية. ثم docker compose pull وdocker compose up -d وdocker compose ps حتى تُبلغ كل خدمة الحالة healthy.

3 · تثبيت دون اتصال (عزل)

لا يجري المكدس أي اتصالات شبكية بطرف ثالث عند الإقلاع — كل ما يحتاجه موجود في الصور وفي مجلد config/ داخل الحزمة. للتثبيت دون اتصال بالإنترنت:

1. 1

   انسخ الصور مرآةً

   على مضيف متصل، انسخ digests الصور المسجلة في release-manifest.yaml إلى سجلك الداخلي، أو صدّرها عبر docker save. يثبّت docker-compose.pinned.yml كل صورة بالـ digest فيبقى النشر قابلًا للتكرار.

2. 2

   النقل

   انقل الحزمة المتحقق منها والصور المنسوخة إلى موقعك المعزول عبر وسيط معتمد (USB، بريد سريع، صندوق تسليم).

3. 3

   ثبّت من سجلك

   اضبط STELLA_REGISTRY في .env على سجلك الداخلي وشغّل ./install.sh --offline. تصل بيانات التنبيهات وVEX منفصلة ضمن Offline Kit — استوردها بالأمر stella offline import --bundle <kit>.tar.zst أو ضعها في airgap-import/.

4 · حدود المستوى المجاني

يسمح الترخيص بحرية بالتقييم والتطوير والاختبار، وبالاستخدام الإنتاجي ضمن 3 بيئات و100 فحصًا لملخصات جديدة في أي فترة 24 ساعة متجددة. البناء نفسه مستخدم في كل المستويات — لا شيء محجوب خلف ملف تنفيذي مختلف.

بعد هذه الحدود يلزم ترخيص تجاري — انظر الأسعار. الحدود شروط في الترخيص لا قيود تشغيلية في البرنامج.

5 · اربط CI

يمكن لمسارك إنتاج أدلة قبل ربط أي هدف نشر. ينشئ stella ci init سير عمل لـ GitHub أوGitLab أوGitea؛ ثم يفحص كل بناء الصورة ويوقّع إفادة بناء (DSSE?Dead Simple Signing Envelope - معيار بسيط ومرن لتوقيع البيانات بتوقيعات تشفيرية). لا يلزم موصل نشر.

$ stella ci init --platform github --mode scan-attest
✓ Created: .github/workflows/stellaops-gate.yml

✓ 1 template(s) initialized successfully

Next steps:
  1. Review the generated workflow files
  2. Add required secrets (STELLAOPS_TOKEN, etc.)
  3. Commit and push to trigger the workflow

6 · العناصر والتحقق

مصادر العناصر اليوم وكيف تتحقق منها قبل الثقة بها.

تحقق قبل التشغيل الأول: استورد مفاتيح Cosign?أداة توقيع الحاويات من مشروع Sigstore لتوقيع والتحقق من صور الحاويات والمخرجات/PGP العامة وافحص توقيع كل عنصر وملف تعريفه — متصلًا أو معزولًا. مفاتيح التحقق →

لمراجعة المشتريات، استخدم الترخيص و الأسعار كمراجع رسمية للاستحقاق والترخيص.

7 · أول ترقية موثقة لديك

لا يحتوي التثبيت الجديد بعد على أي بيئات أو إصدارات. تنقل هذه الخطوات الأربع صورة حاوية واحدة من التسجيل إلى الترقية، وتنتهي بتصدير القرار كبطاقة أدلة موقّعة واحدة.

1. 1

   أنشئ بيئاتك

   حدّد مسار الترقية — dev وstaging وproduction — وأرفق سياسة بكل بيئة. عبر الكونسول فقط اليوم: لا يوجد بعد أمر CLI لهذه الخطوة.

2. 2

   سجّل إصدارًا بالبصمة

   أضف صورة حاوية عبر بصمة محتواها. تفحصها Stella وتولّد SBOM?قائمة مواد البرمجيات - قائمة كاملة بجميع الحزم والتبعيات في برنامجك. عبر الكونسول فقط اليوم: لا يوجد بعد أمر CLI لهذه الخطوة.

3. 3

   أرسل الترقية

   اطلب من Stella نقل الإصدار إلى البيئة التالية. يقتصر الأمر على إرسال القرار — أما نتيجة البوابة والموافقات المتبقية فتظهر في الكونسول.

4. 4

   صدّر بطاقة الأدلة

   احزم حزمة أدلة مختومة في ملف موقّع واحد. بدون --output يُكتب الملف باسم <pack-id>.evidence-card.json.

$ stella release promote rel-7829726 --to staging
$ stella evidence card export evp-2026-01-14-abc123 --output evidence-card.json

كلا الوسيطين معرّفان مبهمان يولّدهما المنتج: معرّف الإصدار على هيئة rel-7829726، ومعرّف حزمة الأدلة على هيئة evp-2026-01-14-abc123. لن يُحَل اسم الإصدار أو رقم نسخته. خذ كليهما من الكونسول — لا يوجد بعد أمر CLI يسرد الإصدارات.