API sürümleme stratejisinin önemi

Azure API Management

Fiodar Sazanavets

Senior Software Engineer at Microsoft

API sürümlemeye giriş

Sürümlemeye giriş

Azure API Management

API sürümleme temelleri

Sürümleme benzetmesi

  • Kırıcı değişiklikler yolcuları şaşırtacağında kullanılır

  • Yeni hat yapılırken yolcular eskisini kullanır

  • Revizyonlar aynı hattaki bakım ayarları gibidir

    • Rayları düzeltmek, işaret eklemek, sürüşü yumuşatmak

  • APIM’de:

    • Sürümler bir sürüm kümesi içinde yer alır
    • Revizyonlarla düzenleyin, test edin ve birini geçerli olarak işaretleyin
Azure API Management

Sürüm işaretleme

  • Üç sürüm işaretleme stratejisi desteklenir:
    • Sürüm URL yolunda belirtilir
    • Sürüm istek başlığında belirtilir
    • Sürüm URL sorgu dizesinde belirtilir
  • Sürümleme stratejisi tutarlı olmalıdır

URL yolu ile sürümleme

Başlık ile sürümleme

Sorgu dizesi ile sürümleme

Azure API Management

Sürüm vs revizyon

Sürüm vs revizyon

Azure API Management

Kanarya yayınları

Kanarya yayını

  • Sonuçlar:
    • Geri bildirim iyiyse -> revizyonu geçerli olarak işaretleyin
    • Kötüyse -> önceki revizyona geri dönün

  • Mutfak testi gibi: önce yeni tarifi birkaç masada deneyin

  • APIM’de:

    • Yeni bir revizyon oluşturun ve özel olarak test edin
    • Sınırlı bir kitleye açın (pilot ürün veya çağıranların bir alt kümesi)
    • Özel bir URL ve revizyon numarasıyla belirli bir revizyonu hedefleyin

  • Demiryolu benzetmesi: testçiler ana hattı etkilemeden “bakım hattında” gider

Azure API Management

Önemli kavramlar

  • Sürüm ne zaman, revizyon ne zaman kullanılır
  • Sürüm şemasını yapılandırma
  • Değişiklikleri ileri/geri alma

API Yönetimi

Azure API Management

Hadi pratik yapalım!

Azure API Management

Preparing Video For Download...