Türkiye'nin Yerli PaaS Platformu

İlk Deploy

📖 Bu rehberde

⏱ Ortalama Süre: 2-5 dk

✓ Projenizi GitHub üzerinden Skyversal'e bağlayacaksınız.
✓ Derleme ve dağıtım (build/deploy) ayarlarını göreceksiniz.
✓ İlk uygulamanızı canlıya (production) alacaksınız.

Artık her şey hazır. Bu rehberde GitHub'daki projenizi Skyversal'e bağlayacak, gerekli ayarları yapacak ve ilk deploy'unuzu birkaç dakika içinde tamamlayacaksınız.

Skyversal Proje Oluşturma Ekranı — Yeni proje oluşturma ve kaynak seçimi ekranı.

📦 1. Proje Kaynağını Belirlemek

Kontrol panelinizden "Yeni Proje Ekle" butonuna tıkladığınızda karşınıza üç farklı kaynak seçeneği çıkar. Projenizin nerede durduğuna göre en uygun olanı seçmelisiniz:

GitHub ile Bağlan (Önerilen)

En popüler yöntemdir. Skyversal uygulamasını GitHub hesabınıza yetkilendirdiğinizde, projelerinizi bağlayabilirsiniz. GitHub'daki main veya master dalına yaptığınız her push sonrasında Skyversal yeni bir deploy başlatabilir. Böylece dağıtım süreci otomatik hale gelir.

💡 Tip

Yerel bilgisayarınızda aşağıdaki komutu çalıştırdığınız anda sunucunuzdaki kodlar otomatik güncellenir:

git push origin main

ZIP Arşivi Yükleme

Eğer projeniz sadece yerel diskinizde duruyorsa, tüm proje dosyalarınızı bir .zip arşivi haline getirip doğrudan panele sürükleyip bırakabilirsiniz. Skyversal bu arşivi açar ve derlemeye başlar.

Marketplace Şablonları

Skyversal Marketplace'te bulunan hazır WordPress, Ghost, Strapi veya Laravel şablonlarını tek tıklamayla kurabilirsiniz. Hiç kod yazmadan hazır bir sisteme sahip olmak isteyenler için idealdir.

🤖 2. Akıllı Kod Tanıma (Auto-Detection)

Skyversal, proje dosyalarınızı analiz ederek kullanılan framework'ü ve çalışma ortamını otomatik olarak algılar. Desteklenen projeler için gerekli build ve çalışma ayarları otomatik olarak hazırlanır. İster React, Vue, Next.js, Laravel isterseniz de Python Django/FastAPI projeniz olsun, Skyversal dosya yapısını tarayarak uygun yapılandırmayı sunar. Örneğin;

package.json → Node.js, Next.js, React vb. ortamlara hazırlanır.
composer.json → Laravel ve PHP gereksinimleri ayarlanır.
Dockerfile → Docker tabanlı özel deployment başlatılır.

🛠️ 3. Kurulum Modları & Veritabanı Eklentileri

Projenizin türü belirlendikten sonra, uygulamanızın ihtiyaç duyduğu ek servisleri seçebilirsiniz. Skyversal arayüzünde 3 sekme bulunur: Hızlı, Pro ve Uzman (Expert).

Tek Tıkla Servisler (Addons)

Eğer uygulamanız bir veritabanına veya önbellek sistemine ihtiyaç duyuyorsa, harici bir veritabanı sunucusu kiralamanıza gerek kalmadan arayüzden şu servisleri projenize anında dahil edebilirsiniz:

PostgreSQL MySQL MongoDB Redis Memcached S3 Storage

🔑 4. Çevresel Değişkenler (Environment Variables)

API anahtarları, şifreler veya gizli token'lar asla kod içerisinde saklanmamalıdır. Çoğu framework bu ayarları .env dosyalarından okur.

Proje oluşturma ekranındaki Environment Variables alanına kendi .env dosyanızın içeriğini yapıştırabilirsiniz. Environment Variables güvenli şekilde saklanır ve yalnızca build ile çalışma sırasında uygulamanıza aktarılır.

⚠️ Uyarı

Güvenliğiniz için .env veya .env.production gibi dosyaları asla GitHub reponuza yüklemeyin. Gizli anahtarlarınızı sadece Skyversal paneli üzerinden yönetin.

📋 Deploy Özeti

Repository ✓ laravel-blog

Branch ✓ main

Runtime ✓ PHP 8.4

Framework ✓ Laravel 12

Region ✓ Germany

Database ✓ PostgreSQL

Auto Deploy ✓ Enabled

Estimated Deploy Time ✓ ≈ 2 dakika

🚀 5. Build ve Deploy Süreci

Her şeyi ayarladınız ve o sihirli "Deploy" butonuna bastınız. Deploy sırasında Skyversal otomatik olarak şu adımları gerçekleştirir. Tüm işlemleri canlı Deploy Log ekranından gerçek zamanlı olarak takip edebilirsiniz:

✓ Kaynak kodunu indirir
✓ Build işlemini başlatır
✓ Bağımlılıkları yükler
✓ Environment Variables'ı ekler
✓ Uygulamayı başlatır
✓ Sağlık kontrolünü gerçekleştirir
✓ Trafiği yeni sürüme yönlendirir

Skyversal Deploy Log Ekranı — Canlı deploy günlükleri (logs) sayesinde süreci adım adım takip edin.

Zero-Downtime (Sıfır Kesinti)

Yeni sürüm sağlık kontrollerini başarıyla geçtiğinde trafik yeni sürüme yönlendirilir. Böylece kullanıcılar dağıtım sırasında kesinti yaşamaz.

❓ Sorun mu Yaşadınız? (Sık Karşılaşılan Hatalar)

Deploy sırasında yaygın alınan hatalar ve çözümleri:

E_BUILD_FAILED

Derleme aşamasında hata oluştu. Syntax hatası veya eksik paket olabilir. Deploy Log'larını kontrol edin.

Missing Environment Variable

Projenizin ihtiyaç duyduğu bir değişken (örn. veritabanı şifresi) eksik. Ayarlar sekmesinden ilgili değişkeni ekleyip yeniden deploy edin.

Eğer hatanın kaynağını bulamazsanız genel sorun giderme adımları:

Hatanın kaynağını anlamak için Deploy Log ekranını inceleyin.
Framework'ünüz için gerekli build komutlarının doğru yapılandırıldığından emin olun.
Environment Variables ayarlarınızın eksiksiz ve doğru olduğunu kontrol edin.
Desteklenen framework listesine ve özel build ayarlarına göz atın.
Çözemediğiniz sorunlar için Destek ekibimizle iletişime geçmekten çekinmeyin.

🎉 Tebrikler, Canlıdasınız!

Artık uygulamanız internete açık durumda.

Bir sonraki rehberde kendi alan adınızı bağlayacak ve Skyversal'in otomatik SSL desteğini etkinleştireceksiniz.

➜ Özel Alan Adı (Custom Domain) Ekleme