Aracılığıyla paylaş


Hızlı Başlangıç: Azure SQL ve Azure Static Web Apps ile Veri API'sini kullanma

Bu hızlı başlangıçta, Azure Container Apps'e Docker kapsayıcısı olarak Veri API'si oluşturucusu (DAB) dağıtacaksınız. En son en iyi yöntemleri kullanarak bir Azure SQL veritabanıyla birlikte DAB yayımlamak için bir Azure Geliştirici CLI (AZD) şablonu kullanırsınız. Şablon ayrıca GraphQL kullanarak DAB uç noktasına bağlanan örnek bir web uygulaması dağıtır.

Önkoşullar

  • Azure Geliştirici CLI'sı
  • .NET 9.0

Azure hesabınız yoksa başlamadan önce ücretsiz hesap oluşturun.

Projeyi başlatma

Azure SQL hesabı oluşturmak, DAB'yi kapsayıcılı çözüm olarak dağıtmak ve kapsayıcılı örnek bir uygulama dağıtmak için Azure Geliştirici CLI'sini (azd) kullanın. Örnek uygulama, örnek verileri sorgulamak için DAB kullanır.

  1. Boş bir dizinde bir terminal açın.

  2. Henüz kimlik doğrulaması yapmadıysanız azd auth loginkullanarak Azure Geliştirici CLI'sinde kimlik doğrulamasından geçin. Tercih ettiğiniz Azure kimlik bilgilerini kullanarak CLI'da kimlik doğrulaması yapmak için araç tarafından belirtilen adımları izleyin.

    azd auth login
    
  3. Projeyi başlatmak için azd init kullanın.

    azd init --template dab-azure-sql-quickstart
    
  4. Başlatma sırasında benzersiz bir ortam adı yapılandırın.

  5. azd upkullanarak tam çözümü Azure'a dağıtın. Bicep şablonları, Azure SQL hesabını DAB ile birlikte Azure Container Apps'e ve örnek bir web uygulamasına dağıtır.

    azd up
    
  6. Sağlama işlemi sırasında aboneliğinizi ve istediğiniz konumu seçin. Sağlama işleminin tamamlanmasını bekleyin. İşlem yaklaşık yedi dakikasürebilir.

  7. Azure kaynaklarınızın sağlanması tamamlandıktan sonra, çalışan web uygulamasının URL'si çıktıya eklenir.

    Deploying services (azd deploy)
    
    (✓) Done: Deploying service api
    - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
    
    (✓) Done: Deploying service web
    - Endpoint: <https://[container-app-sub-domain].azurecontainerapps.io>
    
    SUCCESS: Your up workflow to provision and deploy to Azure completed in 7 minutes 0 seconds.
    
  8. api ve web hizmetlerinin URL değerlerini kaydedin. Bu değerleri bu kılavuzun ilerleyen bölümlerinde kullanacaksınız.

Veritabanı bağlantısını yapılandırma

Şimdi Azure Container Apps'te kapsayıcılı her uygulamaya göz atarak beklendiği gibi çalıştıklarını doğrulayın.

  1. İlk olarak, API hizmetinin URL'sine gidin. Bu URL, çalışan DAB örneğine bağlanır.

  2. DAB'den JSON çıkışını gözlemleyin. DAB kapsayıcısının çalıştığını ve durumunun sağlıklıolduğunu göstermelidir.

    {
      "status": "healthy",
      "version": "1.1.7",
      "app-name": "dab_oss_1.1.7"
    }
    
  3. DAB örneğinin göreli /swagger yoluna gidin. Bu URL, REST tümleşik geliştirme ortamı (IDE) Swagger kullanıcı arabirimini açmalıdır.

  4. Swagger IDE'de Azure SQL products tablosundaki tüm satırlar için bir GET isteği çalıştırın.

  5. Son olarak, web hizmetinin URL'sine gidin. Bu URL, önceki adımda erişmiş olduğunuz GraphQL uç noktasına bağlanan çalışan örnek web uygulamasına bağlanır.

  6. Çalışan web uygulamasını gözlemleyin ve çıkış verilerini gözden geçirin.

    Azure Container Apps'te çalışan web uygulamasının ekran görüntüsü.

Temizlemek

Örnek uygulamaya veya kaynaklara artık ihtiyacınız kalmadığında, ilgili dağıtımı ve tüm kaynakları kaldırın.

  1. Dağıtımı Azure aboneliğinizden kaldırın.

    azd down
    
  2. GitHub Codespaces kullanıyorsanız depolama ve çekirdek yetkilendirmelerinizi en üst düzeye çıkarmak için çalışan kod alanını silin.

Sonraki adım

REST uç noktalarını