Azure İşlevleri’ni yerel olarak kodlama ve test etme

Makale
12/09/2023

Azure portalında Azure İşlevleri geliştirip test edebilirsiniz ancak birçok geliştirici yerel geliştirme deneyimini tercih eder. İşlevler'i kullandığınızda, yerel bilgisayarınızda işlev oluşturmak ve test etmek için sık kullandığınız kod düzenleyicisini ve geliştirme araçlarını kullanmak daha kolay hale gelir. Yerel işlevleriniz canlı Azure hizmetlerine bağlanabilir ve tam İşlevler çalışma zamanını kullanarak yerel bilgisayarınızda bunların hatalarını ayıklayabilirsiniz.

Bu makale, tercih ettiğiniz dil için belirli geliştirme ortamlarına bağlantılar sağlar. Ayrıca, local.settings.json dosyasıyla çalışma gibi yerel geliştirme için bazı paylaşılan yönergeler sağlar.

Yerel geliştirme ortamları

Yerel bilgisayarınızda işlevleri geliştirme yönteminiz dilinize ve araç tercihlerinize bağlıdır. Aşağıdaki tablodaki ortamlar yerel geliştirmeyi destekler:

Ortam	Diller	Açıklama
Visual Studio Code	C# (işlem içi) C# (yalıtılmış çalışan işlemi) JavaScript PowerShell Python	VS Code için Azure İşlevleri uzantısı VS Code'a İşlev desteği ekler. Çekirdek Araçları gerektirir. Core Tools'un 2.x sürümünü kullanırken Linux, macOS ve Windows üzerinde geliştirmeyi destekler. Daha fazla bilgi edinmek için bkz . Visual Studio Code kullanarak ilk işlevinizi oluşturma.
Komut istemi veya terminal	C# (işlem içi) C# (yalıtılmış çalışan işlemi) JavaScript PowerShell Python	Azure İşlevleri Core Tools, yerel geliştirmeyi etkinleştiren işlevler oluşturmaya yönelik temel çalışma zamanı ve şablonları sağlar. Sürüm 2.x, Linux, macOS ve Windows üzerinde geliştirmeyi destekler. Tüm ortamlar, yerel İşlevler çalışma zamanı için Temel Araçlar'a dayanır.
Visual Studio	C# (işlem içi) C# (yalıtılmış çalışan işlemi)	Azure İşlevleri araçları, Visual Studio 2019'dan başlayarak Visual Studio'nun Azure geliştirme iş yüküne dahildir. Bir sınıf kitaplığında işlevleri derlemenize ve .dll Azure'da yayımlamanıza olanak tanır. Yerel test için Temel Araçları içerir. Daha fazla bilgi edinmek için bkz. Visual Studio kullanarak Azure İşlevleri geliştirme.
Maven (çeşitli)	Java	Maven arketipi, Java işlevlerinin geliştirilmesini sağlamak için Core Tools'u destekler. Sürüm 2.x, Linux, macOS ve Windows üzerinde geliştirmeyi destekler. Daha fazla bilgi edinmek için bkz . Java ve Maven ile ilk işlevinizi oluşturma. Ayrıca Eclipse ve IntelliJ IDEA kullanarak geliştirmeyi de destekler.

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ı

Bu yerel geliştirme ortamlarının her biri işlev uygulaması projeleri oluşturmanıza ve yeni işlevler oluşturmak için önceden tanımlanmış işlev şablonlarını kullanmanıza olanak tanır. Her biri Çekirdek Araçları'nı kullanarak işlevlerinizi diğer tüm uygulamalarda olduğu gibi kendi makinenizdeki gerçek İşlevler çalışma zamanına göre test edebilir ve hatalarını ayıklayabilirsiniz. İşlev uygulaması projenizi bu ortamların herhangi birinden Azure'da da yayımlayabilirsiniz.

Yerel proje dosyaları

İşlevler proje dizini, dilden bağımsız olarak proje kök klasöründe aşağıdaki dosyaları içerir:

Dosya adı	Açıklama
host.json	Daha fazla bilgi edinmek için host.json başvurusuna bakın.
local.settings.json	Ayarlar, uygulama ayarları da dahil olmak üzere yerel olarak çalışırken Core Tools tarafından kullanılır. Daha fazla bilgi için bkz . yerel ayarlar dosyası.
.gitignore	local.settings.json dosyasının yanlışlıkla git deposunda yayımlanmasını engeller. Daha fazla bilgi için bkz . yerel ayarlar dosyası.
.vscode\extensions.json	Visual Studio Code'da proje klasörü açılırken kullanılan Ayarlar dosyası.

Projedeki diğer dosyalar dilinize ve belirli işlevlerinize bağlıdır. Daha fazla bilgi için dilinize yönelik geliştirici kılavuzuna bakın.

Yerel ayarlar dosyası

local.settings.json dosya, yerel geliştirme araçları tarafından kullanılan uygulama ayarlarını ve ayarlarını depolar. local.settings.json dosyasındaki Ayarlar yalnızca projenizi yerel olarak çalıştırdığınızda kullanılır. Projenizi Azure'da yayımladığınızda, işlev uygulamasının uygulama ayarlarına gerekli ayarları da eklediğinizden emin olun.

Önemli

local.settings.json bağlantı dizesi gibi gizli diziler içerebileceğinden, bunu hiçbir zaman uzak bir depoda depolamamalısınız. İşlevleri destekleyen araçlar, local.settings.json dosyasındaki ayarları projenizin dağıtıldığı işlev uygulamasındaki uygulama ayarlarıyla eşitlemenin yollarını sağlar.

Yerel ayarlar dosyası şu yapıya sahiptir:

{
  "IsEncrypted": false,
  "Values": {
    "FUNCTIONS_WORKER_RUNTIME": "<language worker>",
    "AzureWebJobsStorage": "<connection-string>",
    "MyBindingConnection": "<binding-connection-string>",
    "AzureWebJobs.HttpExample.Disabled": "true"
  },
  "Host": {
    "LocalHttpPort": 7071,
    "CORS": "*",
    "CORSCredentials": false
  },
  "ConnectionStrings": {
    "SQLConnectionString": "<sqlclient-connection-string>"
  }
}

Projeleri yerel olarak çalıştırdığınızda bu ayarlar desteklenir:

Ayar	Açıklama
`IsEncrypted`	Bu ayar olarak `true`ayarlandığında, tüm değerler yerel makine anahtarıyla şifrelenir. Komutlarla kullanılır `func settings` . Varsayılan değer `false` olarak belirlenmiştir. Hizmet bağlantı dizesi gibi gizli diziler içerdiğinde yerel bilgisayarınızdaki local.settings.json dosyasını şifrelemek isteyebilirsiniz. Konak çalıştığında ayarların şifresini otomatik olarak çözer. `func settings decrypt` Yerel olarak şifrelenmiş ayarları okumaya çalışmadan önce komutunu kullanın.
`Values`	Proje yerel olarak çalışırken kullanılan uygulama ayarlarının koleksiyonu. Bu anahtar-değer (dize-dize) çiftleri, Gibi `AzureWebJobsStorage`Azure'daki işlev uygulamanızdaki uygulama ayarlarına karşılık gelir. Birçok tetikleyici ve bağlama, Blob depolama tetikleyicisi gibi `Connection` bir bağlantı dizesi uygulama ayarına başvuran bir özelliğe sahiptir. Bu özellikler için dizide tanımlanmış bir uygulama ayarına `Values` ihtiyacınız vardır. Sık kullanılan ayarların listesi için sonraki tabloya bakın. Değerler JSON nesneleri veya dizileri değil dizeler olmalıdır. Ayar adları çift alt çizgi (`__`) içeremez ve iki nokta üst üste (`:`) içermemelidir. Çift alt çizgi karakterleri çalışma zamanı tarafından ayrılmıştır ve iki nokta üst üste bağımlılık eklemeyi desteklemek için ayrılmıştır.
`Host`	Bu bölümdeki Ayarlar, projeleri yerel olarak çalıştırdığınızda İşlevler ana bilgisayar işlemini özelleştirin. Bu ayarlar, Azure'da projeleri çalıştırdığınızda da geçerli olan host.json ayarlarından ayrıdır.
`LocalHttpPort`	Yerel İşlevler ana bilgisayarını (`func host start` ve `func run`) çalıştırırken kullanılan varsayılan bağlantı noktasını ayarlar. Komut `--port` satırı seçeneği bu ayardan önceliklidir. Örneğin, Visual Studio IDE'de çalışırken, "Proje Özellikleri -> Hata Ayıklama" penceresine gidip "Uygulama Bağımsız Değişkenleri" alanında sağlanabilir bir `host start --port <your-port-number>` komutta bağlantı noktası numarasını açıkça belirterek bağlantı noktası numarasını değiştirebilirsiniz.
`CORS`	Çıkış noktaları arası kaynak paylaşımı (CORS) için izin verilen kaynakları tanımlar. Çıkış noktaları, boşluk içermeyen virgülle ayrılmış bir liste olarak sağlanır. Joker karakter değeri (*) desteklenir ve bu değer herhangi bir kaynaktan gelen isteklere izin verir.
`CORSCredentials`	olarak ayarlandığında `true`isteklere izin verir `withCredentials` .
`ConnectionStrings`	Bir koleksiyon. İşlev bağlamalarınız tarafından kullanılan bağlantı dizesi için bu koleksiyonu kullanmayın. Bu koleksiyon yalnızca genellikle Entity Framework gibi bir yapılandırma dosyasının bölümünden `ConnectionStrings` bağlantı dizesi alan çerçeveler tarafından kullanılır. Bu nesnedeki Bağlan ion dizeleri, sağlayıcı türüyle ortama eklenirSystem.Data.SqlClient. Bu koleksiyondaki öğeler diğer uygulama ayarlarıyla Azure'da yayımlanmaz. Bu değerleri işlev uygulaması ayarlarınızın koleksiyonuna `Connection strings` açıkça eklemeniz gerekir. İşlev kodunuzda bir `SqlConnection` oluşturuyorsanız, bağlantı dizesi değerini portaldaki Uygulama Ayarlar diğer bağlantılarınızla birlikte depolamanız gerekir.

Aşağıdaki uygulama ayarları yerel olarak çalıştırılırken diziye Values eklenebilir:

Ayar	Değerler	Açıklama
`AzureWebJobsStorage`	hesap bağlantı dizesi Depolama veya `UseDevelopmentStorage=true`	Azure depolama hesabının bağlantı dizesi içerir. HTTP dışındaki tetikleyiciler kullanılırken gereklidir. Daha fazla bilgi için başvuruya `AzureWebJobsStorage` bakın. Azurite Öykünücüsü yerel olarak yüklendiğinde ve olarak ayarladığınızda `AzureWebJobsStorageUseDevelopmentStorage=true`Core Tools öykünücüyü kullanır. Daha fazla bilgi için bkz . Yerel depolama öykünücüsü.
`AzureWebJobs.<FUNCTION_NAME>.Disabled`	`true`\|`false`	Bir işlevi yerel olarak çalıştırırken devre dışı bırakmak için, işlevin adı olan `<FUNCTION_NAME>` koleksiyona ekleyin`"AzureWebJobs.<FUNCTION_NAME>.Disabled": "true"`. Daha fazla bilgi edinmek için bkz. Azure İşlevleri işlevleri devre dışı bırakma.
`FUNCTIONS_WORKER_RUNTIME`	`dotnet` `dotnet-isolated` `node` `java` `powershell` `python`	İşlevler çalışma zamanının hedeflenen dilini gösterir. İşlevler çalışma zamanının 2.x ve üzeri sürümleri için gereklidir. Bu ayar, projeniz için Core Tools tarafından oluşturulur. Daha fazla bilgi edinmek için başvuruya `FUNCTIONS_WORKER_RUNTIME` bakın.
`FUNCTIONS_WORKER_RUNTIME_VERSION`	`~7`	Yerel olarak çalışırken PowerShell 7'nin kullanılacağını gösterir. Ayarlanmadıysa PowerShell Core 6 kullanılır. Bu ayar yalnızca yerel olarak çalıştırılırken kullanılır. PowerShell çalışma zamanı sürümü, portalda ayarlanabilen `powerShellVersion`Azure'da çalıştırıldığında site yapılandırma ayarı tarafından belirlenir.

Eşitleme ayarları

İşlevlerinizi yerel olarak geliştirirken, uygulamanızın gerektirdiği tüm yerel ayarlar kodunuzun dağıtıldığı işlev uygulamasının uygulama ayarlarında da bulunmalıdır. Geçerli ayarları işlev uygulamasından yerel projenize de indirmeniz gerekebilir. Uygulama ayarlarını Azure portalında el ile yapılandırabilirsiniz ancak aşağıdaki araçlar uygulama ayarlarını projenizdeki yerel ayarlarla eşitlemenize de olanak sağlar:

Tetikleyiciler ve bağlamalar

İşlevlerinizi yerel olarak geliştirirken tetikleyici ve bağlama davranışlarını dikkate almanız gerekir. HTTP tetikleyicileri için, kullanarak http://localhost/yerel bilgisayarda HTTP uç noktasını çağırabilirsiniz. HTTP ile tetiklenmeyen işlevler için yerel olarak çalıştırılacak çeşitli seçenekler vardır:

Yerel geliştirme sırasında bağlamaları test etmenin en kolay yolu, canlı Azure hizmetlerini hedefleyen bağlantı dizesi kullanmaktır. local.settings.json dosyasındaki diziye uygun bağlantı dizesi ayarlarını Values ekleyerek canlı hizmetleri hedefleyebilirsiniz. Bunu yaptığınızda, test sırasındaki yerel yürütmeler canlı hizmet verilerini etkiler. Bu nedenle, geliştirme ve test sırasında kullanılacak ayrı hizmetler ayarlamayı ve ardından üretim sırasında farklı hizmetlere geçmeyi göz önünde bulundurun.
Depolama tabanlı tetikleyiciler için yerel bir depolama öykünücüsü kullanabilirsiniz.
Özel yönetici uç noktalarını kullanarak HTTP olmayan tetikleyici işlevlerini el ile çalıştırabilirsiniz. Daha fazla bilgi için bkz . HTTP ile tetiklenmeyen bir işlevi el ile çalıştırma.

Yerel test sırasında, Çekirdek Araçlar (func.exe) tarafından sağlanan konağı yerel olarak çalıştırıyor olmanız gerekir. Daha fazla bilgi için bkz. Azure İşlevleri Temel Araçlar.

Yerel depolama öykünücüsü

Yerel geliştirme sırasında, uzak depolama hizmetlerine bağlanmak zorunda kalmadan Azure Depolama bağlamalarıyla (Kuyruk Depolama, Blob Depolama ve Tablo Depolama) işlevleri test ederken yerel Azurite öykünücüsü kullanabilirsiniz. Azurite, Visual Studio Code ve Visual Studio ile tümleştirilir ve npm kullanarak komut isteminden de çalıştırabilirsiniz. Daha fazla bilgi için bkz. Yerel Azure Depolama geliştirmesi için Azurite öykünücüsü kullanma.

local.settings.json dosyasının Values koleksiyonundaki aşağıdaki ayar yerel İşlevler ana bilgisayarına varsayılan AzureWebJobsStorage bağlantı için Azurite kullanmasını söyler:

"AzureWebJobsStorage": "UseDevelopmentStorage=true"

Bu ayar değeriyle, bağlantı olarak kullanan AzureWebJobsStorage tüm Azure Depolama tetikleyicileri veya bağlamaları yerel olarak çalıştırılırken Azurite'ye bağlanır. Yerel yürütme sırasında depolama öykünmesi kullanılırken şu noktaları göz önünde bulundurun:

Azurite yüklü ve çalışıyor olmalıdır.
Azure'da yayımlamadan önce Azure hizmetlerine gerçek bir depolama bağlantısıyla test etmelisiniz.
Projenizi yayımladığınızda, ayarını olarak UseDevelopmentStorage=trueyayımlamayınAzureWebJobsStorage. Azure'da bu ayar her AzureWebJobsStorage zaman işlev uygulamanız tarafından kullanılan depolama hesabının bağlantı dizesi olmalıdır. Daha fazla bilgi için bkz. AzureWebJobsStorage.

Sonraki adımlar

Visual Studio kullanarak derlenmiş C# işlevlerinin (hem işlem içi hem de yalıtılmış çalışan işlemi) yerel olarak geliştirilmesi hakkında daha fazla bilgi edinmek için bkz. Visual Studio kullanarak Azure İşlevleri geliştirme.
Mac, Linux veya Windows bilgisayarda VS Code kullanarak işlevlerin yerel olarak geliştirilmesi hakkında daha fazla bilgi edinmek için tercih ettiğiniz dil için Visual Studio Code kullanmaya başlama makalesine bakın:
Komut isteminden veya terminalden işlev geliştirme hakkında daha fazla bilgi edinmek için bkz. Azure İşlevleri Core Tools ile çalışma.