Hızlı Başlangıç: NoSQL ve Azure Static Web Apps için Azure Cosmos DB ile Veri API oluşturucusu kullanma

Bu Hızlı Başlangıçta bir Azure Developer CLI (AZD) şablonu dağıtacaksınız. Şablon, veritabanı bağlantıları özelliğini kullanarak Veri API oluşturucusunu barındıran bir Azure Statik Web Uygulaması dağıtır. Şablon ayrıca çözümleriniz için başlangıç noktası olarak kullanabileceğiniz örnek bir uygulama içerir.

Önkoşullar

• Azure aboneliği. Azure aboneliğiniz yoksa ücretsiz deneme hesabı oluşturun
• .NET 8
• Azure Geliştirici CLI

İpucu

Alternatif olarak, bu Hızlı Başlangıcı GitHub Codespaces'ta açın ve tüm geliştirici önkoşulları zaten yüklüdür. Kendi Azure aboneliğinizi getirmeniz yeterlidir. GitHub hesapları, depolama ve çekirdek saatleri için hiçbir ücret ödemeden yetkilendirme içerir. Daha fazla bilgi için bkz. GitHub hesapları için dahil edilen depolama ve çekirdek saatler.

Şablonu dağıtma

İlk olarak, AZD şablonunu kullanarak gerekli tüm hizmetleri dağıtın.

1. Projenin kök dizininde bir terminal açın.

2. kullanarak azd auth loginAzure Developer CLI kimliğini doğrulayın. 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 kullanın azd init .

   azd init --template dab-azure-cosmos-db-nosql-quickstart
   

   Önemli

   GitHub Codespaces içinde çalıştırıyorsanız, kod ortamınıza zaten kopyalandığından bağımsız değişkeni güvenle atlayabilirsiniz --template .

4. Başlatma sırasında benzersiz bir ortam adı yapılandırın.

   İpucu

   Ortam adı hedef kaynak grubu adı olarak da kullanılır. Bu hızlı başlangıç için kullanmayı msdocs-swa-dabgöz önünde bulundurun.

5. kullanarak Azure Static Web Apps çözümünü azd updağıtın. Bicep şablonları, destekleyici depolama, kimlik ve konak hizmetleriyle birlikte Bir NoSQL için Azure Cosmos DB hesabı dağıtır. Web konağına örnek bir web uygulaması dağıtılı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 beş dakika sürebilir.

7. Azure kaynaklarınızın sağlanması tamamlandıktan sonra, şablon çalıştırmanın süresiyle birlikte bir SUCCESS iletisi döndürür.

   SUCCESS: Your application was provisioned and deployed to Azure in 5 minutes 0 seconds.
   

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

Şimdi dağıtılan statik web uygulaması ile dağıtılan veritabanı arasında bağlantı oluşturmak için Azure Static Web Apps veritabanı bağlantıları özelliğini kullanın. Bu özellik, belirttiğiniz kimlik bilgilerini kullanarak NoSQL için çalışan bir Azure Cosmos DB hesabına bağlantı oluşturmak için Data API builder'ı sorunsuz bir şekilde kullanır.

1. Azure portal Azure Statik Web Uygulaması kaynağına gidin.

2. Bu ayarları kullanarak NoSQL için Azure Cosmos DB hesabına Veritabanı Bağlantısı eklemek için statik web uygulamasını yapılandırın. Ardından Bağlantı'yı seçin.

   	Değer
   Veritabanı türü	Azure Cosmos DB for NoSQL
   Abonelik	AZD dağıtımı için kullandığınız aboneliği seçin
   Kaynak grubu	AZD dağıtımı için kullandığınız kaynak grubunu (ortam) seçin
   Kaynak adı	NoSQL için ön eki olan tek Azure Cosmos DB kaynağını seçin nosql-*
   Veritabanı adı	cosmicworks
   Kimlik doğrulaması türü	User-assigned managed identity
   Kullanıcı tarafından atanan yönetilen kimlik	*Ön ekini içeren tek yönetilen kimlik kaynağını seçin ua-id-*

   

3. Şimdi, çalışan web uygulamasını gözlemlemek için kaynak sayfasında Gözat seçeneğini belirleyin.

   

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 codespace'i silin.

Sonraki adım

GraphQL uç noktaları