Alıştırma - API ağ geçidi oluşturma

  • 10 dakika

Bu alıştırmada örnek bir web API'sini dağıtıp bir API ağ geçidi yapılandıracaksınız. Sonraki bir ünitede web API'sini ağ geçidinizde yayımlayacaksınız.

Ayakkabı şirketi örneğinde NorthWind Shoes, bir envanter API'sini iş ortaklarıyla paylaşmaya karar verdi. Bu API, iş ortaklarının stok ve ürün bilgilerine erişmesini sağlamaktadır.

Önemli

Bu alıştırmayı çalıştırmak için kendi Azure aboneliğinizin olması gerekir ve ücret ödeyebilirsiniz. Mevcut bir Azure aboneliğiniz yoksa başlamadan önce ücretsiz hesap oluşturun.

ShoeCompany web API'sini dağıtma

Envanter ve ürün bilgileri oluşturan bir .NET Core uygulaması geliştirdiniz. Bu uygulama, OpenAPI Swagger belgelerini oluşturmak için Swashbuckle hizmetine sahiptir.

Zaman kazanmak amacıyla, RESTful API'mizi Azure'da barındırmak için bir betik çalıştırarak başlayalım. Betik aşağıdaki adımları gerçekleştirir:

  • Ücretsiz katmanında bir Azure App Service planı oluşturur.
  • Yerel bir depodan Git dağıtımı için yapılandırılmış bir Azure Uygulaması Hizmeti içinde web API'sini oluşturur.
  • Uygulamamız için hesap düzeyinde dağıtım kimlik bilgilerini ayarlar.
  • Git’i yerel olarak yapılandırır.
  • Web API'mizi App Service örneğimize dağıtır.

  1. Azure Portal oturum açın.

  2. Azure görev çubuğunda Cloud Shell simgesini seçerek Azure Cloud Shell'i açın.

    Screenshot of Cloud Shell icon in taskbar.

  3. Cloud Shell'de aşağıdaki git komutu çalıştırarak GitHub deposunu kopyalayın ve uygulamamızın kaynak kodunu indirin.

    git clone https://github.com/MicrosoftDocs/mslearn-publish-manage-apis-with-azure-api-management.git

  4. İşlem tamamlandıktan sonra, aşağıdaki komutları çalıştırarak yerel depo klasörünüzü açın ve içeriğini listeleyin.

    cd mslearn-publish-manage-apis-with-azure-api-management
ls -l

    Dosyalardan biri setup.sh. Adından da anlaşılacağı gibi, test API'mizi ayarlamak için çalıştırdığımız betiktir.

  5. Bu betiği çalıştırmak için aşağıdaki komutu girin. OpenAPI arabirimini kullanıma sunan bir genel web uygulaması oluşturur.

    bash setup.sh

    Bu betiğin çalıştırılması yaklaşık bir dakika sürer. Dağıtım sırasında, uygulamamızın çalışması için gereken tüm bağımlılıklar uzak App Service'e otomatik olarak yüklenir. Çıkışta tüm işlemler listelenir. Betik tamamlandığında, son iki satır uygulama dağıtımını test etmek için kullandığınız URL'lerdir.

  6. Uygulamamızın doğru dağıtıldığını test etmek için Cloud Shell'den ilk URL'yi (Swagger URL'si) kopyalayın ve tarayıcınızın yeni bir sekmesine yapıştırın.

    Tarayıcı, uygulamamız için swagger kullanıcı arabirimini görüntülemeli ve aşağıdaki RESTful uç noktalarını bildirmelidir:

    • api/inventory , ürünlerin listesini ve stoktaki sayıyı oluşturur.
    • api/inventory/{productid} belirtilen ürün kimliği (tamsayı) için stoktaki sayıyı döndürür.
    • api/Products bir ürün listesi oluşturur.
    • api/Products/{productid} belirtilen ürün kimliğinin ayrıntılarını döndürür.

    Overview of API management.

  7. Son olarak, Cloud Shell çıkışından ikinci URL'yi (Swagger JSON URL'si) kopyalayın ve Not Defteri gibi bir yere kaydedin. Sonraki alıştırmada bu URL'ye ihtiyacınız olacak.

API ağ geçidi dağıtma

Bu alıştırmadaki son görev, Azure portalında bir API ağ geçidi oluşturmaktır. Sonraki alıştırmada API'nizi yayımlamak için bu ağ geçidini kullanacaksınız.

  1. Azure Portal oturum açın.

  2. Azure hizmetlerinde veya Giriş sayfasında Kaynak oluştur'u seçin. Kaynak oluştur bölmesi görüntülenir.

  3. Kaynak menüsünde Tümleştirme'yi seçin ve sonuçlarda API Management'ı seçin. API Management hizmeti oluştur bölmesi görüntülenir.

  4. Temel Bilgiler sekmesinde, her ayar için aşağıdaki değerleri girin.

    Ayar Değer
    Proje ayrıntıları
    Abonelik Aboneliğinizi seçin.
    Kaynak grubu Yeni veya mevcut bir kaynak grubu seçin. Kaynak grubu, Bir Azure çözümü için ilgili kaynakları barındıran mantıksal bir kapsayıcıdır.
    Örnek ayrıntıları
    Bölge Kullanılabilir bir bölge seçin.
    Kaynak Adı apim-NorthWindShoes<random number>değerini kendi sayı serinizle değiştirerek random number adın genel olarak benzersiz olmasını sağlayın.
    Organizasyon Adı NorthWindShoes. Geliştirici portalında kullanılmak üzere kuruluşunuzun adı ve e-posta bildirimleri. (Geliştirici portalı ve bildirimler tüm hizmet katmanlarında kullanılamaz.)
    Yönetici E-postası Tüm sistem bildirimlerini almak için e-posta adresi.
    Fiyatlandırma Katmanı Consumption

    Dekont

    Tüketim katmanı test için hızlı dağıtım sağlar ve kullanım için ödeme fiyatlandırma modeline sahiptir. Genel API yönetimi deneyimi, diğer fiyatlandırma katmanlarına benzer.

  5. Ayarlarınızı doğrulamak için Gözden geçir ve oluştur'u seçin.

  6. Doğrulama başarılı olduğunda Oluştur'u seçin. Dağıtımın tamamlanması birkaç dakika sürebilir.

  7. Dağıtım tamamlandığında API Management örneğiniz Azure kaynaklarında listelenir. API Management hizmetinizin bölmesini görüntülemek için Kaynağa git'i seçin.