Eğitimlere dön

gRPC ve API tasarımı

Protobuf sözleşmeleriyle gRPC servisleri tasarlamak, sürümlemek ve bir API geçidi arkasında tarayıcıya ve mobil istemcilere açmak.

Süre: 5 gün (40 saat) Seviye: Orta düzey Hedef kitle: Backend geliştiriciler ve API tasarımcıları
gRPC Protobuf API tasarımı .NET API geçidi

Eğitime genel bakış

İyi bir API, onu kullanan ekiplerin sizi aramadan iş yapabildiği API’dir. Bu eğitimde sözleşmeyi önce yazıyor, gRPC servislerini Protobuf ile tasarlıyor, alanları kırmadan büyütüyor ve servisleri bir API geçidi üzerinden web ve mobil istemcilere açıyoruz. Örnekler, onlarca servisin ortak bir sözleşme deposundan beslendiği MicroFrame’den geliyor.

Kurs içeriği

1. API tasarımına giriş

  • REST, gRPC ve GraphQL karşılaştırması
  • Kaynak odaklı tasarım
  • Sözleşme önce yaklaşımı

2. Protobuf

  • Mesaj, alan numarası ve tipler
  • enum, oneof ve map
  • Well-known types: Timestamp, wrappers
  • Adlandırma kuralları

3. Sözleşme deposu

  • Tek depo, çok tüketici
  • buf ile lint ve kod üretimi
  • Breaking change kontrolü
  • Submodule ve paket olarak dağıtım

4. Hata modeli

  • gRPC durum kodları
  • Tipli hata kodu ve oneof sonuç
  • İstemcinin hatayı kullanıcıya göstermesi
  • Doğrulama: protovalidate

5. Liste ve sorgu

  • Sayfalama: sayfa ve imleç
  • Filtreleme ve sıralama
  • Alan maskeleri
  • Uygulama: bir servisin sözleşmesini yazmak

6. ASP.NET Core ile gRPC

  • Servis uygulaması
  • Interceptor’lar
  • Deadline ve iptal
  • Streaming çağrılar

7. Güvenlik

  • Kimlik doğrulama metadata ile
  • İzin kontrolünü metoda bağlamak
  • Anonim metotları açıkça işaretlemek
  • mTLS

8. Tarayıcı ve mobil

  • gRPC-Web
  • Connect protokolü ve TypeScript istemcisi
  • API geçidinin rolü: yönlendirme, oran sınırı, CORS

9. Sürümleme

  • Geriye uyumlu değişiklik kuralları
  • Alanı opsiyonel eklemek, silmek, yeniden adlandırmak
  • Paket sürümü: v1, v2

10. Test

  • Birim ve entegrasyon testleri
  • Sözleşme testleri ile iki ucu doğrulamak
  • Uygulama: geçit arkasında tarayıcıdan çağrılan servis

Program akışı

Her modül yaklaşık 4 saat, yani yarım gün sürer; toplam 40 saat.

    1. gün: modül 1 ve 2
    1. gün: modül 3 ve 4
    1. gün: modül 5 ve 6
    1. gün: modül 7 ve 8
    1. gün: modül 9 ve 10

Ön koşullar

  • C# ve ASP.NET Core ile API geliştirme deneyimi
  • HTTP ve JSON tabanlı API’lere aşinalık
  • Docker Desktop ve .NET 10 SDK kurulu bir dizüstü bilgisayar

Eğitim formatı

  • Yerinde ya da uzaktan: ofisinizde veya canlı sanal oturumlarla.
  • Uygulamalı: her gün, o günün konusunu çalışan bir örnek üzerinde uyguladığınız lab oturumlarıyla biter.
  • Lab ortamı: katılımcılara önceden hazırlanmış bir çalışma ortamı ve örnek kod deposu verilir.
  • Ekibinize göre: içerik ve örnekler, eğitimden önce yaptığımız kısa bir görüşmeyle ekibinizin kullandığı teknolojilere uyarlanır.
  • Materyaller: sunumlar, lab yönergeleri ve referans kod eğitimden sonra da sizde kalır.
Başlamaya hazır mısınız?

Projenize başlamaya hazır mısınız?

Fikirlerinizi hayata geçirmek için size nasıl yardımcı olabileceğimizi konuşalım.