التخزين المؤقت لعمليات التكامل المستمر (CI) في البناء

لتحسين أداء البناء، يحفظ Next.js ذاكرة تخزين مؤقت في .next/cache يتم مشاركتها بين عمليات البناء المختلفة.

للاستفادة من هذه الذاكرة المؤقتة في بيئات التكامل المستمر (CI)، يجب تكوين سير العمل في CI الخاص بك للحفاظ على الذاكرة المؤقتة بشكل صحيح بين عمليات البناء.

إذا لم يتم تكوين CI الخاص بك للحفاظ على .next/cache بين عمليات البناء، قد تظهر لك رسالة خطأ No Cache Detected.

إليك بعض أمثلة تكوينات الذاكرة المؤقتة لمزودي CI الشائعين:

Vercel

يتم تكوين ذاكرة التخزين المؤقت لـ Next.js تلقائيًا لك. لا يلزم اتخاذ أي إجراء من جانبك.

CircleCI

قم بتحرير خطوة save_cache في ملف .circleci/config.yml لتشمل .next/cache:

steps:
  - save_cache:
      key: dependency-cache-{{ checksum "yarn.lock" }}
      paths:
        - ./node_modules
        - ./.next/cache

إذا لم يكن لديك مفتاح save_cache، يرجى اتباع توثيق CircleCI حول إعداد ذاكرة التخزين المؤقت للبناء.

Travis CI

أضف أو ادمج ما يلي في ملف .travis.yml:

cache:
  directories:
    - $HOME/.cache/yarn
    - node_modules
    - .next/cache

GitLab CI

أضف أو ادمج ما يلي في ملف .gitlab-ci.yml:

cache:
  key: ${CI_COMMIT_REF_SLUG}
  paths:
    - node_modules/
    - .next/cache/

Netlify CI

استخدم Netlify Plugins مع @netlify/plugin-nextjs.

AWS CodeBuild

أضف (أو ادمج) ما يلي إلى ملف buildspec.yml:

cache:
  paths:
    - 'node_modules/**/*' # تخزين `node_modules` مؤقتًا لـ `yarn` أو `npm i` أسرع
    - '.next/cache/**/*' # تخزين Next.js مؤقتًا لإعادة بناء التطبيق بشكل أسرع

GitHub Actions

باستخدام actions/cache من GitHub، أضف الخطوة التالية في ملف سير العمل الخاص بك:

uses: actions/cache@v3
with:
  # راجع هنا للتخزين المؤقت مع `yarn` https://github.com/actions/cache/blob/main/examples.md#node---yarn أو يمكنك الاستفادة من التخزين المؤقت مع actions/setup-node https://github.com/actions/setup-node
  path: |
    ~/.npm
    ${{ github.workspace }}/.next/cache
  # إنشاء ذاكرة تخزين مؤقت جديدة عند تغيير الحزم أو ملفات المصدر.
  key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
  # إذا تغيرت ملفات المصدر ولكن لم تتغير الحزم، أعد البناء من ذاكرة التخزين المؤقت السابقة.
  restore-keys: |
    ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-

Bitbucket Pipelines

أضف أو ادمج ما يلي في ملف bitbucket-pipelines.yml في المستوى الأعلى (نفس مستوى pipelines):

definitions:
  caches:
    nextcache: .next/cache

ثم أشر إليه في قسم caches من step في خط أنابيبك:

- step:
    name: your_step_name
    caches:
      - node
      - nextcache

Heroku

باستخدام custom cache من Heroku، أضف مصفوفة cacheDirectories في ملف package.json الرئيسي:

"cacheDirectories": [".next/cache"]

Azure Pipelines

باستخدام Cache task من Azure Pipelines، أضف المهمة التالية إلى ملف pipeline yaml في مكان ما قبل المهمة التي تنفذ next build:

- task: Cache@2
  displayName: 'Cache .next/cache'
  inputs:
    key: next | $(Agent.OS) | yarn.lock
    path: '$(System.DefaultWorkingDirectory)/.next/cache'

التخزين المؤقت لعمليات التكامل المستمر (CI) في البناء

On this page