تنزيل verdaccio - تنزيل كود المصدر verdaccio

verdaccio

شفرة المصدر الأخرى

v6.0.2

تنزيل

فيرداتشيو يقف من أجل السلام ، أوقفوا الحرب، سنكون أصفر/أزرق؟؟ حتى يحدث ذلك.

الإصدار التالي (فرع التطوير)

هل تبحث عن نسخة Verdaccio 6؟ تحقق من الفرع 6.x توجد المكونات الإضافية للإصدار v6.x المستضافة داخل هذه المؤسسة في مستودع verdaccio/monorepo ، بينما تتم استضافة الإصدار next في هذا المشروع ./packages/plugins .

لاحظ أن إرشادات المساهمة قد تكون مختلفة بناءً على الفرع.

Verdaccio هو سجل npm محلي خاص بسيط ولا يتطلب تكوينًا صفريًا . لا حاجة لقاعدة بيانات كاملة فقط للبدء! يأتي Verdaccio خارج الصندوق مزودًا بقاعدة بيانات صغيرة خاصة به ، وإمكانية إنشاء وكيل للسجلات الأخرى (مثل npmjs.org)، والتخزين المؤقت للوحدات التي تم تنزيلها على طول الطريق. بالنسبة لأولئك الذين يتطلعون إلى توسيع قدرات التخزين الخاصة بهم، تدعم Verdaccio العديد من المكونات الإضافية التي أنشأها المجتمع للاتصال بخدمات مثل Amazon's s3 أو Google Cloud Storage أو إنشاء مكون إضافي خاص بك.

ثَبَّتَ

Node.js v18 هو الحد الأدنى المطلوب للإصدار

التثبيت باستخدام npm:

npm install -g verdaccio@next

مع yarn

yarn global add verdaccio@next

مع pnpm

pnpm i -g verdaccio@next

أو

docker pull verdaccio/verdaccio:nightly-master

أو مع الرسم البياني الرسمي للقيادة .

helm repo add verdaccio https://charts.verdaccio.org
helm repo update
helm install verdaccio/verdaccio

علاوة على ذلك، يمكنك قراءة إرشادات التصحيح وأمثلة Docker لمزيد من التطوير المتقدم.

الإضافات

يمكنك تطوير المكونات الإضافية الخاصة بك باستخدام منشئ verdaccio. مطلوب تثبيت Yeoman.

 npm install -g yo
npm install -g generator-verdaccio-plugin

تعرف على المزيد هنا حول كيفية تطوير المكونات الإضافية. شارك المكونات الإضافية الخاصة بك مع المجتمع.

اختبارات التكامل

في مشروع اختبار التوافق الخاص بنا، نحن ملتزمون بضمان عمل أوامرك المفضلة بسلاسة عبر الإصدارات المختلفة من npm وpnpm وYarn. من نشر الحزم إلى إدارة التبعيات. هدفنا هو أن نمنحك الثقة لاستخدام مدير الحزم المفضل لديك دون أي مشاكل. لذا، قم بالتعمق في المصفوفة الخاصة بنا، وتحقق منها، وشاهد مدى نجاح أوامرك في جميع المجالات!

تعلم أو المساهمة هنا

الأوامر

كمد	npm6	npm7	npm8	npm9	npm10	pnpm8	pnpm9	pnpm10	الغزل1	الغزل2	الغزل3	الغزل4
نشر	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
إلغاء النشر	✅	✅	✅	✅	✅	✅	✅
معلومات	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
مراجعة	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
ثَبَّتَ	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
إهمال	✅	✅	✅	✅	✅	✅	✅	✅	⛔	⛔	⛔	⛔
بينغ	✅	✅	✅	✅	✅	✅	✅	✅	⛔	⛔	⛔	⛔
يبحث	✅	✅	✅	✅	✅	✅	✅	✅	⛔	⛔	⛔	⛔
نجم	✅	✅	✅	✅	✅	✅	✅	✅	⛔	⛔	⛔	⛔
النجوم	✅	✅	✅	✅	✅	✅	✅	✅	⛔	⛔	⛔	⛔
علامة التوزيع	✅	✅	✅	✅	✅	✅	✅	✅	✅

ملحوظات:
يوجد cmd لبحث الغزل في العصر الحديث ولكنه لا يستخدم نقطة نهاية تسجيل البحث.
يحتوي الغزل الحديث على أمرين للمعلومات، الأمر المستخدم هنا هو yarn npm info

= لم يتم اختباره ✅ = تم اختباره ⛔ = لا يوجد دعم

التبرعات

تتم إدارة Verdaccio بواسطة متطوعين . لا أحد يعمل بدوام كامل على ذلك. إذا وجدت هذا المشروع مفيدًا وترغب في دعم تطويره، ففكر في تقديم تبرع لدعم طويل - وسيكون شعارك موجودًا في هذا القسم من الملف التمهيدي.

يتبرع ؟؟؟ بدءًا من 1 دولار شهريًا أو مساهمة واحدة فقط.

ماذا يفعل فيرداتشيو من أجلي؟

استخدام الحزم الخاصة

إذا كنت ترغب في استخدام جميع مزايا نظام حزم npm في شركتك دون إرسال جميع التعليمات البرمجية إلى الجمهور، واستخدام الحزم الخاصة بنفس سهولة استخدام الحزم العامة.

ذاكرة التخزين المؤقت للتسجيل npmjs.org

إذا كان لديك أكثر من خادم تريد تثبيت الحزم عليه، فقد ترغب في استخدام هذا لتقليل زمن الوصول (من المفترض أن يتم توصيل npmjs.org "البطيء" به مرة واحدة فقط لكل حزمة/إصدار) وتوفير تجاوز فشل محدود (إذا كان npmjs. org معطلاً، ربما لا يزال بإمكاننا العثور على شيء مفيد في ذاكرة التخزين المؤقت) أو تجنب مشكلات مثل كيف قام أحد المطورين بكسر Node وBabel وآلاف المشاريع في 11 سطرًا من JavaScript ، أو اختفت العديد من الحزم فجأة أو عاد السجل 404 للحزمة التي قمت بتثبيتها من قبل .

ربط سجلات متعددة

إذا كنت تستخدم سجلات متعددة في مؤسستك وتحتاج إلى جلب حزم من مصادر متعددة في مشروع واحد، فقد تستفيد من ميزة الوصلات الصاعدة مع Verdaccio، وربط سجلات متعددة وجلب من نقطة نهاية واحدة.

تجاوز الحزم العامة

إذا كنت تريد استخدام نسخة معدلة من بعض حزم الجهات الخارجية (على سبيل المثال، وجدت خطأً، لكن المشرف لم يقبل طلب السحب بعد)، فيمكنك نشر نسختك محليًا بنفس الاسم. انظر بالتفصيل هنا.

اختبار E2E

لقد أثبت Verdaccio أنه سجل خفيف الوزن يمكن تشغيله في بضع ثوانٍ، وبسرعة كافية لأي CI. تستخدم العديد من المشاريع مفتوحة المصدر Verdaccio للاختبار الشامل، على سبيل المثال لا الحصر، create-react-app ، أو mozilla neutrino ، أو pnpm ، أو Storybook ، أو babel.js ، أو angular-cli ، أو docusaurus . يمكنك قراءة المزيد هنا.

علاوة على ذلك، إليك بعض الأمثلة حول كيفية البدء:

e2e-ci-example-gh-actions
اختبارات verdaccio من النهاية إلى النهاية
verdaccio-fork

شاهد فيديوهاتنا

Node 2022، فبراير 2022، مجانًا عبر الإنترنت

قد ترغب في الاطلاع أيضًا على محادثاتنا السابقة:

استخدام Docker وVerdaccio لتسهيل اختبار التكامل - Docker All Hands #4 ديسمبر - 2021
خوان بيكادو – اختبار سلامة مكونات React من خلال النشر في سجل خاص - React فنلندا - 2021
لقاء BeerJS Cba رقم 53 مايو 2021 - خوان بيكادو
هجمات ارتباك التبعية Node.js - أبريل 2021 - خوان بيكادو
OpenJS World 2020 حول *تغطية مشاريعك باستخدام سجل Node.js خفيف الوزن متعدد الأغراض - خوان بيكادو
لقاء ViennaJS - مقدمة إلى Verdaccio بقلم بريسيلا أوليفيرا وخوان بيكادو
مفتوح المصدر؟ تريفاجو - فيرداتشيو ( أيوش وخوان بيكادو ) يناير 2020
مرحلة GitNation مفتوحة المصدر - كيف بنينا سجل Node.js باستخدام React - خوان بيكادو ديسمبر 2019
Verdaccio - سجل وكيل خاص خفيف الوزن تم إنشاؤه في Node.js | خوان بيكادو في عرض Destro Dev

ابدأ

تشغيل في المحطة الخاصة بك

verdaccio

ستحتاج إلى ضبط بعض إعدادات npm، وهذا أمر اختياري.

npm set registry http://localhost:4873/

بالنسبة للأوامر لمرة واحدة أو لتجنب إعداد السجل عالميًا:

NPM_CONFIG_REGISTRY=http://localhost:4873 npm i

يمكنك الآن الانتقال إلى http://localhost:4873/ حيث سيتم إدراج حزمك المحلية ويمكن البحث فيها.

تحذير: لا يدعم Verdaccio حاليًا وضع مجموعة PM2، وقد يؤدي تشغيله مع وضع المجموعة إلى حدوث سلوك غير معروف.

نشر

1. قم بإنشاء مستخدم وتسجيل الدخول

npm adduser --registry http://localhost:4873

إذا كنت تستخدم HTTPS، أضف معلومات CA المناسبة ("خالية" تعني الحصول على قائمة CA من نظام التشغيل)

npm set ca null

2. قم بنشر الحزمة الخاصة بك

npm publish --registry http://localhost:4873

سيطالبك هذا ببيانات اعتماد المستخدم التي سيتم حفظها على خادم verdaccio .

عامل ميناء

فيما يلي المعلومات الأكثر طلبًا، حيث يتم توثيق كل جانب من جوانب Docker وverdaccio بشكل منفصل

 docker pull verdaccio/verdaccio:nightly-master

متاح كعلامات.

تشغيل Verdaccio باستخدام Docker

لتشغيل حاوية عامل الإرساء:

docker run -it --rm --name verdaccio -p 4873:4873 verdaccio/verdaccio

تتوفر أمثلة Docker في هذا المستودع.

التوافق

يهدف Verdaccio إلى دعم جميع ميزات عميل npm القياسي الذي يكون من المنطقي دعمه في مستودع خاص. لسوء الحظ، ليس من الممكن دائما.

الميزات الأساسية

تثبيت الحزم ( npm install ، npm update ، وما إلى ذلك) - مدعوم
حزم النشر ( npm publish ) - مدعومة

التحكم المتقدم في الحزمة

إلغاء نشر الحزم ( npm unpublish ) - مدعوم
وضع العلامات ( npm dist-tag ) - مدعوم
الإهمال ( npm deprecate ) - مدعوم

إدارة المستخدم

تسجيل مستخدمين جدد ( npm adduser {newuser} ) - مدعوم
تغيير كلمة المرور ( npm profile set password ) - مدعوم
نقل الملكية ( npm owner ) - مدعوم
الرمز المميز ( npm token ) - مدعوم

متنوع

البحث ( npm search ) - مدعوم (cli/المتصفح)
Ping ( npm ping ) - مدعوم
بطولة ( npm star ، npm unstar ، npm stars ) - مدعومة

حماية

التدقيق ( npm/yarn audit ) - مدعوم

الإبلاغ عن ثغرة أمنية

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

شكر خاص

شكرًا للشركات التالية لمساعدتنا في تحقيق أهدافنا بتوفير تراخيص مجانية مفتوحة المصدر. توفر كل شركة موارد كافية لدفع هذا المشروع إلى الأمام.

شركة	الشعار	رخصة
جيت براينز		توفر JetBrains تراخيص للمنتجات للمشرفين النشطين، قابلة للتجديد سنويًا
كراودين		يوفر Crowdin منصة للترجمات
متصفح ستاك		يوفر BrowserStack خطة لإجراء اختبار شامل لواجهة المستخدم
نيتليفي		توفر Netlify خطة احترافية لنشر موقع الويب
ألغوليا		توفر Algolia خدمات البحث للموقع
عامل ميناء		يقدم Docker عمليات سحب غير محدودة وخروجًا غير محدود لأي وجميع المستخدمين