<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Salimcan Karadeniz on Medium]]></title>
        <description><![CDATA[Stories by Salimcan Karadeniz on Medium]]></description>
        <link>https://medium.com/@salimcankaradeniz?source=rss-5285eada9698------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*k7uACRZ7Vw3fG2uASrwC7g.jpeg</url>
            <title>Stories by Salimcan Karadeniz on Medium</title>
            <link>https://medium.com/@salimcankaradeniz?source=rss-5285eada9698------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 22:24:09 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@salimcankaradeniz/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[.NET Projesi için GitHub Actions CI/CD Pipeline]]></title>
            <link>https://medium.com/@salimcankaradeniz/net-projesi-i%C3%A7in-github-actions-ci-cd-pipeline-2d5acc5bbdd9?source=rss-5285eada9698------2</link>
            <guid isPermaLink="false">https://medium.com/p/2d5acc5bbdd9</guid>
            <category><![CDATA[devops]]></category>
            <category><![CDATA[github]]></category>
            <category><![CDATA[kafka]]></category>
            <category><![CDATA[dotnet]]></category>
            <category><![CDATA[docker]]></category>
            <dc:creator><![CDATA[Salimcan Karadeniz]]></dc:creator>
            <pubDate>Thu, 30 Apr 2026 09:09:21 GMT</pubDate>
            <atom:updated>2026-04-30T09:09:21.979Z</atom:updated>
            <content:encoded><![CDATA[<p>Her yazılım geliştiricinin hayatında bir an gelir: kodu yazdın, test ettin, çalışıyor. Şimdi sıra deploy’da. Ama deploy süreci uzun, elle yapılan adımlarla dolu ve hata yapmaya açık. Bir adımı unutsan ya da yanlış sırayla yapsan sistem çöküyor.</p><p>Şöyle bir senaryo düşünün: Kafka entegrasyonlu .NET projenizde yeni bir özellik geliştirdiniz. Producer’a yeni bir endpoint eklediniz, Consumer’a yeni bir işleme mantığı yazdınız. Şimdi production’a almanız gerekiyor.</p><p>Elle yapılan deploy akışı şöyle görünür:</p><ol><li>dotnet build çalıştır, hata yok mu kontrol et.</li><li>dotnet test çalıştır, testler geçiyor mu kontrol et.</li><li>Producer için Docker İmage oluştur.</li><li>Consumer için Docker İmage oluştur.</li><li>İki image’ı da Docker Hub’a pusla.</li><li>Sunucu da imageleri çek ve yeniden başlat</li></ol><p>Haftada birkaç kez deploy yapıyorsanız bu adımları kaç kez tekrar ettiğinizi bir düşünün. CI/CD tam olarak bu sorunu çözer.</p><p>Bu makalede, daha önce geliştirdiğimiz <a href="https://github.com/SalimcanKaradeniz/NetCoreKafkaIntegation"><strong>Apache Kafka + .NET 10 </strong></a>projesine <strong>Github Actions </strong>ile eksiksiz bir CI/CD pipeline ekleyeceğiz. Sıfırdan başlayıp her kavramı açıklamaya çalışacağım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*UwtzI5UuQ3F39FArOpMYEQ.jpeg" /></figure><p><strong>CI/CD Nedir? Neden Gereklidir?</strong></p><p>CI/CD iki kavramın birleşimidir:</p><p><strong>CI — Continuous Integration(Sürekli Entegrasyon):</strong></p><p>Kod her pushlandığında otomatik olarak build alınır ve testler çalışır. “Bu kod çalışıyor mu?” sorusunu pipeline otomatik olarak cevaplar.Çalışmayan kodlar veya testten geçmeyen kodlar main/master branch’e hiç ulaşmaz.</p><p><strong>CD — Continuous Delivery/Deployment(Sürekli Teslimat) :</strong></p><p>CI’da testler başarılıysa kod otomatik olarak paketlenir, image oluşturulur ve deploy edilecek hub’a/ortama gönderilir.</p><p><strong>Temel kural şu test geçmeden deploy olmaz.</strong></p><p><strong>Github Actions Nedir?</strong></p><p>GitHub Actions, GitHub’ın yerleşik CI/CD aracıdır. Ayrı bir platform kurmanıza, lisans almanıza ya da ekstra konfigürasyon yapmanıza gerek kalmaz. GitHub’da bir repository’niz varsa Actions kullanıma hazırdır.</p><p>Çalışma mantığı şu şekilde : <strong>.github/workflows</strong> klasöründe bir <strong>.yaml</strong> dosyası koyarsınız. GitHub bu dosyayı okur ve belirttiğiniz koşullar gerçekleştiğinde pipeline başlar.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Zv9UIebDGCNfiaB06IcwjQ.jpeg" /></figure><p>Dört temel kavram vardır:</p><ul><li><strong>Workflow :</strong> YAML dosyasının kendisi. Ne zaman, ne yapılsın? sorusunu cevaplar.</li><li><strong>Job :</strong> Workflow içindeki iş birimi. Her job ayrı ve temiz bir sanal makine de çalışır.</li><li><strong>Step :</strong> Job içindeki adımlar. Ya hazır bir action kullanır ya da shell komutu çalıştırır.</li><li><strong>Runner :</strong> Pipeline’ın çalıştığı sanal makine. Public repo’larda ücretsiz ayda 2.000 dakika.</li></ul><p>GitHub Actions’ın en güçlü özelliği <strong>needs: </strong>direktifidir. Bir job’ın bir başkasına bağımlı olduğunu söylediğinizde, bağımlı olunan bir job başarısız olursa bağımlı job hiç başlamaz. Bu sayede hatalı/testten geçmemiş olan kod asla deploy edilmez.</p><p><strong>Proje yapısına Dockerfile Ekleme :</strong></p><p>Pipeline Docker image oluşturabilmesi için her servis için bir Dockerfile gerekiyor. .NET projesinde <strong>iki aşamalı build(multi-stage build)</strong> kullanıyoruz. İlk aşamada SDK image’ı ile build ve publish alıyoruz, ikinci aşamada sadece runtime image’ına publish çıktısını kopyalıyoruz.</p><p>Bu yaklaşımın iki büyük avantajı var. Birincisi final image boyutu dramatik şekilde küçülür. SDK image ~750MB iken runtime image ~220MB. İkincisi kaynak kodunuz, compiler’ınız ve build araçlarınız final image’da yer almaz, bu da güvenlik açısından kritiktir.</p><p><strong>Producer DockerFile :</strong></p><pre>FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build<br>WORKDIR /src<br><br># Once proje dosyalarini kopyala — Docker layer cache icin<br>COPY KafkaDemo.Contracts/KafkaDemo.Contracts.csproj KafkaDemo.Contracts/<br>COPY KafkaDemo.Producer/KafkaDemo.Producer.csproj KafkaDemo.Producer/<br>RUN dotnet restore KafkaDemo.Producer/KafkaDemo.Producer.csproj<br><br># Kaynak kodu kopyala ve publish al<br>COPY KafkaDemo.Contracts/ KafkaDemo.Contracts/<br>COPY KafkaDemo.Producer/ KafkaDemo.Producer/<br>RUN dotnet publish KafkaDemo.Producer/KafkaDemo.Producer.csproj \<br>    -c Release -o /app/publish<br><br>FROM mcr.microsoft.com/dotnet/aspnet:10.0 AS runtime<br>WORKDIR /app<br>COPY --from=build /app/publish .<br>ENTRYPOINT [&quot;dotnet&quot;, &quot;KafkaDemo.Producer.dll&quot;]</pre><p>Consumer Dockerfile’de aynı yapıda, sadece proje adı ve <strong>ENTRYPOINT </strong>farklı. Consumer bir <strong>Worker Service </strong>olduğu için <strong>aspnet </strong>yerine<strong> runtime </strong>image kullanılır<strong>.</strong></p><p><strong>Consumer DockerFile :</strong></p><pre>FROM mcr.microsoft.com/dotnet/sdk:10.0 AS build<br>WORKDIR /src<br><br>COPY KafkaDemo.Contracts/KafkaDemo.Contracts.csproj KafkaDemo.Contracts/<br>COPY KafkaDemo.Consumer/KafkaDemo.Consumer.csproj KafkaDemo.Consumer/<br>RUN dotnet restore KafkaDemo.Consumer/KafkaDemo.Consumer.csproj<br><br>COPY KafkaDemo.Contracts/ KafkaDemo.Contracts/<br>COPY KafkaDemo.Consumer/ KafkaDemo.Consumer/<br>RUN dotnet publish KafkaDemo.Consumer/KafkaDemo.Consumer.csproj \<br>    -c Release -o /app/publish<br><br>FROM mcr.microsoft.com/dotnet/runtime:10.0 AS runtime<br>WORKDIR /app<br>COPY --from=build /app/publish .<br>ENTRYPOINT [&quot;dotnet&quot;, &quot;KafkaDemo.Consumer.dll&quot;]</pre><p><strong>Önemli bir optimazasyon proje dosyalarını önce kopyalamak :</strong></p><p>Dockerfile’da önce sadece <strong>.csproj </strong>dosyalarını kopyalayıp restore yapıyoruz, sonra kaynak kodun geri kalanını kopyalıyoruz. Bunun sebebi Docker’ın katman cache mekanizmasıdır. Bağımlılıklar değişmediği sürece Docker restore adımını cache’ten alır ve build süresi önemli derece kısalır.</p><p><strong>GitHub Secrets — Şifreleri Güvenli Saklamak :</strong></p><p>Pipeline’ın Docker Hub’a image push edebilmesi için kullanıcı adı ve token bilgisi gerekiyor. Bu bilgileri asla YAML dosyasına yazmayız. GitHub’a pushlanır ve herkes tarafından görülür. Bunun yerine <strong>GitHub Secrets </strong>kullanacağız. Secrets eklemek için <strong>GitHub repo sayfanızda Settings → Secrets and Variables -&gt; Actions -&gt; New Repository Secret </strong>yolu üzerinden ekleyebilirsiniz.</p><ul><li>DOCKERHUB_USERNAME — Docker Hub kullanıcı adınız.</li><li>DOCKERHUB_TOKEN — <strong>Docker Hub -&gt; Account Settings -&gt; Personal Access Token -&gt; Generate(Read&amp;Write izini ile)</strong></li></ul><p><strong>CI/CD Pipeline :</strong></p><p>Projenizde .github/workflows/ci-cd.yml dosyasını oluşturun:</p><pre>name: KafkaDemo CI/CD<br><br>on:<br>  push:<br>    branches: [master]<br>  pull_request:<br>    branches: [master]<br><br>env:<br>  DOTNET_VERSION: &#39;10.0.x&#39;<br>  PRODUCER_IMAGE: ${{ secrets.DOCKERHUB_USERNAME }}/kafkademo-producer<br>  CONSUMER_IMAGE: ${{ secrets.DOCKERHUB_USERNAME }}/kafkademo-consumer<br><br>jobs:<br><br>  ci:<br>    name: Build &amp; Test<br>    runs-on: ubuntu-latest<br>    steps:<br>      - name: Checkout<br>        uses: actions/checkout@v4<br><br>      - name: .NET kurulumu<br>        uses: actions/setup-dotnet@v4<br>        with:<br>          dotnet-version: ${{ env.DOTNET_VERSION }}<br><br>      - name: Restore<br>        run: dotnet restore KafkaDemo.slnx<br><br>      - name: Build<br>        run: dotnet build KafkaDemo.slnx --no-restore -c Release<br><br>      - name: Test<br>        run: dotnet test KafkaDemo.slnx --no-build -c Release --verbosity normal<br><br>  cd:<br>    name: Docker Build &amp; Push<br>    runs-on: ubuntu-latest<br>    needs: ci<br>    if: github.ref == &#39;refs/heads/master&#39; &amp;&amp; github.event_name == &#39;push&#39;<br>    steps:<br>      - name: Checkout<br>        uses: actions/checkout@v4<br><br>      - name: Docker Hub Login<br>        uses: docker/login-action@v3<br>        with:<br>          username: ${{ secrets.DOCKERHUB_USERNAME }}<br>          password: ${{ secrets.DOCKERHUB_TOKEN }}<br><br>      - name: Image metadata - Producer<br>        id: metadata-producer<br>        uses: docker/metadata-action@v5<br>        with:<br>          images: ${{ env.PRODUCER_IMAGE }}<br>          tags: |<br>            type=raw,value=latest<br>            type=sha,prefix=sha-<br><br>      - name: Image metadata - Consumer<br>        id: metadata-consumer<br>        uses: docker/metadata-action@v5<br>        with:<br>          images: ${{ env.CONSUMER_IMAGE }}<br>          tags: |<br>            type=raw,value=latest<br>            type=sha,prefix=sha-<br><br>      - name: Producer - Build &amp; Push<br>        uses: docker/build-push-action@v5<br>        with:<br>          context: .<br>          file: KafkaDemo.Producer/Dockerfile<br>          push: true<br>          tags: ${{ steps.metadata-producer.outputs.tags }}<br><br>      - name: Consumer - Build &amp; Push<br>        uses: docker/build-push-action@v5<br>        with:<br>          context: .<br>          file: KafkaDemo.Consumer/Dockerfile<br>          push: true<br>          tags: ${{ steps.metadata-consumer.outputs.tags }}<br><br>      - name: Özet<br>        run: |<br>          echo &quot;## Deploy Özeti&quot; &gt;&gt; $GITHUB_STEP_SUMMARY<br>          echo &quot;Producer: ${{ env.PRODUCER_IMAGE }}:latest&quot; &gt;&gt; $GITHUB_STEP_SUMMARY<br>          echo &quot;Consumer: ${{ env.CONSUMER_IMAGE }}:latest&quot; &gt;&gt; $GITHUB_STEP_SUMMARY<br>          echo &quot;Commit: ${{ github.sha }}&quot; &gt;&gt; $GITHUB_STEP_SUMMARY</pre><ul><li><strong>CI Job : </strong>Ubuntu latest üzerinde çalışır. Kodu indirir, .NET kurar restore yapar, build alır ve testleri çalıştırır. Tek bir test bile başarısız olursa job fail olur ve CD hiç başlamaz.</li><li><strong>CD Job : needs:ci </strong>ile CI’a bağımlıdır. Yalnızca <strong>master </strong>branch’e direkt push geldiğinde çalışır. Pull Requestlerde <strong>CD</strong> çalışmaz, sadece <strong>CI</strong> çalışır.</li><li><strong>Image Tagging : </strong>Her başarılı build’de iki tag oluşturulur <strong>:latest </strong>(her zaman en son versiyonu gösterir) ve <strong>:sha-428639e</strong> gibi commit SHA tag’i(belirli bir versiyona geri dönmek için). Bu strateji production’da hayat kurtarır.</li></ul><pre># Sorunlu deploy sonrasi rollback<br>docker pull kullaniciadı/kafkademo-producer:sha-428639e<br>docker run kullaniciadı/kafkademo-producer:sha-428639e</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zMQ38EjLW9nLHy2EAlagaw.jpeg" /></figure><p><strong>Pipeline Çalıştığında Ne Görürsünüz?</strong></p><p>Git push yaptıktan sonra GitHub repo sayfanızda <strong>Actions</strong> sekmesine gidin. Pipeline’ın çalıştığını göreceksiniz. Yaklaşık 3–5 dakika içinde:</p><ul><li>CI job tamamlanır — build ve testler geçti</li><li>CD job başlar — Docker image’lar oluşturulur</li><li>Docker Hub’da iki yeni image belirir</li></ul><p>Her step’in üzerine tıklayarak detaylı logları görebilirsiniz. Test başarısızlıklarını, build hatalarını, Docker push sonuçlarını ayrıntılı olarak takip edebilirsiniz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*tMtiIGtUTf9oozAeQBAMZQ.png" /></figure><p>GitHub’ta Actions sayfasında build adımı ve push adımlarını takip edebilir içeriğine tıkladığınızda detaylı logları görüntüleyebilirsiniz.</p><p>Bu makalede sıfırdan başlayarak <a href="https://github.com/SalimcanKaradeniz/NetCoreKafkaIntegation">Kafka ve .NET</a> projemize eksiksiz bir CI/CD pipeline ekledik. Artık her <strong><em>git push master</em></strong> komutundan sonra şunlar otomatik gerçekleşiyor: kod build ediliyor, testler çalışıyor, Docker image’ları oluşturuluyor ve Docker Hub’a push’lanıyor.</p><p>Makaleyi faydalı bulduysanız takip ederek destek olabilirsiniz 🙏</p><ul><li><a href="https://github.com/SalimcanKaradeniz/NetCoreKafkaIntegation">GitHub - SalimcanKaradeniz/NetCoreKafkaIntegation</a></li><li><a href="https://medium.com/@salimcankaradeniz">Salimcan Karadeniz - Medium</a></li></ul><p>Bir sonraki yazıda görüşmek üzere 😊</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=2d5acc5bbdd9" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Kafka Nedir? .NET Core İle Kafka Kullanımı]]></title>
            <link>https://medium.com/@salimcankaradeniz/kafka-nedir-net-core-i%CC%87le-kafka-kullan%C4%B1m%C4%B1-2909600f5455?source=rss-5285eada9698------2</link>
            <guid isPermaLink="false">https://medium.com/p/2909600f5455</guid>
            <category><![CDATA[software-architecture]]></category>
            <category><![CDATA[net-core]]></category>
            <category><![CDATA[kafka]]></category>
            <category><![CDATA[rabbitmq]]></category>
            <category><![CDATA[event-driven-architecture]]></category>
            <dc:creator><![CDATA[Salimcan Karadeniz]]></dc:creator>
            <pubDate>Tue, 14 Apr 2026 07:31:32 GMT</pubDate>
            <atom:updated>2026-04-14T07:36:59.081Z</atom:updated>
            <content:encoded><![CDATA[<p>Selamlar,</p><p>Bugün ki makalemiz de Kafka nedir? Ne zaman kullanmalıyız? RabbitMQ ile arasında ki farklar nelerdir? Kafka nasıl kurulur? konularına değinip .NET ile örnek proje yaparak bu konuları pekiştireceğiz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*pYeTRl6iCVPHd48ycHrtpg.gif" /></figure><h3><strong>Apache Kafka :</strong></h3><p>Yazılım geliştirmenin belirli bir noktasında, her geliştirici aynı soruyla yüzleşir: “Sistemin bir parçası bir olayı tetiklediğinde, diğer parçalar bunu nasıl öğrenecek?” akla gelen en basit çözüm servisleri birbirleri ile doğrudan bağlamaktır. Sipariş servisi oluştuğunda stok servisini çağırır, stok servisi bildirim servisini çağırır ve bir süre sonra elimizde, her parçanın her diğer parçayı tanıdığı, kırılgan ve yönetilemez bir ağ oluştur.</p><p>İşte Kafka, tam olarak bu sorunu çözmek için 2011 yılında LinkedIn tarafından tasarlandı.Netflix, Uber, Airbnb ve dünyanın bir çok teknoloji şirketinin altyapısında bulunmaktadır.Kafka’nın hangi sorunu çözmek üzerine tasarlandığını sizlere aktarırken Kafka’nın çalışma mantığını da örnek bir senaryo ile aktarmak isterim.</p><p>Bir süpermarketin kasasını hayal edin.Müşteriler alışverişlerini kasaya getiriyorlar(<strong>producer</strong>), kasa bu bilglieri bir banda koyuyor, arkada muhasebe departmanı hesapları güncelliyor, stok birimi envanter düşüyor, kampanya ekibi puanları işliyor(<strong>consumer</strong>). Kasa, müşterinin kim olduğunu ya da arkadaki departmanların ne yaptığını umursamıyor. Sadece bir bant üzerinde mesajları biriktiriyor.</p><p>Kafka tam olarak budur: bir <strong>dağıtık olay akışı platformu (distributed event streaming platform)</strong>. Sisteminizdeki farklı parçaların birbirine bağlı olmadan iletişim kurmasını sağlayan, yüksek verimli bir mesaj taşıyıcısı.</p><p>Kafka’nın geleneksel mesaj kuyruklarından farkı felsefeye dayanıyor.Çoğu kuyruk sistemi “görev dağıtımı” mantığıyla çalışır: mesaj üretilir, tüketilir,silinir. Kafka ise bir <strong>olay günlüğü(event log) </strong>gibi davranır: mesajlar diskte saklanır, okunmak onları silmez, geçmişe gidip tekrar okuyabilirsiniz. Bu küçük ama köklü fark, Kafka’nın neden bu kadar güçlü olduğunu açıklar.</p><h3>Temel Kavramlar :</h3><p><strong>Topic : </strong>Kafka’daki mesaj kategorisidir.Tıpkı bir veritabanındaki tablo gibi düşünebilirsiniz. order-topic,payment-topic,user-activity-topic gibi.</p><p><strong>Partition :</strong> Her topic’in bölündüğü paralel şeritlerdir. Bir otoyolun birden fazla şeridine benzetilebilir: her şerit bağımsız akar,araçlar paralel ilerler. Partition sayısını arttırmak, aynı anda daha fazla consumer’ın paralel çalışmasını sağlar ve bu Kafka’nın inanılmaz throughput’unun temelidir.</p><p><strong>Offset :</strong> Her mesajın partition içerisindeki sıra numarasıdır.Consumer’lar “offset 10&#39;a kadar okudum” diyerek yerlerini takip ederler. Eğer bir consumer çökerse, kaldığı yerden devam edebilir.</p><p><strong>Producer : </strong>Kafka’ya mesaj yazan her bir sistemdir. Bir web uygulaması sipariş oluşturduğunda, bir IoT sensörü sıcaklık ölçümü gönderdiğinde, bir servis bir hata logladığında hepsi bir producerdir.</p><p><strong>Consumer :</strong> Kafka’dan mesaj okuyan her bir sistemdir. Kritik bir nokta: mesajı okumak onu silmez. Aynı mesajı istediğiniz kadar, istediğiniz zaman okuyabilirsiniz.</p><p><strong>Consumer Group :</strong> Birden fazla consumer’ın ekip olarak çalışabilmesidir. Bir topic’in her partition’ı, gruptaki yalnızca bir consumer tarafından okunur. Bu sayede yük otomatik olarak dağıtılır. Gruba yeni bir consumer eklenirse Kafka yükü yeniden dengeler; bir consumer düşerse diğerleri devralır.</p><p><strong>Broker Ve Cluster</strong> : Broker, Kafka’nın çalıştığı sunucudur. Birden fazla broker bir araya geldiğinde <strong>Kafka Cluster</strong> oluşur. Mesajlar broker’lar arasında replica olarak kopyalanır: bir broker çökse veriler kaybolmaz, diğerleri devam eder. Bu Kafka’nın “hiçbir mesaj kaybolmaz” garantisinin temelidir.</p><h3><strong>Kafka Ne İçin Kullanılır?</strong></h3><p>Kafka’nın en yaygın kullanım alanları :</p><ul><li><strong>Event Sourcing ve CQRS :</strong> Sistemimizdeki her değişikliği bir olay olarak saklarsanız. “Sipariş oluşturuldu”, ”Ödeme onaylandı”, ”Kargo gönderildi” gibi. Geçmiş olayları tekrar oynatarak sistemin herhangi bir anki durumunu yeniden oluşturabilirsiniz.</li><li><strong>Log Toplama :</strong> Yüzlerce mikroservisin loglarını merkezi bir Kafka topic’ine toplayıp oradan Elasticsearch, S3, ya da başka sistemlere iletebilirsiniz.</li><li><strong>Gerçek Zamanlı Stream Processing :</strong> Kafka Streams veya Apache Flink ile akan veriyi anlık işleyebilirsiniz. Fraud detection, gerçek zamanlı dashboard, anlık öneri sistemleri bunun örnekleridir.</li><li><strong>Mikro-servis Entegrasyonu :</strong> Servisler birbirini doğrudan çağırmak yerine Kafka üzerinden iletişim kurar. Bu gevşek bağlılık(loose coupling) sağlar.</li><li><strong>CDC (Change Data Capture) :</strong> Veritabanındaki her değişikliği Kafka’ya aktarıp farklı sistemleri senkronize tutabilirsiniz.</li></ul><h3>Kafka mı RabbitMQ mu?</h3><p>Bu sorunun tek bir doğru cevabı yok, çünkü ikisi farklı problemleri çözüyor ama şöyle özetlenebilir.</p><p><strong>RabbitMQ </strong>bir <strong>görev dağıtıcısıdır</strong>. “Şu işi yap” diyorsunuz bir, worker alıp yapıyor, mesaj siliniyor. Karmaşık yönlendirme kuralları (exchange,binding) destekliyor. Kurulumu ve yönetimi daha basit. Orta ölçekli uygulamalar, e-posta gönderimi, arka plan görevleri için idealdir.</p><p><strong>Kafka </strong>bir o<strong>lay arşividir</strong>. “Şu olay gerçekleşti, kim ilgileniyorsa okusun” diyorsunuz. Mesajlar saklanıyor, birden fazla consumer aynı veriyi okuyabiliyor, geçmişe gidebiliyorsunuz. Milyon mesaj/saniye throughput. Büyük ölçekli sistemler, event sourcing. stream processing. çoklu consumer senaryoları için idealdir.</p><blockquote>Kural olarak: “Bu işi bir kez yap ve bitir” ise RabbitMQ,<br>“Bu olayı birden fazla sistem farklı amaçlarla kullansın” ise Kafka.</blockquote><p>Örnek: Bir e-ticaret sipariş akışında, sipariş oluşturulduğunda hem stok düşülmesi, hem fatura kesilmesi, hem kargo başlatılması, hem müşteriye bildirim gönderilmesi, hem de analitik sisteminin güncellenmesi gerekiyorsa Kafka net tercih olacaktır.</p><p>Sadece arka planda e-posta gönder diyorsanız RabbitMQ fazlasıyla yeterlidir.</p><h3>Gerçek Bir .NET Projesi: Sipariş Sistemi :</h3><p>Senaryomuz şu: Bir sipariş API’si siparişleri Kafka’ya yazar, ayrı bir worker service bu siparişleri okuyup işler. İkisi birbirini tanımaz, birbirinin çalışıp çalışmadığını umursamaz.</p><p><strong>Proje Yapısı ve Paket Kurulumu:</strong></p><p>Kafka kurulumunu sağlamak için <strong>docker-compose.yml </strong>yazıp bunu çalıştırabilirseniz dilerseniz <strong>docker desktop </strong>üzerinden de gerçekleştirebilirsiniz.</p><pre># docker-compose.yml<br>version: &#39;3.8&#39;<br>services:<br>  kafka:<br>    image: confluentinc/cp-kafka:7.6.0<br>    ports:<br>      - &quot;9092:9092&quot;<br>    environment:<br>      KAFKA_NODE_ID: 1<br>      KAFKA_PROCESS_ROLES: broker,controller<br>      KAFKA_LISTENERS: PLAINTEXT://0.0.0.0:9092,CONTROLLER://0.0.0.0:9093<br>      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://localhost:9092<br>      KAFKA_CONTROLLER_QUORUM_VOTERS: 1@kafka:9093<br>      KAFKA_LISTENER_SECURITY_PROTOCOL_MAP: PLAINTEXT:PLAINTEXT,CONTROLLER:PLAINTEXT<br>      KAFKA_CONTROLLER_LISTENER_NAMES: CONTROLLER<br>      KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1<br>      CLUSTER_ID: &quot;MkU3OEVBNTcwNTJENDM2Qk&quot;</pre><pre># Proje yapısı<br>dotnet new sln -n KafkaDemo<br>dotnet new webapi -n KafkaDemo.Producer<br>dotnet new worker  -n KafkaDemo.Consumer<br>dotnet sln add KafkaDemo.Producer KafkaDemo.Consumer</pre><pre># Her iki projeye da Confluent.Kafka paketini ekle<br>dotnet add KafkaDemo.Producer package Confluent.Kafka<br>dotnet add KafkaDemo.Consumer package Confluent.Kafka</pre><p><strong>Paylaşılan Model :</strong></p><pre># Contracts projesini oluştur<br>dotnet new classlib -n KafkaDemo.Contracts<br>dotnet sln add KafkaDemo.Contracts<br><br># Her iki projeye referans ekle<br>dotnet add KafkaDemo.Producer reference KafkaDemo.Contracts<br>dotnet add KafkaDemo.Consumer reference KafkaDemo.Contracts</pre><pre>// Models/OrderCreatedEvent.cs<br>public record OrderCreatedEvent(<br>    Guid OrderId,<br>    string CustomerId,<br>    decimal Amount,<br>    DateTime CreatedAt<br>);</pre><p><strong>Producer(Order API) :</strong></p><pre>// KafkaDemo.Producer — Program.cs<br>var builder = WebApplication.CreateBuilder(args);<br><br>builder.Services.AddSingleton&lt;IProducer&lt;string, string&gt;&gt;(sp =&gt;<br>{<br>    var config = new ProducerConfig<br>    {<br>        BootstrapServers = &quot;localhost:9092&quot;,<br>        Acks = Acks.All,               // En güvenli mod — tüm replica&#39;lar onaylasın<br>        EnableIdempotence = true        // Aynı mesajı iki kez yazma<br>    };<br>    return new ProducerBuilder&lt;string, string&gt;(config).Build();<br>});<br><br>var app = builder.Build();<br><br>app.MapPost(&quot;/orders&quot;, async (<br>    CreateOrderRequest request,<br>    IProducer&lt;string, string&gt; producer) =&gt;<br>{<br>    var orderEvent = new OrderCreatedEvent(<br>        OrderId: Guid.NewGuid(),<br>        CustomerId: request.CustomerId,<br>        Amount: request.Amount,<br>        CreatedAt: DateTime.UtcNow<br>    );<br><br>    var message = new Message&lt;string, string&gt;<br>    {<br>        Key = orderEvent.CustomerId,    // Aynı müşterinin siparişleri hep aynı partition&#39;a gider<br>        Value = JsonSerializer.Serialize(orderEvent)<br>    };<br><br>    var result = await producer.ProduceAsync(&quot;orders-topic&quot;, message);<br><br>    return Results.Ok(new { <br>        OrderId = orderEvent.OrderId,<br>        Partition = result.Partition.Value,<br>        Offset = result.Offset.Value<br>    });<br>});<br><br>app.Run();<br><br>record CreateOrderRequest(string CustomerId, decimal Amount);</pre><p>Producer tarafında kritik üç detay var;</p><ul><li><strong>Acks = All:</strong> Mesajın tüm replikalara yazıldığından emin olunur. En güvenli mod.</li><li><strong>EnableIdempotence = true:</strong> Ağ hatası durumunda aynı mesajın iki kez yazılması engellenir.</li><li><strong>Key olarak CustomerId:</strong> Aynı müşterinin siparişleri hep aynı partition’a gider, sıralama korunur.</li></ul><p><strong>Consumer (Sipariş İşleyen Worker) :</strong></p><p>Consumer tarafında en kritik detay manuel commit kullanmaktır. AutoCommit açık olsaydı mesaj okunur okunmaz <strong>işlendi</strong> olarak işaretlenirdi; işlem sırasında bir hata olsa mesaj kaybolurdu. Manuel commit ile önce işi yapıyoruz, sonra Kafka’ya “aldım, başarıyla işledim” diyoruz.</p><pre>// KafkaDemo.Consumer — OrderConsumerService.cs<br>public class OrderConsumerService : BackgroundService<br>{<br>    private readonly ILogger&lt;OrderConsumerService&gt; _logger;<br>    private readonly IConsumer&lt;string, string&gt; _consumer;<br><br>    public OrderConsumerService(ILogger&lt;OrderConsumerService&gt; logger)<br>    {<br>        _logger = logger;<br>        <br>        var config = new ConsumerConfig<br>        {<br>            BootstrapServers = &quot;localhost:9092&quot;,<br>            GroupId = &quot;order-processing-group&quot;,  // Consumer group adı<br>            AutoOffsetReset = AutoOffsetReset.Earliest,  // Baştan oku<br>            EnableAutoCommit = false             // Manuel commit — güvenli<br>        };<br>        <br>        _consumer = new ConsumerBuilder&lt;string, string&gt;(config).Build();<br>    }<br><br>    protected override async Task ExecuteAsync(CancellationToken cancellationToken)<br>    {<br>        _consumer.Subscribe(&quot;orders-topic&quot;);<br>        _logger.LogInformation(&quot;Sipariş consumer başladı...&quot;);<br><br>        while (!cancellationToken.IsCancellationRequested)<br>        {<br>            try<br>            {<br>                // 1 saniye bekle, mesaj varsa al<br>                var result = _consumer.Consume(TimeSpan.FromSeconds(1));<br>                <br>                if (result == null) continue;<br><br>                var order = JsonSerializer.Deserialize&lt;OrderCreatedEvent&gt;(result.Message.Value)!;<br>                <br>                _logger.LogInformation($&quot;Sipariş İşleniyor: {order.OrderId} | Müşteri: {order.CustomerId} | Tutar: {order.Amount}&quot;);<br>                <br>                // İş mantığın buraya gelir:<br>                await ProcessOrderAsync(order);<br><br>                // Başarılıysa offset&#39;i commit et<br>                _consumer.Commit(result);<br>            }<br>            catch (ConsumeException ex)<br>            {<br>                _logger.LogError(ex, &quot;Mesaj okuma hatası&quot;);<br>            }<br>        }<br><br>        _consumer.Close();<br>    }<br><br>    private async Task ProcessOrderAsync(OrderCreatedEvent order)<br>    {<br>        // DB&#39;ye kaydet, e-posta gönder, stok güncelle vb.<br>        await Task.Delay(100); // Simüle ediyoruz<br>        _logger.LogInformation($&quot;Sipariş {order.OrderId} işlendi&quot;);<br>    }<br><br>    public override void Dispose()<br>    {<br>        _consumer.Dispose();<br>        base.Dispose();<br>    }<br>}</pre><pre>// KafkaDemo.Consumer - Program.cs<br>using KafkaDemo.Consumer;<br><br>var builder = Host.CreateApplicationBuilder(args);<br>builder.Services.AddHostedService&lt;OrderConsumerService&gt;();<br><br>var host = builder.Build();<br>host.Run();</pre><p><strong>Çalıştırmak İçin :</strong></p><pre># Terminal 1 — Kafka&#39;yı başlat<br>docker-compose up -d<br><br># Terminal 2 — Consumer&#39;ı başlat<br>cd KafkaDemo.Consumer &amp;&amp; dotnet run<br><br># Terminal 3 — Producer API&#39;yi başlat<br>cd KafkaDemo.Producer &amp;&amp; dotnet run<br><br># Terminal 4 — Test et<br>Invoke-WebRequest -Uri &quot;http://localhost:5278/orders&quot; `<br>  -Method POST `<br>  -ContentType &quot;application/json&quot; `<br>  -Body &#39;{&quot;customerId&quot;: &quot;ahmet-123&quot;, &quot;amount&quot;: 299.99}&#39;</pre><p><strong>Sonuç :</strong></p><p>Kafka’nın çalışıp çalışmadığını mesajın işlenip işlenmediğini Consumer’ı çalıştırdığınız terminal çıktısından görüntüleyebilirsiniz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/952/1*-1potvPmnNMFYKTdG99OFg.png" /></figure><p>Kafka, ilk bakışta karmaşık görülebilir ama temel fikir son derece sade: üreticileri ve tüketicileri birbirinden bağımsız kılmak mesajları güvenilir biçimde saklamak ve yüksek hacimi sorunsuz taşımak.</p><p>Küçük bir uygulama geliştiriyorsanız ve basit arka plan görevlerine ihtiyacınız varsa RabbitMQ daha az yük getirir ama sisteminiz büyüdükçe, servis sayısı arttıkça, veri hacmi yükseldikçe Kafka’nın sunduğu mimari avantajlar kendini gösterir.</p><p>Bu yazıda kurduğumuz .NET projesi, Kafka ile çalışmanın temelini gösteriyor. Buradan ileri adımlar şunlar olabilir: Schema Registry ile mesaj şemalarını verisyonlamak, Kafka Streams ile akan veriyi gerçek zamanlı işlemek veya Kafka Connect ile mevcut veritabanlarınızı Kafka’ya bağlamak.</p><p>Makaleyi faydalı bulduysanız takip ederek destek olabilirsiniz 🙏</p><ul><li><a href="https://github.com/SalimcanKaradeniz/NetCoreKafkaIntegation">GitHub - SalimcanKaradeniz/NetCoreKafkaIntegation</a></li><li><a href="https://medium.com/@salimcankaradeniz">Salimcan Karadeniz - Medium</a></li></ul><p>Bir sonraki yazıda görüşmek üzere 😊</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=2909600f5455" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[.NET’de Type-Safe Configuration Management: ConfigPlus ile Güvenli Ayar Yöntemi]]></title>
            <link>https://medium.com/@salimcankaradeniz/netde-type-safe-configuration-management-configplus-ile-g%C3%BCvenli-ayar-y%C3%B6ntemi-bc0a57d64c4c?source=rss-5285eada9698------2</link>
            <guid isPermaLink="false">https://medium.com/p/bc0a57d64c4c</guid>
            <category><![CDATA[programming]]></category>
            <category><![CDATA[dotnet]]></category>
            <category><![CDATA[software-development]]></category>
            <category><![CDATA[aspnetcore]]></category>
            <category><![CDATA[csharp]]></category>
            <dc:creator><![CDATA[Salimcan Karadeniz]]></dc:creator>
            <pubDate>Tue, 23 Sep 2025 06:05:14 GMT</pubDate>
            <atom:updated>2025-09-23T06:05:14.200Z</atom:updated>
            <content:encoded><![CDATA[<p>Modern .NET uygulamalarında configuration yönetimi nasıl güvenli,type-safe,environment-aware hale getirilir? ConfigPlus kütüphanesini geliştirirken bu sorunu çözüme kavuşturmayı hedefledim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kxFupnshkqh7qmiVYf1-sg.png" /></figure><h3><strong>Her .NET Developer’in Yaşadığı Configuration Kabusu</strong></h3><p>Production ortamında gece saat 02.00 sularında uygulamanız çalışıyor olarak gözüküyor kullanıcılar sistemi sorunsuz kullanıyor fakat bir email gönderim işlemi gerçekleştiğinde aşağıda ki hata yaşanıyor.</p><p><strong>Error: Object reference not set to an instance of an object</strong></p><p>Burada ki sorunun konfigürasyon hatası olduğunu ele alarak sizlere anlatacağım.</p><p>Sorun <strong>appsettings.Production.json </strong>dosyasında email konfigürasyonu eksik.Uygulama başlarken hiçbir hata almadınız, çünkü geleneksel yöntemlerle konfigürasyon okuma işlemi bu tür hataları uygulama ayağa kalkarken program.cs’de yakalamıyor.</p><p><strong>Geleneksel Yaklaşımın Problemleri</strong></p><pre>// Geleneksel yöntem<br>public void ConfigureServices(IServiceCollection services)<br>{<br>    // String-based configuration access - null olabilir<br>    var connectionString = Configuration[&quot;Database:ConnectionString&quot;];<br>    <br>    // Type conversion risk - exception fırlayabilir<br>    var timeout = int.Parse(Configuration[&quot;Database:Timeout&quot;]);<br>}</pre><p><strong>Bu yaklaşımın sorunları :</strong></p><ul><li><strong>Runtime Crash Risk</strong>: Configuration hataları production’da ortaya çıkıyor</li><li><strong>String-based Access</strong>: IntelliSense desteği yok, typo riski var</li><li><strong>Type Safety Yo</strong>k: Manual type conversion gerekli</li><li><strong>Environment Management</strong>: Ortam bazlı ayar yönetimi zor</li><li><strong>Validation Eksikliği</strong>: Geçersiz değerlerin tespiti geç fark edilebiliyor</li></ul><p>Geleneksel yöntemin sorunlarından bahsettik ve ConfigPlus ile bu sorunların çözümlerine geçmeden önce sizlere biraz daha ConfigPlus’dan bahsetmek ve detaylandırmak istiyorum.</p><p><strong>ConfigPlus: Type-Safe Configuration Management</strong></p><p>ConfigPlus, bu problemleri çözmek için geliştirdiğim bir .NET kütüphanesidir.Temel hedefi configuration hatalarını production’da değil program.cs’de yakalamak.</p><p><strong>ConfigPlus Kurulumu :</strong></p><pre>dotnet add package ConfigPlus</pre><pre>Install-Package ConfigPlus</pre><p><strong>ConfigPlus’ın Öne Çıkan Özellikleri</strong></p><ul><li><strong>Type-Safe Access</strong>: Strong typing ile IntelliSense desteği</li><li><strong>Environment-Aware</strong>: Otomatik ortam bazlı konfigürasyon yönetimi</li><li><strong>Built-in Validation</strong>: Data annotation desteği ile detaylı hata raporlama</li><li><strong>Startup Validation</strong>: Production’a çıkmadan önce tüm hataları yakala</li><li><strong>DI Integratio</strong>n: .NET dependency injection ile mükemmel entegrasyon</li><li><strong>Zero Dependencies</strong>: Sadece Microsoft.Extensions.* paketlerini kullanır</li></ul><h3>ConfigPlus’ın Sağladığı Avantajlar</h3><h3>1. Erken Hata Tespiti</h3><p><strong>ConfigPlus Öncesi (Geleneksel Yöntem):</strong></p><ul><li>Uygulama başlar</li><li>2 saat sonra email gönderme kısmında crash verir</li><li>Production’da müşteri etkilenir</li></ul><p><strong>ConfigPlus Sonrası:</strong></p><ul><li>Startup’ta validation yapılır</li><li>Uygulama başlamaz</li><li>Hata development’ta yakalanır</li></ul><h3>Ne Zaman ConfigPlus Kullanmalısınız?</h3><ul><li><strong>Çok ortamlı deployment</strong> (Dev, Test, Production)</li><li><strong>Karmaşık configuration</strong> yapısı</li><li><strong>Zero-downtime deployment</strong> hedefi</li><li><strong>Enterprise-grade</strong> güvenilirlik</li><li><strong>Team development</strong> — Configuration hatalarını minimize etmek</li></ul><h3>Sonuç ve Tavsiyeler</h3><p>ConfigPlus, .NET uygulamalarında configuration management’ı bir sonraki seviyeye taşıyor. <strong>Type safety</strong>, <strong>environment awareness</strong>, ve <strong>startup validation</strong> ile configuration hell’den kurtuluyorsunuz.</p><h3>Hemen Başlamak İçin:</h3><ol><li><strong>NuGet Package</strong>: dotnet add package ConfigPlus</li><li><strong>GitHub Repository</strong>: <a href="https://github.com/SalimcanKaradeniz/ConfigPlus/tree/master">ConfigPlus Source Code</a></li><li><strong>Sample Project</strong>: Aşağıda ki örnek projeyi baz alarak kendi projenizde deneyin</li></ol><p>ConfigPlus kütüphanesini örnek üzerinden anlatmak için bir .NET Web API projesi oluşturacağız. Bu proje’de 2 farklı ortamımız olucak development ve production burada ki konfigürasyonlara göre fail ve success aldığımız çıktıları görüntüleyeceğiz.</p><p>Oluşturduğumzu API projesine ConfigPlus nuget paketimizi kurduktan sonra Models klasörü oluşturdum appsettings’de bulunan konfigürasyonlarımızı modellemek için burada 2 adet classımız olacak DatabaseSettings ve EmailSettings.</p><p><strong>ConfigPlus Kurulumu :</strong></p><pre>dotnet add package ConfigPlus</pre><p><strong>DatabaseSettings :</strong></p><pre>/// &lt;summary&gt;<br>/// Database bağlantı ayarları<br>/// &lt;/summary&gt;<br>public class DatabaseSettings<br>{<br>    [Required(ErrorMessage = &quot;Connection string zorunludur&quot;)]<br>    public string ConnectionString { get; set; } = string.Empty;<br><br>    [Range(1, 3600, ErrorMessage = &quot;Timeout 1-3600 saniye arasında olmalı&quot;)]<br>    public int CommandTimeoutSeconds { get; set; } = 30;<br><br>    public bool EnableRetryPolicy { get; set; } = true;<br><br>    [Range(1, 10, ErrorMessage = &quot;Retry sayısı 1-10 arasında olmalı&quot;)]<br>    public int MaxRetryAttempts { get; set; } = 3;<br>}</pre><p><strong>EmailSettings :</strong></p><pre> /// &lt;summary&gt;<br> /// Email servisi ayarları<br> /// &lt;/summary&gt;<br> public class EmailSettings<br> {<br>     [Required(ErrorMessage = &quot;SMTP host adresi zorunludur&quot;)]<br>     public string SmtpHost { get; set; } = string.Empty;<br><br>     [Range(1, 65535, ErrorMessage = &quot;SMTP port 1-65535 arasında olmalı&quot;)]<br>     public int SmtpPort { get; set; } = 587;<br><br>     [Required(ErrorMessage = &quot;Gönderici email adresi zorunludur&quot;)]<br>     [EmailAddress(ErrorMessage = &quot;Geçerli email formatında olmalı&quot;)]<br>     public string FromAddress { get; set; } = string.Empty;<br><br>     [Required(ErrorMessage = &quot;Gönderici adı zorunludur&quot;)]<br>     public string FromName { get; set; } = string.Empty;<br><br>     public bool EnableSsl { get; set; } = true;<br> }</pre><p>Modellerimizi oluşturduktan sonra appsettings.json ve appsettings.Production.json dosyalarımızı aşağıda ki gibi yapılandırıyoruz.</p><p><strong>appsettings.json :</strong></p><pre>{<br>    &quot;Logging&quot;: {<br>        &quot;LogLevel&quot;: {<br>            &quot;Default&quot;: &quot;Information&quot;,<br>            &quot;Microsoft.AspNetCore&quot;: &quot;Warning&quot;<br>        }<br>    },<br>    &quot;AllowedHosts&quot;: &quot;*&quot;,<br><br>    &quot;Database&quot;: {<br>        &quot;ConnectionString&quot;: &quot;Server=localhost;Database=ConfigPlusTestDb;Trusted_Connection=true;&quot;,<br>        &quot;CommandTimeoutSeconds&quot;: 30,<br>        &quot;EnableRetryPolicy&quot;: true,<br>        &quot;MaxRetryAttempts&quot;: 1<br>    },<br>    &quot;Email&quot;: {<br>        &quot;SmtpHost&quot;: &quot;smtp.gmail.com&quot;,<br>        &quot;SmtpPort&quot;: 587,<br>        &quot;FromAddress&quot;: &quot;noreply@dev.configplus.com&quot;,<br>        &quot;FromName&quot;: &quot;ConfigPlus Dev&quot;,<br>        &quot;EnableSsl&quot;: true<br>    }<br>}</pre><p><strong>appsettings.Production.json :</strong></p><pre>{<br>    &quot;Database_Production&quot;: {<br>        &quot;ConnectionString&quot;: &quot;Server=prod-server;Database=ConfigPlusDb;User Id=sa;Password=SecurePassword123!;&quot;,<br>        &quot;CommandTimeoutSeconds&quot;: 60,<br>        &quot;EnableRetryPolicy&quot;: true,<br>        &quot;MaxRetryAttempts&quot;: 1<br>    },<br>    &quot;Email_Production&quot;: {<br>        &quot;SmtpHost&quot;: &quot;smtp.office365.com&quot;,<br>        &quot;SmtpPort&quot;: 587,<br>        &quot;FromAddress&quot;: &quot;noreply@configplus.com&quot;,<br>        &quot;FromName&quot;: null,<br>        &quot;EnableSsl&quot;: true<br>    }<br>}</pre><p>Bu tanımlamaları yaptıktan sonra asıl aşamaya gelmiş bulunuyoruz Program.cs’de ConfigPlus entegrasyonunu gerçekleştireceğiz.</p><p><strong>Program.cs :</strong></p><p>Aşağıda bulunan entegrasyon adımlarını “var app = builder.Build();” öncesine ekleyiniz.</p><pre><br>//ConfigPlus entegrasyonu<br>builder.Services.AddConfigPlus(builder.Configuration);<br><br>// Environment-aware configuration registration<br><br>if (builder.Environment.IsProduction())<br>{<br>    // Production ortamında environment-specific config kullan   <br>    builder.Services.ConfigureFromConfigPlusForEnvironment&lt;DatabaseSettings&gt;(&quot;Database&quot;, &quot;Production&quot;);<br>    builder.Services.ConfigureFromConfigPlusForEnvironment&lt;EmailSettings&gt;(&quot;Email&quot;, &quot;Production&quot;);<br>}<br>else<br>{<br>     // Development/Staging ortamında base config kullan<br>    builder.Services.ConfigureFromConfigPlus&lt;DatabaseSettings&gt;(&quot;Database&quot;);<br>    builder.Services.ConfigureFromConfigPlus&lt;EmailSettings&gt;(&quot;Email&quot;);<br>}<br><br>// STARTUP VALIDATION - Bu çok önemli!<br>var configSections = new Dictionary&lt;string, Type&gt;();<br><br>if (builder.Environment.IsProduction())<br>{<br>    configSections = new Dictionary&lt;string, Type&gt;<br>    {<br>        { &quot;Database_Production&quot;, typeof(DatabaseSettings) },<br>        { &quot;Email_Production&quot;, typeof(EmailSettings) }<br>    };<br>}<br>else<br>{<br>    configSections = new Dictionary&lt;string, Type&gt;<br>    {<br>        { &quot;Database&quot;, typeof(DatabaseSettings) },<br>        { &quot;Email&quot;, typeof(EmailSettings) }<br>    };<br>}<br><br>try<br>{<br>    builder.Services.ValidateConfigurations(configSections);<br>    Console.WriteLine(&quot;Tüm konfigürasyonlar başarıyla doğrulandı!&quot;);<br>}<br>catch (AggregateException ex)<br>{<br>    Console.WriteLine(&quot;Konfigürasyon doğrulama hatası:&quot;);<br>    foreach (var error in ex.InnerExceptions)<br>    {<br>        Console.WriteLine($&quot;   • {error.Message}&quot;);<br>    }<br><br>    Console.WriteLine(&quot;Uygulama geçersiz konfigürasyon nedeniyle başlatılamıyor!&quot;);<br>    Environment.Exit(1);<br>}</pre><p>ConfigPlus’ı entegre ettikten sonra ConfigPlus’ın hangi environmenti baz alarak görevlerini yetirine getirmesi için gerekli kullanımı sağlıyoruz uygulama production ortamda çalışıyor ise konfigüre ederken production bilgisini de gönderiyoruz eğer production’da çalışmıyor ise base settings’i baz alarak yani appsettings.json’ı baz alarak ilerliyor.Burayı kendi kullanacağınız şekilde değiştirebilirsiniz production/dev vs gibi.</p><p>Entegrasyonu tamamladıktan sonra uygulamamızı test edebiliriz. Success ve Fail durumlarında aşağıda ki ekran çıktılarını almamız gerekiyor.</p><p><strong>Success Çıktı :</strong></p><pre>Tüm konfigürasyonlar başarıyla doğrulandı!<br>ConfigPlusExample Development ortamında başlatılıyor...</pre><p><strong>Fail Çıktı :</strong></p><pre>Konfigürasyon doğrulama hatası:<br>   • Validation failed: Gönderici adı zorunludur<br>Uygulama geçersiz konfigürasyon nedeniyle başlatılamıyor!</pre><p><strong>NOT : Uygulamanızı appsettings.Production.json üzerinden çalıştıramazsanız launchSettings.json dosyası üzerinden environment değerlerini Production olarak güncelleyerek tekrar test edebilirsiniz.</strong></p><p>ConfigPlus nuget adresi,github repository,makale de yapmış olduğumuz örnek api uygulamasını ve dökümantasyonu aşağıda ki linklerde bulabilirsiniz.</p><ul><li><strong>NuGet Package</strong>: <a href="https://www.nuget.org/packages/ConfigPlus">https://www.nuget.org/packages/ConfigPlus</a></li><li><strong>GitHub Repository</strong>: <a href="https://github.com/yourusername/ConfigPlus">https://github.com/SalimcanKaradeniz/ConfigPlus</a></li><li><strong>Example Project</strong>: Örnek projeyi görüntelemek için <a href="https://github.com/SalimcanKaradeniz/ConfigPlus/tree/master/examples/ConfigPlusExamples">buraya </a>tıklayınız.</li><li><strong>Documentation</strong>: README.md dosyası için <a href="https://github.com/SalimcanKaradeniz/ConfigPlus/blob/master/README.md">buraya </a>tıklayınız.</li></ul><p>Makaleyi faydalı bulduysanız takip ederek destek olabilirsiniz 🙏</p><p><a href="https://medium.com/@salimcankaradeniz">Salimcan Karadeniz - Medium</a></p><p>Bir sonraki yazıda görüşmek üzere 😊</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=bc0a57d64c4c" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Entity Framework Core Performans İyileştirme Yöntemleri]]></title>
            <link>https://medium.com/@salimcankaradeniz/entity-framework-core-performans-i%CC%87yile%C5%9Ftirme-y%C3%B6ntemleri-8be060e1d501?source=rss-5285eada9698------2</link>
            <guid isPermaLink="false">https://medium.com/p/8be060e1d501</guid>
            <category><![CDATA[net-core]]></category>
            <category><![CDATA[backend]]></category>
            <category><![CDATA[ef-core]]></category>
            <category><![CDATA[csharp]]></category>
            <category><![CDATA[ef-core-performance]]></category>
            <dc:creator><![CDATA[Salimcan Karadeniz]]></dc:creator>
            <pubDate>Mon, 28 Apr 2025 10:16:26 GMT</pubDate>
            <atom:updated>2025-04-28T10:16:26.875Z</atom:updated>
            <content:encoded><![CDATA[<p>Entity Framework Core (EF Core) .NET uygulamalarında veritabanı ile etkileşimde güçlü bir ORM aracıdır. Fakat yanlış kullanım durumunda performans sorunlarına yol açabilmektedir. Bu yazıda, EF Core ile yüksek performanslı sorgular nasıl yazılabilir örneklerle sizlerle paylaşmaya çalışacağım. Özellikle Include, Select Projection, AsNoTracking, Compiled Queries ve Raw SQL gibi özellikleri ele alarak sizlerle paylaşmaya çalışacağım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5WnsC5FP5tGtn_nRqPXu2g.png" /></figure><h3>1. Include Yerine Select (Projection) Kullanmak</h3><p>EF Core’da ilişkili verileri çekmek için Include() sık kullanılır. Ancak, bu yöntem çoğu zaman gereğinden fazla veri taşınmasına neden olur.</p><h4>Kötü Örnek (Gereksiz Include)</h4><pre>var orders = context.Orders<br>    .Include(o =&gt; o.Customer)<br>    .ToList();</pre><p>Bu sorgu tüm Customer bilgilerini getirir, ama biz sadece müşteri adını kullanacaksak bütün customer bilgisini almamıza gerek yok. Yukarıda vermiş olduğumuz örnekte olduğu gibi kullanılırsa bu kullanım fazla veri taşınmasına neden olacaktır.</p><h4>İyi Örnek (Select Projection)</h4><pre>var orders = context.Orders<br>    .Select(o =&gt; new {<br>        OrderId = o.Id,<br>        CustomerName = o.Customer.Name<br>    })<br>    .ToList();</pre><p>Yalnızca ihtiyaç duyulan müşteri adı alanı çekildiği için daha hızlı ve hafif bir sorgu olur.</p><h3>2. AsNoTracking ile İzleme Yükünü Azaltmak</h3><p>EF Core, verileri Change Tracker ile izler. Ancak sadece okuma işlemi yapacaksanız bu izleme gereksiz bir yük oluşturur.</p><h4>İzleme Açık (Varsayılan)</h4><pre>var products = context.Products.ToList();</pre><h4>İzleme Kapalı</h4><pre>var products = context.Products.AsNoTracking().ToList();</pre><p>AsNoTracking kullanımında performans artışı özellikle büyük veri setlerinde daha net hissedilir.</p><h3>3. Compiled Queries ile Sorguları Önbelleğe Almak</h3><p>Sık kullanılan sorgular derlenerek bellekte tutulabilir. Bu da çalıştırma süresini azaltır.</p><h4>Compiled Query Kullanımı</h4><pre>private static readonly Func&lt;MyDbContext, int, Product?&gt; _getProductById =<br>    EF.CompileQuery((MyDbContext context, int id) =&gt;<br>        context.Products.FirstOrDefault(p =&gt; p.Id == id));<br><br>var product = _getProductById(context, 5);</pre><h3>4. Raw SQL ile Karmaşık Sorgularda Esneklik Kazanmak</h3><p>Bazı durumlarda LINQ yeterli esnekliği sağlamaz. Bu durumlarda FromSqlInterpolated ile doğrudan SQL yazabilirsiniz.</p><h4>Raw SQL Örneği</h4><pre>var topProducts = context.Products<br>    .FromSqlInterpolated($&quot;SELECT TOP 5 * FROM Products ORDER BY Sales DESC&quot;)<br>    .AsNoTracking()<br>    .ToList();</pre><p>Bu yöntem, performans kritik senaryolarda oldukça etkili olabilir.</p><h3>5. Lazy Loading Yerine Eager veya Explicit Loading Kullanmak</h3><p>Lazy loading arka planda ekstra sorgular oluşturabilir. Bunun yerine Include() (Eager) veya .Load() (Explicit) tercih edilebilir.</p><h4>Lazy Loading</h4><pre>var order = context.Orders.First();<br>var customerName = order.Customer.Name; // Arka planda ikinci sorgu!</pre><h4>Eager Loading</h4><pre>var order = context.Orders<br>    .Include(o =&gt; o.Customer)<br>    .First();</pre><p>Performans, sadece daha hızlı çalışan bir uygulama değil; aynı zamanda daha az kaynak tüketimi ve daha iyi kullanıcı deneyimi anlamına gelir. EF Core ile performans optimizasyonu sağlamak için Include, Projection, NoTracking, Compiled Queries ve Raw SQL gibi yöntemleri bilinçli kullanmak gerekir.</p><p>Takipte kalmak istersen <a href="https://medium.com/@salimcankaradeniz">Medium</a> üzerinden beni takip edebilir, <a href="https://github.com/SalimcanKaradeniz">GitHub</a> reposunu da inceleyebilirsin.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8be060e1d501" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[.NET 9 ile Gelen 10 Öne Çıkan Özellik]]></title>
            <link>https://medium.com/@salimcankaradeniz/net-9-ile-gelen-10-%C3%B6ne-%C3%A7%C4%B1kan-%C3%B6zellik-6a6bf496d48d?source=rss-5285eada9698------2</link>
            <guid isPermaLink="false">https://medium.com/p/6a6bf496d48d</guid>
            <category><![CDATA[software-development]]></category>
            <category><![CDATA[c-sharp-programming]]></category>
            <category><![CDATA[net-core]]></category>
            <category><![CDATA[development]]></category>
            <category><![CDATA[devops]]></category>
            <dc:creator><![CDATA[Salimcan Karadeniz]]></dc:creator>
            <pubDate>Mon, 21 Apr 2025 11:07:50 GMT</pubDate>
            <atom:updated>2025-04-21T11:07:50.414Z</atom:updated>
            <content:encoded><![CDATA[<p>.NET 9 ile birlikte gelen yeni özellikler hem performans hem de geliştirici deneyimi açısından dikkat çekici olmuştur. Bu yazıda .NET 9 ile gelen 10 önemli özelliği, sade açıklamalar ve kod örnekleriyle sizlerle paylaşmaya çalışacağım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4e4cX_65UyxNk1P3toQRhw.png" /></figure><h3>1. Primary Constructors in Classes</h3><p>Artık sadece record türleri değil, class türleri de doğrudan constructor parametrelerini sınıf tanımıyla birlikte alabiliyor. Bu sayede, sınıflar daha kısa ve okunabilir şekilde yazılabiliyor. Örneğin Product sınıfının Name ve Price alanlarını klasik constructor tanımı yerine doğrudan başlık kısmında tanımlayabiliyoruz.</p><pre>public class Product(string name, decimal price)<br>{<br>    public string Name =&gt; name;<br>    public decimal Price =&gt; price;<br>}</pre><h3>2. Collection Literals</h3><p>Daha sade koleksiyon oluşturmak için yeni [] söz dizimi kullanılabiliyor. Özellikle list ve array tanımlarında daha kısa ve temiz bir ifade biçimi sunuyor.</p><pre>var numbers = [1, 2, 3, 4];<br>var people = [new Person(&quot;Ali&quot;), new Person(&quot;Ayşe&quot;)];</pre><h3>3. Params Span Desteği</h3><p>Span&lt;T&gt; ve ReadOnlySpan&lt;T&gt; türleri artık params anahtar sözcüğüyle kullanılabiliyor. Bu sayede belleği verimli kullanan yöntemler yazmak daha kolay hale geliyor. Özellikle performans kritik uygulamalarda faydalı.</p><pre>void Print(params ReadOnlySpan&lt;int&gt; values)<br>{<br>    foreach (var v in values)<br>        Console.WriteLine(v);<br>}</pre><h3>4. Default Lambda Parameters</h3><p>Artık lambda ifadelerinde varsayılan parametre değeri tanımlanabiliyor. Bu özellik, daha esnek ve sade lambda fonksiyonları yazmaya olanak tanıyor.</p><pre>Func&lt;int, int, int&gt; sum = (x, y = 5) =&gt; x + y;<br>Console.WriteLine(sum(3));</pre><h3>5. Frozen Collections</h3><p>FrozenList ve FrozenSet gibi koleksiyonlar değiştirilemez (immutable) yapılardır ve veri değişmeyeceği zaman kullanıldığında performansı ciddi şekilde artırır. Özellikle lookup işlemleri çok daha hızlıdır.</p><pre>var frozenList = [&quot;A&quot;, &quot;B&quot;, &quot;C&quot;].ToFrozenList();<br>var frozenSet = [1, 2, 3].ToFrozenSet();</pre><h3>6. Inline Arrays (Preview)</h3><p>Küçük ve sabit uzunluktaki dizileri daha performanslı saklamak için kullanılan bir yapı. Özellikle embedded senaryolar ya da performans hassas işlemlerde avantaj sağlar. Bu özellik şu an için önizleme aşamasındadır.</p><pre>[InlineArray(3)]<br>struct ThreeBytes<br>{<br>    private byte element0;<br>}</pre><h3>7. Better Support for AOT (Ahead-of-Time) Compilation</h3><p>.NET 9, Native AOT desteğini daha fazla senaryo için genişletti. Native AOT sayesinde uygulamalar derlenmiş (native) hale getirilip çok daha hızlı başlatılabilir ve dağıtılabilir hale geliyor. Mikroservis, CLI araçları ve konteyner ortamları için mükemmel bir seçim.</p><h3>8. Enhanced Interceptors and Code Generators</h3><p>Yeni interceptor yetenekleri sayesinde, kodun çalışma zamanında değil, derleme aşamasında nasıl çalışacağı değiştirilebiliyor. Özellikle AOP (Aspect Oriented Programming) benzeri işlemler için büyük esneklik sağlıyor.</p><h3>9. Improved JSON Serialization</h3><p>System.Text.Json üzerinde yapılan geliştirmelerle JSON işlemleri artık daha hızlı ve güçlü hale geldi. Özellikle source generation desteğiyle serialization işlemleri compile-time sırasında optimize edilebiliyor.</p><pre>var json = JsonSerializer.Serialize(obj, new JsonSerializerOptions { TypeInfoResolver = MyContext.Default });</pre><h3>10. HTTP/3 ve QUIC Desteği</h3><p>.NET 9 ile birlikte Kestrel sunucusu artık HTTP/3 protokolünü destekliyor. QUIC tabanlı bu yeni protokol, daha düşük gecikme süreleriyle modern web uygulamalarında daha iyi performans sunuyor.</p><pre>var builder = WebApplication.CreateBuilder();<br>builder.WebHost.ConfigureKestrel(options =&gt;<br>{<br>    options.ConfigureHttpsDefaults(o =&gt; o.Http3 = true);<br>});</pre><p>.NET 9 ile gelen bu yeni özellikler hem modern yazılım ihtiyaçlarına yanıt veriyor hem de geliştiricilere daha temiz, performanslı ve az kodla çok iş yapma fırsatı sunmaktadır.</p><p>Takipte kalmak istersen <a href="https://medium.com/@salimcankaradeniz">Medium</a> üzerinden beni takip edebilir, <a href="https://github.com/SalimcanKaradeniz">GitHub</a> reposunu da inceleyebilirsin.</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6a6bf496d48d" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[.NET Core Uygulamalarında Webhook Entegrasyonu]]></title>
            <link>https://medium.com/@salimcankaradeniz/net-core-uygulamalar%C4%B1nda-webhook-entegrasyonu-23daf85c9337?source=rss-5285eada9698------2</link>
            <guid isPermaLink="false">https://medium.com/p/23daf85c9337</guid>
            <category><![CDATA[webhook-integration]]></category>
            <category><![CDATA[development]]></category>
            <category><![CDATA[net-core]]></category>
            <category><![CDATA[c-sharp-programming]]></category>
            <category><![CDATA[webhooks]]></category>
            <dc:creator><![CDATA[Salimcan Karadeniz]]></dc:creator>
            <pubDate>Tue, 12 Mar 2024 20:48:06 GMT</pubDate>
            <atom:updated>2024-03-12T20:48:06.464Z</atom:updated>
            <content:encoded><![CDATA[<p>Webhook, bir uygulamanın başka bir uygulamayla iletişim kurmasını sağlayan bir mekanizmadır. Genellikle olay tabanlı sistemlerde kullanılır ve bir olay gerçekleştiğinde bu olay ile ilgili bilgiye ihtiyacı olan uygulamaya anında bilgi iletilmesini sağlar.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wspMc-0zLn_gGmiukRt1sg.png" /></figure><h3>Webhook Nedir?</h3><p>Webhook, bir olayın gerçekleştiği zaman bu gerçekleşen olay ile ilişkisi olan veya bilgiye ihtiyacı olan farklı bir uygulama’ya HTTP isteği gönderen bir sistemdir. Bu, iki uygulama arasında gerçek zamanlı iletişim kurulmasına olanak sağlar.</p><p>Webhookları birer websocket gibi düşünebiliriz çalışma mantıkları birbirleri ile benzerlerdir. Websocket uygulama içerisinde belirlenen olaylar yaşandığı an browser üzerinden bilgi akışı sağlamaya yaramaktadır.Webhook’ta aslında tam olarak bu işlevi sağlamaktadır ikisi arasındaki fark ise websocketler browser tabanlı iletişim sağlarken webhook uygulamalar arasında iletişim sağlamaktadır.</p><h3>Webhook Avantajları Nelerdir?</h3><ol><li>Webhook’lar, olay gerçekleştiği anda tetiklenerek diğer sistemlere bilgi aktarılmasını ve hızlı tepki vermesini sağlayabilir.</li><li>Webhook’lar entegrasyon kolaylıkları sağlar geleneksel API hizmetleri gibi her defasında istek çıkmak yerine belirlenen olay gerçekleştiği anda tetiklenerek bilgi akışı sağlarlar.</li><li>Webhook’lar anlık bilgi akışı sağladığı için sürekli istek atılma durumunu ortadan kaldırarak sunucuda daha az trafik görülmesini sağlar.</li></ol><h3>.NET Core Webhook Entegrasyonu :</h3><p>Örnek olarak bir task sisteminin durum güncelleme senaryosunda bu task’ın durumunun güncellendiğine dair diğer sistemlere bilgi akışı sağlayabiliriz bu diğer sistemler sms veya mail gönderen sistemler olabilir ben yapacağım örnekte taskın durumu güncellendiğinde MailAPI isimli uygulamaya webhook ile istek göndereceğim fakat MailAPI herhangi bir mail gönderimi yapmayacaktır. “x numaralı task güncellendi” şeklinde bir response dönecek şekilde ayarlayacağım.</p><p>Yapacağımız örnekte 2 adet API uygulamamız olucak bunlardan bir tanesi TaskAPI(GetAll,Get,UpdateTaskStatus) işlemlerini yapacağımız birde update işlemini yaptıktan sonra webhook ile tetikleyeceğimiz MailAPI uygularımızdır.API projelerini .NET 8 ile oluşturacağım siz istediğiniz sürümü kullanabilirsiniz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/413/1*ifp3NWwRz3Zw1K6MnFIvlw.png" /></figure><p>TaskAPI uygulamamız’da bulunan TaskController içerisinde 4 adet methotumuz bulunmaktadır. Bu methotlar GetAll,Get,UpdateTaskStatus,TriggerWebhook methotlarıdır.Bizim için burada kritik olan methot UpdateTaskStatus methotu çünkü task’ın statüsü update olduğu an webhook’umuz tetiklenicek ve mail api içerisinde bilgiyi alması gereken methota http isteği atacağız.</p><p>TaskController.cs dosyasının içeriğine geçmeden önce bu işlemlerin en başında bize lazım olan TaskModel.cs modelimizi oluşturmalıyız bu modelimizin amacı bize fake bir veri hazırlaması için bir entity modeliymiş gibi davranıp içerisinde repository pattern kullanılarak bir list verisi çekmişiz gibi bize veri sunmaktadır bu modeli GetAll,Get ve UpdateTaskStatus methotlarımızda kullanıyor olacağız.</p><p><strong>TaskModel.cs :</strong></p><pre>namespace TaskAPI.Model<br>{<br>    public class TaskModel<br>    {<br>        public int Id { get; set; }<br>        public string Title { get; set; }<br>        public string Description { get; set; }<br>        public int Status { get; set; }<br><br>        public List&lt;TaskModel&gt; PrepareListTaskModel()<br>        {<br>            List&lt;TaskModel&gt; taskModels = new List&lt;TaskModel&gt;();<br><br>            for (int i = 1; i&lt;=3; i++)<br>            {<br>                taskModels.Add(new TaskModel()<br>                {<br>                    Id = i,<br>                    Title = $&quot;{i}. Task&quot;,<br>                    Description = $&quot;{i}. Taskın açıklama metinidir.&quot;,<br>                    Status = i<br>                });<br>            }<br><br>            return taskModels;<br>        }<br>    }<br>}</pre><p>TaskModel içerisinde bulunan “PrepareListTaskModel” bize 3 elemanlı fake bir task listesi oluşturmaktadır.</p><p>Modelimizi oluşturduktan sonra Controller kısmına geçebilir ve methotlarımızı yazabiliriz.</p><p><strong>TaskController.cs :</strong></p><pre>using Microsoft.AspNetCore.Mvc;<br>using System.Text;<br>using System.Text.Json;<br>using TaskAPI.Model;<br><br>namespace TaskAPI.Controllers<br>{<br>    [Route(&quot;api/tasks&quot;)]<br>    [ApiController]<br>    public class TaskController : ControllerBase<br>    {<br>        private readonly IHttpClientFactory _httpClientFactory;<br>        public TaskController(IHttpClientFactory httpClientFactory)<br>        {<br>            _httpClientFactory = httpClientFactory;<br>        }<br><br>        [HttpGet(&quot;all&quot;)]<br>        public IActionResult GetAll()<br>        {<br>            var getallTasks = new TaskModel().PrepareListTaskModel();<br>            return Ok(getallTasks);<br>        }<br><br>        [HttpGet(&quot;get-tasks-by-id/{id}&quot;)]<br>        public IActionResult Get([FromRoute] int id)<br>        {<br>            return Ok(new TaskModel().PrepareListTaskModel().FirstOrDefault(x =&gt; x.Id == id));<br>        }<br><br>        [HttpPut(&quot;update-tasks-status&quot;)]<br>        public IActionResult UpdateTaskStatus([FromBody] TaskModel updateModel)<br>        {<br>            try<br>            {<br>                var task = new TaskModel().PrepareListTaskModel().FirstOrDefault(x =&gt; x.Id == updateModel.Id);<br>                task.Status = updateModel.Status;<br><br>                //Webhook tetiklenmeli ve bilgi akışı sağlanmalı.<br>                TriggerWebhook(task.Id);<br>                return Ok(new { payload = new { data = task, Message = &quot;Güncelleme işlemi başarıyla gerçekleşti&quot; } });<br>            }<br>            catch (Exception ex)<br>            {<br>                return BadRequest(new { payload = new { Message = &quot;Task&#39;ın statü değeri güncellenemedi.&quot; } });<br>            }<br>        }<br><br>        private async void TriggerWebhook(int id)<br>        {<br>            var httpClient = _httpClientFactory.CreateClient();<br><br>            // Webhook URL olarak MailAPI uygulamasının local adres bilgisini verebiliriz.<br>            string webhookUrl = &quot;https://localhost:7176&quot;;<br><br>            await httpClient.PostAsync($&quot;{webhookUrl}/api/mail/send&quot;, new StringContent(JsonSerializer.Serialize(id), Encoding.UTF8, &quot;application/json&quot;));<br>        }<br>    }<br>}</pre><p>TaskController içerisinde bizim için en kritik nokta UpdateTaskStatus ve TriggerWebhook methotları. UpdateTaskStatus methotunda x bir task’ın statü değeri değiştirildiğinde task’ı takip eden diğer uygulamaların bilgilenebilmesi için bir mail atılacaktır fakat mail uygulamamız ayrı bir uygulamadır işte tam olarak bu noktada task’ın statüsü update olduktan sonra webhook tetiklenmektedir. Bunu yapmanın birden fazla yolu mevcut ben daha anlaşılır olması açısından ve basit bir örnek üzerinden gittiğim için private methot yaparak bir http isteği ile süreci tamamladım fakat farklı yöntemleri de mevcuttur IPublisher kullanılarak bir evente publish edilebilir ve bu event içerisinden de http isteği sağlanılabilirdi yada Webhook worker yazılarak arka planda hosted service olarak sistemi takip ederek olayları yakalayıp bilgi akışı sağlanabilir.</p><p>TaskAPI uygulamamızda ki adımları tamamlandıktan sonra http isteği attığımız MailAPI uygulamasında ki geliştirmeyi yapabiliriz.</p><p><strong>MailController :</strong></p><pre>using Microsoft.AspNetCore.Mvc;<br><br>namespace MailAPI.Controllers<br>{<br>    [ApiController]<br>    [Route(&quot;api/mail&quot;)]<br>    public class MailController : ControllerBase<br>    {<br>        public MailController()<br>        {<br>        }<br><br>        [HttpPost(&quot;send&quot;)]<br>        public IActionResult Send(int id)<br>        {<br>            if (id &gt; 0)<br>            {<br>                Console.WriteLine($&quot;{id} numaralı task güncellendi&quot;);<br>                return Ok();<br>            }<br>            else<br>            {<br>                Console.WriteLine($&quot;Task güncellenirken hata oldu.&quot;);<br>                return BadRequest();<br>            }<br>        }<br>    }<br>}</pre><p>Gerçek bir mail gönderimi sağlamadığımız için ve bir taskı güncelledikten sonra webhook ile iletişim sağladığımız MailAPI response değerini görebilmek için response textini console bastım bu geliştirmeyi yaptıktan sonra örneğimizi test edebiliriz.</p><p>Swagger üzerinden all methotuna istek atarak tasklarımızın listesini elde edebiliriz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qlbdKnrb8YyzlQi9KwMDpQ.png" /></figure><p>Elde ettiğimiz tasklardan herhangi birinin statü değerini yine swagger üzerinden aşağıdaki görseldeki gibi update edebiliriz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7MlwrYghJpVVN9HayAa3-g.png" /></figure><p>Update işlemi gerçekleştikten sonra Webhook ile attığımız requestin yanıtı beklenmeden bize update edilen task’ın response bilgisi aşağıdaki gibi dönücektir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*KyqQ2uKr-oqehdY-KwySAw.png" /></figure><p>Güncelleme işlemi sağlandıktan sonra http isteği sonucu beklenmeden bize güncelleme işleminin tamamlandığına dair response dönmüştü ve bu bilgilendirme için MailAPI uygulamamıza istek atmıştık aşağıda ki görüntü güncellenen taskın güncellendiğine dair MailAPI’de ki response bilgisidir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*h1looCO_rjWNLXN-ZSs-0A.png" /></figure><p>Bu işlemler sayesinde 2 uygulama arasındaki haberleşmeyi sağlamış olduk ben en basit yöntem ile ilerledim makalenin önceki kısımlarında bahsetmiş olduğum gibi IPublisher kullanarak bir notification handler yazarak publisher ile güncelleme sonrası yönlendirme yapıp notification handler içerisinde de http isteği atarak aradaki iletişimi sağlayabilirdik veya bir diğer yöntem olan bir worker yazarak bunu da program.cs içerisinde hosted service olarak ekleyerek ilgili olayları dinletebilir ve bir olay gerçekleştiğinde arka planda da bu süreci ilerletebilirdik.</p><p>Örnek projeye <a href="https://github.com/SalimcanKaradeniz/NetCoreWebhookIntegration/tree/master">linkten</a> ulaşabilirsiniz.</p><p>Bir sonraki yazıda görüşmek üzere …</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=23daf85c9337" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[.NET Core Health Check Kullanımı & Health Check Nedir?]]></title>
            <link>https://medium.com/@salimcankaradeniz/net-core-health-check-kullan%C4%B1m%C4%B1-health-check-nedir-cb21b45f3b1b?source=rss-5285eada9698------2</link>
            <guid isPermaLink="false">https://medium.com/p/cb21b45f3b1b</guid>
            <category><![CDATA[backend-development]]></category>
            <category><![CDATA[c-sharp-programming]]></category>
            <category><![CDATA[net-core]]></category>
            <category><![CDATA[health-check]]></category>
            <category><![CDATA[devops]]></category>
            <dc:creator><![CDATA[Salimcan Karadeniz]]></dc:creator>
            <pubDate>Sun, 15 Oct 2023 16:05:53 GMT</pubDate>
            <atom:updated>2023-10-15T16:09:19.237Z</atom:updated>
            <content:encoded><![CDATA[<p>Selamlar,</p><p>Bugün ki yazımda sizlere Health Check nedir? .NET Core uygulamalarımızda nasıl yapılandarabiliriz konularında bilgiler vermeye çalışacağım.</p><p><strong>Health Check Nedir?</strong></p><p>Health Check uygulamalarımızın veya sistemin parçalarının sağlıklı çalışıp çalışmama durumlarını kontrol etmemizi sağlar.Bu kontrolleri bizlere sağlamış olduğu UI end pointi ile detaylı bir şekilde görüntüleyebiliriz.</p><p>Örneğin sistemlerimizin yayın hayatında ki akışlarını takip edebilmek için genelde loglama mekanizmaları kurabiliriz fakat bu loglama mekanizmaları uygulamamız yada servislerimiz sağlıklı/çalışır vaziyette olduğu sürece beslenebileceğimiz durumlardır.Uygulama sunucumuzun çalışmadığı,uygulamanın veritabanına erişelemediği yada rabbitMQ vs gibi kullanımlar sağladığımız sunucularda arza/erişim vs gibi sorunlar yaşadığımızda kurduğumuz log mekanizmaları ile takip edemeyebiliriz.Bu tarz durumlarda uygulamamızı takip edebileceğimiz servislerimizin ne durumda olduğunu inceleyebileceğimiz izleme(monitoring) inşaa etmeliyiz.Health Check sayesinde herhangi api’ye istek atmadan ilgili konfigürasyonlar yapıldıktan sonra loglama vb gibi yapılara ihtiyaç kalmadan uygulamalarımızın durumlarını takip edebilir ve izleyebiliriz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/888/1*gidSs_gAYTyjCjon1dM1Zg.png" /></figure><p><strong>.NET Core Health Check Entegrasyonu :</strong></p><p>Uygulamamızın yapısını oluştururken 3 adet .Net Core Web API projesi oluşturuyoruz bu api’lerden Account ve Product api’lerimizi uygulamalarımızın sağlık durumları açısından kontrole deceğiz 3. API uygulamamız da ise Health Check UI entegrasyonu yaparak Account ve Product api’lerimizin veritabanlarının ne konumda olduğunun kontrollerini sağlayacağız.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/413/1*4cSGimj9tCJYMiH4EjDy3A.png" /></figure><p>Öncelikle “<strong>Microsoft.Extensions.Diagnostics.HealthChecks</strong>”,”<strong>AspNetCore.HealthChecks.UI.Client</strong>”,”<strong>AspNetCore.HealthChecks.NpgSql</strong>” NuGet paketlerini projelerinize eklemeniz gerekir. Ben örneklerimde PostgreSQL kullandım siz farklı bir veritabanı kullanıcaksanız ona uygun paketi kurmanız gerekmektedir.NuGet paketlerini ekledikten sonra program.cs dosyasımızda aşağıda ki eklemeleri yapalım.</p><pre>builder.Services.AddHealthChecks()<br>.AddNpgSql(builder.Configuration.GetConnectionString(&quot;HealthCheckDb&quot;));<br><br>app.UseHealthChecks(&quot;/health&quot;, new HealthCheckOptions<br>{<br>    ResponseWriter = UIResponseWriter.WriteHealthCheckUIResponse<br>});</pre><p>Yukarıda ki eklemeleri yaptıktan sonra uygulamamızın hangi statülerde olduğunu görüntüleyebiliriz.3 adet statü durumumuz bulunmaktadır.</p><ul><li>Healthy, yazılımın problemsiz çalıştığını ifade eder.</li><li>Unhealthy, yazılımın çalışmasında bazı problemlerin var olduğunu ifade eder.</li><li>Degraded, yazılımın sorunsuz olduğunu fakat cevap süresinin çok fazla olduğunu ifade etmektedir.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/409/1*gWzQHRFUiVrRYAZOgDOgzQ.png" /></figure><p>Yukarıda ki görselde status alanına baktığımızda uygulamamızın sorunsuz çalıştığı görülmektedir.Herhangi bir UI üzerinden kontrol etmeden uygulamanızın adresi /health adresine giderek bir json çıktısı olarakta uygulamanızın durumunu görebilirsiniz.</p><p><strong>Health Check UI Entegrasyonu :</strong></p><p>Birden fazla servisten gelebilecek bilgileri tek bir arayüzden takip edebilmek için health check entegrasyonları yapıtğımız Account ve Product api projelerimizde değil farklı bir API projesi üzerinden entegrasyonu sağlayacağız.</p><p>Health Check UI entegrasyonuna başlarken projemize aşağıda ki NuGet paketlerimizi kuralım.</p><ul><li>AspNetCore.HealthChecks.UI</li><li>AspNetCore.HealthChecks.UI.Client</li><li>AspNetCore.HealthChecks.UI.PostgreSQL.Storage</li></ul><p>İlgili paketleri kurduktan sonra aşağıdaki konfigürasyonu program.cs dosyamıza ekleyelim.</p><pre>builder.Services<br>    .AddHealthChecksUI(settings =&gt;<br>    {<br>        settings.AddHealthCheckEndpoint(&quot;Account API&quot;, &quot;https://localhost:7084/health&quot;);<br>        settings.AddHealthCheckEndpoint(&quot;Product API&quot;, &quot;https://localhost:7111/health&quot;);<br>    }).AddPostgreSqlStorage(connectionString: builder.Configuration.GetConnectionString(&quot;MonitoringSQLServer&quot;));<br><br>app.UseHealthChecksUI(options =&gt; options.UIPath = &quot;/health-ui&quot;);</pre><p><strong>AddHealthChecksUI </strong>methotu ile Health Check UI arayüzünün konfigürasyonunu yapmış bulunmaktayız.Health Check UI arayüzünü entegre ederken lambda üzerinden <strong>AddHealthCheckEndpoint </strong>methotu ile hangi uygulamaların sağlık durumlarını kontrol edeceğimizi belirtiyoruz.Entegrasyona başlarken Product ve Account api’ler oluşturduk sonrasına bu api’lerimize health check entegre ederken “/health” diye bir endpoint belirlemiştik işte UI apimizde Product ve Account api’lerimizin “/health” end pointini dinleyerek orada yaşanan durumları bize bir UI üzerinden sunacaktır buradaki haberleşmenin konfigürasyonu <strong>AddHealthCheckEndpoint </strong>üzerinden sağlanmaktadır<strong>.</strong>UI uygulamamız api’lerimizden gelen durumları metrikleştirip/görselleştirip bizlere sunabilmesi için almış olduğu verileri bir yerde tutması depolaması gerekmektedir ben PostgreSQL kullandım bu yüzden db konfigürasyonum ise <strong>AddPostgreSqlStorage </strong>adımında yapılmaktadır<strong>.</strong></p><p>Connection string bilgileri doğru olduktan sonra uygulamayı derleyip ayağa kaldırdığınızda Health Check ilgili veritabanında migrate işlemi yaparak tablolarını vs kendisi oluşturmaktadır.</p><p><strong>UseHealthChecksUI ile </strong>uygulamımızda hangi route üzerinden kontrollerimizi sağlayacağımızı belirtiyoruz.</p><p>Yukarıda ki konfigürasyonları yaptıktan sonra uygulamamızı derleyip çalıştırabiliriz.Projemizi çalıştırırken 3 projeyi de multiple olarak çalıştırmayı unutmayalım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*AGRo5HcHgbZMUscVrZlpCw.png" /></figure><p>“<a href="https://localhost:7295/health-u">https://localhost:7295/health-u</a>i” adresine giderek Account ve Product api uygulamalarızın durumlarını inceleyebilirsiniz şuan uygulamamızda ve veritabanı erişiminde herhangi bir problem olmadığı için “Health” statüsünde gözükmektedir.Örneğimizde sadece PostgreSQL kullanıldığı için “npgsql” gözükmektedir fakat rabbitMQ,Kafka,Redis vs gibi teknolojileri de kullanmış olsaydık her teknoloji için burada tek tek onlarnda statülerini görüntüleyebilicektik.UnHealthy durumunu görebilmek için bir test daha gerçekleştirelim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*F24B-UHgdNlkzgYw9OM1cg.png" /></figure><p>Account API uygulamamızın connection string bilgisini var olmayan bir veritabanı ismi ile değiştirdim ve bulamadığı için hata aldık hatayı aldığımız gibi UI ekranı üzerinden Account API uygulamamızda bir problem yaşadığımızı görebiliyoruz.Bu şekilde Health Check UI entegrasyonu sağlayarak uygulamalarımızda yaşanan durumları metrikleri kolayca takip edebiliriz ve çözümler üretebiliriz.</p><p>Örnek projeye <a href="https://github.com/SalimcanKaradeniz/HealthCheckIntegration">linkten </a>ulaşabilirsiniz.</p><p>Bir sonraki yazıda görüşmek üzere …</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=cb21b45f3b1b" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[.NET Core ile CQRS&MediatR Kullanımı]]></title>
            <link>https://medium.com/@salimcankaradeniz/net-core-ile-cqrs-mediatr-kullan%C4%B1m%C4%B1-4ff281ace071?source=rss-5285eada9698------2</link>
            <guid isPermaLink="false">https://medium.com/p/4ff281ace071</guid>
            <category><![CDATA[net-core]]></category>
            <category><![CDATA[mediatr]]></category>
            <category><![CDATA[c-sharp-programming]]></category>
            <category><![CDATA[cqrs]]></category>
            <category><![CDATA[software-development]]></category>
            <dc:creator><![CDATA[Salimcan Karadeniz]]></dc:creator>
            <pubDate>Thu, 24 Aug 2023 11:48:18 GMT</pubDate>
            <atom:updated>2023-08-24T11:48:18.593Z</atom:updated>
            <content:encoded><![CDATA[<p>Selamlar,</p><p>Bugün ki yazımda .NET Core ile CQRS ve MediatR kullanımını anlatmaya çalışacağım.CQRS ve MediatR hakkında detaylı bilgiler vermeye çalışacağım.</p><p><strong>CQRS(Command Query Responsibility Segregation) Nedir?</strong></p><p>Yazma ve okuma işlemlerinin ayrıştırılmasına dayanan bir tasarım modelidir.CQS baz alınarak kurulmuştur.CQRS kullanarak uygulamanızın performansı ve ölçeklendirebilirliği en üst düzeye çıkabilir.</p><p><strong>Command :</strong></p><p>Veri Yazma işlemlerinin uygulandığı modeldir.Insert,Update,Delete gibi işlemleri gerçekleştiririz.</p><p><strong>Queries :</strong></p><p>Veri okuma işlemlerinin uygulandığı modeldir.Veritabanından veya x bir noktadan veri çekme işlemlerimizi gerçekleştiririz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/875/1*-IlOhrP_pzccSy3me14OMA.png" /></figure><p><strong>CQRS’in Avantajları :</strong></p><ol><li>Performans ve ölçeklendirebilirliği arttırmaya olanak sağlar.</li><li>Yazma ve okuma işlemleri için farklı veritabanları kullanılabilir.Örn: veri yazmak için PostgreSQL kullanırken veri okuma işlemlerimizi MSSQL/MongoDB üzerinden gerçekleştirebiliriz.</li><li>Projede ki bağımlılık en minimuma iner ve bizi karışık bağımlılıklarla karşlılaşma ihtimalimizi azaltmaya olanak sağlar</li></ol><p><strong>CQRS’in Dezavantajları :</strong></p><ol><li>Kod karmaşıklığı oluşturabilir.</li><li>Ayrı veritabanları ile işlemler uyguladığımızda <strong>Command</strong> işlemi sonrasında bir event ile veya farklı bir yöntem ile <strong>Read </strong>ettiğimiz noktada ki veriyi güncellemek isek <strong>Read </strong>işlemlerinde eski verileri göstermek durumunda kalabiliriz. <strong>CQRS Command işleminden sonra buradaki mesajlasma/event olayını zorunlu kılmamaktadır.</strong></li></ol><p><strong>CQRS’i Neden/Ne Zaman Kullanmalıyız ? :</strong></p><ol><li>Kompleks iş kurallarının olduğu projelerde kullanılabilir.</li><li>Yazma ve okuma işlemlerinin birbirinden bağımsız olmasını istediğimiz noktalarda kullanabiliriz.</li><li>Kod okunabilirliğini arttırabilir.</li></ol><p><strong>CQRS’i Ne Zaman Kullanmamalıyız ? :</strong></p><ol><li>İş kurallarının basit olduğu projelerde.</li><li>Temel CRUD işlemlerinin olduğu projelerde.</li></ol><p><strong>MediatR Nedir?</strong></p><p>MediatR, Meditor patternini kullanmamızı sağlayan bir kütüphanedir.Gevşek bağlılığı(loosely coupled) hedefler.</p><p><strong>Mediator Pattern Nedir ?</strong></p><p>Aynı interface‘’den türeyen nesneler arasındaki haberleşmeyi tek bir noktadan sağlar.Haberleşmeyi tek bir sınıf üzerinden gerçekleştirdiği için gevşek bağlılık(loosely coupled) sağlar.Bu konuyu en iyi özetleyen örnek uçak ve kule örneğidir hemen hemen herkes bu örneği vermektedir.Uçaklar birbiri ile iletişime geçmezler sadece kule ile iletişime geçerler ve tüm haberleşmeyi kule sağlar burada bizim kulemiz Mediator olurken uçaklar ise haberleşilmesi gereken classlardır.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/840/1*dau5XamkvgK9ByrVn_cDyg.png" /></figure><p><strong>CQRS&amp;MediatR .NET Core Entegrasyonu :</strong></p><p>1 adet .NET 7.0 Web API projesi ve 3 adet Domain,Infrastructure,Application isimli class librarylerimizi oluşturuyoruz.Projemizin yapısı aşağıdaki gibidir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/436/1*41eC0YKnZlE7Q3fpa3WJYQ.png" /></figure><p><strong>Infrastructure</strong> katmanı içerisine “<strong>ServiceCollectionExtensions</strong>” classımızı oluşturalım ve içerisine aşağıda ki kodları ekleyelim.<strong>ServiceCollectionExtensions </strong>classı içerisinde veritabanı bağlantımızı ve<strong> IRepository </strong>interfacemizi resolve etmek için kullanıyoruz<strong>.</strong></p><pre>public static class ServiceCollectionExtensions<br>{<br>   public static void AddInfrastructureServices(this IServiceCollection services, IConfiguration configuration)<br>   {<br>      services.AddDbContext&lt;NetCoreCQRSAndMediatRExampleDbContext&gt;((serviceProvider, dbContextBuilder) =&gt;<br>      {<br>         dbContextBuilder.UseNpgsql(configuration.GetConnectionString(&quot;PostgreSQLConnection&quot;),<br>           optionsBuilder =&gt;<br>           {<br>               optionsBuilder.MigrationsAssembly(&quot;NetCoreCQRSAndMediatRExample.Infrastructure&quot;);<br>               optionsBuilder.MigrationsHistoryTable(&quot;__EFMigrationsHistory&quot;, &quot;public&quot;);<br>            }).UseSnakeCaseNamingConvention();<br>       });<br><br>        services.AddScoped(typeof(IRepository&lt;&gt;), typeof(LinqToSqlRepository&lt;&gt;));<br>     }<br>}</pre><p>Ben veritabanı olarak PostgreSQL kullandım siz farklı veritabanı da tercih edebilirsiniz.ÖRN:(MSSQL,MySQL vb.)</p><p><strong>Domain </strong>katmanı içerisinde Entites klasörü altında Products isimli classımızı tanımlıyoruz.</p><pre>    public class Products<br>    {<br>        public Guid Id { get; set; }<br>        public string Name { get; set; }<br>        public string StockCode { get; set; }<br>        public int Quantity { get; set; }<br>        public decimal Price { get; set; }<br>        public decimal InstallmentPrice { get; set; }<br>        public decimal ListPrice { get; set; }<br>        public DateTime CreateTime { get; set; }<br>    }</pre><p><strong>Application </strong>katmanı içerisinde Command ve Query işlemlerimizi yapacağız. Application katmanı içerisinde <strong>Command </strong>ve <strong>Query </strong>isimli 2 adet klasör oluşturuyoruz.Bu klasörlerin içerisine <strong>Products </strong>isimli<strong> </strong>bir klasör daha oluşturuyoruz.Products klasörü içerisinde hem Command/Query işlemlerimizi gerçekleştireceğiz hemde request ve response modellerimizi oluşturacağımız <strong>Dto </strong>isimli<strong> </strong>bir klasör oluşturup içerisinde request ve response modellerimizi tanımlayacağız.</p><p><strong>CreateProductRequest</strong> :</p><pre>public class CreateProductRequest : IRequest&lt;CreateProductResponse&gt;<br>{<br>   public string StockCode { get; set; }<br>   public string Name { get; set; }<br>   public int Quantity { get; set; }<br>   public decimal Price { get; set; }<br>   public decimal InstallmentPrice { get; set; }<br>   public decimal ListPrice { get; set; }<br>        <br>}</pre><p><strong>CreateProductResponse :</strong></p><pre>    public class CreateProductResponse<br>    {<br>        public Guid Id { get; set; }<br>        public bool Success { get; set; }<br>        public string Message { get; set; }  <br>    }</pre><p><strong>ProductGetAllQueryRequest :</strong></p><pre>    public class ProductGetAllQueryRequest : IRequest&lt;List&lt;ProductGetAllQueryResponse&gt;&gt;<br>    {<br><br>    }</pre><p><strong>ProductGetAllQueryResponse :</strong></p><pre>    public class ProductGetAllQueryResponse<br>    {<br>        public Guid Id { get; set; }<br>        public string Name { get; set; }<br>        public string StockCode { get; set; }<br>        public int Quantity { get; set; }<br>        public decimal Price { get; set; }<br>        public decimal InstallmentPrice { get; set; }<br>        public decimal ListPrice { get; set; }<br>        public DateTime CreateTime { get; set; }<br>    }</pre><p><strong>ProductGetByIdQueryRequest :</strong></p><pre>public class ProductGetByIdQueryRequest : IRequest&lt;ProductGetByIdQueryResponse&gt;<br>{<br>    public Guid Id { get; set; }<br>}</pre><p><strong>ProductGetByIdQueryResponse :</strong></p><pre>public class ProductGetByIdQueryResponse<br>{<br>    public Guid Id { get; set; }<br>    public string Name { get; set; }<br>    public string StockCode { get; set; }<br>    public int Quantity { get; set; }<br>    public decimal Price { get; set; }<br>    public decimal InstallmentPrice { get; set; }<br>    public decimal ListPrice { get; set; }<br>    public DateTime CreateTime { get; set; }<br>}</pre><p>Request ve response modellerimizi yukarıda ki gibi tanımlıyoruz.</p><p>Manage Nuget Packages üzerinden <strong>MediatR</strong> kütüphanesi kuruyoruz ve sonrasında <strong>Application</strong> katmanı içerisinde <strong>ServiceCollectionExtensions </strong>isimli bir class oluşturarak aşağıda ki gibi<strong> MediatR </strong>tanımlamasını gerçekleştiriyoruz.</p><p><strong>ServiceCollectionExtensions :</strong></p><pre>public static class ServiceCollectionExtensions<br>{<br>    public static void ApplicationServiceCollection(this IServiceCollection services)<br>    {<br>        services.AddMediatR(x =&gt;<br>        {<br>            x.RegisterServicesFromAssemblyContaining(typeof(ServiceCollectionExtensions));<br>        });<br>    }<br>}</pre><p>Tüm tanımlamaları model oluşturma işlemlerini bitirdiğimize göre artık Command ve Query kodlarımızı gerçekleştirebiliriz.</p><p><strong>CreateProductCommand :</strong></p><pre>public class CreateProductCommand : IRequestHandler&lt;CreateProductRequest,CreateProductResponse&gt;<br>{<br>    private readonly IRepository&lt;NetCoreCQRSAndMediatRExample.Domain.Entities.Products&gt; _productsRepository;<br>    public async Task&lt;CreateProductResponse&gt; Handle(CreateProductRequest request,CancellationToken cancellationToken)<br>    {<br>        var product = await _productsRepository.Table.FirstOrDefaultAsync(x =&gt; x.StockCode == request.StockCode);<br>        if (product != null)<br>            return new CreateProductResponse { Message = &quot;Girdiğiniz stok kodu farklı bir ürün tarafından kullanılmaktadır.Lütfen kontrol ediniz.&quot;, Success = false};<br><br>        var newProduct = new NetCoreCQRSAndMediatRExample.Domain.Entities.Products<br>        {<br>            Id = Guid.NewGuid(),<br>            Name = request.Name,<br>            StockCode = request.StockCode,<br>            Quantity = request.Quantity,<br>            Price = request.Price,<br>            InstallmentPrice = request.InstallmentPrice,<br>            ListPrice = request.ListPrice,<br>            CreateTime = DateTime.Now,<br>        };<br><br>        await _productsRepository.InsertAsync(product);<br>        await _productsRepository.SaveAllAsync();<br><br>        return new CreateProductResponse<br>        {<br>            Success = product.Id != Guid.Empty ? true : false, <br>            Id = product.Id,<br>        };<br><br>    }<br>}</pre><p><strong>ProductGetAllQuery :</strong></p><pre>public class ProductGetAllQuery : IRequestHandler&lt;ProductGetAllQueryRequest, List&lt;ProductGetAllQueryResponse&gt;&gt;<br>{<br>    private readonly IRepository&lt;NetCoreCQRSAndMediatRExample.Domain.Entities.Products&gt; _productRepository;<br><br>    public ProductGetAllQuery(IRepository&lt;NetCoreCQRSAndMediatRExample.Domain.Entities.Products&gt; productRepository)<br>    {<br>        _productRepository = productRepository;<br>    }<br><br>    public async Task&lt;List&lt;ProductGetAllQueryResponse&gt;&gt; Handle(ProductGetAllQueryRequest request, CancellationToken cancellationToken)<br>    {<br>        return await _productRepository.Table.Select(x =&gt; new ProductGetAllQueryResponse<br>        {<br>            Id = x.Id,<br>            Name = x.Name,<br>            StockCode = x.StockCode,<br>            Quantity = x.Quantity,<br>            Price = x.Price,<br>            InstallmentPrice = x.InstallmentPrice,<br>            ListPrice = x.ListPrice,<br>            CreateTime = x.CreateTime,<br>        }).ToListAsync();<br>    }<br>}</pre><p><strong>ProductGetByIdQuery :</strong></p><pre>public class ProductGetByIdQuery : IRequestHandler&lt;ProductGetByIdQueryRequest, ProductGetByIdQueryResponse&gt;<br>{<br>    private readonly IRepository&lt;NetCoreCQRSAndMediatRExample.Domain.Entities.Products&gt; _productRepository;<br>    public ProductGetByIdQuery(IRepository&lt;NetCoreCQRSAndMediatRExample.Domain.Entities.Products&gt; productRepository)<br>    {<br>        _productRepository = productRepository;<br>    }<br><br>    public async Task&lt;ProductGetByIdQueryResponse&gt; Handle(ProductGetByIdQueryRequest request, CancellationToken cancellationToken)<br>    {<br>        var product = await _productRepository.Table.FirstOrDefaultAsync(x =&gt; x.Id == request.Id);<br>        if (product == null)<br>            return new ProductGetByIdQueryResponse();<br><br>        return new ProductGetByIdQueryResponse<br>        {<br>            Id = product.Id,<br>            Name = product.Name,<br>            StockCode = product.StockCode,<br>            Price = product.Price,<br>            InstallmentPrice = product.InstallmentPrice,<br>            ListPrice = product.ListPrice,<br>            Quantity = product.Quantity,<br>            CreateTime = product.CreateTime<br>        };<br>    }<br>}</pre><p>Command ve Query’lerimizi de yazdığımıza göre artık API tarafına geçebiliriz MediatR ile isteklerimizi atıp uygulamamızı test edebiliriz.</p><p>API projemiz içerisin de bulunan <strong>Program.cs</strong> dosyasına aşağıda ki eklemeyi yapıyoruz.</p><pre>// application ve Infrastructure katmanında bulunan Service Collection classlarımızı tanımlıyoruz.<br>builder.Services.AddInfrastructureServices(builder.Configuration);<br>builder.Services.ApplicationServiceCollection();</pre><p><strong>ProductController :</strong></p><pre>[ApiController]<br>[Route(&quot;api/product&quot;)]<br>public class ProductsController : ControllerBase<br>{<br>    IMediator _mediator;<br>    public ProductsController(IMediator mediator)<br>    { <br>        _mediator = mediator;<br>    }<br>    #region Command<br>    [HttpPost(&quot;CreateProduct&quot;)]<br>    public async Task&lt;IActionResult&gt; CreateProduct(CreateProductRequest request)<br>    {<br>        return Ok(await _mediator.Send(request));<br>    }<br><br>    #endregion<br>    #region Queries<br>    [HttpGet(&quot;GetProducts&quot;)]<br>    public async Task&lt;IActionResult&gt; GetProducts(ProductGetAllQueryRequest request)<br>    {<br>        return Ok(await _mediator.Send(request));<br>    }<br><br>    [HttpGet(&quot;GetProductById&quot;)]<br>    public async Task&lt;IActionResult&gt; GetProductById([FromQuery] ProductGetByIdQueryRequest request)<br>    {<br>        return Ok(await _mediator.Send(request));<br>    }<br>    #endregion<br>}</pre><p>Yukarı’da ki ProductsController içerisinde bulunan end pointlere istek geldiğinde MediatR kütüphanesinin <strong>Send </strong>methotu ile ilgli end point için yazılmış <strong>Handler’</strong>e yönlendirilir.</p><p>MediatR gelen isteği hangi <strong>Handler</strong>’e yönlendirmesi gerektiğini nereden biliyor/yakalıyor sorusunun cevabı ise şu şekilde;</p><p>Send methotu ilgili request tipinde bulunan handler’e yönlendirme sağlıyor bu ise Command veya Query işlemleri yaptığımızda <strong>IRequestHandler </strong>üzerinden classımızı türeterek belirtiyoruz.<strong>IRequestHandler </strong>methotu <strong>TRequest ve TResponse değerleri almaktadır.</strong></p><p>Örneğin bizim <strong>ProductGetByIdQuery </strong>aksiyonumuzda <strong>IRequestHandler ProductGetByIdQueryRequest, ProductGetByIdQueryResponse </strong>modellerini belirtilmiş. API tarafında “GetProductById” end pointine gelen istek <strong>ProductGetByIdQueryRequest </strong>ise IRequestHandler tanımından dolayı MediatR bu isteğin ProductGetByIdQuery’inin Handler methotuna yönlenmesi gerektiğini yakalıyor ve yönlendirmeyi gerçekleştiriyor.</p><p><strong>CreateProduct Request :</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8peXu6RbwAoSP2MW_10Tjg.png" /></figure><p><strong>CreateProduct Response :</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rStFSiejMUTqxB3hvrJ4bQ.png" /></figure><p><strong>GetProductByIdQuery Request :</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*y0RVuP1tULHUf7eID5iG8A.png" /></figure><p><strong>GetProductByIdQuery Response:</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ydHjQ5C_SUtw28YDJeWYLg.png" /></figure><p>Örnek projeye <a href="https://github.com/SalimcanKaradeniz/NetCoreCQRSAndMediatRExample/tree/master">linkten </a>ulaşabilirsiniz.</p><p>Başka bir konuda görüşmek üzere…</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4ff281ace071" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[.NET Core ile YARP Kullanımı]]></title>
            <link>https://medium.com/@salimcankaradeniz/net-core-ile-yarp-kullan%C4%B1m%C4%B1-bc3b42445e22?source=rss-5285eada9698------2</link>
            <guid isPermaLink="false">https://medium.com/p/bc3b42445e22</guid>
            <category><![CDATA[c-sharp-programming]]></category>
            <category><![CDATA[net-core]]></category>
            <category><![CDATA[devops]]></category>
            <category><![CDATA[yarp]]></category>
            <category><![CDATA[backend]]></category>
            <dc:creator><![CDATA[Salimcan Karadeniz]]></dc:creator>
            <pubDate>Mon, 21 Aug 2023 10:13:59 GMT</pubDate>
            <atom:updated>2023-08-21T10:47:27.771Z</atom:updated>
            <content:encoded><![CDATA[<p>Selamlar,</p><p>Bugün sizlere YARP(Yet Another Reverse Proxy) ile API GATEWAY oluşturarak bilgiler vermeye çalışacağım.</p><p><strong>API GATEWAY Nedir?</strong></p><p>API GATEWAY birden fazla uygulamanın haberleşmesini veri alışverişinde bulunmasını sağlar ve buradaki trafiği yönetir.API Gateway gelen istekleri alır ve bu istekleri uygun API veya API’lere yönlendirir.Yönlendirilmiş olan API’lerden dönen cevabı ise isteği gönderen cliente iletir.</p><p><strong>API GATEWAY Araçları :</strong></p><ol><li>YARP</li><li>NGINX</li><li>APACHE APISIX</li><li>APIMAN</li><li>OCELOT</li></ol><p><strong>Reverse Proxy Nedir?</strong></p><p>Cacheleme,sunucularda ki işlem yükünü dengelemek,saldırılardan korunmak gibi çözümler sağlamaktadır.</p><p>Örneğin : Product Api,Order Api,Identity Api olmak üzere 3 farklı api uygulamam bulunmaktadır.Client atacağı isteklerde direkt olarak bu 3 apiye istek atmaktansa araya konulan API Gateway uygulamasına istek atar API Gateway bu isteği karşılayarak ilgili API uygulamasına yönlendirip dönen cevabı client tarafına iletir.Bu gibi senaryolarda Reverse Proxy kullanılmaktadır.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/786/1*B92k9hxMbcMXxwhrH5qgRA.png" /></figure><p><strong>YARP(Yet Another Reverse Proxy) Nedir?</strong></p><p>YARP(Yet Another Reverse Proxy) Microsoft tarafından C# ile geliştirilen, özelleştirebileceğimiz temel proxy işlevselliği ve API GATEWAY hizmeti sağlayan pakettir.Hem kod üzerinden hemde file üzerinden konfigürasyon yapılabilmesine imkan sağlamaktadır.</p><p><strong>Özellikleri :</strong></p><ol><li>CORS kullanım imkanı sağlamaktadır.</li><li>Code based ve file based konfigürasyon yapmamıza olanak taınmaktadır.</li><li>Birden fazla Load Balancing seçeneği sunarak yükü dengelememize olanak sağlamaktadır.</li><li>HTTP 3 protokolünü desteklemektedir.</li></ol><p><strong>YARP .NET Entegrasyonu :</strong></p><p>1 adet API Gateway 3 adet ise servisleri temsil eden API projeleri oluşturuyoruz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/354/1*KhTa4I7LEAnlqJl-LdTwGg.png" /></figure><p>NetCoreYARPEntegration.APIGATEWAY projesi içerisinde ki controllers klasörünü silebiliriz çünkü bu projemizde herhangi bir business işlemi yapılmayacaktır gelen istek karşılanıp ilgili servis apilerine yönlendirmeleri yapılacaktır.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/336/1*gGJeBWjvmAS5RV3KB9iOcw.png" /></figure><p>API GATEWAY projesinde YARP paketini kurarak işlemlere başlayabiliriz.</p><p>NugetPackages’den YARP.ReverseProxy paketini install edebilirsiniz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sTMWmhffwdzh7rWy0HDbRA.png" /></figure><p>YARP paketinin tetiklenebilmesi için program.cs dosyası içerisinde gerekli tanımlamaları yapabiliriz.</p><pre>var builder = WebApplication.CreateBuilder(args);<br><br>// Add services to the container.<br><br>builder.Services.AddControllers();<br>// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle<br>builder.Services.AddEndpointsApiExplorer();<br>builder.Services.AddSwaggerGen();<br><br>// YARP AddReverseProxy<br>builder.Services.AddReverseProxy()<br>                .LoadFromConfig(builder.Configuration.GetSection(&quot;ReverseProxy&quot;));<br><br>var app = builder.Build();<br><br>// YAPR Add MapReverseProxy<br>app.MapReverseProxy();<br><br>// Configure the HTTP request pipeline.<br>if (app.Environment.IsDevelopment())<br>{<br>    app.UseSwagger();<br>    app.UseSwaggerUI();<br>}<br><br>app.UseHttpsRedirection();<br><br>app.UseAuthorization();<br><br>app.MapControllers();<br><br>app.Run();</pre><p>YARP paketinin gelen istekleri ilgili servis uygulamalarına yönlendirebilmesi için <strong>route mapping ve cluster </strong>tanımlamalarını yapmamız gerekmektedir. <strong>appsettings.json</strong> dosyasına aşağıda ki bilgileri ekleyebiliriz.</p><pre>{<br>  &quot;ReverseProxy&quot;: {<br>      &quot;Routes&quot;: {<br>        &quot;customer_routes&quot;: {<br>          &quot;ClusterId&quot;: &quot;order_api&quot;,<br>          &quot;Match&quot;: {<br>            &quot;Path&quot;: &quot;/api/orders/{**catchall}&quot;<br>          }<br>        },<br>        &quot;product_routes&quot;: {<br>          &quot;ClusterId&quot;: &quot;product_api&quot;,<br>          &quot;Match&quot;: {<br>            &quot;Path&quot;: &quot;/api/products/{**catchall}&quot;<br>          }<br>        },<br>        &quot;shipping_routes&quot;: {<br>          &quot;ClusterId&quot;: &quot;shipping_api&quot;,<br>          &quot;Match&quot;: {<br>            &quot;Path&quot;: &quot;/api/shipping/{**catchall}&quot;<br>          }<br>        }<br>      },<br>      &quot;Clusters&quot;: {<br>        &quot;order_api&quot;: {<br>          &quot;Destinations&quot;: {<br>            &quot;destination1&quot;: {<br>              &quot;Address&quot;: &quot;https://localhost:7297/&quot;<br>            }<br>          }<br>        },<br>        &quot;product_api&quot;: {<br>          &quot;Destinations&quot;: {<br>            &quot;destination1&quot;: {<br>              &quot;Address&quot;: &quot;https://localhost:7158/&quot;<br>            }<br>          }<br>        },<br>        &quot;shipping_api&quot;: {<br>          &quot;Destinations&quot;: {<br>            &quot;destination1&quot;: {<br>              &quot;Address&quot;: &quot;https://localhost:7285/&quot;<br>            }<br>          }<br>        }<br>      }<br>    }<br>}</pre><p><strong>Routes Nedir?</strong></p><p>Routes olarak adlandırılan bölümde gelen istekte hangi path’in/patter’nin hangi clustere gideceği belirtilir.</p><p><strong>Clusters Nedir?</strong></p><p>Clusters olarak adlandırılan bölümde gelen isteklerin yönleneceği servis uygulamamalarımızın tanımlamaları yapılmaktadır.</p><p>Uygulamalarımızın tamamını aynı anda çalıştırarak testlerimize başlayabiliriz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/977/1*TiHRpR7EK1ARX4uomoGdrg.png" /></figure><p>Testi postman üzerinden gerçekleştireceğim ve istek atacağım uygulama sadece API GATEWAY uygulaması olacak.API GATEWAY ise atacağım isteği ilgili uygulamaya yönlendirerek bize ilgili response değerini dönecektir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2Xjz8_25Oza-LjW-8t3sIQ.png" /></figure><p>Dikkat ederseniz <strong>appsettings.json</strong> dosyasında OrderAPI uygulamasının end pointi “https://localhost:7297” fakat biz isteğimizi <a href="https://localhost:7297/">https://localhost:72</a>69 yani API GATEWAY uygulamamızın adresine attık ve API GATEWAY uygulamamız bizi Order API’ye yönlendirerek response bilgisini geri döndü.</p><p>YARP ile şuana kadar yapmış olduğumuz tüm işlemler file based işlemlerdi appsettings.json dosyası üzerine yapmış olduğumuz tanımlamalar üzerinden süreci ilerlettik gelin birde bunu code based olarak yapalım.</p><p>Öncelikle API GATEWAY projemiz içerisine “YarpCustomProxyConfiguration” isimli bir class oluşturuyoruz ve içerisine aşağıda bulunan kodları yazıyoruz.</p><pre>public class YarpCustomProxyConfiguration : IProxyConfigProvider<br>{<br>    private CustomMemoryConfig _config;<br><br>    public YarpCustomProxyConfiguration()<br>    {<br>       var routeConfigs = new[]<br>       {<br>          new RouteConfig<br>          {<br>            RouteId = &quot;order_routes&quot;,<br>            ClusterId = &quot;order_api&quot;,<br>            Match = new RouteMatch<br>            {<br>               Path = &quot;/api/orders/{**catch-all}&quot;<br>            }<br>         },<br>          new RouteConfig<br>          {<br>             RouteId = &quot;product_routes&quot;,<br>             ClusterId = &quot;product_api&quot;,<br>             Match = new RouteMatch<br>             {<br>                Path = &quot;/api/products/{**catch-all}&quot;<br>             }<br>            },<br>            new RouteConfig<br>            {<br>               RouteId = &quot;shipping_routes&quot;,<br>               ClusterId = &quot;shipping_api&quot;,<br>               Match = new RouteMatch<br>               {<br>                  Path = &quot;/api/shippings/{**catch-all}&quot;<br>                }<br>             }<br>        };<br><br>        var clusterConfigs = new[]<br>        {<br>           new ClusterConfig<br>           {<br>              ClusterId = &quot;order_api&quot;,<br>              LoadBalancingPolicy = LoadBalancingPolicies.RoundRobin,<br>              Destinations = new Dictionary&lt;string, DestinationConfig&gt;<br>              {<br>                 { &quot;destination&quot;, new DestinationConfig { Address = &quot;https://localhost:7297/&quot; } },<br>              }<br>           },<br>           new ClusterConfig<br>           {<br>              ClusterId = &quot;product_api&quot;,<br>              LoadBalancingPolicy = LoadBalancingPolicies.RoundRobin,<br>              Destinations = new Dictionary&lt;string, DestinationConfig&gt;<br>              {<br>                 { &quot;destination&quot;, new DestinationConfig { Address = &quot;https://localhost:7158/&quot; } },<br>              }<br>           },<br>           new ClusterConfig<br>          {<br>             ClusterId = &quot;shipping_api&quot;,<br>             LoadBalancingPolicy = LoadBalancingPolicies.RoundRobin,<br>             Destinations = new Dictionary&lt;string, DestinationConfig&gt;<br>             {<br>                { &quot;destination&quot;, new DestinationConfig { Address = &quot;https://localhost:7285/&quot; } },<br>             }<br>          },<br><br>         };<br><br>         _config = new CustomMemoryConfig(routeConfigs, clusterConfigs);<br><br>        }<br>        public IProxyConfig GetConfig() =&gt; _config;<br><br>        private class CustomMemoryConfig : IProxyConfig<br>        {<br>            private readonly CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();<br>            public CustomMemoryConfig(IReadOnlyList&lt;RouteConfig&gt; routes, IReadOnlyList&lt;ClusterConfig&gt; clusters)<br>            {<br>                Routes = routes;<br>                Clusters = clusters;<br>                ChangeToken = new CancellationChangeToken(cancellationTokenSource.Token);<br>            }<br>            public IReadOnlyList&lt;RouteConfig&gt; Routes { get; }<br><br>            public IReadOnlyList&lt;ClusterConfig&gt; Clusters { get; }<br><br>            public IChangeToken ChangeToken { get; }<br><br>            internal void SignalChange()<br>            {<br>                cancellationTokenSource.Cancel();<br>            }<br>        }<br>    }</pre><p>İlk verdiğimiz örnekte appsettings.json üzerinden ilerlemiştik ve uygulamamız ayağa kalkarken appsettings.json üzerinden konfigüre ediliyordu fakat artık code base işlem yaptığımız için değişiklik yapmamız gerekiyor.</p><p>appsettings.json dosyasına “UseCodeBasedConfig” isimli bir property oluşturuyoruz bunun nedeni ise “UseCodeBasedConfig” true ise Code Base yapılan işlemi tetikletmek false ise appsettings.json üzerinde yaptığımız File Base işlemini tetikletmek için kullanacağız.</p><p>appsettings.json dosyasına aşağıda ki gibi ekleme yapıyoruz.</p><pre>&quot;YarpUseCodeBasedConfig&quot;: true</pre><p>appsettings.json dosyasına eklediğimiz “YarpUseCodeBasedConfig” değerine göre tetikleme durumunu yapacağız program.cs dosyasında aşağıda ki gibi değişiklik yapıyoruz.</p><pre>using Microsoft.Extensions.Configuration;<br>using NetCoreYARPEntegration.APIGATEWAY;<br>using Yarp.ReverseProxy.Configuration;<br><br>var builder = WebApplication.CreateBuilder(args);<br>IConfiguration _configuration = builder.Configuration;<br><br>// Add services to the container.<br><br>builder.Services.AddControllers();<br>// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle<br>builder.Services.AddEndpointsApiExplorer();<br>builder.Services.AddSwaggerGen();<br><br>// YARP AddReverseProxy<br>if (_configuration.GetValue&lt;bool&gt;(&quot;UseCodeBasedConfig&quot;))<br>{<br>    builder.Services.AddSingleton&lt;IProxyConfigProvider&gt;(new YarpCustomProxyConfiguration()).AddReverseProxy();<br>}<br>else<br>{<br>    builder.Services.AddReverseProxy()<br>                .LoadFromConfig(builder.Configuration.GetSection(&quot;ReverseProxy&quot;));<br>}<br><br>var app = builder.Build();<br><br>// YAPR Add MapReverseProxy<br>app.MapReverseProxy();<br><br>// Configure the HTTP request pipeline.<br>if (app.Environment.IsDevelopment())<br>{<br>    app.UseSwagger();<br>    app.UseSwaggerUI();<br>}<br><br>app.UseHttpsRedirection();<br><br>app.UseAuthorization();<br><br>app.MapControllers();<br><br>app.Run();</pre><p>Tüm eklemelerimiz ve yapacağımız ayarlar bitti File Based işlemde olduğu gibi uygulamamızı multiple çalıştırarak 4 uygulamayı aynı anda ayağa kaldırarak postman üzerinden testimizi gerçekleştiriyoruz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vx8KoVNRQX4XUOVeRfQAeQ.png" /></figure><p>Projeye <a href="https://github.com/SalimcanKaradeniz/NetCoreYARPEntegration/tree/master">linkten </a>ulaşabilirsiniz.</p><p>Başka bir konuda görüşmek üzere…</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=bc3b42445e22" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[.NET Core ile Redis Cache Kullanımı]]></title>
            <link>https://medium.com/@salimcankaradeniz/net-core-ile-redis-cache-kullan%C4%B1m%C4%B1-4c21024a0ed8?source=rss-5285eada9698------2</link>
            <guid isPermaLink="false">https://medium.com/p/4c21024a0ed8</guid>
            <category><![CDATA[net-core]]></category>
            <category><![CDATA[caching]]></category>
            <category><![CDATA[redis]]></category>
            <dc:creator><![CDATA[Salimcan Karadeniz]]></dc:creator>
            <pubDate>Wed, 09 Aug 2023 17:29:31 GMT</pubDate>
            <atom:updated>2023-08-09T17:33:52.782Z</atom:updated>
            <content:encoded><![CDATA[<p>Selamlar,</p><p>Bugün ki makalemizde Redis Nedir? Redis’in kurulumu nasıl gerçekleştirilir ve .NET Core ile nasıl entegre olabiliriz sizlere basitçe anlatmaya çalıştım.</p><p><strong>Redis Nedir?</strong></p><p>Redis open source olarak yazılmış bir NoSQL veri tabanıdır. Key-Value şeklinde verileri depolamamıza yaramaktadır. Günümüzde geliştiriciler tarafından sıklıkla tercih edilmektedir ve caching mekanizmaları için kullanılmaktadır.</p><p>Redis bir Distributed Cache yöntemi olduğu için, Cache verileri ayrı bir cache service’sinde tutulur.</p><p>Bulunduğu sunucu üzerinde verileri RAM bellekte tutmaktadır. Sunucunun restart olması veya kapanması gibi durumlarda cachelenen verilerin silinebilme ihtimaline karşı verileri aynı zamanda disk üzerinde de tutabilmemize olanak sağlar ve bu sayede veri tutarlılığı sağlanabilmektedir.</p><p>Redis, C#, Python, Java, PHP, Go gibi bir çok programlama dilini desteklemektedir.</p><p>Redis’in en önemli özelliklerinden bir tanesi performanslı çalışmasıdır verileri bellek üzerinden mili saniyelerde client tarafına dönebilmektedir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qMvVyjQzRtjGE--AV-PuqA.png" /></figure><p><strong>Redis’in Avantajları :</strong></p><p>1. <strong>Çoklu Veri Yapıları</strong> : Redis, verileri key-value şeklinde tutmamızı sağlar.Her bir key değeri farklı veri yapılarında değerler barındırabilmektedir. Örn : String,List,int vb.</p><p>2. <strong>Performans :</strong> Verileri bellek üzerinde saklamaktadır bu özelliği ile disklere erişim sağlamaz ve daha az CPU kullanarak verilere erişim sağlamaktadır.</p><p>3. <strong>Veri Kalıcılığı :</strong> Redis, verileri bellekte tutmaktadır fakat sunucunun kapanması veya restart olması gibi durumlarda veri kaybı ihtimali doğmaktadır bu veri kaybı ihtimalinin önüne geçmek için Redis bize seçenek sunmaktadır. Bu seçenek <strong>Point-Intime Snapshots</strong> seçeneğidir. <strong>Point-Intime Snapshots</strong> seçeneği belirli aralıklar ile bellekte tutulan verinin bir kopyasını diske kaydeder ve olası bir sunucu kapanması/restart edilmesi gibi durumlarda diskten tekrar ilgili veri kullanımını sağlamaktadır.</p><p><strong>Redis’in Dezavantajları :</strong></p><p>1. Tutulacak veri boyutuna göre RAM ihtiyacı yaratabilmektedir.</p><p>2. İlişkisel veritabanlarında(MSSQL,MySQL) gerçekleştirmiş olduğumuz gibi kompleks sorgulama yapmamızı desteklemez.</p><p><strong>Redis’in Çalışma Mantığı :</strong></p><p>1. Uygulamamızda cache’lemek istediğimiz veriyi server’dan çekip daha sonra cachelemek istediğimiz alanları/oluşturacağımız şemayı belirleyerek redis’e kaydediyoruz.</p><p>2. Cache’lenen veriye ihtiyaç duyulan istekte artık veriyi alıp işleyebilmek için server’e gitmek yerine ilk önce istenen veri redis’te(cache’de) var mı diye kontrol ediyoruz eğer veri redis’te(cache’de) var ise veriyi server’e gitmeden direkt olarak client tarafına dönüyoruz.</p><p>3. Eğer ki veri redis’te yok ise tekrar server’e gidip ilgili veriyi alıp redis’e kaydedip client tarafına dönüyoruz.</p><p><strong>Redis Kurulumu :</strong></p><p>Cihazınıza redisi kurabilmek için <a href="https://github.com/microsoftarchive/redis/releases/download/win-3.0.504/Redis-x64-3.0.504.zip">link </a>üzerinden Redis’i indirebilirsiniz.İndirdikten sonra klasörün içerisinde bulunan <strong>redis-server.exe</strong>’yi çalıştırmanız gerekmtekdir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ob3e9fSYUyNVbAwrCqppFg.png" /></figure><p>Yukarıda ki işaretlenmiş alanda Redis’in çalışmış olduğu gözükmektedir.Kurulum sonrası port açılan ekranda port bilgileriniz ve running yazısı gözükmekte ise kurulumunuz başarıyla gerçekleşmiştir.Redis’i test etmek için <strong>redis-cli.exe</strong>’yi çalıştırarak testlerimizi gerçekleştirebilir kurulumdan emin olabiliriz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*0rCKgv-7vEDhFGPS9BxUog.png" /></figure><p><strong>Redis .NET Entegrasyonu :</strong></p><p>.NET 6.0 Web API projesi açarak Redis entegrasyonu sağlayacağız.Projeyi oluşturduktan sonra nugette bulunan <strong>StackExchane.Redis</strong> paketini kurmanız gerekmektedir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bUBNwY_5R2gP0vrvkMqM9w.png" /></figure><p>İlgili paketi kurduktan sonra sırası ile aşağıda ki adımları gerçekleştireceğiz.</p><p><strong>appsettings.json </strong>dosyasına redis connection bilgilerini ekliyoruz default portu kullandığımız için herhangi bir port bilgisi eklememize gerek yoktur.</p><pre>{<br>  &quot;Logging&quot;: {<br>    &quot;LogLevel&quot;: {<br>      &quot;Default&quot;: &quot;Information&quot;,<br>      &quot;Microsoft.AspNetCore&quot;: &quot;Warning&quot;<br>    }<br>  },<br>  &quot;AllowedHosts&quot;: &quot;*&quot;,<br>  &quot;ConnectionStrings&quot;: {<br>    &quot;Redis&quot; : &quot;localhost&quot;<br>  }<br>}</pre><p><strong>Program.cs </strong>dosyasına aşağıda ki configuration tanımalamarını yapıyoruz.</p><pre>IConfiguration configuration = builder.Configuration;<br>var redisConnection = ConnectionMultiplexer.Connect(configuration.GetConnectionString(&quot;Redis&quot;));<br>builder.Services.AddSingleton&lt;IConnectionMultiplexer&gt;(redisConnection);</pre><p>Bu aşamalardan sonra projemize bir tane .NET class library oluşturacağız ve cache service işlemlerimizi bu katmanda gerçekleştireceğiz. Katmanımızı oluşturduktan sonra içerisine <strong>Interfaces </strong>ve <strong>Services </strong>olmak üzere 2 adet klasör oluşturuyoruz .Interfaces klasörü içerisine <strong>IRedisCacheService </strong>isimli bir interface oluşturduktan sonra Services klasörü içerisine de <strong>RedisCacheService</strong> isimli classımızı oluşturuyoruz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/347/1*5_AT_Gb6QTueTLuc_PW-Xg.png" /></figure><p>IRedisCacheService ve RedisCacheSerevice classlarımızı tanımladıktan sonra Redis ile işlemler yapmamızı sağlayan methot tanımlarını ekleyerek işlemlerimize devam edebiliriz.</p><p><strong>IRedisCacheService :</strong></p><pre>public interface IRedisCacheService<br>{<br>        Task&lt;string&gt; GetValueAsync(string key);<br>        Task&lt;bool&gt; SetValueAsync(string key, string value);<br>        Task Clear(string key);<br>        void ClearAll();<br>}</pre><p><strong>RedisCacheService :</strong></p><pre>public class RedisCacheService : IRedisCacheService<br>{<br>        private readonly IConnectionMultiplexer _redisConnection;<br>        private readonly IDatabase _cache;<br><br>        public RedisCacheService(IConnectionMultiplexer redisConnection)<br>        {<br>            _redisConnection = redisConnection; <br>            _cache = redisConnection.GetDatabase();<br>        }<br><br>        public async Task Clear(string key)<br>        {<br>            await _cache.KeyDeleteAsync(key);<br>        }<br><br>        public void ClearAll()<br>        {<br>           var redisEndpoints = _redisConnection.GetEndPoints(true);<br>            foreach (var redisEndpoint in redisEndpoints)<br>            {<br>                var redisServer = _redisConnection.GetServer(redisEndpoint);<br>                redisServer.FlushAllDatabases();<br>            }<br>        }<br><br>        public async Task&lt;string&gt; GetValueAsync(string key)<br>        {<br>            return await _cache.StringGetAsync(key);<br>        }<br><br>        public async Task&lt;bool&gt; SetValueAsync(string key, string value)<br>        {<br>            return await _cache.StringSetAsync(key, value,TimeSpan.FromHours(1));<br>        }<br> }</pre><p>Interface ve Classlarımıza yukarı da ki methotları yazıyoruz.RedisService classımızın içerisinde ki <strong>SetValueAsync</strong> methotu içerisinde cacheleyeceğiniz verinin cache’te ne kadar kalabileceğini ayarlayabilirsiniz örnek kod üzerinde 1 saat olarak gözükmektedir fakat bu sizin ihtiyacınıza göre değişiklik gösterebilir.</p><p><strong>IRedisCacheService </strong>interface’nin bağımlılığını API projemizin program.cs dosyasına ekliyoruz.</p><pre>builder.Services.AddSingleton&lt;IRedisCacheService, RedisCacheService&gt;();</pre><p>Redis’e veri yazmak ve veri çekmek için gerekli işlemleri yapacağımız bir endpoint yaratmalıyız bu nedenle API projemize CacheController ekleyerek Redis servislerimiz ile haberleşicek controllerimizi oluşturuyoruz.</p><pre>    [ApiController]<br>    [Route(&quot;api&quot;)]<br>    public class CacheController : ControllerBase<br>    {<br>        private readonly IRedisCacheService _redisCacheService;<br>        <br>        public CacheController(IRedisCacheService redisCacheService)<br>        {<br>            _redisCacheService = redisCacheService;<br>        }<br><br>        [HttpPost(&quot;cache/{key}&quot;)]<br>        public async Task&lt;IActionResult&gt; Get(string key)<br>        {<br>            return Ok(await _redisCacheService.GetValueAsync(key));<br>        }<br><br>        [HttpPost(&quot;cache/set&quot;)]<br>        public async Task&lt;IActionResult&gt; Set([FromBody] RedisCacheRequestModel redisCacheRequestModel)<br>        {<br>            await _redisCacheService.SetValueAsync(redisCacheRequestModel.Key, redisCacheRequestModel.Value);<br>            return Ok();<br>        }<br><br>        [HttpPost(&quot;cache/{key}&quot;)]<br>        public async Task&lt;IActionResult&gt; Delete(string key)<br>        {<br>            await _redisCacheService.Clear(key);<br>            return Ok();<br>        }<br><br>        <br>    }</pre><p><strong>RedisCacheRequestModel :</strong></p><pre>public class RedisCacheRequestModel<br>{<br>    public string Key { get; set; }<br>    public string Value { get; set; }<br>}</pre><p>Controllerimizi oluşturduktan sonra projeyi çalıştırıp postman veya swagger üzerinden uygulamımızı test edebiliriz aynı zamanda Redis’i kurduğumuzda kontrollerimizi sağladığımız <strong>redis-cli.exe</strong> üzerinden de verileri takip edebiliriz.</p><p><strong>Redis’e veri kaydeden methot :</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Omt-Mx7xiL3brKA6OjDfPQ.png" /></figure><p><strong>Redis üzerinden veri okuyan methot :</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hehzzg4xhy5zQDDVN9nxyw.png" /></figure><p><strong>redis-cli.exe kontrolü :</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/537/1*k94ZYZBU9MtmvWQvzDExvg.png" /></figure><p><strong>Redis’de kayıtlı olan veriyi silen methot :</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*GUxO85r21k9WeYhgjOk4Dg.png" /></figure><p>Veriyi sildikten sonra tekrar <strong>redis-cli.exe</strong> üzerinden kontrollerimizi sağlıyoruz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/499/1*dHnPTYE3vhKL1y456H80yg.png" /></figure><p>Projeye bu <a href="https://github.com/SalimcanKaradeniz/NetCoreRedisEntegration">linkten </a>ulaşabilirsiniz.</p><p>Başka bir konuda görüşmek üzere…</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4c21024a0ed8" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>