Hızlı Başlangıç: Azure SQL ve Azure Container Apps ile Veri API oluşturucusu 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, Azure Geliştirici CLI'sinde azd auth login kullanarak kimlik doğrulaması gerçekleştirin. 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. Sonraki adıma geçmeden önce Docker'ın makinenizde çalıştığından emin olun.

6. 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
   

7. Sağlama işlemi sırasında aboneliğinizi ve istediğiniz konumu seçin. Sağlama işleminin tamamlanmasını bekleyin. İşlemyaklaşık yedi dakika sürebilir.

8. 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.
   

9. 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 belirtmelidir.

   {
     "status": "healthy",
     "version": "1.4.35",
     "app-name": "dab_oss_1.4.35"
   }
   

3. DAB örneği için göreli /swagger yoluna ilerleyin. Bu URL, REST tümleşik geliştirme ortamı (IDE) Swagger kullanıcı arabirimini açmalıdır.

4. Swagger IDE'de Azure SQL GET tablosundaki tüm satırlar için bir products 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.

   

Temizleme

Ö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ı