# Daha hızlı build

Derleme önbelleğinin nasıl çalıştığını ve Dockerfile, .dockerignore ile kilit dosyasını hızlı derleme için nasıl düzenleyeceğinizi anlatır.

Last reviewed: 2026-11-12

## DeployVera önbelleği nasıl çalışır

DeployVera her uygulama için derleme önbelleğini otomatik tutar ve her derlemede kullanır. Önbellek uygulamaya özeldir; müşteriler arasında paylaşılmaz.

Önbellek önceki derlemelerden kalan katmanları ve paket indirmelerini yeniden kullanır. Bu bir garanti değildir: bağımlılık dosyası veya kaynak değiştiğinde ilgili adımlar yeniden çalışır. Derleme süresi için belirli bir değer vaat edilmez.

Derleme listesinde, uygulamanın son başarılı derlemelerinin medyanına göre en az yüzde 30 ve en az 30 saniye kısa süren başarılı derlemeler "Önbellekten" etiketiyle gösterilir. Etiket yalnızca süreye dayanan bir tahmindir ve en az üç önceki başarılı derleme gerektirir.

## Dockerfile katmanlarını doğru sırala

Bağımlılık dosyalarını önce kopyalayıp kurulumu çalıştırın; kaynak kodu sonra kopyalayın. Yalnızca kaynak kodu değiştiğinde bağımlılık kurulumu önbellekten yeniden kullanılır.

```
FROM node:22-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
CMD ["npm", "start"]
```

## BuildKit önbellek bağlama noktası: npm

`RUN --mount=type=cache` paket yöneticisinin indirme önbelleğini imajın dışında tutar ve sonraki derlemelerde yeniden kullanır. Bu sözdizimi BuildKit gerektirir; dosyanın ilk satırındaki `# syntax=docker/dockerfile:1` satırı etkinleştirir.

```
# syntax=docker/dockerfile:1
FROM node:22-alpine
WORKDIR /app
COPY package*.json ./
RUN --mount=type=cache,target=/root/.npm npm ci
COPY . .
RUN npm run build
CMD ["npm", "start"]
```

## pnpm ve pip için önbellek bağlama noktaları

pnpm adımından önce pnpm'in imajda kurulu olması gerekir. pip komutunda `--no-cache-dir` kullanmayın; aksi halde pip önbelleği devre dışı kalır. Hedef yol, imajın kullanıcısının ev dizinine göre değişebilir; kullandığınız temel imajda kontrol edin.

```
# pnpm
RUN --mount=type=cache,target=/root/.local/share/pnpm/store pnpm install --frozen-lockfile

# pip
RUN --mount=type=cache,target=/root/.cache/pip pip install -r requirements.txt
```

## .dockerignore ile gereksiz dosyaları dışarıda bırakın

Derleme bağlamındaki gereksiz dosyalar kopyalama katmanlarını boş yere değiştirir. Yerel bağımlılıkları, Git geçmişini ve derleme çıktılarını dışarıda bırakın; `.env` gibi gizli dosyaları da ekleyin.

```
node_modules
.git
.next/cache
dist
```

## Kilit dosyasını depoya ekleyin

`package-lock.json` veya `pnpm-lock.yaml` dosyasını commit edip depoya ekleyin. `npm ci` kilit dosyası olmadan çalışmaz; kilit dosyası varsa her derlemede aynı paket sürümleri kurulur ve bağımlılık katmanı daha sık yeniden kullanılır.

## Zorunlu yeniden derlemeden kaçının

Panelden zorunlu yeniden derleme (önbelleği atlama) şu anda sunulmuyor; her derleme önbelleği kullanır. Önbelleğin bozulduğundan şüpheleniyorsanız destek talebi açın ve derleme kimliğini ekleyin.

## Next.js: standalone çıktı

`next.config.js` içinde `output: 'standalone'` ayarı, çalışma zamanında gereken dosyaları ayrı bir klasörde toplar ve imajı küçültür. Bu ayar derleme süresini kısaltmaz. Dockerfile kullanıyorsanız çıktıdaki `.next/standalone` klasörünü imaja kopyalayın.

```
// next.config.js
module.exports = {
  output: 'standalone',
};
```

Sources: https://api.deployvera.com/api/plans · https://deployvera.com/docker · https://deployvera.com/help
