DeployVeraDocs

TEKNİK REFERANS

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.

Son kontrol: Markdown

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',
};