Bu makalede anlatılan yöntem Next.js 14'ten sonraki sürümler için geçerlidir. Bu versiyondan önceki sürümlerde kurulum işlemini başka bir makalede yazacağım.

Bu makalemde, Next.js ile geliştirilen bir uygulamanın Plesk kontrol paneli üzerinden nasıl çalıştırılacağına dair adım adım bir rehber sunacağım.

Next.js, modern web uygulamaları geliştirmek için popüler bir React framework’üdür ve Plesk panel ile entegre edilmesi, doğru yapılandırma ile oldukça etkili bir şekilde gerçekleştirilebilir. Aşağıdaki adımları takip ederek uygulamanızı sorunsuz bir şekilde Plesk üzerinde çalıştırabilirsiniz.

Ön Koşullar

Başlamadan önce aşağıdaki gerekliliklerin size mevcut olması gerekir:

• Plesk kontrol paneline sahip bir sunucu.
• Sunucuda Node.js ve npm/yarn yüklü olmalı (Plesk’in Node.js eklentisi ile kurulabilir).
• Git yüklü ve yapılandırılmış olmalı (Plesk Git eklentisi kullanılabilir).
• Sunucuya SSH erişimi (bazı manuel düzenlemeler için gerekli olabilir).
• Bir alan adı veya alt alan adı (subdomain) yapılandırılmış olmalı.

Adım 1: Plesk Panelde Domain veya Subdomain Oluşturma

1. Plesk paneline yönetici veya kullanıcı hesabınızla giriş yapın.
2. Plesk panelinde Domains > Add Domain seçeneğine tıklayın. Next.js uygulamanızı barındıracak bir alan adı veya alt alan adı oluşturun. Örneğin, app.ornek.com.
3. Domain veya subdomain oluştururken, Node.js application seçeneğini işaretleyin. Bu, Node.js ortamını otomatik olarak etkinleştirir.
4. Varsayılan olarak, Plesk dosyaları /httpdocs dizinine yerleştirir.

Adım 2: Dosyalarınızı İlgili Dizine Çekme

Next.js projenizi Plesk’e deploy etmek için 2 yol bulunmaktadır;

-> Dosya yükleme kısmından projenizi upload edebilirsiniz,
-> Git entegrasyonunu kullanarak upload edebilirsiniz.

Not: Git ile yükleme işlemini bilmeyenler için daha sonra başka bir makalede anlatıyor olacağım.

Adım 3: Node.js Ortamını Yapılandırma

Plesk’in Node.js eklentisi, Next.js uygulamanızı çalıştırmak için gerekli ortamı sağlar, ancak doğru yapılandırma önemlidir.

1. Domain’inizin yönetim panelinde Node.js sekmesini bulun.
2. Application Root olarak projenizin kök dizinini seçin (örneğin, /httpdocs).
3. Next.js için başlangıç dosyası genellikle node_modules/.bin/next olacaktır. Application Startup File kısmına bu yolu girin.
4. Projenizde npm veya yarn kullanıyorsanız, bunu Node.js sekmesinde belirtin. Örneğin, yarn kullanıyorsanız, Package Manager olarak yarn seçin.
5. Projenizin gerektirdiği Node.js sürümünü seçin. Next.js genellikle Node.js 16 veya üstü ile uyumludur. Plesk’te mevcut sürümleri görmek için SSH üzerinden plesk ext nodejs –versions komutunu çalıştırabilirsiniz.

Adım 4: Uygulamayı Derleme ve Çalıştırma

Next.js uygulamanızı production modunda çalıştırmak için bazı ek ayarlar gereklidir, çünkü Plesk varsayılan olarak uygulamaları development modunda çalıştırabilir.

1. Bağımlılıkları Yükleme:
   • Node.js sekmesinde, Run Node.js Commands kısmına gidin.
   • npm install veya yarn install komutunu çalıştırarak bağımlılıkları yükleyin.
2. Uygulamayı Derleme:
   • Aynı sekmede, npm run build veya yarn build komutunu çalıştırın. Bu, Next.js uygulamanızı production için optimize eder ve .next klasörünü oluşturur.
3. Next.js’i Production Modunda Çalıştırma:
   • Plesk, varsayılan olarak next dev komutunu çalıştırmaya çalışabilir, bu da development moduna neden olur. Bunu düzeltmek için node_modules/.bin/next dosyasını düzenlemeniz gerekir.
   • SSH ile Dosya Düzenleme:
     • Sunucunuza SSH ile bağlanın (Plesk’in SSH terminalini de kullanabilirsiniz).
     • node_modules/.bin/next dosyasını bir metin editörüyle açın (örneğin, nano /httpdocs/node_modules/.bin/next).
     • Dosyada program.command("dev", { isDefault: true }) satırını bulun ve isDefault: true değerini isDefault: false olarak değiştirin.
     • Ardından, program.command("start", { isDefault: true }) satırını ekleyin veya mevcut start komutunun isDefault: false değerini isDefault: true olarak değiştirin.
     • Dosyayı kaydedin ve çıkın.
   • Not: Plesk’in dahili dosya yöneticisiyle bu dosyayı düzenlemek sorunlara yol açabilir, bu yüzden SSH kullanılması önerilir.
4. Uygulamayı Başlatma:
   • Node.js sekmesine geri dönün ve Restart App butonuna tıklayın.
   • Alternatif olarak, SSH üzerinden touch tmp/restart.txt komutunu çalıştırarak uygulamayı yeniden başlatabilirsiniz.

Adım 5: SSL ve Güvenlik

1. SSL Sertifikası: Plesk üzerinden Let’s Encrypt ile ücretsiz bir SSL sertifikası kurun (Websites & Domains > Let’s Encrypt).
2. Güvenlik Duvarı: Plesk’in güvenlik duvarında, uygulamanızın kullandığı portun (örneğin, 3000) açık olduğundan emin olun.
3. Dosya İzinleri: Proje dosyalarının doğru izinlere sahip olduğundan emin olun (genellikle 755 dizinler için, 644 dosyalar için).

Sonuç

Next.js uygulamanızı Plesk panelde çalıştırmak, doğru yapılandırma ile oldukça basittir. Yukarıdaki adımları takip ederek, projenizi production modunda sorunsuz bir şekilde deploy edebilir ve otomatik deployment ile güncellemeleri kolayca yönetebilirsiniz. Eğer ek sorularınız varsa veya daha fazla detaya ihtiyacınız varsa, Plesk’in resmi dokümantasyonunu veya destek forumlarını kontrol edebilirsiniz.

Bu makalemde anlamadığınız bir yer varsa da bana ulaşarak sorabilirsiniz.