Daha \u00f6nce AppVeyor’u kullanmam\u0131\u015f arkada\u015flar i\u00e7in konuya ba\u015flamadan \u00f6nce belirtmek istiyorum ki, AppVeyor kullan\u0131m\u0131 open-source projeler i\u00e7in \u00fccretsizdir. Bu makale kapsam\u0131nda AppVeyor nedir, ne de\u011fildir gibi detaylara de\u011finmeyece\u011fimden dolay\u0131, merak eden arkada\u015flar buradan<\/a><\/em> inceleyebilirler.<\/p>\n Bir \u00e7o\u011fumuz gerek i\u015f yerlerimizde, gerekse de open source projelerimizde NuGet server \u00fczerinden paketlerimizi bir \u015fekilde y\u00f6netiyoruz. CI\/CD d\u00fcnyas\u0131n\u0131n h\u0131zla geli\u015fmesi ile birlikte, deployment\u00a0i\u015flemlerinin automated<\/strong> bir hale getirilmesi sizlerinde bildi\u011fi gibi bir \u00e7ok a\u00e7\u0131dan bizlere\u00a0h\u0131z ve zaman kazand\u0131rmaktad\u0131r.<\/p>\n En basitinden \u015fimdi ele alacak oldu\u011fumuz NuGet konusuna bakt\u0131\u011f\u0131m\u0131zda, e\u011fer herhangi bir CI arac\u0131 kullanm\u0131yor isek en basit haliyle:<\/p>\n gibi manuel s\u00fcre\u00e7ler\u00a0ger\u00e7ekle\u015ftiriyoruz.<\/p>\n AppVeyor ise bu ad\u0131mlar\u0131 bizim i\u00e7in automated bir hale getiriyor. Projeyi commit ettikten sonra ger\u00e7ekle\u015fen ad\u0131mlar ise:<\/p>\n ve bu s\u00fcre\u00e7lerin hepsi otomatik olarak i\u015fliyor. Ne kadar g\u00fczel de\u011fil mi? :)<\/p>\n \u0130\u015fin asl\u0131na bakt\u0131\u011f\u0131m\u0131zda her ne kadar \u00e7ok da fazla DevOps konular\u0131 ile i\u00e7li d\u0131\u015fl\u0131 olmasam da,\u00a0hayatlar\u0131m\u0131z\u0131 ne kadar da kolayla\u015ft\u0131rd\u0131klar\u0131 bir ger\u00e7ek!<\/p>\n Dilerseniz \u015fimdi\u00a0\u00f6rne\u011fimize ge\u00e7elim. Bunun i\u00e7in \u00f6ncelikle GitHub<\/strong> \u00fczerinde “ci-nuget-sample” isminde public bir repository olu\u015fturuyorum. Olu\u015fturmu\u015f\u00a0oldu\u011fumuz repository’i, a\u015fa\u011f\u0131daki gibi Visual Studio \u00fczerinden clone<\/strong> edelim.<\/p>\n Clone i\u015flemini tamamlad\u0131ktan sonra i\u00e7erisine “HelloService” isminde yeni bir class library olu\u015ftural\u0131m ve ard\u0131ndan i\u00e7erisine “HelloService” isminde bir class tan\u0131mlayal\u0131m. Bu class’\u0131n g\u00f6revi,\u00a0\u00e7a\u011f\u0131r\u0131ld\u0131\u011f\u0131nda “Hello!” demek olsun. :)<\/p>\n “HelloService” class’\u0131n\u0131 a\u015fa\u011f\u0131daki gibi kodlayal\u0131m.<\/p>\n \u015eimdi istiyoruz ki biz bu “HelloService” i, NuGet \u00fczerinden bir paket olarak sunal\u0131m.<\/p>\n \u00d6ncelikle\u00a0bir NuGet paketi olu\u015fturabilmemiz i\u00e7in NuGet spec file’\u0131n\u0131 tan\u0131mlamam\u0131z gerekmektedir. Bunun i\u00e7in “HelloService” library’si \u00fczerine sa\u011f t\u0131klay\u0131p “Add > New Item” penceresine geldikten sonra, “HelloService.nuspec” ad\u0131nda bir file olu\u015ftural\u0131m.<\/p>\n Olu\u015fturmu\u015f oldu\u011fumuz nuspec file’\u0131n\u0131 ise a\u015fa\u011f\u0131daki gibi\u00a0tan\u0131mlayaca\u011f\u0131z. Ben tan\u0131mlama s\u0131ras\u0131nda en yayg\u0131n kullan\u0131lan metadata element’lerini kullanmaya \u00e7al\u0131\u015faca\u011f\u0131m.\u00a0Tan\u0131mlama s\u0131ras\u0131nda sizlerde buray\u0131<\/a><\/em> referans alabilirsiniz.<\/p>\n Burada bulunan “id”, “version”, “description” ve “authors” alanlar\u0131 doldurulmas\u0131 gereken must alanlard\u0131r. Bunlar\u0131n d\u0131\u015f\u0131nda kalanlar ise opsiyonel olarak eklenebilmektedir. Burada dikkat ederseniz “version” k\u0131sm\u0131na value olarak “$version$” parametresini ekledim.\u00a0Versiyonlama i\u015flemini ilgili paketim i\u00e7in manuel olarak y\u00f6netmek yerine, AppVeyor’un\u00a0bu i\u015flemi otomatik olarak ger\u00e7ekle\u015ftirebilmesini sa\u011flam\u0131\u015f oluyoruz. (Bu i\u015flemin AppVeyor \u00fczerinden nas\u0131l handle edildi\u011fini ilerleyen k\u0131s\u0131mda g\u00f6rece\u011fiz)<\/p>\n Spec \u00fczerindeki “metadata” d\u0131\u015f\u0131nda “files” k\u0131sm\u0131na bakt\u0131\u011f\u0131m\u0131zda ise, olu\u015fturulacak olan NuGet paketinin i\u00e7erisinde hangi assembly’lerin\u00a0olaca\u011f\u0131n\u0131, nelerin\u00a0exclude edilece\u011fini\u00a0tan\u0131mlayabiliyoruz.<\/p>\n Bunlara ek olarak da e\u011fer paketimiz herhangi bir dependency’e ihtiyac\u0131 var ise, yine a\u015fa\u011f\u0131daki gibi tan\u0131mlayabilmek m\u00fcmk\u00fcnd\u00fcr:<\/p>\n NuGet\u00a0specification file’\u0131 art\u0131k haz\u0131r durumdad\u0131r.<\/p>\n Bu k\u0131s\u0131mda ise GitHub \u00fczerinde olu\u015fturmu\u015f oldu\u011fumuz “ci-nuget-sample” repository’sini, AppVeyor ile entegre \u00e7al\u0131\u015f\u0131r hale getirece\u011fiz. Yani repository \u00fczerine herhangi bir commit geldi\u011finde, otomatik olarak AppVeyor’un tetiklenmesini sa\u011flayaca\u011f\u0131z.<\/p>\n Bunun \u00f6ncesinde, \u00f6ncelikle buraya<\/a><\/em> t\u0131klayarak bir AppVeyor hesab\u0131 olu\u015ftural\u0131m. Hesab\u0131 olu\u015ftururken “Plan” sekmesinden “FREE – for open-source projects” se\u00e7ene\u011fini se\u00e7ebilirsiniz veya GitHub hesab\u0131n\u0131z var ise GitHub se\u00e7ene\u011fini t\u0131klayarak da GitHub hesab\u0131n\u0131z ile giri\u015f yapabilirsiniz. AppVeyor’a giri\u015f yapt\u0131ktan sonra “Projects” sekmesinden “New Project” e t\u0131klayarak, ben GitHub hesab\u0131m ile oturum a\u00e7t\u0131\u011f\u0131m i\u00e7in otomatik olarak GitHub repository’lerimi a\u015fa\u011f\u0131daki gibi getirdi.<\/p>\n Bu ekran \u00fczerinden \u00f6rne\u011fimiz i\u00e7in olu\u015fturmu\u015f oldu\u011fumuz “ci-nuget-sample” projesinin, sa\u011f taraf\u0131nda bulunan “ADD” se\u00e7ene\u011fine basal\u0131m.<\/p>\n Ekleme i\u015flemi ba\u015far\u0131l\u0131 bir \u015fekilde ger\u00e7ekle\u015ftikten sonra, a\u015fa\u011f\u0131daki gibi bir ekran\u0131 kar\u015f\u0131m\u0131za getirecektir.<\/p>\n Ger\u00e7ekle\u015ftirdi\u011fimiz bu i\u015flem ile AppVeyor, GitHub \u00fczerindeki “ci-nuget-sample” projemizin webhook k\u0131sm\u0131na kendisini default olarak\u00a0eklemektedir. Emin olmak\u00a0i\u00e7in ise GitHub \u00fczerindeki repository’nin “Settings” sekmesinden, “Webhooks” k\u0131sm\u0131na girelim.<\/p>\n Yukar\u0131da g\u00f6rd\u00fc\u011f\u00fcm\u00fcz gibi “https:\/\/ci.appveyor.com\/api\/github\/webhook” url’i ile kendisini eklemi\u015f bulunmaktad\u0131r.<\/p>\n Trigger ayarlar\u0131n\u0131 de\u011fi\u015ftirebilmek i\u00e7in ise, “Edit” butonuna basal\u0131m.<\/p>\n Yukar\u0131da bulunan\u00a0“Payload URL” k\u0131sm\u0131nda AppVeyor’un projeniz i\u00e7in vermi\u015f oldu\u011fu URL yer almaktad\u0131r. E\u011fer AppVeyor otomatik olarak webhook ayar\u0131n\u0131 yapmam\u0131\u015f olsayd\u0131, GitHub repository setting’i \u00fczerinden yine “WebHooks” sekmesinden “New WekHook” diyerek, “Payload URL” i girmemiz ve trigger ayar\u0131n\u0131 se\u00e7memiz yeterli olacakt\u0131. Biraz a\u015fa\u011f\u0131ya bakt\u0131\u011f\u0131m\u0131zda bulunan “Let me select individual events.” ayarlar\u0131ndan ise, hangi event’lar do\u011frultusunda\u00a0AppVeyor’un trigger olmas\u0131n\u0131 istedi\u011fimizi se\u00e7ebilmekteyiz. Burada AppVeyor taraf\u0131ndan default olarak “Pull request” ve “Push” event’leri se\u00e7ili olarak gelmektedir.<\/p>\n “Pull request” event’\u0131n\u0131n g\u00fczel taraf\u0131 ise herhangi bir brach’e bir pull request geldi\u011finde, merge i\u015flemini ger\u00e7ekle\u015ftirmeden hemen \u00f6nce AppVeyor taraf\u0131ndan otomatik olarak build ediliyor ve merge i\u015flemini ger\u00e7ekle\u015ftirirseniz ne ile kar\u015f\u0131la\u015fabilece\u011finizi g\u00f6rebiliyorsunuz.<\/p>\n Biz \u00f6rne\u011fimiz gere\u011fi sadece master branc’i \u00fczerinden ilerleyece\u011fiz. GitHub \u00fczerindeki ayarlar\u0131m\u0131z tamamland\u0131\u011f\u0131na g\u00f6re, hen\u00fcz kodumuzu commit etmeden birde AppVeyor \u00fczerindeki ayarlara bir g\u00f6z atal\u0131m. Bunun i\u00e7in AppVeyor \u00fczerindeki “SETTINGS” sekmesine gelelim.<\/p>\n \u0130lk olarak “Next build number” k\u0131sm\u0131ndan bir sonraki build’in hangi numaraya sahip olaca\u011f\u0131n\u0131 ayarlayabiliyorsunuz ve bu build number, versiyon numaras\u0131 olarak da kullan\u0131labilmekte. Hat\u0131rlarsan\u0131z NuGet spec tan\u0131mlarken version sekmesine “$version$” olarak bir parametre vermi\u015ftik. \u0130\u015fte bu parametreyi AppVeyor deployment a\u015famas\u0131nda, “Build version format” k\u0131sm\u0131nda belirtmi\u015f oldu\u011funuz format’a g\u00f6re bir versiyon numaras\u0131 set etmektedir. Bunun d\u0131\u015f\u0131nda di\u011fer bir \u00f6nemli k\u0131s\u0131m ise “Branches to build” k\u0131sm\u0131d\u0131r. Biz burada build i\u015flemi sonras\u0131 otomatik olarak NuGet paketi olu\u015fturup publish\u00a0edece\u011fimiz i\u00e7in, “All branches” se\u00e7ene\u011fi yerine “Only branches specified below” k\u0131sm\u0131n\u0131 se\u00e7erek buraya master branch’i belirtmek gerekiyor. \u015euanda \u00f6rne\u011fimiz gere\u011fi tek bir branch’e sahip oldu\u011fumuz i\u00e7in, pek bir \u00f6nemi bulunmamaktad\u0131r.<\/p>\n A\u015fa\u011f\u0131 k\u0131s\u0131mdaki se\u00e7eneklere bakt\u0131\u011f\u0131m\u0131zda ise burada belki kullanabilece\u011finiz “Ignore appveyor.yml” se\u00e7ene\u011fi olabilir. AppVeyor \u00fczerinde build ve deployment tarz\u0131 i\u015flemlerinizi, “yml” format\u0131nda bir file haz\u0131rlayarak da ger\u00e7ekle\u015ftirebilirsiniz. E\u011fer bu tarz i\u015flemlerin\u00a0d\u0131\u015far\u0131dan eri\u015filmesini istemiyorsan\u0131z, ignore se\u00e7ene\u011fini se\u00e7erek sadece aray\u00fcz \u00fczerindeki ayarlar ile ger\u00e7ekle\u015febilmesini sa\u011flayabilirsiniz.<\/p>\n Bunlar\u0131n d\u0131\u015f\u0131nda di\u011fer script alanlar\u0131 ile ilgili \u015fuan i\u00e7in bir ihtiyac\u0131m\u0131z yok.<\/p>\n \u015eimdi geldi art\u0131k build k\u0131s\u0131mlar\u0131n\u0131 ayarlamaya. Hemen sol sekmeden “Build” k\u0131sm\u0131na ge\u00e7elim.<\/p>\n Burada \u00fcst se\u00e7eneklerden “MSBUILD” se\u00e7ili oldu\u011fundan emin olal\u0131m. Bunun ard\u0131ndan “Configuration” k\u0131sm\u0131ndan build i\u015flemi ger\u00e7ekle\u015firken “Debug” m\u0131 yoksa “Release” konfig\u00fcrasyonunun mu kullan\u0131laca\u011f\u0131n\u0131 belirtece\u011fiz. Yukar\u0131da g\u00f6rd\u00fc\u011f\u00fcm\u00fcz gibi buraya “Release” yazal\u0131m.<\/p>\n Sayfan\u0131n\u00a0alt k\u0131s\u0131m\u0131ndaki ayarlara bakt\u0131\u011f\u0131m\u0131zda ise burada “Before build script” k\u0131sm\u0131n\u0131 “CMD” se\u00e7elim ve buraya a\u015fa\u011f\u0131daki gibi “nuget restore” command’\u0131n\u0131 yazal\u0131m. Bu command sayesinde proje build olurken, kulland\u0131\u011f\u0131m\u0131z herhangi bir NuGet paketleri varsa otomatik olarak restore olacakt\u0131r.<\/p>\n “After build script” k\u0131sm\u0131nda ise, “PS” k\u0131sm\u0131n\u0131 se\u00e7elim ve buraya yukar\u0131da oldu\u011fu gibi a\u015fa\u011f\u0131daki PowerShell Script’ini yazal\u0131m.<\/p>\n Bu script ile k\u0131saca nuspec file’\u0131n\u00a0path’ini belirterek, versiyon numaras\u0131n\u0131 environment \u00fczerinden “APPVEYOR_BUILD_VERSION” parametresi ile almas\u0131n\u0131 ve ard\u0131ndan bir “*.nupkg” file’\u0131 olu\u015fturup\u00a0onu\u00a0push etmesini s\u00f6yl\u00fcyoruz.<\/p>\n \u015eimdi geriye sadece deployment ayarlar\u0131 kald\u0131. Sol men\u00fcden h\u0131zl\u0131ca “Deployment” sekmesine ge\u00e7elim ve a\u015fa\u011f\u0131daki gibi NuGet ayarlar\u0131n\u0131 yapmaya ba\u015flayal\u0131m.<\/p>\n \u0130lk olarak a\u00e7\u0131lan ekran\u0131n providers b\u00f6l\u00fcm\u00fcnden, “Add deployment” a t\u0131klayarak NuGet provider’\u0131n\u0131 se\u00e7elim.<\/p>\n Bu k\u0131s\u0131mda biz direkt olarak nuget.org<\/a>\u00a0<\/em>\u00fczerine publish edece\u011fimiz i\u00e7in, bu k\u0131sm\u0131 bo\u015f b\u0131rak\u0131yoruz. Burada yapmam\u0131z gereken ilk \u015fey kendimize bir NuGet hesab\u0131 olu\u015fturup, “API key” bilgisini buraya girmektir. NuGet \u00fcyeli\u011fini ise buradan<\/a><\/em> ger\u00e7ekle\u015ftirebilirsiniz. \u00dcyelik i\u015flemini tamamlad\u0131ktan sonra, “Accounts” sayfas\u0131 alt\u0131nda bulunan “Credentials” sekmesinden “API Keys” bilgisine ula\u015fabilirsiniz.<\/p>\n API key’ini ald\u0131ktan sonra AppVeyor \u00fczerindeki “API key” b\u00f6l\u00fcm\u00fcne girelim ve ard\u0131ndan, “Do not publish symbol packages” se\u00e7ene\u011fini se\u00e7elim. Daha sonra “Deploy from branch” se\u00e7ene\u011fini se\u00e7erek a\u00e7\u0131lan alana ilgili branch ad\u0131n\u0131 yazal\u0131m ve art\u0131k ayarlar\u0131 kaydedelim.<\/p>\n Bu ad\u0131mlar\u0131n\u00a0ard\u0131ndan deployment k\u0131sm\u0131n\u0131n son hali ise a\u015fa\u011f\u0131daki gibi olacakt\u0131r.<\/p>\n GitHub’a commit i\u015flemi i\u00e7in Visual Studio’ya art\u0131k geri d\u00f6nebiliriz. E\u011fer herhangi eksik bir \u015fey yapmad\u0131 ise, HelloService’i commit etti\u011fimiz an NuGet \u00fczerinde bir paket haline gelecektir. :)<\/p>\n Commit i\u015fleminin ard\u0131ndan AppVeyor \u00fczerinden “LATEST BUILD” sekmesine gelelim ve ilgili commit’in buraya gelip build i\u015flemi i\u00e7in queue’ya al\u0131nd\u0131\u011f\u0131n\u0131 g\u00f6rebiliriz.<\/p>\n Build i\u015flemi burada k\u0131sa bir s\u00fcre i\u00e7erisinde ba\u015flayacakt\u0131r ve ba\u015flad\u0131\u011f\u0131nda ise a\u015fa\u011f\u0131daki gibi bir ekranla kar\u015f\u0131la\u015faca\u011f\u0131z.<\/p>\n Burada dikkat edersek AppVeyor’da ilk build numaram\u0131z “1” oldu\u011fu i\u00e7in, ayarlam\u0131\u015f oldu\u011fumuz version format’\u0131 do\u011frultusunda ilk versiyonu “1.0.1” olarak belirlemi\u015ftir. AppVeyor, GitHub \u00fczerinden belirtmi\u015f oldu\u011fumuz master branch’ini \u00e7ekerek, build i\u015flemi s\u0131ras\u0131nda “nuget restore” i\u015flemini de ger\u00e7ekle\u015ftirmi\u015ftir. Sonras\u0131nda ise tan\u0131mlam\u0131\u015f oldu\u011fumuz nuspec file’\u0131n\u0131 kullanarak, “HelloService.1.0.1.nupkg” paketini\u00a0olu\u015fturmu\u015ftur ve\u00a0NuGet’e publish i\u015flemini ba\u015far\u0131yla ger\u00e7ekle\u015ftirmi\u015ftir.<\/p>\n \u015eimdi NuGet hesab\u0131m\u0131z \u00fczerinden “Manage My Packages” k\u0131sm\u0131na girerek, buradan HelloService paketini se\u00e7elim ve detaylar\u0131na bir bakal\u0131m.<\/p>\n Evet! Paketimiz “HelloService” ismi ile ve “1.0.1” versiyon numaras\u0131 ile ba\u015far\u0131l\u0131 bir \u015fekilde NuGet \u00fczerinde yerini alm\u0131\u015f bulunmaktad\u0131r.<\/p>\n Her ne kadar farkl\u0131 bir alana de\u011finmi\u015f olsam da, eminim\u00a0sizlerinde bir \u00e7ok konuda i\u015fine yarayacakt\u0131r. Konuyu burada sonland\u0131rmadan \u00f6nce son bir \u015fey daha eklemek istiyorum. GitHub’da bulunan baz\u0131 projeler \u00fczerinde sizlerde g\u00f6rm\u00fc\u015fs\u00fcn\u00fczd\u00fcr “build passing” veya “nuget package 1.0.0” gibi versiyon numaralar\u0131n\u0131n\u00a0g\u00f6rsellerini. Kendi paketim \u00fczerinden \u00f6rnek vermek gerekirse:<\/p>\n Burada AppVeyor logosu ile g\u00f6rd\u00fc\u011f\u00fcm\u00fcz “build passing” ve nuget package versiyonlar\u0131 gibi g\u00f6rselleri ekleyebilmek i\u00e7in, AppVeyor’da “Settings” sekmesinin alt\u0131nda bulunan “Badges” k\u0131sm\u0131na girelim.<\/p>\n![\"\"](\"\/wp-content\/uploads\/2017\/02\/appveyor-logo.jpg\"){kind=logo}
<\/a><\/p>\n\n
\n
<\/a><\/p>\nnamespace HelloService\r\n{\r\n public class HelloService\r\n {\r\n public string SayHello()\r\n {\r\n return \"Hello!\";\r\n }\r\n }\r\n}<\/pre>\nNuGet\u00a0Specification Olu\u015fturma<\/h4>\n
\r\n\r\n \r\n HelloService\r\n $version$\r\n HelloService\r\n G\u00f6khan G\u00f6kalp\r\n G\u00f6khan G\u00f6kalp\r\n https:\/\/github.com\/GokGokalp\/ci-nuget-sample\r\n false\r\n Say hello!\r\n Copyright 2017 G\u00f6khan G\u00f6kalp\r\n Hello Service\r\n \r\n \r\n \r\n \r\n<\/pre>\n
\r\n \r\n \r\n<\/pre>\n
AppVeyor ile GitHub Entegrasyonu<\/h4>\n
<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\nnuget pack HelloService\\HelloService.nuspec -version $env:APPVEYOR_BUILD_VERSION\r\nGet-ChildItem .\\*.nupkg | % { Push-AppveyorArtifact $_.FullName -FileName $_.Name }<\/pre>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n<\/a><\/p>\n