Nucleus ile proje geliştirme - Proje altyapısını kurma ve çalıştırma - #Part1 - #tr

Bu yazıda github üzerinde open source olarak paylaşılan nucleus projesiyle nasıl uygulama yazabileceğimizi göstermek istiyorum.

Nucleus Nedir?

Nucleus, dotnet core ve vue.js ile geliştirilen açık kaynaklı bir proje altyapısıdır. Bu projeyi kullanarak yeni uygulamalar geliştirebilirsiniz. Başlangıç olarak kullanıcı yönetimi ve rol yönetimi için altyapı sağlar.

Aşağıdaki adresten projeyi inceleyebilir ve destek olabilirsiniz.

Projenin gereksinimleri yüklenmesi

Projenin çalışması için bazı gereksinimlerin yüklenmesi gerekiyor.

• Node.js
• Dotnet Core
• Docker
• Vs Code

Projeyi klonlayıp bilgisayarda açmak

Projeyi github üzerinden forklayıp kendi bilgisayarımıza yüklüyoruz. Terminal üzerinde aşağıdaki komutu çalıştırıp, kodları bilgisayarınıza indirebilirsiniz.

git clone https://github.com/eymel/Nucleus.git

Terminal üzerinden projenin dizinine gidiyoruz.

cd Nucleus/

Vs Code ile projeyi açıyoruz.

code .

Projeyi çalıştırma

Geliştirme yapmadan önce uygulamamızı çalıştırmak için aşağıdaki adımları izlememiz gerekiyor

Veritabanı kurulumu

Veritabanı için PostgreSQL yüklü olması gerekiyor. Bunu direk olarak indirebiliriz fakat biz docker kullanarak PostgresSQL'i bilgisayarımıza kuracağız.

docker-compose up -d postgres_image

Sonuç:

• docker-compose komutu bizim için docker-compose.yml dosyasındaki tanımları kullanarak container oluşturmamızı sağlıyor.

• Veritabanını yönetmek için pgAdmin uygulamasını indirebilirsiniz.

Api(dotnet core) Uygulamasının Çalıştırma

Eklenti kurulumu (sadece VsCode için)

Vs Code indirildiyse eğer dotnet core uygulamalarını çalıştırmak için eklenti kurmanız gerekiyor.

• C# for Visual Studio Code (powered by OmniSharp)

Uygulamanın veritabanını güncellemesi

Veritabanını güncellemek için dotnet-ef paketinin yüklü olması gerekiyor. Projenin ana dizininde aşağıdaki komutu çalıştırıyoruz.

dotnet tool install --global dotnet-ef --version 5.0.1

Sonuç:

Uygulamanın tablolarını oluşturma

Dotnet-ef yüklendikten sonra veritabanı içerisinde tabloları oluşturmamız gerekiyor.

cd src/Nucleus.EntityFramework/ && dotnet ef database update --startup-project ../Nucleus.Web.Api/Nucleus.Web.Api.csproj

Sonuç:

Api projesinin çalıştırılması

• Uygulamayı çalıştırmak için F5 tuşuna basmamız gerekiyor.

Sonuç:

Api projesinin test etmek

http://localhost:36222/swagger bu adresi tarayıcı üzerinden açtığımızda aşağıdaki ekranla karşılaşmamız gerekiyor.

Vue.js projesini çalıştırma

Vue.js projesini çalıştırmak için bilgisayarımızda node.js yüklü olması gerekiyor.

Gerekli paketlerin yüklenmesi

Projenin ana dizini içerisinden src/Nucleus.Web.Vue/ dizinine gitmemiz gerekiyor.

cd src/Nucleus.Web.Vue/

Projenin paketlerini yüklemek için yarn paket yöneticisini kullanıyoruz.

yarn install

Sonuç:

Vue.js projesinin çalıştırılması

Projeyi çalıştırmak için src/Nucleus.Web.Vue/ dizini içerisindeyken aşağıdaki komutu çalıştırıyoruz.

yarn serve

Sonuç:

Vue.js projesini test etme

http://localhost:8080 bu adresi tarayıcı üzerinden açtığımızda aşağıdaki ekranla karşılaşmamız gerekiyor.

Uygulamaya admin/123qwe bilgileriyle giriş yapabilirsiniz.

Not: Giriş yaparken sıkıntı yaşıyorsanız Api projesinin çalıştığından emin olmalısınız.

Sonuç

Projeyi kendi bilgisayarımıza indirdik ve çalıştırdık. Bir sonraki yazıda basit bir not defteri yapmaya çalışacağım.

Daha fazlası için Twitter ve Github üzerinden takip etmeyi unutmayın

Sevgiler