Continuous Integration (CI) Build Caching

Derleme performansını artırmak için Next.js, derlemeler arasında paylaşılan bir önbelleği .next/cache adresine kaydeder.

Sürekli Entegrasyon (CI) ortamlarında bu önbellekten yararlanmak için, CI iş akışınızın derlemeler arasında önbelleği doğru şekilde devam ettirecek şekilde yapılandırılması gerekir.

CI'nız derlemeler arasında .next/cache adresini kalıcı hale getirecek şekilde yapılandırılmamışsa Önbellek Algılanmadı hatası görebilirsiniz.

Yaygın CI sağlayıcıları için bazı örnek önbellek yapılandırmaları aşağıda verilmiştir:

Vercel

Next.js önbelleğe alma sizin için otomatik olarak yapılandırılır. Sizin tarafınızdan herhangi bir işlem yapılması gerekmez.

CircleCI

.circleci/config.yml adresindeki save_cache adımınızı .next/cache adresini içerecek şekilde düzenleyin:

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

Eğer bir save_cache anahtarınız yoksa, lütfen CircleCI'ın yapı önbellekleme kurulumuna ilişkin belgelerini takip edin.

Travis CI

Aşağıdakileri .travis.yml adresinize ekleyin veya birleştirin:

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

GitLab CI

Aşağıdakileri .gitlab-ci.yml adresinize ekleyin veya birleştirin:

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

Netlify CI

Netlify Eklentilerini ile kullanın @netlify/plugin-nextjs.

AWS CodeBuild

Aşağıdakileri buildspec.yml adresinize ekleyin (veya birleştirin):

cache:
  paths:
    - 'node_modules/**/*' # Cache `node_modules` for faster `yarn` or `npm i`
    - '.next/cache/**/*' # Cache Next.js for faster application rebuilds

GitHub Actions

GitHub'ın actions/cache adresini kullanarak iş akışı dosyanıza aşağıdaki adımı ekleyin:

uses: actions/cache@v3
with:
  # See here for caching with `yarn` https://github.com/actions/cache/blob/main/examples.md#node---yarn or you can leverage caching with actions/setup-node https://github.com/actions/setup-node
  path: |
    ~/.npm
    ${{ github.workspace }}/.next/cache
  # Generate a new cache whenever packages or source files change.
  key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
  # If source files changed but packages didn't, rebuild from a prior cache.
  restore-keys: |
    ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-

Bitbucket Pipelines

Aşağıdakileri bitbucket-pipelines.yml adresinize en üst düzeyde ekleyin veya birleştirin ( pipelines ile aynı düzeyde):

definitions:
  caches:
    nextcache: .next/cache

Ardından boru hattınızın step adresindeki caches bölümünde referans olarak gösterin:

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

Heroku

Heroku'nun özel önbelleğini kullanarak , üst düzey package.json dosyanıza bir cacheDirectories dizisi ekleyin:

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

Azure Pipelines

Azure Pipelines'ın Cache görevini kullanarak, aşağıdaki görevi next build çalıştıran görevden önce bir yerde boru hattı yaml dosyanıza ekleyin:

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

Jenkins (Pipeline)

Jenkins'in Job Cacher eklentisini kullanarak, Jenkinsfile adresinize normalde next build veya npm install çalıştıracağınız yere aşağıdaki derleme adımını ekleyin:

stage("Restore npm packages") {
    steps {
        // Writes lock-file to cache based on the GIT_COMMIT hash
        writeFile file: "next-lock.cache", text: "$GIT_COMMIT"
 
        cache(caches: [
            arbitraryFileCache(
                path: "node_modules",
                includes: "**/*",
                cacheValidityDecidingFile: "package-lock.json"
            )
        ]) {
            sh "npm install"
        }
    }
}
stage("Build") {
    steps {
        // Writes lock-file to cache based on the GIT_COMMIT hash
        writeFile file: "next-lock.cache", text: "$GIT_COMMIT"
 
        cache(caches: [
            arbitraryFileCache(
                path: ".next/cache",
                includes: "**/*",
                cacheValidityDecidingFile: "next-lock.cache"
            )
        ]) {
            // aka `next build`
            sh "npm run build"
        }
    }
}