Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Önemli
Statik Web Uygulamaları CLI'sından dağıtımların güvenliğini artırmak için, 15 Ocak 2025'e kadar Static Web Apps CLI'nın en son sürümüne (2.0.2) yükseltmenizi gerektiren bir hataya neden olan değişiklik kullanıma sunulmuştur.
Azure Static Web Apps web siteleri bulutta barındırılır ve genellikle bir bulut hizmetleri koleksiyonuna bağlanır. Geliştirme sırasında ve uygulamanızı yerel olarak çalıştırmanız gerektiğinde, uygulamanızın bulutta nasıl çalıştığını taklit etmek için araçlara ihtiyacınız vardır.
Static Web Apps CLI (SWA CLI), uygulamanızın Azure'da yaklaşık olarak nasıl çalıştırıldığını ancak bunun yerine yalnızca makinenizde çalıştırıldığını belirten bir dizi yerel hizmet içerir.
Azure Static Web Apps CLI aşağıdaki hizmetleri sağlar:
- Yerel statik site sunucusu
- Ön uç çerçeve geliştirme sunucusuna ara sunucu
- API uç noktalarınıza yönelik bir ara sunucu - Azure İşlevleri Temel Araçlar aracılığıyla kullanılabilir
- Sahte kimlik doğrulama ve yetkilendirme sunucusu
- Yerel yollar ve yapılandırma ayarları zorlaması
Nasıl çalışır?
Aşağıdaki grafik, isteklerin yerel olarak nasıl işleneceğini gösterir.
Önemli
http://localhost:4280 CLI tarafından sunulan uygulamaya erişmek için adresine gidin.
Bağlantı noktasına
4280yapılan istekler, isteğin türüne bağlı olarak uygun sunucuya iletilir.HTML veya CSS gibi statik içerik istekleri, iç CLI statik içerik sunucusu veya hata ayıklama için ön uç çerçeve sunucusu tarafından işlenir.
Kimlik doğrulaması ve yetkilendirme istekleri, uygulamanıza sahte kimlik profili sağlayan bir öykünücü tarafından işlenir.
functions Core Tools runtime1 , sitenin API'sine yönelik istekleri işler.
Tüm hizmetlerden gelen yanıtlar , hepsi tek bir uygulamaymış gibi tarayıcıya döndürülür.
Kullanıcı arabirimini ve Azure İşlevleri API uygulamalarını bağımsız olarak başlattıktan sonra, statik Web Apps CLI'sini başlatın ve aşağıdaki komutu kullanarak çalışan uygulamalara işaret edin:
swa start http://localhost:<DEV-SERVER-PORT-NUMBER> --api-location http://localhost:7071
İsteğe bağlı olarak, komutunu kullanırsanız swa init , Statik Web Apps CLI'sı uygulama kodunuze bakar ve CLI için bir swa-cli.config.json yapılandırma dosyası oluşturur. swa-cli.config.json dosyasını kullandığınızda, uygulamanızı yerel olarak başlatmak için komutunu çalıştırabilirsinizswa start.
1 Azure İşlevleri Temel Araçları, sisteminizde yoksa CLI tarafından otomatik olarak yüklenir.
Kullanmaya başlayın
Aşağıdaki kaynaklarla Static Web Apps CLI ile çalışmaya başlayın.
| Kaynak | Açıklama |
|---|---|
| Statik Web Apps CLI'sını (SWA CLI) yükleme | Azure Static Web Apps CLI'sini makinenize yükleyin. |
| Ortamınızı yapılandırma | Uygulamanızın yapılandırma bilgilerini nasıl okuyacaklarını ayarlayın. |
| Web sitesi öykünücüsunu başlatma | Web sitenize yerel olarak hizmet vermek için hizmeti başlatın. |
| Yerel API sunucusunu başlatma | API uç noktalarınıza yerel olarak hizmet vermek için hizmeti başlatın. |
| Azure’a dağıtın | Uygulamanızı Azure'da üretime dağıtın. |
Not
Genellikle ön uç çerçevesiyle oluşturulan siteler, yol altındaki api istekleri doğru şekilde işlemek için bir ara sunucu yapılandırma ayarı gerektirir. Azure Statik Web Uygulamaları CLI'sini kullanırken ara sunucu konum değeri şeklindedir /apive CLI olmadan değeri şeklindedir http://localhost:7071/api.