Azure İşlevleri’ne Giriş
Azure Işlevleri, altyapıyı açıkça sağlamak veya yönetmek zorunda kalmadan, kod – – işlevleri – –, bulutta olay odaklı kod parçacıkları oluşturup çalıştırmanın bir yoludur. Azure İşlevleri hakkında daha fazla bilgi için bkz. Azure İşlevleri belgeleri.
Gereksinimler
Azure işlev araçları, Mac için Visual Studio 7,5 ve daha yeni bir sürüme dahildir.
İşlev oluşturup dağıtmak için bir Azure aboneliğine de ihtiyacınız vardır. Azure hesabınız yoksa bugün ücretsiz olarak kaydolabilir ve 12 aylık ücretsiz hizmetler, $200 ücretsiz kredi ve 25 + her zaman ücretsiz hizmetler > alabilirsiniz https://azure.com/free .
İlk Azure Işlevleri projenizi oluşturma
Mac için Visual Studio dosya > yeni çözüm' ı seçin.
yeni Project iletişim kutusunda Cloud > genel ' in altındaki Azure işlevleri şablonunu seçin ve ileri' ye tıklayın:
Kullanmak istediğiniz ilk Azure Işlevleri şablonunu seçin, işlevinizin adını girin ve İleri' ye tıklayın.
İpucu
Paketlenmiş Azure Işlevleri çalışma zamanı ve şablonları (CLı) mümkün olduğunca güncel tutulurken, kaçınılmaz olarak güncelliğini yitirmiş. yeni bir işlevler projesi oluştururken, Mac için Visual Studio clı güncelleştirmelerini denetler ve aşağıdaki görüntüde gösterildiği gibi size bildirir. Güncelleştirilmiş şablonları indirmek için düğmeye tıklamanız yeterlidir.
Seçtiğiniz işlevin türüne bağlı olarak, sonraki sayfada aşağıdaki görüntüde gösterildiği gibi erişim hakları gibi ayrıntılar girmeniz istenir:
Farklı türlerde Azure Işlevleri şablonları ve her bir şablonu yapılandırmak için gereken bağlama özellikleri hakkında daha fazla bilgi için, kullanılabilir işlev şablonları bölümüne bakın. Bu örnekte, erişim hakları anonim olarak ayarlanmış bir http tetikleyicisi kullanıyoruz.
Parametreleri ayarladıktan sonra, projenin konumunu seçin ve Oluştur' a tıklayın.
Mac için Visual Studio, varsayılan bir işlevle dahil .NET Standard bir proje oluşturur. ayrıca, çeşitli AzureWebJobs paketlerine ek olarak, newtonsoft. Json paketini de NuGet başvuruları içerir.
Yeni proje aşağıdaki dosyaları içerir:
- işleviniz-Name. cs – Bu sınıf seçtiğiniz işlevin ortak kodunu içerir. İşlev adına sahip bir fonksiyonadı özniteliği ve işlevi neyin tetikleyeceğini belirten bir tetikleyici özniteliği içerir (örn. bir HTTP isteği). İşlev yöntemi hakkında daha fazla bilgi için bkz. Azure Işlevleri C# Geliştirici başvurusu makalesi.
- Host. JSON – bu dosya, işlevler ana bilgisayarı için genel yapılandırma seçeneklerini açıklar. Örnek bir dosya ve bu dosya için kullanılabilir ayarlar hakkında bilgi için bkz. Azure işlevleri için Host. JSON başvurusu.
- Local. Settings. JSON – bu dosya, işlevleri yerel olarak çalıştırmaya yönelik tüm ayarları içerir. Bu ayarlar Azure Functions Core Tools tarafından kullanılır. Daha fazla bilgi için Azure Functions Core Tools makalesindeki yerel ayarlar dosyası ' na bakın.
artık Mac için Visual Studio yeni bir Azure işlevleri projesi oluşturduğunuza göre, yerel makinenizden varsayılan HTTP ile tetiklenen işlevi test edebilirsiniz.
İşlevi yerel olarak test etme
Mac için Visual Studio Azure işlevleri desteğiyle, işlevinizi yerel geliştirme bilgisayarınızda test edebilir ve hatalarını ayıklayabilirsiniz.
işlevinizi yerel olarak test etmek için Mac için Visual Studio içindeki çalıştır düğmesine basın:
Projeyi çalıştırmak, Azure Işlevinde yerel hata ayıklamayı başlatır ve aşağıdaki görüntüde gösterildiği gibi yeni bir Terminal penceresi açar:
Çıktıdan URL 'YI kopyalayın.
HTTP isteğinin URL’sini tarayıcınızın adres çubuğuna yapıştırın. Sorgu dizesini
?name=<yourname>URL 'nin sonuna ekleyin ve isteği yürütün. Aşağıdaki görüntüde, bu işlevin döndürdüğü yerel GET isteğine tarayıcıda yapılan yanıt gösterilmektedir:
Projenize başka bir işlev ekleme
İşlev Şablonları, en sık kullanılan tetikleyicileri ve şablonları kullanarak yeni işlevleri hızlıca oluşturmanızı sağlar. Başka bir işlev türü oluşturmak için aşağıdakileri yapın:
Yeni bir işlev eklemek için proje adına sağ tıklayın ve > Ekle Işlev Ekle... öğesini seçin:
Yeni Azure işlevi iletişim kutusunda, ihtiyacınız olan işlevi seçin:
Kullanılabilir işlev şablonları bölümünde Azure işlev şablonlarının bir listesi verilmiştir.
İşlev uygulaması projenize daha fazla işlev eklemek için yukarıdaki yordamı kullanabilirsiniz. Projedeki her bir işlev farklı bir tetikleyicisine sahip olabilir, ancak bir işlevin tam olarak bir tetikleyicisi olmalıdır. Daha fazla bilgi için bkz. Azure işlevleri Tetikleyicileri ve bağlamaları kavramları.
Azure’da Yayımlama
Proje adına sağ tıklayın ve yayımla > Azure 'Da Yayımla' yı seçin:
Azure hesabınızı Mac için Visual Studio için zaten bağladıysanız, kullanılabilir uygulama hizmetlerinin bir listesi görüntülenir. Oturum açmadıysanız bunu yapmanız istenir.
Azure App Service Yayımla iletişim kutusunda, var olan bir uygulama hizmetini seçebilir veya Yeni' ye tıklayarak yeni bir tane oluşturabilirsiniz.
Yeni App Service oluştur iletişim kutusunda,
Ayar Açıklama App Service Adı Yeni işlev uygulamanızı tanımlayan genel olarak benzersiz bir ad. Abonelik Kullanılacak Azure aboneliği. Kaynak grubu İşlev uygulamanızın oluşturulacağı kaynak grubunun adı. + Yeni bir kaynak grubu oluşturmayı seçin. Hizmet planı Mevcut bir planı seçin veya özel bir plan oluşturun. Size yakın bir bölgede veya işlevlerinizin erişebileceği diğer hizmetlere yakın bir konum seçin. Bir depolama hesabı oluşturmak için İleri ' ye tıklayın. İşlevler çalışma zamanı için bir Azure depolama hesabı gereklidir. Genel amaçlı bir depolama hesabı oluşturmak için özel ' e tıklayın veya var olan birini kullanın:
Oluştur'a tıklayarak Azure'da bu ayarlarla bir işlev uygulaması ve ilgili kaynaklar oluşturun ve işlev proje kodunuzu dağıtın.
Yayımlama sırasında bir iletişim kutusu istenebilir, "Azure 'da Işlevleri güncelleştirme" konusunda sizi bilgilendiren bir iletişim kutusu görüntülenebilir. Evet' e tıklayın:
İşlev uygulaması ayarları
Yerel. Settings. JSON içine eklediğiniz tüm ayarlar ayrıca Azure 'daki işlev uygulamasına eklenmelidir. Projeyi yayımladığınızda bu ayarlar otomatik olarak karşıya yüklenemez.
Uygulama ayarlarınıza erişmek için Azure portal gidin https://ms.portal.azure.com/ . Işlevler uygulamalar' ın altında işlev uygulamaları ' nı seçin ve işlevinizin adını vurgulayın:
Genel bakış sekmesinden yapılandırılmış özellikler altında uygulama ayarları ' nı seçin:
buradan, yeni uygulama ayarları ekleyebileceğiniz veya var olanları değiştirebileceğiniz işlev uygulaması için uygulama Ayarlar ayarlayabilirsiniz:
Ayarlamanız gerekebilmeniz gereken önemli bir ayardır FUNCTIONS_EXTENSION_VERSION . Mac için Visual Studio yayımlarken, bu değer beta olarak ayarlanmalıdır.
Kullanılabilir işlev şablonları
GitHub Tetikleyicisi: Depolama depolarınız içinde GitHub yanıt verin. Daha fazla bilgi için Azure İşlevleri makalesine GitHub
- GitHub- Bu işlev, bir sorun veya çekme isteği için GitHub bir web kancası aldığında ve bir açıklama ekleyene kadar çalıştır.
- GitHub Web Kancası – Bu işlev bir web kancası aldığında GitHub olur.
HTTP: Http isteği kullanarak kodunuzun yürütülmesini tetikler. Aşağıdaki HTTP tetikleyicileri için açık şablonlar vardır:
- Http Tetikleyicisi
- Http GET CRUD
- Http POST CRUD
- Parametrelerle Http Tetikleyicisi
Zamanlayıcı : Temizlemeyi veya diğer toplu görevleri önceden tanımlanmış bir zaman çizelgesiyle yürütün. Bu şablon iki alan alır: Altı alanlı CRON ifadesi olan Ad ve zamanlama. Daha fazla bilgi için Time Azure İşlevleri makalesine bakın
Kuyruk Tetikleyicisi: Bu işlev, Azure depolama kuyruğuna gelen iletilere yanıt Depolama olur. İşlev adına ek olarak, bu şablon bir Yol (iletinin okunacak olduğu kuyruğun adı) ve depolama hesabı Bağlantısı (depolama hesabı bağlantı dizenizi içeren uygulama ayarının adı) alır. Daha fazla bilgi için Kuyruk Azure İşlevleri makalesine Depolama.
Blob Tetikleyicisi : Azure Depolama blobları kapsayıcıya eklendiğinde işler. Bu şablon, işlev adına ek olarak bir yol ve bağlantı özelliği de alır. path özelliği, tetikleyicinin izlemesi için depolama hesabı içindeki yoldur. Bağlantı hesabı, depolama hesabı bağlantı dizenizi içeren uygulama ayarının adıdır. Daha fazla bilgi için blob Azure İşlevleri makalesine Depolama bakın.
Genel Web Kancası – Bu, web kancalarını destekleyen herhangi bir hizmetten her istek aldığında çalıştıracak basit bir işlevdir. Daha fazla bilgi için genel web kancaları Azure İşlevleri makalesine bakın.
Dayanıklı işlevler düzenlemesi: Dayanıklı İşlevler sunucusuz bir ortamda durum bilgisine sahip işlevler yazmanız için kullanılır. Uzantı sizin için durumu, denetim noktalarını ve yeniden başlatmaları yönetir. Daha fazla bilgi için Dayanıklı Azure İşlevleri kılavuzlara bakın.
Resim Boyutlandırıcı: Bu işlev, kapsayıcıya her blob ekleniyorsa yeniden boyutlandırılır görüntüler oluşturur. Şablon tetikleyicinin yolunu ve bağlantı dizesini, küçük bir görüntü çıktısını ve orta ölçekli görüntü çıkışını alır.
SAS belirteci – Bu işlev, kapsayıcı ve blob adı gibi azure Depolama sas belirteci üretir. Bu şablon, işlev adına ek olarak bir yol ve bağlantı özelliği de alır. path özelliği, tetikleyicinin izlemesi için depolama hesabı içindeki yoldur. Bağlantı hesabı, depolama hesabı bağlantı dizenizi içeren uygulama ayarının adıdır. Erişim haklarının da ayarlanmış olması gerekir. Yetkilendirme düzeyi, işlevin bir API anahtarı ve hangi anahtarın kullanılamayacaklarını kontrol eder; İşlev bir işlev anahtarı kullanır; Yönetici, hesap erişim anahtarınızı kullanır. Daha fazla bilgi için bkz. SAS belirteçleri oluşturmak için C# Azure İşlevi örneği.