İşlev uygulamanızı yönetme
Azure İşlevleri bir işlev uygulaması, tek tek işlevleriniz için yürütme bağlamı sağlar. İşlev uygulaması davranışları, belirli bir işlev uygulaması tarafından barındırılan tüm işlevler için geçerlidir. İşlev uygulamasındaki tüm işlevler aynı dilde olmalıdır.
İşlev uygulamasındaki tek tek işlevler birlikte dağıtılır ve birlikte ölçeklendirilir. Aynı işlev uygulamasındaki tüm işlevler, işlev uygulaması ölçeklendirildikçe örnek başına kaynakları paylaşır.
Bağlantı dizeleri, ortam değişkenleri ve diğer uygulama ayarları her işlev uygulaması için ayrı ayrı tanımlanır. İşlev uygulamaları arasında paylaşılması gereken tüm veriler kalıcı bir depoda harici olarak depolanmalıdır.
Azure portalını kullanmaya başlama
Not
Azure portalında işlev kodunu düzenlemeyle ilgili sınırlamalar nedeniyle işlevlerinizi yerel olarak geliştirmeniz ve kod projenizi Azure'daki bir işlev uygulamasında yayımlamanız gerekir. Daha fazla bilgi için bkz . Azure portalında geliştirme sınırlamaları
İşlev uygulamanızdaki uygulama ayarlarını görüntülemek için şu adımları izleyin:
Azure hesabınızı kullanarak Azure portalda oturum açın. İşlev uygulamanızı arayın ve seçin.
İşlev uygulamanızın sol bölmesinde Ayarlar'ı genişletin, Ortam değişkenleri'ni ve ardından Uygulama ayarları sekmesini seçin.
Uygulama ayarlarıyla çalışma
Azure İşlevleri tarafından kullanılan önceden tanımlanmış uygulama ayarlarına ek olarak işlev kodunuzun gerektirdiği sayıda uygulama ayarı oluşturabilirsiniz. Daha fazla bilgi için bkz. Azure İşlevleri için uygulama ayarları başvurusu.
Bu ayarlar şifrelenmiş olarak depolanır. Daha fazla bilgi için bkz . Uygulama ayarları güvenliği.
Uygulama ayarlarını Azure portalından ve Azure CLI ile Azure PowerShell kullanarak yönetebilirsiniz. Uygulama ayarlarını Visual Studio Code'dan ve Visual Studio'dan da yönetebilirsiniz.
Uygulama ayarlarınızı görüntülemek için bkz . Azure portalında kullanmaya başlama.
Uygulama ayarları sekmesi, işlev uygulamanız tarafından kullanılan ayarları korur:
Uygulama ayarlarını kullanma
İşlev uygulaması ayarları değerleri, kodunuz içinde ortam değişkenleri olarak da okunabilir. Daha fazla bilgi için bu dile özgü başvuru makalelerinin Ortam değişkenleri bölümüne bakın:
Bir işlev uygulamasını yerel olarak geliştirirken, bu değerlerin yerel kopyalarını local.settings.json proje dosyasında tutmanız gerekir. Daha fazla bilgi için bkz . Yerel ayarlar dosyası.
FTPS dağıtım ayarları
Azure İşlevleri, FTPS kullanarak işlev uygulamanıza proje kodu dağıtmayı destekler. Bu dağıtım yöntemi tetikleyicileri eşitlemenizi gerektirdiği için önerilmez. Proje dosyalarını güvenli bir şekilde aktarmak için her zaman FTP'yi değil FTPS'yi kullanın.
FTPS dağıtımı için gereken kimlik bilgilerini almak için şu yöntemlerden birini kullanın:
İşlev uygulamanızın yayımlama profilini indirerek Azure portalında FTPS yayımlama kimlik bilgilerini alabilirsiniz.
Önemli
Yayımlama profili önemli güvenlik kimlik bilgilerini içerir. İndirilen dosyanın güvenliğini her zaman yerel bilgisayarınızda sağlayın.
İşlev uygulamanızın yayımlama profilini indirmek için:
Azure portalında işlev uygulamanızın sayfasını bulun ve sol sütundaki Ayarlar>Yapılandırması'nı genişletin.
Yapılandırma sayfasında Genel ayarlar sekmesini seçin ve SCM Temel Kimlik Doğrulama Yayımlama Kimlik Bilgileri'nin Açık olduğundan emin olun. Bu ayar Kapalı olduğunda yayımlama profillerini kullanamazsınız, bu nedenle Açık'ı ve ardından Kaydet'i seçin.
İşlev uygulamasının Genel Bakış sayfasına dönün ve yayımlama profili al'ı seçin.
Dosyanın içeriğini kaydedin ve kopyalayın.
- dosyasında özniteliğine
publishProfile
publishMethod="FTP"
sahip öğesini bulun. Bu öğedepublishUrl
, ,userName
veuserPWD
öznitelikleri FTPS yayımlama için hedef URL'yi ve kimlik bilgilerini içerir.
Barındırma planı türü
bir işlev uygulaması oluşturduğunuzda, uygulamanın çalıştığı bir barındırma planı da oluşturursunuz. Bir planda bir veya daha fazla işlev uygulaması olabilir. İşlevlerinizin işlevselliği, ölçeklendirmesi ve fiyatlandırması planın türüne bağlıdır. Daha fazla bilgi için bkz. Azure İşlevleri barındırma seçenekleri.
İşlev uygulamanız tarafından kullanılan plan türünü Azure portalından veya Azure CLI veya Azure PowerShell API'lerini kullanarak belirleyebilirsiniz.
Aşağıdaki değerler plan türünü gösterir:
Plan türü | Azure portal | Azure CLI/PowerShell |
---|---|---|
Tüketim | Tüketim | Dynamic |
Premium | ElasticPremium | ElasticPremium |
Ayrılmış (App Service) | Çeşitli | Çeşitli |
İşlev uygulamanız tarafından kullanılan plan türünü belirlemek için Azure portalındaki işlev uygulamasının Genel Bakış sayfasındaki App Service Planı'na bakın.
Fiyatlandırma katmanını görmek için App Service Planının adını seçin ve ardından sol bölmeden Ayarlar > Özellikleri'ni seçin.
Geçişi planlama
İşlev uygulamasını Tüketim planı ile Windows'ta Premium plan arasında geçirebilirsiniz. Planlar arasında geçiş yaparken aşağıdaki noktaları göz önünde bulundurun:
- Ayrılmış (App Service) planına doğrudan geçiş desteklenmez.
- Linux'ta geçiş desteklenmez.
- Kaynak plan ve hedef plan aynı kaynak grubunda ve coğrafi bölgede olmalıdır. Daha fazla bilgi için bkz . Uygulamayı başka bir App Service planına taşıma.
- Belirli CLI komutları geçişin yönüne bağlıdır.
- İşlev uygulaması planlar arasında geçirilirken işlev yürütmelerinizde kapalı kalma süresi oluşur.
- Aynı Azure Dosyalar paylaşımı uygulama tarafından geçiş öncesinde ve sonrasında kullanıldığından, duruma ve uygulamaya özgü diğer içerik korunur.
Planınızı şu araçları kullanarak geçirebilirsiniz:
Windows'ta uygulamanız için geçiş yönünü seçin.
Azure portalında geliştirme sınırlamaları
İşlevlerinizi Azure portalında geliştirirken şu sınırlamaları göz önünde bulundurun:
- Portal içi düzenleme yalnızca Azure portalında oluşturulan veya en son değiştirilen işlevler için desteklenir.
- Portal içi düzenleme yalnızca JavaScript, PowerShell, Python ve C# Betik işlevleri için desteklenir.
- Flex Consumption planının önizleme sürümünde portal içi düzenleme desteklenmez.
- Azure portalının dışından bir işlev uygulamasına kod dağıttığınızda, artık portalda bu işlev uygulamasının kodlarından hiçbirini düzenleyemezsiniz. Bu durumda yerel geliştirmeyi kullanmaya devam edin.
- Python için özel modüllerle geliştirme şu anda portalda desteklenmemektedir. İşlev uygulamanıza özel modüller eklemek için uygulamanızı yerel olarak geliştirmeniz gerekir.
- Derlenmiş C# işlevleri ve Java işlevleri için, işlev uygulamasını ve ilgili kaynakları portalda oluşturabilirsiniz. Ancak işlev kodu projesini yerel olarak oluşturup Azure'da yayımlamanız gerekir.
Mümkün olduğunda işlevlerinizi yerel olarak geliştirin ve kod projenizi Azure'daki bir işlev uygulamasında yayımlayın. Daha fazla bilgi için bkz. Yerel olarak Azure İşlevleri kod ve test.
Uzantıları el ile yükleme
C# sınıf kitaplığı işlevleri, uzantıları doğrudan sınıf kitaplığı projesinde bağlamaya yönelik NuGet paketlerini içerebilir. Diğer non-.NET dilleri ve C# betiği için uzantı paketlerini kullanmanız gerekir. Uzantıları el ile yüklemeniz gerekiyorsa, Azure İşlevleri Core Tools'u yerel olarak kullanarak bunu yapabilirsiniz. Uzantı paketlerini kullanamıyorsanız ve yalnızca portalda çalışabiliyorsanız, extensions.csproj dosyasını doğrudan sitede el ile oluşturmak için Gelişmiş Araçlar'ı (Kudu) kullanmanız gerekir. önce öğesini host.json dosyasından kaldırdığınızdan extensionBundle
emin olun.
Aynı işlem, uygulamanıza eklemeniz gereken diğer tüm dosyalarda da çalışır.
Önemli
Mümkün olduğunda, dosyaları doğrudan Azure'daki işlev uygulamanızda düzenlemeyin. Uygulama dosyalarınızı yerel olarak indirmenizi, uzantıları ve diğer paketleri yüklemek için Core Tools'u kullanmanızı, değişikliklerinizi doğrulamanızı ve ardından Core Tools veya desteklenen diğer dağıtım yöntemlerinden birini kullanarak uygulamanızı yeniden yayımlamanızı öneririz.
Azure portalında yerleşik olarak bulunan İşlevler düzenleyicisi, işlev kodunuzu ve yapılandırma dosyalarınızı doğrudan portalda güncelleştirmenizi sağlar:
İşlev uygulamanızı seçin, ardından İşlevler'in altında İşlevler'i seçin.
İşlevinizi seçin ve Geliştirici'nin altında Kod + test'i seçin.
Düzenlemek istediğiniz dosyayı seçin ve bitirdiğinizde Kaydet'i seçin.
Uygulamanın kökündeki function.proj veya extensions.csproj gibi dosyaların Gelişmiş Araçlar (Kudu) kullanılarak oluşturulması ve düzenlenmesi gerekir:
İşlev uygulamanızı seçin, Geliştirme araçları'nı genişletin ve ardından Gelişmiş araçlar>Git'i seçin.
İstenirse, Azure kimlik bilgilerinizle Kaynak Denetim Yöneticisi (SCM) sitesinde oturum açın.
Hata ayıklama konsolu menüsünden CMD'yi seçin.
adresine
.\site\wwwroot
gidin, üstteki artı (+) düğmesini seçin ve Yeni dosya'yı seçin.Dosyaya gibi
extensions.csproj
bir ad verin ve Enter tuşuna basın.Yeni dosyanın yanındaki düzenle düğmesini seçin, dosyaya kod ekleyin veya güncelleştirin ve ardından Kaydet'i seçin.
extensions.csproj gibi bir proje dosyası için aşağıdaki komutu çalıştırarak extensions projesini yeniden oluşturun:
dotnet build extensions.csproj
Platform özellikleri
İşlev uygulamaları, bunların bakımını yapan Azure Uygulaması Hizmeti platformunda çalışır. Bu nedenle işlev uygulamalarınız Azure'ın temel web barındırma platformunun özelliklerinin çoğuna erişebilir. Azure portalını kullandığınızda, sol bölmede App Service platformunun işlev uygulamalarınızda kullanabileceğiniz birçok özelliğine erişebilirsiniz.
Aşağıdaki matris, barındırma planı ve işletim sistemi ile Azure portalı özellik desteğini gösterir:
Özellik | Tüketim planı | Esnek Tüketim planı | Premium planı | Ayrılmış plan |
---|---|---|---|---|
Gelişmiş araçlar (Kudu) | Windows: ✔ Linux: X |
X | ✔ | ✔ |
App Service düzenleyicisi | Windows: ✔ Linux: X |
X | Windows: ✔ Linux: X |
Windows: ✔ Linux: X |
Yedeklemeler | X | X | X | ✔ |
Konsol | Windows: komut satırı Linux: X |
X | Windows: komut satırı Linux: SSH |
Windows: komut satırı Linux: SSH |
Bu makalenin geri kalanında portalda işlev uygulamalarınız için yararlı olan aşağıdaki özelliklere odaklanılır:
- App Service düzenleyicisi
- Konsol
- Gelişmiş araçlar (Kudu)
- Dağıtım seçenekleri
- CORS
- Kimlik Doğrulaması
App Service ayarlarıyla çalışma hakkında daha fazla bilgi için bkz. Azure Uygulaması Hizmet Ayarlarını Yapılandırma.
App Service düzenleyicisi
App Service düzenleyicisi, JSON yapılandırma dosyalarını ve kod dosyalarını değiştirmek için kullanabileceğiniz gelişmiş bir portal içi düzenleyicidir. Bu seçeneğin seçilmesi, temel bir düzenleyici ile ayrı bir tarayıcı sekmesi başlatır. Bu düzenleyici Git deposuyla tümleştirmenize, kodu çalıştırmanıza ve hatalarını ayıklamanıza ve işlev uygulaması ayarlarını değiştirmenize olanak tanır. Bu düzenleyici, yerleşik işlev düzenleyicisine kıyasla işlevleriniz için gelişmiş bir geliştirme ortamı sağlar.
İşlevlerinizi yerel bilgisayarınızda geliştirmeyi düşünmenizi öneririz. Yerel olarak geliştirip Azure'da yayımladığınızda, proje dosyalarınız Azure portalında salt okunur olur. Daha fazla bilgi için bkz. Yerel olarak Azure İşlevleri kod ve test.
Konsol
Komut satırından işlev uygulamanızla etkileşime geçmek istediğinizde portal içi konsol ideal bir geliştirici aracıdır. Yaygın komutlar, dizin ve dosya oluşturma ve gezintinin yanı sıra toplu iş dosyalarını ve betiklerini yürütmeyi içerir.
Yerel olarak geliştirme yaparken Azure İşlevleri Core Tools ve Azure CLI'yi kullanmanızı öneririz.
Gelişmiş araçlar (Kudu)
App Service için gelişmiş araçlar (Kudu olarak da bilinir), işlev uygulamanızın gelişmiş yönetim özelliklerine erişim sağlar. Kudu'dan sistem bilgilerini, uygulama ayarlarını, ortam değişkenlerini, site uzantılarını, HTTP üst bilgilerini ve sunucu değişkenlerini yönetirsiniz. Kudu'yu, işlev uygulamanızın SCM uç noktasına göz atarak da başlatabilirsiniz; örneğin: https://<myfunctionapp>.scm.azurewebsites.net/
.
Dağıtım Merkezi
İşlev kodunuzu geliştirmek ve korumak için bir kaynak denetimi çözümü kullandığınızda, Dağıtım Merkezi kaynak denetiminden derlemenizi ve dağıtmanızı sağlar. Güncelleştirmeler yaptığınızda projeniz oluşturulur ve Azure'a dağıtılır. Daha fazla bilgi için bkz. Azure İşlevleri dağıtım teknolojileri.
Çıkış noktaları arası kaynak paylaşma
İstemcide kötü amaçlı kod yürütülmesini önlemek için modern tarayıcılar, web uygulamalarından ayrı bir etki alanında çalışan kaynaklara yönelik istekleri engeller. Çıkış noktaları arası kaynak paylaşımı (CORS), üst Access-Control-Allow-Origin
bilginin işlev uygulamanızda uç noktaları çağırmasına izin verilen kaynakları bildirmesine olanak tanır.
İşlev uygulamanız için İzin verilen çıkış noktaları listesini yapılandırdığınızda, Access-Control-Allow-Origin
üst bilgi işlev uygulamanızdaki HTTP uç noktalarındaki tüm yanıtlara otomatik olarak eklenir.
Başka bir etki alanı girişi varsa joker karakter (*) yoksayılır.
Kimlik Doğrulaması
İşlevler bir HTTP tetikleyicisi kullandığında, çağrıların önce kimlik doğrulamasının yapılmasını gerektirebilirsiniz. App Service, Microsoft Entra kimlik doğrulamasını ve Facebook, Microsoft ve X gibi sosyal sağlayıcılarla oturum açmayı destekler. Belirli kimlik doğrulama sağlayıcılarını yapılandırma hakkında bilgi için bkz. hizmet kimlik doğrulamasına genel bakış Azure Uygulaması.