Sunucu Kurulumu

Sunucu kurulumu: Windows, Linux ve macOS

English · Türkçe · Languages / Diller

Kapsam: JSON API Forge 0.5.1 · İnceleme: 17 Eylül 2026 · Dil: Türkçe

Gereksinimler ve doğru sürüm

main paketi json-api-forge adını kullanır ve Python >=3.10 ister. Resmi CI kapsamı Python 3.10–3.14'tür; mevcut kurulum belgesi 3.13'ü temel sürüm olarak önerir. Python paketinin metadata sınırı ile test edilen sürüm aralığını karıştırmayın.

Önce Git ve uygun Python kurulu olmalıdır. İlk kullanım için kaynak + sanal ortam yolu en açık kurulumdur. Aşağıdaki v0.5.1 etiketi sunucu dalına aittir; SDK veya Editör kaynağını bu etiketten kurmayın.

Windows PowerShell

git clone --branch v0.5.1 --single-branch https://github.com/YoungLionOrganization/JSON-API-Forge.git JSON-API-Forge-main
Set-Location JSON-API-Forge-main
py -3.13 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e .
.\.venv\Scripts\Activate.ps1
forge new MyService --slug my-service
forge init
forge validate
forge doctor
forge dev

Aktivasyon PowerShell politikası nedeniyle engellenirse .\.venv\Scripts\forge.exe ile komutları doğrudan çalıştırabilirsiniz. Sistem çapında yürütme politikasını değiştirmeniz gerekmez. py -3.13 kurulu değilse uygun Python yürütülebilirini seçin.

Linux ve macOS

git clone --branch v0.5.1 --single-branch https://github.com/YoungLionOrganization/JSON-API-Forge.git JSON-API-Forge-main
cd JSON-API-Forge-main
python3 -m venv .venv
.venv/bin/python -m pip install -e .
source .venv/bin/activate
forge new MyService --slug my-service
forge init
forge validate
forge doctor
forge dev

Depodaki scripts/install.sh / scripts/install.ps1 aynı kurulum için yardımcı seçeneklerdir. Test bağımlılıkları gerektiğinde python -m pip install -e ".[dev]" kullanın.

İlk açılış

Sunucu varsayılan olarak 127.0.0.1:8000 adresini dinler. Proje dokümanı http://127.0.0.1:8000/api/my-service/v1/_docs adresindedir. Varsayılan minimal preset kaynak oluşturmaz; CRUD öğrenmek için ilk API bölümündeki postgres-api preset'i kullanın. Adına rağmen bu preset, database URL verilmezse SQLite ile başlar.

main dalı örnek uygulama içermez. Sadece sunucuyu başlatıp hazır uygulama beklemeyin. Etkin uygulama yokken /health çalışabilir, /ready 503 dönebilir.

Kaynağı kopyalamadan paket kurulumu

python -m pip install "json-api-forge @ git+https://github.com/YoungLionOrganization/JSON-API-Forge.git@356106c6610ce817fb9dfb03e391c85dd1726b24"
mkdir my-deployment
cd my-deployment
forge new MyService --slug my-service
forge init
forge dev

Bu yol framework kodunu Python ortamına kurar; app/, .env, veritabanları ve medya dağıtım dizinine aittir. Wheel/sdist kurmak bir uygulama veritabanını taşımaz.

Derlenmiş paketler

Release varlıkları Linux glibc/musl x64/ARM64, macOS x64/ARM64 ve Windows x64 sunucu paketlerini içerir. Windows ARM64 için sunucu kurulum yardımcısı x64 uyumluluk paketini seçer; Editörün native ARM64 paketi ayrı üründür.

--release kurulum yolu arşivin yanında <asset>.sha256 dosyasını da indirir. 17 Eylül 2026'da incelenen v0.5.1 release listesinde bu sidecar dosyalar görünmüyor. Bu nedenle bu Wiki'nin ilk çalıştırma yolu kaynak kurulumudur. Otomatik release kurulumunu kullanmadan önce sidecar'ların gerçekten yayımlandığını kontrol edin; doğrulamayı atlatmayın. Tam liste sürüm varlıkları sayfasındadır.

Kaynak ve doğrulama

Bu sayfa aşağıdaki sabit commitlerdeki davranışı açıklar. Yeni bir sürümde aynı davranışın sürdüğünü varsaymayın.

• main/INSTALL.md
• main/pyproject.toml
• main/framework/cli.py
• main/scripts/install-release.sh
• main/docs/43-Platform-and-Hosting-Matrix.md

---

Wiki ana sayfa · Tüm sayfalar · Sürüm ve bakım