وحدة التحكم على الويب
وحدة التحكم على الويب هي واجهة Arkvory في المتصفح. وهي جزء من الخادم، فلا تحتاج إلى تثبيتها بشكل منفصل. افتح /console/ على عنوان خادمك، مثل http://127.0.0.1:8080/console/ على الخادم نفسه، أو https://arkvory.example/console/ بعد إعداد HTTPS.
تستخدم وحدة التحكم HTTP API نفسها التي يستخدمها عميل سطر الأوامر وSDK. ويتحقق الخادم من كل طلب. وإخفاء زر يعني فقط أن حسابك أو مفتاحك لا يستطيع استخدام تلك العملية.
تخطيط الواجهة
يجمّع الشريط الجانبي الأقسام. وعلى الشاشة الضيقة يتحول الشريط الجانبي إلى زر الأقسام.
| المجموعة | الأقسام |
|---|---|
| المكتبة | المُخرَجات، الحزم، محفوظات الملفات، تفاصيل المُخرَج |
| النقل | الرفع، التنزيلات |
| الموارد | المستخدمون والوصول، المستودعات، وصول الخدمات، التحديثات، النسخ الاحتياطية، البدء، API و CLI |
يعرض الشريط العلوي عنوان القسم وزر رفع ملف وزر الملاحظات وعناصر التحكم في المظهر واللغة.
لكل قسم عنوانه الخاص، مثل #/catalog أو #/packages أو #/backups. وللمُخرَج المفتوح العنوان #/artifact/<repository>/<id>. يمكنك حفظ هذه العناوين في المفضلة وإرسالها إلى آخرين. ولا يحتوي العنوان أبدًا على كلمة مرور أو مفتاح أو نص بحث. وإذا فتحت رابطًا قبل تسجيل الدخول، تفتحه وحدة التحكم بعد أن تسجّل الدخول.
تظهر بعض الأقسام لبعض المستخدمين فقط:
| القسم | من يراه |
|---|---|
| المستخدمون والوصول | المسؤولون |
| المستودعات | كل من سجّل الدخول |
| وصول الخدمات | مفتاح الاسترداد، ومفاتيح المشغّل ذات الحقوق المفوَّضة |
| التحديثات | المسؤولون |
| النسخ الاحتياطية | المسؤولون ومفتاح الاسترداد |
تسجيل الدخول
تظهر بطاقة الاتصال بالمستودع أعلى الصفحة.
- أدخل اسم المستخدم وكلمة المرور.
- اختر تسجيل الدخول. تستمر الجلسة 12 ساعة.
- تختار وحدة التحكم أول المستودع يمكنك القراءة منه. وللعمل في مستودع آخر، اكتب اسمه أو اخترْه من القائمة.
للاتصال بمفتاح بدلًا من كلمة المرور، افتح الاتصال بمفتاح خدمة أو أتمتة والصق المفتاح ثم اختر اتصال. يبقى المفتاح في ذاكرة علامة تبويب المتصفح هذه، ولا تحفظه وحدة التحكم أبدًا.
يظهر التسجيل فقط عندما يسمح المسؤول بالتسجيل الذاتي. وينهي قطع الاتصال الاتصال.
بعد تسجيل الدخول بكلمة مرور، يمكنك استخدام تغيير كلمة مروري ورموز الوصول الشخصية. رمز الوصول الشخصي مفتاح لأدواتك الخاصة. راجع الحسابات والوصول.
المالك الأول
لا توجد حسابات في التثبيت الجديد. على Windows ينشئ برنامج التثبيت المالك. وفي التثبيتات الأخرى، أنشئ المالك في وحدة التحكم:
- افتح البدء ووسّع إنشاء المالك الأول.
- الصق مفتاح الاسترداد من
config/bootstrap-token.txtفي دليل التثبيت. - أدخل اسمًا وكلمة مرور لا تقل عن 12 حرفًا، ثم اختر إنشاء المالك.
- سجّل الدخول بالاسم وكلمة المرور الجديدين.
يعمل النموذج ما دامت لا توجد حسابات. والمالك مسؤول، ويحصل كذلك على إذن الكتابة في المستودع releases عبر المجموعة arkvory-owners.
المكتبة
المُخرَجات
يعرض المُخرَجات الملفات المنشورة في المستودع. ابحث بالاسم أو بقيمة من بيانات التعريف. استخدم التصفية حسب التسمية لعرض تسمية واحدة، ومطابقة بيانات التعريف لمطابقة دقيقة لمفتاح وقيمة. يعرض كل صف الاسم والحجم ووقت النشر والمراحل والتسميات. اختر تنزيل لتنزيل ملف، أو فتح لعرض تفاصيله. ويعرض تحميل المزيد الصفحة التالية.
الحزم
يعرض الحزم إصدارات UPack المسجَّلة. صفِّ حسب مجموعة UPack واسم الحزمة، واختر الفرز حسب والتجميع حسب، ثم اختر تطبيق. يوضح عمود المراحل أين رُقّي كل إصدار. راجع الحزم.
محفوظات الملفات
يمكن أن يشير مسار ملف، مثل builds/game/1.4/GameSetup.exe، إلى محتوى جديد مرات كثيرة. وكل تغيير مراجعة جديدة. في محفوظات الملفات أدخل مسارًا واختر تحميل المحفوظات. سترى كل مراجعة مع كاتبها ووقتها. ويمكنك فتح أي مراجعة لتنزيل محتواها الأصلي. تنشئ استعادة مراجعة قديمة مراجعة جديدة ولا تحذف شيئًا. راجع الملفات والمسارات.
تفاصيل المُخرَج
يعرض تفاصيل المُخرَج مُخرَجًا واحدًا:
- الملخص: الحجم وتاريخ الرفع وSHA-256 مع زر نسخ.
- الخصائص: التسميات والتجميعات وبيانات تعريف البناء. اختر حفظ التغييرات لحفظها. ولا يتغير الملف نفسه.
- الإجراءات: تنزيل؛ وينشئ رابط التنزيل رابطًا يعمل ساعة واحدة دون مفتاح؛ ويفهرس تسجيل UPack أرشيف UPack.
- رابط الملف: يجعل تعيين الملف هذا المُخرَج المحتوى الحالي لمسار ملف.
- الترقية: يعلّم إضافة مرحلة المُخرَج بمرحلة، مثل
qaأوrelease. وينشره ترقية في مستودع آخر. راجع الترقية. - ملفات البيان والملفات الإضافية: يربط إضافة مرفق ملف بيان أو SBOM أو توقيعًا أو تقريرًا أو ملفًا آخر بنسخة البناء هذه. ويعرض محفوظات المرفقات المجموعات السابقة.
- حذف المُخرَج: يعرض التحقق من التبعيات ما لا يزال يستخدم المُخرَج. وللحذف، الصق معرّف المُخرَج واختر حذف هذا المُخرَج.
النقل
الرفع
في الرفع اختر ملفًا ثم اختر رفع / استئناف. تحسب وحدة التحكم أولًا SHA-256 للملف، ثم ترسله على أجزاء. ويوقف إيقاف مؤقت النقل ويُبقي الأجزاء المرفوعة.
للمتابعة لاحقًا، احتفظ بمعرّف الرفع. افتح استئناف عملية رفع واختر الملف نفسه وأدخل معرّف الرفع. ويحذّرك المتصفح قبل أن تغادر الصفحة أثناء الرفع. راجع النقل.
التنزيلات
التنزيلات قائمة انتظار بالملفات التي تنزّلها من وحدة التحكم. وتتحقق وحدة التحكم من SHA-256 لكل ملف قبل أن تحفظ الملف النهائي.
- يضبط إعدادات قائمة الانتظار كلًّا من التنزيلات المتوازية (من 1 إلى 8) وفاصل البدء، ms وحد الانتظار في القائمة، بالثواني.
- تتحكم إيقاف الكل مؤقتًا واستئناف قائمة الانتظار وإلغاء المنتظرة وإلغاء الكل وإزالة المكتملة في القائمة كلها.
- بعد إعادة تحميل الصفحة، سجّل الدخول مرة أخرى واختر استعادة قائمة الانتظار. ثم استأنف كل ملف واختر مكان حفظه.
تحتاج التنزيلات الكبيرة إلى Chrome أو Edge على عنوان آمن (HTTPS أو الحاسوب المحلي). وتبقى البيانات المؤقتة في التخزين الخاص بالمتصفح.
الموارد
المستخدمون والوصول
يدير المسؤولون الأشخاص هنا. يعرض الحسابات الحسابات، ويعرض المجموعات والأذونات المجموعات. استخدم إنشاء مستخدم وإعادة تعيين كلمة المرور وإنشاء مجموعة وإدارة أعضاء المجموعات. وفي إدارة الوصول إلى المستودعات امنح مجموعة إذن قراءة أو قراءة وكتابة على مستودع بالاسم. وليس للمستودع خطوة إنشاء مستقلة: فهو يوجد بمجرد أن يسمّيه منح وصول أو سياسة خدمة.
المستودعات
يعرض المستودعات المستودعات التي يمكنك رؤيتها، مع أذوناتك. لكل بطاقة فتح الملفات والتخزين والتنظيف (حصة التخزين والتنظيف التلقائي والتنظيف الفعلي)، وإدارة الوصول للمسؤولين. ويعرض المستودع المنسوخ بمرآة الشارة مرآة. راجع المستودعات والتخزين.
وصول الخدمات
هنا تنشئ حسابات للأدوات وأنظمة CI. ولرؤية هذا القسم، اتصل بمفتاح الاسترداد أو بمفتاح مشغّل. اختر إنشاء حساب خدمة ثم اضبط أذونات المستودعات. ويملأ إعداد مسبق للقراءة وإعداد مسبق للنشر مجموعات الأذونات المعتادة.
لإصدار مفتاح، افتح مفاتيح الخدمة واختر إصدار مفتاح. يظهر السر مرة واحدة فقط. انسخه، وأكّد لقد حفظت السر، ثم اختر تنشيط المفتاح. وينتهي المفتاح الذي لم يُنشَّط بعد 15 دقيقة. استخدم تدوير لاستبدال مفتاح وإبطال لإيقافه. ويتيح الإدارة المفوَّضة للمالك أن يمنح مشغّلًا حقوق إدارة محدودة.
التحديثات
يعرض التحديثات قيمتي الإصدار المثبَّت وأحدث إصدار مستقر. اختر التحقق الآن أو تثبيت التحديث. وفي التحديثات التلقائية فعّل تثبيت الإصدارات المستقرة المتوافقة تلقائيًا واختر ساعة الصيانة (UTC). راجع التحديثات.
النسخ الاحتياطية
يعرض النسخ الاحتياطية ما إذا كانت النسخ الاحتياطية سليمة، وأحدث نسخة احتياطية، والتشغيل التالي، ووكيل النسخ الاحتياطي ومخزن النسخ الاحتياطية. اختر إنشاء نسخة احتياطية الآن لبدء نسخة احتياطية. ويسرد نقاط الاستعادة نقاط الاستعادة؛ ويمكنك التحقق من كل بايت في نقطة أو تثبيتها. ويضبط الجدول والاحتفاظ الوقت اليومي والمنطقة الزمنية وعدد النقاط التي يُحتفظ بها. والاستعادة أمر يُنفَّذ على الخادم. راجع النسخ الاحتياطية.
البدء ومرجع API
يعرض البدء الخطوات الأولى لخادم جديد. ويسرد API و CLI أوامر نموذجية. ويعرض تحميل عمليات API المسموح بها عمليات API التي يستطيع حسابك أو مفتاحك الحالي استدعاءها.
الملاحظات
بعد تسجيل الدخول، يرسل الملاحظات رسالة إلى ProAnimaStudio عبر المركز (hub). يمكنك إضافة ما يصل إلى 6 صور وعنوان بريد إلكتروني للرد. ويمكن للمسؤولين إرفاق سجل الخادم. اختر عرض ما سيُرفق لترى بالضبط ما سيُرسل.
المظهر واللغة
يتيح المظهر ثلاثة خيارات: حسب النظام وفاتح وداكن. ويسرد اللغة كل لغات وحدة التحكم باسمها الخاص: English، Русский، Español، Français، Deutsch، Português، 中文، 日本語، 한국어، हिन्दी، العربية. تتبدل الصفحة فورًا دون إعادة تحميل ودون فقدان ما كتبته؛ وتُقرأ العربية من اليمين إلى اليسار. وفي الزيارة الأولى تتبع وحدة التحكم لغات المتصفح وتعود إلى الإنجليزية إذا لم تجد لغة مطابقة. ويفتح التوثيق في API و CLI هذا التوثيق بلغة وحدة التحكم. ولا يحفظ المتصفح سوى المظهر واللغة، ولا شيء عن حسابك أو مستودعاتك.