Ubuntu .NET Core kurulumu ve Swagger ile API oluşturulması

Önceki yazıda swagger-codegen kurulumunu gerçekleştirdik

Aşağıdaki sayfadan kendi sisteminiz için gerekli kurulumu gerçekleştirebilirsiniz

https://dotnet.microsoft.com/download/linux-package-manager/ubuntu18-04/sdk-current

Ubuntu 18.04 kullandığım için aşağıdaki şekilde kurulumu gerçekleştiriyorum

wget -q https://packages.microsoft.com/config/ubuntu/18.04/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb sudo add-apt-repository universe

sudo apt-get install apt-transport-https
sudo apt-get update
sudo apt-get install dotnet-sdk-2.2

dotnet help komutunu yazdığızda aşağıdaki çıktıyı alıyorsanız kurulum tamamdır. Aşağıda başka komutlar daha var listelenen ama ekran görüntüsünde bu kadarını alabildim.

 Şimdi aşağıdaki komutla örnek bir swagger projesi olan petstore kullanarak apiyi oluşturalım.

swagger-codegen generate -i http://petstore.swagger.io/v2/swagger.json -l aspnetcore -o api

Komutu çalıştırdığınızda aşağıdaki logları göreceksiniz

-i swagger dosyasının dosya yolu ya da adresi

-l projeyi hangi platformda oluşturmak istiyorsanız burada onun anahtar değerini belirtmelisiniz.

Desteklenen platformları görmek için swagger-codegen yazabilirsiniz

Projenin oluşturulduğu dizine girdiğinizde README.md dosyasında hangi platformda çalışıyorsanız onun için projeyi nasıl çalışır duruma getireceğinizi görebilirsiniz. Docker kullanımına sonraki yazıda geleceğiz.

Çalıştıracağımız komut linux bir sistem üzerinde çalıştığımız için

sh build.sh

Komut tamamlandığında aşağıdaki çıktıyı göreceksiniz

Now, run the following to start the project: 

dotnet run -p src/IO.Swagger/IO.Swagger.csproj --launch-profile web

Bu komutu çalıştırdığınızda proje 5000 portundan çalışır duruma geçer.

Bir sunucu üzerinde çalışıyorsanız adres satırına sunucu ip adresi:5000 şeklinde yazdığınızda sayfanın çalışmadığını göreceksiniz. Bir tanımlama yapmanız gerekiyor bu şekilde çalışması için

src/IO.Swagger/Program.cs dosyasında aşağıdaki eklemeyi yapmanız gerekiyor. Yıldızlı kısma sunucu ip adresinizi yazmanız yeterli. Portu başka açık bir port ile istiyorsanız değiştirebilirsiniz.

public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseUrls("http://*:5000/")
                .UseStartup<Startup>()
                .Build();

Daha fazla bilgi için: https://andrewlock.net/configuring-urls-with-kestrel-iis-and-iis-express-with-asp-net-core/

Adresi çağırdığınızda aşağıdaki gibi bir sayfa karşınıza çıkacak

Herhangi bir apiyle deneme yapmanız durumunda bir geri dönüş alamayacaksınız çünkü sonraki adım veritabanını bağlamak ve servis kodlarını geliştirmek. Sonraki yazıda görüşmek üzere.