TEKNİK REFERANS
İlk uygulamanı yayınla
Git deposundan çalışan bir API veya web uygulamasına.
Depoyu hazırla
GitHub veya GitLab bağlantısı ya da herkese açık bir HTTPS deposu kullanın. Gitea yalnızca bağlayıcısı DeployVera tarafından etkinleştirilmiş hesaplarda görünür; genel self-servis akışın parçası değildir.
Derlenecek dalı, Dockerfile veya otomatik derleme yöntemini ve uygulamanın dinlediği portu belirleyin. Sunucu 0.0.0.0 üzerinde dinlemelidir; yalnız localhost üzerinde dinleyen süreç proxy tarafından erişilemez.
Panelde oluştur
- Etkin hizmeti seçin; uygulama kotasını kontrol edin.
- Depo ve dalı seçin. Otomatik dağıtım yalnız bağlı dalın push olaylarını izler.
- Derleme yöntemini, portu ve gerekli ortam değişkenlerini girin.
- Dağıtımı başlatın; derleme loglarını, ardından çalışma durumunu izleyin.
Python API örneği
Bu örnekte panelde uygulama portu 8000 olmalıdır. Modül yolunu kendi projenize göre değiştirin.
FROM python:3.13-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]Canlı sürümü doğrula
Yayında durumu ile commit güncelliği farklı bilgiler verir. Çalışan sürümün SHA değerini, bağlı dalın son commit’iyle karşılaştırın. Başarısız veya iptal edilmiş bir deneme, önceki çalışan sürümün yeni commit olduğu anlamına gelmez. Build başarısız olursa nedenler ve çözümler için /docs/tr/build-errors makalesine bakın.
Node.js sürümü yetmiyorsa (Nixpacks)
Otomatik (Nixpacks) derlemede NIXPACKS_NODE_VERSION=22 yalnızca ana sürümü seçer; alt sürümü Nixpacks'in kullandığı nixpkgs arşivi belirler ve bu arşivdeki Node.js 22 sürümü 22.11.0'dır. Astro gibi bir araç Node.js 22.12 veya üstünü isterse derleme Node.js v22.11.0 is not supported hatasıyla durur.
Çözüm: deponun köküne nixpacks.toml ekleyip nixpkgs arşivini daha yeni bir commit'e sabitleyin. Aşağıdaki commit Node.js 22.13.1 sağlar. Arşiv sabitleme yalnız Node.js'i değil o commit'teki tüm paket kümesini değiştirir; ilk derlemeyi kontrol edin. Kesin bir sürüm seçmenin alternatifi Dockerfile derleme yöntemidir.
[phases.setup]
nixpkgsArchive = '51ad838b03a05b1de6f9f2a0fffecee64a9788ee'Sonraki derlemeleri hızlandırma
Derleme süresini kısaltmak için Dockerfile katman sırasını, .dockerignore dosyasını ve paket önbelleğini düzenleyebilirsiniz. Ayrıntılar için /docs/tr/faster-builds makalesine bakın.