نظرة عامة على الـ package registry¶
الـ package registry في ليڤانت غيت (LevantGit) يخزّن مخرجات مشروعك الجاهزة — مكتبة npm، أو package بلغة Python، أو container image، أو ملفًا ثنائيًّا عاديًّا — في الحساب نفسه الذي يستضيف كودك، وتسحبها منه بأدواتك المعتادة. تشرح هذه الصفحة مديرات الـ packages المدعومة، ولمن تتبع الـ package، ومَن يقرأها أو يرفعها، وكيف تعرضها وتنزّلها وتحذفها من الواجهة.
ملاحظة
الـ package registry متاح إن كان مفعّلاً على levantgit.com؛ تظهر تبويبة Packages في ملفك الشخصي أو في الـ repository عندها. كل ما يلي ينطبق فقط إن كانت التبويبة ظاهرة لديك.
ما هو الـ package registry؟¶
الـ package registry مخزن عام أو خاص لمخرجات مشروعك الجاهزة: مكتبة npm، package بلغة Python،
container image، أو حتى ملف ثنائي عادي. بدل أن ترفعها إلى خدمة منفصلة، ترفعها إلى الحساب نفسه
الذي يستضيف كودك، وتسحبها منه بأدواتك المعتادة (npm وpip وdocker وغيرها).
مديرات الـ packages المدعومة¶
الجدول التالي يعدّد ما يدعمه Gitea 1.25 الذي يعمل عليه ليڤانت غيت. لسبع منها صفحات عربية هنا؛ والبقية موثّقة في وثائق Gitea الأصلية بالإنجليزية.
| الاسم | اللغة | العميل |
|---|---|---|
| Alpine (انظر وثائق Gitea) | - | apk |
| Arch (انظر وثائق Gitea) | - | pacman |
| Cargo (انظر وثائق Gitea) | Rust | cargo |
| Chef (انظر وثائق Gitea) | - | knife |
| Composer | PHP | composer |
| Conan (انظر وثائق Gitea) | C++ | conan |
| Conda (انظر وثائق Gitea) | - | conda |
| Container | - | أي عميل متوافق مع OCI |
| CRAN (انظر وثائق Gitea) | R | - |
| Debian (انظر وثائق Gitea) | - | apt |
| Generic | - | أي عميل HTTP |
| Go | Go | go |
| Helm (انظر وثائق Gitea) | - | أي عميل HTTP، cm-push |
| Maven | Java | mvn، gradle |
| npm | JavaScript | npm، yarn، pnpm |
| NuGet (انظر وثائق Gitea) | .NET | nuget |
| Pub (انظر وثائق Gitea) | Dart | dart، flutter |
| PyPI | Python | pip، twine |
| RPM (انظر وثائق Gitea) | - | yum، dnf، zypper |
| RubyGems (انظر وثائق Gitea) | Ruby | gem، Bundler |
| Swift (انظر وثائق Gitea) | Swift | swift |
| Vagrant (انظر وثائق Gitea) | - | vagrant |
الـ package تتبع الـ owner لا الـ repository¶
الـ package تتبع دائمًا owner: مستخدمًا أو organization، لا repository. لذلك يظهر عنوان الـ
registry في كل الصفحات بالشكل https://levantgit.com/api/packages/{owner}/....
يمكنك مع ذلك ربط package رفعتها بـ repository معيّن: افتح صفحة الـ package، ثم Settings، واختر الـ repository. الربط يشمل الـ package كلها بكل إصداراتها، لا إصدارًا واحدًا. بعد الربط تظهر الـ package في قائمة packages الـ repository، ويظهر في صفحة الـ package رابط إلى الـ repository وإلى الـ issues فيه.
مَن يرى الـ package ومَن يرفعها؟¶
| نوع المالك | مستخدم | organization |
|---|---|---|
| القراءة | عامة إن كان المستخدم عامًّا؛ وإلا لهذا المستخدم وحده | عامة إن كانت الـ organization عامة؛ وإلا لأعضائها فقط |
| الكتابة | الـ owner وحده | أعضاء الـ organization الذين لهم صلاحية كتابة أو إدارة عليها |
الأدوات (مثل npm أو pip) لا تستطيع استخدام كلمة مرورك مباشرة في كل الحالات، وخاصة إن كنت
تستخدم 2FA. أنشئ access token من إعدادات الحساب: Settings ← Applications، وامنحه
صلاحية package بمستوى Read للتنزيل فقط، أو Read & Write للنشر أيضًا. راجع
الـ 2FA.
رفع package¶
لكل مدير packages طريقته: أحيانًا أمر واحد مثل npm publish، وأحيانًا طلب HTTP بـ curl. افتح
صفحة المدير الذي تستخدمه من الجدول أعلاه.
عرض الـ packages¶
- افتح ملفك الشخصي (أو صفحة الـ organization، أو الـ repository المرتبط).
- اضغط تبويبة Packages.
- اضغط اسم الـ package لترى تفاصيلها: الإصدارات، وتعليمات التثبيت، والملفات.
تنزيل package من الواجهة¶
- افتح تبويبة Packages.
- اضغط اسم الـ package.
- في قسم Assets اضغط اسم الملف الذي تريده.
حذف package¶
لا يمكن تعديل package بعد نشرها؛ إن أردت تغييرها فاحذفها وارفعها من جديد.
- افتح تبويبة Packages.
- اضغط اسم الـ package.
- اضغط Delete package. الحذف نهائي.
تنبيه
ليڤانت غيت خدمة مجانية تُقدَّم كما هي دون ضمان توفّر. لا تجعل الـ package registry هنا النسخة الوحيدة من ملفات مهمة؛ احتفظ بنسخة لديك.
ماذا بعد؟¶
هذه الصفحة مبنية على وثائق Gitea (رخصة MIT) بعد ترجمتها وتبسيطها.