Azure Statik Web Uygulamanızı planlama

3 dakika

Son hedefiniz, uygulamanızı Azure’da barındırmaktır. Azure Statik Web Uygulamaları gerekli olan tüm Azure kaynaklarını sağlar.

Uygulamanızın barındırılabilmesi için değişiklik yaptıkça uygulamanızı derlemek için kullanabileceğiniz bir özelliğe ihtiyaç duyacaksınız. Bu değişiklikler deponuza yapılan işlemeler veya buraya gönderilen çekme istekleri aracılığıyla yapılabilir. Uygulamanızın derlenmesi ve yayımlanması için bir GitHub Actions iş akışının ayarlanması Azure Statik Web Uygulamaları’nın önemli bir özelliğidir.

Azure Statik Web Uygulaması kaynağını oluşturduğunuzda GitHub Actions iş akışı sizin için oluşturulur. Hemen tetiklenen iş akışı uygulamanızı derleyip yayımlar. İş akışı, deponuzda bulunan izlenen dalda yaptığınız her değişiklik ile tetiklenir.

Azure Statik Web Uygulamaları

Bir web uygulamasının dağıtılırken iki otomatikleştirilmiş özellikten faydalanılır. Bunların ilki uygulamanızı oluşturan temel alınan Azure kaynaklarının sağlanmasıdır. İkincisi de, uygulamanızı derleyip yayımlayan GitHub Actions iş akışıdır.

Azure Statik Web Uygulamaları ile uygulamanızı webde yayımladığınızda web uygulamanızın ve ölçeklenebilir API’leriniz için hızlı barındırma özelliği elde edersiniz. GitHub Actions tarafından sağlanan birleşik derleme ve dağıtım iş akışını da edinirsiniz.

Statik Web Uygulamaları örneğinizi GitHub’a bağlama

Azure Static Web Apps, kaynak kodu GitHub'da yaşarken uygulamaları barındıracak şekilde tasarlanmıştır. Statik Web Apps örneği oluşturduğunuzda GitHub'da oturum açar ve uygulamanızın kodunu içeren depoyu belirtirsiniz.

Uygulamanızın otomatik olarak derlenip dağıtılması için deponuzda üç klasör yolunu da belirtmeniz gerekir:

Konum	Konum örneği	Tanım	Gerekli
Uygulama konumu	İstemci	Web uygulamanıza yönelik kaynak kodunun konumu	Evet
Çıkış konumu	wwwroot	Uygulamanızın derleme yapıtlarının konumu	Hayır
API konumu	Api	API’nize yönelik kaynak kodunun konumu	Hayır

Çıkış konumu, uygulamanızın yayımlama dizininin göreli yoludur. Örneğin, Client konumunda bulunan ve derlenen varlıklarını bin/<build profile>/<framework>/publish/wwwroot klasörüne gönderen bir uygulamanızın olduğunu varsayalım. Bu durumda, yayımlama sistemi ön ekin geri kalanıyla ilgilendiğinden yalnızca bu konum için belirtmeniz wwwroot gerekir.

GitHub Actions ile kaynak kodundan statik varlıklara

GitHub deponuz statik varlıklar değil kaynak kodu içerdiğinden yayımlanmadan önce derlenmesi gerekir.

Bir Statik Web Uygulamaları örneği oluşturduğunuzda, GitHub Actions iş akışı deponuzda Azure tarafından oluşturulur. Değişiklikleri her gönderişinizde veya yayınladığınız dalda bir çekme isteği oluşturduğunuzda iş akışı uygulamanızı oluşturur. Bu işlem, kaynak kodunuzu Azure'ın hizmet yaptığı statik varlıklara dönüştürür. Derleme tamamlandıktan sonra eylem varlıkları dağıtır.

GitHub Eylemi, .github/workflows klasöründeki deponuza eklenir. Bu dosyayı gerektiği gibi gözden geçirebilir veya değiştirebilirsiniz. Kaynağı oluştururken girdiğiniz ayarlar GitHub Action’a ilişkin dosyada depolanır.

Azure İşlevleri ile tümleşik API

Uygulamanız bir API gerektiriyorsa, bunu deponuzda bir Azure İşlevleri projesi olarak uygulayabilirsiniz ve Static Web Apps örneğiniz bunu otomatik olarak dağıtır ve barındırır. Uygulamanızı derleyen ve dağıtan GitHub Actions iş akışı, API konum yolunda belirttiğiniz klasörün adını kullanarak deponuzda API'yi bulur.

Peki API’niz yoksa? Endişelenmeyin. Azure Static Web Apps belirttiğiniz klasörde bir API bulamazsa, API yayımlamaz, ancak yine de uygulamanızı yayımlar.

Sonraki adımlar