Azure Static Web Apps'te Veri API'sini barındırma (önizleme)

Şu konumlar da dahil olmak üzere dağıtım kılavuzu dizisinin şeması: Genel Bakış, Planlama, Hazırlama, Yayımlama, İzleme ve İyileştirme. 'Yayımla' konumu şu anda vurgulanmış durumda.

Yalnızca bir yapılandırma dosyası kullanarak Azure Static Web Apps'te Veri API'si oluşturucusunu hızla barındırabilirsiniz. Bu kılavuz, Veri API'si oluşturucusunu statik bir web uygulamasıyla tümleştirme adımlarını içerir.

Bu kılavuzda, BIR DAB yapılandırma dosyası oluşturma, dosyayı uygulamanızın bir parçası olarak barındırma ve ardından Azure Static Web Apps'te bir veritabanı bağlantısı kullanma adımlarını izleyin.

Önkoşullar

Önemli

Veritabanı bağlantılarını kullanan Azure Static Web Apps'te Veri API oluşturucusu (DAB) desteği önizleme aşamasındadır. Azure Static Web Apps, DAB altyapısının en son kararlı DAB sürümünden farklı olabilecek sabit bir sürümünü kullanır. En son DAB özelliklerine erişmek için GitHub, Microsoft Container Registry (Docker Hub) veya NuGet'ten altyapının en son sürümünü kullanarak DAB için alternatif bir ana bilgisayar kullanmayı göz önünde bulundurun.

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.
• Azure Static Web Apps CLI. Statik Web Uygulamaları (SWA) CLI'sını yükleyin.
• Veri API'si oluşturucu CLI. Veri API oluşturucusu (DAB) CLI'sini yükleyin.
• Azure'dan adreslenebilen mevcut desteklenen veritabanı.
• Azure Static Web Apps'e dağıtılabilir bir GitHub deposundaki mevcut web uygulaması.
  • Web uygulamanız yoksa , temel bir web uygulamasıyla bir depo oluşturun.

Statik web uygulaması oluşturma

Başlamak için Azure portalını kullanarak GitHub'daki web uygulamasını kullanarak yeni bir Azure Statik Web Uygulaması oluşturun.

1. Azure portalında (https://portal.azure.com ) oturum açın.

2. Yeni bir kaynak grubu oluşturun. Bu kılavuzdaki tüm yeni kaynaklar için bu kaynak grubunu kullanacaksınız.

   

   Tavsiye

   Kaynak grubunu msdocs-dab-swa olarak adlandırmanızı öneririz. Bu kılavuzdaki tüm ekran görüntüleri bu adı kullanır.

3. Azure Statik Web Uygulaması oluşturma. Statik web uygulamasını yapılandırmak için bu ayarları kullanın.

   Ayarlar	Değer
   Kaynak Grubu	Daha önce oluşturduğunuz kaynak grubunu seçin
   İsim	Genel olarak benzersiz bir ad girin
   Plan türü	İş yükünüz için en iyi seçeneği belirtin
   Kaynak	GitHub'ı seçin
   GitHub hesabı	Web uygulaması deposuna erişimi olan bir GitHub hesabı yapılandırma
   Kuruluş	Depo için üst kuruluşu veya kullanıcıyı seçin
   Deposu	Depo adını seçin
   Şube	Birincil dalı seçin

   

4. Statik web uygulaması dağıtımının tamamlanmasını bekleyin. Birincil dala her gönderişinizde uygulamayı Azure Static Web Apps'e dağıtacak bir GitHub Actions iş akışı otomatik olarak deponuza eklenir.

   Uyarı

   Bu ilk dağıtım birkaç dakika sürebilir. Dağıtımın durumunu istediğiniz zaman Azure portalından veya deponuzdaki GitHub Actions sekmesinden denetleyebilirsiniz.

5. Azure portalında yeni statik web uygulamasına gidin.

6. Temel Parçalar bölümünde, çalışan web uygulamasına gitmek için URL köprüsüni kullanın. Uygulamanın beklendiği gibi çalıştığını doğrulayın.

DAB yapılandırma dosyasını ekleme

Şimdi yeni bir DAB yapılandırma dosyası oluşturmak ve web uygulaması deposuna eklemek için DAB ve SWA komut satırı arabirimlerini kullanın.

1. Web uygulamanızın GitHub deposunu istediğiniz tümleşik geliştirici ortamında (IDE) açın.

   Tavsiye

   İstediğiniz IDE'i kullanabilirsiniz. Uygulama üzerinde yerel olarak çalışmak istiyorsanız depoyu yerel makinenize kopyalayabilirsiniz. Tarayıcıda çalışmayı tercih ediyorsanız GitHub Codespaces'ı kullanabilirsiniz. SWA ve DAB CLI'lerinin geliştirme ortamınıza yüklendiğinden emin olun.

2. Depo dizininin kökünde bir terminal açın.

3. swa db Belirtilen veritabanı türünü kullanarak yeni bir DAB yapılandırma dosyası başlatmak için SWA CLI'dan komutunu kullanın. komutu, swa-db-connections klasöründe staticwebapp.database.config.json adlı yeni bir dosya oluşturur.

   swa db init --database-type "<database-type>"
   

   Önemli

   Bazı veritabanı türleri başlatmada ek yapılandırma ayarları gerektirir.

4. Komutunu kullanarak dab add yapılandırmaya en az bir veritabanı varlığı ekleyin. Her varlığı anonim kullanıcılar için tüm izinlere izin verecek şekilde yapılandırın. dab add'yi varlıklarınız için istediğiniz kadar tekrarlayın.

   dab add "<entity-name>" --source "<schema>.<table>" --permissions "anonymous:*" --config "swa-db-connections/staticwebapp.database.config.json"
   

5. swa-db-connections/staticwebapp.database.config.json dosyasının içeriğini açın ve gözden geçirin.

6. Değişikliklerinizi depoya işleyin ve birincil dala gönderin. Bu, web uygulamasının yeni dağıtımını otomatik olarak tetikler. Bu kılavuza devam etmeden önce bu en son dağıtımın tamamlanmasını bekleyin.

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

Ardından, statik web uygulamasının veritabanına erişmesine izin vermek için Azure portalında veritabanı bağlantısını yapılandırın.

1. Azure portalında statik web uygulamasına yeniden gidin.

2. Kaynak menüsünün Ayarlar bölümünde Veritabanı bağlantısı seçeneğini belirleyin. Ardından Üretim ortamı için Var olan veritabanını bağla'yı seçin.

   

3. Veritabanını bağla iletişim kutusunda, veritabanı bağlantısını yapılandırmak için bu ayarları kullanın.

   Ayarlar	Değer
   Veritabanı türü	DAB yapılandırma dosyasını oluştururken kullandığınız veritabanı türünü seçin
   Kaynak Grubu	Bu kılavuzun önceki bölümlerinde oluşturduğunuz kaynak grubunu seçin
   Kaynak adı	Statik web uygulamasına bağlamak istediğiniz veritabanı kaynağını seçin
   Veritabanı adı	Veritabanının adını girin
   Kimlik doğrulaması türü	Kullanmayı planladığınız kimlik doğrulaması türünü seçin

   

   Tavsiye

   Yetkilendirme anahtarları içermeyen bir bağlantı dizesi kullanmanızı öneririz. Bunun yerine, veritabanınız ve konağınız arasındaki erişimi yönetmek için yönetilen kimlikleri ve rol tabanlı erişim denetimini kullanın. Daha fazla bilgi için bkz. Yönetilen kimlikleri kullanan Azure hizmetleri.

Veri API'sinin uç noktasını test edin

Son olarak, veri API'sinin uç noktasının statik web uygulamasında kullanılabilir olduğunu doğrulayın.

1. Azure portalında statik web uygulamasına yeniden gidin.

2. Statik web uygulamasının web sitesine yeniden göz atmak için Temel Bileşenler bölümündeki URL alanını kullanın.

3. Geçerli çalışan uygulamanın yoluna /data-api gidin. Yanıtın hala DAB kapsayıcısının iyi durumda olduğunu gösterdiğini gözlemleyin.

   { Healthy }
   

   Uyarı

   Statik Web Apps, çalışma zamanı konak modunu Productionotomatik olarak ayarlar ve yapılandırma dosyasındaki herhangi bir değerin üzerine yazar. Sonuç olarak, Swagger ve Banana Cake Pop gibi geliştirici özellikleri Static Web Apps'te kullanılamaz.

4. Geçerli çalışan uygulamanın yoluna https://<your-static-web-app-url>/data-api/<your-rest-path>/<your-entity-name> gidin. Bu, bu varlık kümesi için bir HTTP GET isteği oluşturur. JSON yanıtını gözlemleyin.

Kaynakları temizleme

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

1. Azure portalını kullanarak kaynak grubuna gidin.

2. Komut çubuğundaSil'i seçin.