Azure İşlevleri geliştirici kılavuzu

Azure Işlevlerinde belirli işlevler, kullandığınız dil veya bağlama ne olursa olsun, birkaç temel teknik kavram ve bileşeni paylaşır. Belirli bir dile veya bağlamaya özgü öğrenme ayrıntılarına geçmeden önce, tüm bunlar için geçerli olan bu genel bakışı okuduğunuzdan emin olun.

Bu makalede, Azure işlevlerine genel bakış ' ıokuduğunuzu varsaymış olursunuz.

İşlev kodu

Bir işlev , Azure işlevlerinde birincil kavramdır. Bir işlev, çeşitli dillerde yazılmış ve bazı config, function. JSON dosyası olmak üzere iki önemli parça içerir. Derlenen diller için, bu yapılandırma dosyası kodunuzdaki ek açıklamalardan otomatik olarak oluşturulur. Komut dosyası dilleri için yapılandırma dosyasını kendiniz sağlamanız gerekir.

Function. JSON dosyası işlevin tetikleyicisini, bağlamalarını ve diğer yapılandırma ayarlarını tanımlar. Her işlevde tek bir tane tetikleyici olması gerekir. Çalışma zamanı, izlenecek olayları ve bir işlev yürütmesindeki verilerin içine nasıl geçirileceğini ve geri döneceğini öğrenmek için bu yapılandırma dosyasını kullanır. Aşağıda örnek bir Function. JSON dosyası verilmiştir.

{
    "disabled":false,
    "bindings":[
        // ... bindings here
        {
            "type": "bindingType",
            "direction": "in",
            "name": "myParamName",
            // ... more depending on binding
        }
    ]
}

Daha fazla bilgi için bkz. Azure işlevleri Tetikleyicileri ve bağlamaları kavramları.

bindingsÖzelliği, hem Tetikleyicileri hem de bağlamaları yapılandırdığınız yerdir. Her bağlama birkaç ortak ayarı ve belirli bir bağlama türüne özgü bazı ayarları paylaşır. Her bağlama için aşağıdaki ayarlar gereklidir:

İşlev uygulaması

Bir işlev uygulaması, Azure 'da işlevlerinizin çalıştırıldığı bir yürütme bağlamı sağlar. Bu nedenle, işlevleriniz için dağıtım ve yönetim birimidir. İşlev uygulaması, yönetilen, dağıtılan ve birlikte ölçeklenen bir veya daha fazla bağımsız işlevden oluşur. Bir işlev uygulamasındaki tüm işlevler aynı fiyatlandırma planı, dağıtım yöntemi ve çalışma zamanı sürümünü paylaşır. İşlev uygulamasını, işlevlerinizi düzenlemek ve topluca yönetmek için bir yol olarak düşünün. Daha fazla bilgi için bkz. bir işlev uygulamasını yönetme.

Klasör yapısı

Belirli bir işlev uygulamasındaki tüm işlevlerin kodu, konak yapılandırma dosyası içeren bir kök proje klasöründe bulunur. Dosya host.jsçalışma zamanının yapılandırmalarını içerir ve işlev uygulamasının kök klasöründedir. Bir bin klasörü, işlev uygulamasının gerektirdiği paketleri ve diğer kitaplık dosyalarını içerir. İşlev uygulaması için gereken belirli klasör yapıları dile bağlıdır:

• C# derlenmiş (.csproj)
• C# betiği (.csx)
• F# betiği
• Java
• JavaScript
• Python

İşlevler çalışma zamanının 2.x ve üst sürümünde, işlev uygulamasındaki tüm işlevlerin aynı dil yığınını paylaşması gerekir.

Yukarıdaki, bir Işlev uygulaması için varsayılan (ve önerilen) klasör yapısıdır. Bir işlevin kodunun dosya konumunu değiştirmek istiyorsanız, scriptFile function. JSON dosyasının bölümünü değiştirin. Ayrıca, Azure 'daki işlev uygulamanıza projenizi dağıtmak için paket dağıtımı kullanmanızı öneririz. Ayrıca, sürekli tümleştirme ve dağıtım ve Azure DevOps gibi mevcut araçları da kullanabilirsiniz.

Yerel araçları ve yayımlamayı kullanma

işlev uygulamaları Visual Studio, Visual Studio Code, ıntellij, tutulmave Azure Functions Core Toolsgibi çeşitli araçlar kullanılarak yazılabilir ve yayımlanabilir. Daha fazla bilgi için bkz. Azure işlevlerini yerel olarak kod ve testetme.

Azure portal işlevleri düzenleme

Azure portal yerleşik Işlevler Düzenleyicisi kodunuzu ve function. JSON dosyanızı doğrudan satır içinde güncelleştirmenize olanak tanır. Bu yalnızca küçük değişiklikler veya kavram provaları için önerilir-en iyi yöntem, VS Code gibi bir yerel geliştirme aracı kullanmaktır.

Paralel yürütme

Çoklu iş parçacıklı bir işlev çalışma zamanının daha hızlı bir şekilde tetiklenmesi durumunda, çalışma zamanı işlevi paralel olarak birden çok kez çağırabilir. Bir işlev uygulaması Tüketim barındırma planınıkullanıyorsa, işlev uygulaması otomatik olarak ölçeklendirebilir. İşlev uygulamasının her örneği, uygulamanın tüketim barındırma planı üzerinde mi yoksa düzenli bir App Service barındırma planıüzerinde mi çalıştığı, birden çok iş parçacığı kullanarak eşzamanlı işlev çağrılarını paralel olarak işleyebilir. Her işlev uygulama örneğindeki maksimum eşzamanlı işlev çağırma sayısı, kullanılan tetikleyici türüne ve işlev uygulamasındaki diğer işlevler tarafından kullanılan kaynaklara göre değişir.

İşlevler çalışma zamanı sürümü oluşturma

Uygulama ayarını kullanarak Işlevler çalışma zamanının sürümünü yapılandırabilirsiniz FUNCTIONS_EXTENSION_VERSION . Örneğin, "~ 3" değeri, işlev uygulamanızın ana sürümü olarak 3. x kullanacağını gösterir. İşlev uygulamaları, yayımlandıklarında her yeni küçük sürüme yükseltilir. İşlev uygulamanızın tam sürümünün nasıl görüntüleneceği dahil olmak üzere daha fazla bilgi için bkz. Azure işlevleri çalışma zamanı sürümlerini hedefleme.

Depolar

Azure işlevleri için kod açık kaynaktır ve GitHub depolarda depolanır:

• Azure İşlevleri
• Azure Işlevleri ana bilgisayarı
• Azure Işlevleri portalı
• Azure Işlevleri şablonları
• Azure Web İşleri SDK'sı
• Azure Web İşleri SDK'sı Uzantıları

Bağlamalar

Desteklenen tüm bağlamaların bir tablosu aşağıda verilmiştir.

Bu tabloda, çalışma zamanının ana sürümlerinde desteklenen bağlamalar Azure İşlevleri gösterir:

¹ Sürüm 2.x çalışma zamanından başlayarak HTTP ve Zamanlayıcı dışındaki tüm bağlamaların kayıtlı olması gerekir. Bkz. Bağlama uzantılarını kaydetme.

² Tetikleyiciler Tüketim planında desteklenmiyor. Çalışma zamanı odaklı tetikleyiciler gerektirir.

³ Yalnızca Kubernetes, IoT Edge ve diğer kendi kendine barındırılan modlarda destekler.

Bağlamalardan gelen hatalarla ilgili sorun mu yaşıyorsunuz? Azure Işlevleri bağlama hata kodları belgelerini gözden geçirin.

Bağlantılar

İşlev projeniz, bağlantı bilgilerine yapılandırma sağlayıcısından ada göre başvurur. Bağlantı ayrıntılarını doğrudan kabul etmez ve bunların ortamlar genelinde değiştirilmesine izin verir. Örneğin, bir tetikleyici tanımı bir connection özelliği içerebilir. Bu bir bağlantı dizesine başvurabilir, ancak bağlantı dizesini doğrudan bir içinde ayarlayamazsınız function.json . Bunun yerine, connection bağlantı dizesini içeren bir ortam değişkeninin adına ayarlanır.

Varsayılan yapılandırma sağlayıcısı ortam değişkenlerini kullanır. bunlar, Azure işlevleri hizmetinde çalışırken veya yerel olarak geliştirilirken yerel ayarlar dosyasından uygulama Ayarlar göre ayarlanabilir.

Bağlantı değerleri

Bağlantı adı tek bir tam değere çözümlenirse, çalışma zamanı, genellikle bir gizli dizi içeren bağlantı dizesi olarak değeri tanımlar. Bağlantı dizesinin ayrıntıları, bağlanmak istediğiniz hizmet tarafından tanımlanır.

Ancak, bir bağlantı adı aynı zamanda birden fazla yapılandırma öğesi koleksiyonuna başvurabilir, kimlik tabanlı bağlantılarıyapılandırmaya yarar vardır. Ortam değişkenleri, Çift alt çizgi ile biten paylaşılan bir ön ek kullanılarak bir koleksiyon olarak değerlendirilir __ . Bu gruba, bu önek için bağlantı adı ayarlanarak izin verebilirsiniz.

Örneğin, connection bir Azure Blob tetikleyici tanımının özelliği "Storage1" olabilir. "Storage1" adlı bir ortam değişkeni tarafından yapılandırılan tek bir dize değeri olmadığı sürece, Storage1__blobServiceUri bağlantı özelliğini bilgilendirmek için adlı bir ortam değişkeni kullanılabilir blobServiceUri . Bağlantı özellikleri her hizmet için farklıdır. Bağlantıyı kullanan bileşen için belgelere bakın.

Kimlik tabanlı bağlantı yapılandırma

Bir Azure İşlevleri gizli bilgi yerine kimlik kullanmak üzere yalıtabilirsiniz. Destek, bağlantıyı kullanan uzantıya bağlıdır. Bazı durumlarda, bağlanmakta olduğu hizmet kimlik tabanlı bağlantıları desteklese de İşlevler'de bağlantı dizesi hala gerekli olabilir. İşlev uygulamalarınızı yönetilen kimliklerle yapılandırma öğreticisi için kimlik tabanlı bağlantılar ile işlev uygulaması oluşturma öğreticisi'ne bakın.

Kimlik tabanlı bağlantılar aşağıdaki bileşenler tarafından de desteklemektedir:

Azure Işlevleri hizmetinde barındırıldığında, kimlik tabanlı bağlantılar yönetilen bir kimlikkullanır. Sistem tarafından atanan kimlik, ve özellikleriyle kullanıcı tarafından atanan bir kimlik belirtibilse de varsayılan olarak kullanılır credential clientID . Yerel geliştirme gibi diğer bağlamlarda çalıştırıldığında geliştirici kimliğiniz bunun yerine özelleştirilebilir. Bkz. kimlik tabanlı bağlantılarla yerel geliştirme.

Kimliğe izin ver

Kullanılan kimliğin istenen eylemleri gerçekleştirmek için izinleri olması gerekir. Azure RBAC 'de, bu izinleri sağlayan yerleşik veya özel roller kullanarak bir rol atamanızgerekir.

Her bileşenin izinleri hakkında bilgi edinmek için aşağıdaki sekmeyi seçin:

Kimlik tabanlı bağlantılar için ortak özellikler

Azure hizmeti için kimlik tabanlı bağlantı aşağıdaki ortak özellikleri kabul eder; burada tetikleyici veya bağlama tanımında <CONNECTION_NAME_PREFIX> connection özelliğinizin değeridir:

Verilen bağlantı türü için ek seçenekler destek olabilir. Lütfen bağlantıyı yapan bileşene ilişkin belgelere bakın.

Kimlik tabanlı bağlantılar ile yerel geliştirme

Yukarıdaki yapılandırma, yerel olarak çalıştırarak çalışma zamanının yerel geliştirici kimliğinizi kullanmalarını söyler. Bağlantı, sırasıyla aşağıdaki konumlardan bir belirteç almaya çalışacak:

• Microsoft uygulamaları arasında paylaşılan yerel önbellek
• Visual Studio'de geçerli kullanıcı bağlamı
• Visual Studio Code'daki geçerli kullanıcı bağlamı
• Azure CLI'daki geçerli kullanıcı bağlamı

Bu seçeneklerden hiçbiri başarılı olursa bir hata oluşur.

Bu, geliştirici kimliğinizi kullanıyor olduğundan, geliştirme kaynaklarına karşı zaten bazı rolleriniz olabilir, ancak bunlar veri erişimi sağlamayabilirsiniz. Sahip gibi yönetim rolleri yeterli değildir. Her bileşen için bağlantılar için hangi izinlerin gerekli olduğunu bir kez daha denetleyin ve bunları kendinize atayın.

Bazı durumlarda, farklı bir kimliğin kullanımını belirtmek istediğiniz durumlar olabilir. Bir hizmet sorumlusu için istemci kimliğine ve gizli anahtarına göre alternatif kimliğe işaret Azure Active Directory yapılandırma özellikleri ebilirsiniz. Bu yapılandırma seçeneği, hizmette barındırılan Azure İşlevleri desteklanmaz. Yerel makineniz üzerinde bir kimlik ve gizli kod kullanmak için bağlantıyı aşağıdaki ek özelliklerle tanımlayın:

Azure Bloblarına kimlik local.settings.json tabanlı bağlantı için gereken özelliklere bir örnek:

{
  "IsEncrypted": false,
  "Values": {
    "<CONNECTION_NAME_PREFIX>__blobServiceUri": "<blobServiceUri>",
    "<CONNECTION_NAME_PREFIX>__queueServiceUri": "<queueServiceUri>",
    "<CONNECTION_NAME_PREFIX>__tenantId": "<tenantId>",
    "<CONNECTION_NAME_PREFIX>__clientId": "<clientId>",
    "<CONNECTION_NAME_PREFIX>__clientSecret": "<clientSecret>"
  }
}

Kimlikle konak depolamaya bağlanma (Önizleme)

Azure İşlevleri, zamanlayıcı tetikleyicilerinin tekil olarak yürütülmesi ve varsayılan uygulama anahtarı depolaması gibi temel davranışlar için varsayılan olarak "AzureWebJobsStorage" bağlantısını kullanır. Bu, kimliklerden de yararlanan bir şekilde yalıtıldığında.

"AzureWebJobsStorage" için kimlik tabanlı bir bağlantı kullanmak üzere aşağıdaki uygulama ayarlarını yapılandırabilirsiniz:

Kimlik tabanlı bağlantıların ortak özellikleri de ayarlanmış olabilir.

Genel Azure için varsayılan DNS soneki ve hizmet adını kullanan bir depolama hesabı kullanıyorsanız, biçimi takip ediyorsanız, bunun yerine depolama hesabınıza https://<accountName>.blob/queue/file/table.core.windows.net AzureWebJobsStorage__accountName göre ayarlayın. Bu hesap için blob ve kuyruk uç noktaları gönderilir. Depolama hesabı bağımsız bir bulutta veya özel bir DNS'ye sahipse bu işlem çalışmaz.

Çalışma zamanında "AzureWebJobsStorage" için depolama hesabına erişim sağlayan bir rol ataması oluşturmanız gerekecektir. Sahip gibi yönetim rolleri yeterli değildir. [Depolama Blob veri sahibi] rolü, işlevlerin temel gereksinimlerini içerir konak depolama-çalışma zamanı, bloblara hem okuma hem de yazma erişimi ve kapsayıcı oluşturma yeteneği gerektirir. blob tetikleyicisi 'nin kullanımıyla ilgili olarak bazı durumlar vardır; burada [Depolama kuyruğu verilerinin katkıda] bulunanı de gereklidir. Başka amaçlar için "AzureWebJobsStorage" kullanırsanız ek izinlere ihtiyacınız olabilir.

Raporlama sorunları

Sonraki adımlar

Daha fazla bilgi için aşağıdaki kaynaklara bakın:

• Azure Işlevleri Tetikleyicileri ve bağlamaları
• Azure İşlevleri’ni yerel olarak kodlama ve test etme
• Azure Işlevleri için en iyi uygulamalar
• Azure Işlevleri C# Geliştirici Başvurusu
• Azure Işlevleri Node.js geliştirici başvurusu