Hızlı Başlangıç: NoSQL için Azure Cosmos DB 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 DAB'yi ve NoSQL için Azure Cosmos DB veritabanını dağıtmak 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 Geliştirici CLI'sını (azd) kullanarak NoSQL için Azure Cosmos DB hesabı oluşturun, DAB'yi kapsayıcılı çözüm olarak dağıtın ve kapsayıcılı örnek bir uygulama dağıtı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-cosmos-db-nosql-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ı, NoSQL için Azure Cosmos DB hesabını, DAB tanımlayıcısı 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 /graphql yoluna ilerleyin. Bu URL, Nitro GraphQL tümleşik geliştirme ortamını (IDE) açmalıdır.

4. Nitro IDE'de yeni bir belge oluşturun ve NoSQL için Azure Cosmos DB products kapsayıcısında 100 öğenin tümünü almak için bu sorguyu çalıştırın.

   query {
     products {
       items {
       id
       name
       description
       sku
       price
       cost
       }
     }
   }
   

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

GraphQL uç noktalarını