تنزيل vercel - تنزيل رمز المصدر vercel

vercel

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

39.1.0

تنزيل

Vercel

يطور. معاينة. سفينة.

الوثائق · changelog · قوالب · CLI

Vercel

توفر سحابة الواجهة الأمامية في Vercel تجربة المطورين والبنية التحتية لبناء وتوسيع وتأمين شبكة أسرع وأكثر تخصيصًا.

نشر

ابدأ عن طريق استيراد مشروع أو اختيار قالب أو استخدام Vercel CLI. ثم ، git push للنشر.

الوثائق

للحصول على تفاصيل حول كيفية استخدام Vercel ، تحقق من وثائقنا.

المساهمة

يستخدم هذا المشروع PNPM لتثبيت التبعيات وتشغيل البرامج النصية.

يمكنك استخدام برنامج vercel Script لتشغيل التغييرات المحلية كما لو كنت تستدعي Vercel CLI. على سبيل المثال ، يمكن تشغيل vercel deploy --cwd=/path/to/project مع تغييرات محلية مع pnpm vercel deploy --cwd=/path/to/project .

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

يرجى قراءة مدونة قواعد السلوك الخاصة بنا ومتابعتها في جميع تفاعلاتك مع المشروع.

التنمية المحلية

تم تكوين هذا المشروع في monorepo ، حيث يحتوي مستودع واحد على حزم NPM متعددة. يتم تثبيت التبعيات وإدارتها باستخدام pnpm ، وليس npm CLI.

للبدء ، قم بتنفيذ ما يلي:

git clone https://github.com/vercel/vercel
cd vercel
corepack enable
pnpm install
pnpm build
pnpm lint
pnpm test-unit

تأكد من أن جميع الاختبارات تمر قبل إجراء التغييرات.

تشغيل تغييرات Vercel CLI

يمكنك استخدام pnpm vercel من حزمة cli لاستدعاء Vercel CLI مع التغييرات المحلية:

cd ./packages/cli
pnpm vercel <cli-commands...>

انظر CLI التنمية المحلية لمزيد من التفاصيل.

التحقق من التغيير الخاص بك

بمجرد الانتهاء من التغييرات الخاصة بك (نقترح القيام بذلك على طول الطريق) ، تأكد من أن جميع الاختبارات لا تزال تمر عن طريق التشغيل:

pnpm test-unit

من جذر المشروع.

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

سحب عملية طلب

بمجرد أن تكون واثقًا من أن التغييرات تعمل بشكل صحيح ، افتح طلب سحب على المستودع الرئيسي.

سيتم مراجعة طلب السحب من قبل المشرفين وسيتم فحص الاختبارات من خلال منصة التكامل المستمر لدينا.

تفسير أخطاء الاختبار

هناك نوعان من الاختبارات في هذا المستودع - اختبارات الوحدة واختبارات التكامل.

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

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

تقوم اختبارات التكامل بإنشاء عمليات نشر في حساب Vercel الخاص بك باستخدام اسم مشروع test . بعد نشر كل اختبار ، يتم استخدام مفتاح probes للتحقق مما إذا كانت الاستجابة هي القيمة المتوقعة. إذا لم تتطابق القيمة ، فسترى رسالة تشرح الفرق. إذا فشل النشر في البناء ، فسترى رسالة أكثر عامة مثل ما يلي:

[Error: Fetched page https://test-8ashcdlew.vercel.app/root.js does not contain hello Root!. Instead it contains An error occurred with this application.

    NO_STATUS_CODE_FRO Response headers:
       cache-control=s-maxage=0
      connection=close
      content-type=text/plain; charset=utf-8
      date=Wed, 19 Jun 2019 18:01:37 GMT
      server=now
      strict-transport-security=max-age=63072000
      transfer-encoding=chunked
      x-now-id=iad1:hgtzj-1560967297876-44ae12559f95
      x-now-trace=iad1]

في مثل هذه الحالات ، يمكنك زيارة عنوان URL الخاص بالنشر الفاشل والإلحاح /_logs لرؤية خطأ الإنشاء. في الحالة أعلاه ، سيكون ذلك https://test-8ashcdlew.vercel.app/_logs

ستحتوي سجلات هذا النشر على الخطأ الفعلي الذي قد يساعدك على فهم الخطأ الذي حدث.

تشغيل اختبارات التكامل محليًا

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

إنشاء رمز الوصول. اتبع الإقناع هنا https://vercel.com/docs/rest-api#creating-an-access-token. تأكد من أن نطاق الرمز المميز هو لحسابك الشخصي.
احصل على معرف الفريق من لوحة معلومات Vercel على https://vercel.com/<MY-TEAM>/~/settings ~/settings.
مصدر هذه في ملف shell rc الخاص بك: echo 'export VERCEL_TOKEN=<MY-TOKEN> VERCEL_TEAM_ID=<MY-TEAM-ID>' >> ~/.zshrc

من هناك ، يجب أن تكون قادرًا على تشغيل اختبار التكامل. اختر واحدة معزولة بالفعل للتحقق من أن الأمور تعمل:

cd packages/next

قم بإجراء الاختبار:

pnpm test test/fixtures/00-server-build/index.test.js

@vercel/nft

يستخدم بعض البناة @vercel/nft إلى ملفات الشجرة قبل النشر. إذا كنت تشك في وجود خطأ في آلية هز الأشجار هذه ، فيمكنك إنشاء البرنامج النصي التالي في مشروعك:

 const {nodefiLetrace} = require ('@vercel/nft') ؛ nodefiLetrace (['path/to/entrypoint.js'] ، {
  TS: صحيح ،
  MixedModules: True ،})
  .Then (o => console.log (O.Filelist))
  .Then (e => console.error (e)) ؛

عند تشغيل هذا البرنامج النصي ، سترى جميع الملفات المستوردة. إذا كانت الملفات مفقودة ، فإن الخطأ في @Vercel/NFT وليس المنشئ.

نشر منشئه مع المشروع الحالي

في بعض الأحيان ، تريد اختبار التغييرات إلى منشئ مقابل مشروع موجود ، ربما مع vercel dev أو النشر الفعلي. يمكنك تجنب نشر كل تغيير منشئ إلى NPM عن طريق تحميل البناء كقطن.