Öğretici: Azure İşlevleri'i Azure İşlevleri

Makale
09/14/2021
Okumak için 10 dakika

Bu laboratuvarda, Azure İşlevleri kullanarak veri Mac için Visual Studio. Ayrıca azure depolama tablolarını da tümleştirebilirsiniz. Bu tablo, geliştiricilerin sahip olduğu bağlama ve tetikleyici türlerinden Azure İşlevleri sunar.

Hedefler

Yerel uygulama oluşturma ve hata Azure İşlevleri
Web ve Azure depolama kaynaklarıyla tümleştirin
Birden çok iş akışı içeren bir iş akışını Azure İşlevleri

Gereksinimler

Mac için Visual Studio 7.5 veya daha yüksek bir değer.
Bir Azure aboneliği (ücretsiz olarak https://azure.com/free kullanılabilir).

Alıştırma 1: Azure İşlevleri oluşturma

Mac için Visual Studio.
Yeni Çözüm >'ı seçin.
Cloud > Genel kategorisinden Azure İşlevleri seçin. C# kullanarak bir .NET sınıf kitaplığı oluşturacak ve bu kitaplığı Azure İşlevleri. İleri’ye tıklayın.
Ad Project "AzureFunctionsLab" olarak ayarlayın ve Oluştur'a tıklayın.
Çözüm Penceresi'nin düğümlerini genişletin. Varsayılan proje şablonu, NuGet çeşitli Azure Web İşleri ve Newtonsoft.Json paketine başvurular içerir.

Ayrıca üç dosya vardır: - konak için genel yapılandırma seçeneklerini açıklayan host.json - hizmet ayarlarını yapılandırmak için local.settings.json. - Proje şablonu ayrıca varsayılan bir HttpTrigger oluşturur. Bu laboratuvar için Projeden HttpTrigger.cs dosyasını silmeniz gerekir.

local.settings.json'ı açın. Varsayılan olarak iki boş bağlantı dizesi ayarına sahip olur.

Alıştırma 2: Azure depolama hesabı oluşturma

azure hesabınızla oturum https://portal.azure.com açın.
Ekranın sol kısmında yer alan Sık Kullanılanlar bölümünün altında Depolama hesaplar'ı seçin:
Yeni bir depolama hesabı oluşturmak için Ekle'yi seçin:
Ad için genel olarak benzersiz bir ad girin ve Bunu Kaynak grubu için yeniden kullanabilirsiniz. Diğer tüm öğeleri varsayılan olarak tutabilirsiniz.
Oluştur’a tıklayın. Depolama hesabını oluşturmak birkaç dakika sürebilir. Başarıyla oluşturulduktan sonra bir bildirim alırsınız.
Bildirimden Kaynağa git düğmesini seçin.
Erişim anahtarları sekmesini seçin.
İlk Bağlantı Dizesini kopyalayın. Bu dize, azure depolamayı daha sonra uygulamanıza Azure İşlevleri için kullanılır.
Bağlantı Mac için Visual Studio geri dönüp tam bağlantı dizesini local.settings.json içinde AzureWebJobsStorage ayarı olarak yapıştırın. Artık, kaynaklarına erişmesi gereken işlevler için özniteliklerde ayarın adına başvurabilirsiniz.

Örnek 3: Azure İşlevi oluşturma ve hata ayıklama

Artık kod eklemeye başlayabilirsiniz. Bir .NET sınıf kitaplığıyla çalışırken, Azure İşlevleri statik yöntemler olarak eklenir. Çözüm Penceresinde AzureFunctions proje düğümüne sağ tıklayın ve İşlev Ekle'yi >'yi seçin:
Yeni Uygulama Azure İşlevleri Genel web kancası şablonunu seçin. Ad'ı Ekle olarak ayarlayın ve tamam'a tıklar ve işlevinizi oluşturun:

Yeni dosyanın en üstüne aşağıdaki using yönergelerini ekleyin:

using Microsoft.Azure.WebJobs.Extensions.Http;
using System.Web;
using Microsoft.WindowsAzure.Storage.Table;

Mevcut yöntemi Run kaldırın ve aşağıdaki yöntemini sınıfına Azure İşlevi olarak ekleyin:

[FunctionName("Add")]
public static int Run(
[HttpTrigger(AuthorizationLevel.Function, "get", Route = null)]
HttpRequestMessage req,
TraceWriter log)
{
    int x = 1;
    int y = 2;

    return x + y;
}

Şimdi yöntem tanımının adım adım adım üzerinden bakalım.

göreceğiniz ilk şey, bu yöntemi Azure İşlevi olarak işaret alan FunctionName özniteliğidir. özniteliği, işlevin genel adını gösterir. Öznitelik adının gerçek yöntem adıyla eşleşmesi gerek değildir.
Ardından yöntemi, gerekli olan genel statik yöntem olarak işaretlenir. Ayrıca dönüş değerinin bir int olduğunu da fark vardır. Yöntem öznitelikleri kullanılarak aksi belirtilmedikçe, bir Azure İşlevinin herhangi bir geçersiz olmayan dönüş değeri istemciye metin olarak döndürülür. Varsayılan olarak XML olarak döndürülür, ancak daha sonra laboratuvarda yapacakları JSON olarak değiştirilebilir.
İlk parametre, bu yöntemin bir HTTP isteği tarafından çağrıldığında olduğunu gösteren HttpTrigger özniteliğiyle işaretlenir. özniteliği, yöntemin yetkilendirme düzeyini ve desteklediği fiilleri de belirtir (bu durumda yalnızca "GET"). ayrıca isteğe bağlı olarak yöntemin yolunu geçersiz kan ve yoldan değişkenleri otomatik olarak ayıklamak için bir yol sunan bir Yol tanımlayabilirsiniz. Route burada null olduğu için bu yöntemin yolu varsayılan olarak /api/Add olur.
yöntemine son parametre, tanılama ve hatalar için iletileri günlüğe göndermek için kullanılan bir TraceWriter'dır.
Yönteminin dönüş satırına, satırın kenar boşluğuna tıklayarak bir kesme noktası ayarlayın:
F5 tuşuna basarak veya Hata Ayıklamayı Başlat'ı seçerek projeyi bir hata ayıklama oturumunda > çalıştırın. Alternatif olarak Çalıştır düğmesine de tıklayabilirsiniz. Bu seçeneklerin hepsi aynı görevi gerçekleştirecek. Bu laboratuvarın geri kalanı F5'e başvurur, ancak en rahat bularak yöntemini kullanabilirsiniz.
Proje çalıştırılırsa Terminal uygulaması otomatik olarak açılır.
Proje, yöntem özniteliklerine ve bu Azure İşlevleri daha sonra ele alınan bir dosya kuralına dayalı olarak bir dosya algılama sürecinden geçmektedir. Bu durumda, tek bir Azure İşlevi algılar ve 1 iş işlevini "üretir".
Başlangıç iletilerinin alt kısmında, Azure İşlevleri http tetikleyici API'lerinin URL'lerini yazdırır. Yalnızca bir tane olması gerekir. Bu URL'yi kopyalayın ve yeni bir tarayıcı sekmesine yapıştırın.
Kesme noktası hemen tetiklenir. Web isteği işlevine yönlendirildi ve artık hata ayıklandı. Değerini görmek için fareyle x değişkeninin üzerine tıklayın.
Daha önce eklemek için kullanılan yöntemi kullanarak kesme noktası kaldırın (kenar boşluğuna tıklayın veya satırı seçin ve F9 tuşuna basın).
Çalışmaya devam etmek için F5 tuşuna basın.
Tarayıcıda yönteminin XML sonucu işlenir. Beklendiği gibi, sabit kodlu toplama işlemi makul bir toplam üretir. Safari'de yalnızca "3" seçeneğini görüyorsanız Safari > Tercihler > Gelişmiş'e gidin ve " Menü çubuğundaKi Geliştirme menüsünü göster" onay kutusunu işaretleyin ve sayfayı yeniden yükleyin.
Hata Mac için Visual Studio' içinde Durdur düğmesine tıklayarak hata ayıklama oturumunu sona erer. Yeni değişikliklerin top olduğundan emin olmak için hata ayıklama oturumunu yeniden başlatmayı (durdurmayı ve sonra çalıştırmayı) unutmayın.
Run yönteminde x ve y tanımlarını aşağıdaki kodla değiştirin. Bu kod, url'nin sorgu dizesinde yer alan değerleri ayıklar, böylece ekleme işlemi sağlanan parametrelere göre dinamik olarak gerçek olabilir.
```
var query = HttpUtility.ParseQueryString(req.RequestUri.Query);

int x = int.Parse(query["x"]);

int y = int.Parse(query["y"]);

return x + y;
```
Uygulamayı çalıştırın.
Tarayıcı penceresine geri dönüp dizeyi /?x=2&y=3 URL'ye ekleyin. Url'nin tamamı artık http://localhost:7071/api/Add?x=2&y=3 olmalıdır. Yeni URL'ye gidin.
Bu kez sonuç yeni parametreleri yansıtacak. Projeyi farklı değerlerle çalıştırmakta serbestsiniz. Herhangi bir hata denetimi olmadığını, dolayısıyla geçersiz veya eksik parametrelerin hataya neden olduğunu unutmayın.
Hata ayıklama oturumunu durdurun.

Alıştırma 4: function.json ile çalışma

Önceki bir alıştırmada, kitaplıkta tanımlanan Mac için Visual Studio Azure İşlevi için bir iş işlevinin "üreti" olduğu belirtildi. Bunun nedeni Azure İşlevleri çalışma zamanında yöntem özniteliklerini kullanmamış olması, bunun yerine derleme zamanı dosya sistemi kuralı kullanarak çalışma zamanının kullanılabilir olduğu yeri ve Azure İşlevleri yapılandırmadır. Çözüm Penceresinde proje düğümünü sağ tıklatın ve Bulıcı'da Ortaya Çıkar'ı seçin.
bin/Debug/netstandard2.0'a ulaşana kadar dosya sisteminde aşağı gidin. Ekle adlı bir klasör olması gerekir. Bu klasör, C# kodundaki işlev adı özniteliğine karşılık gelen şekilde oluşturulmuş. Tek bir function.json dosyasını ortaya çıkarmak için Klasör ekle'yi genişletin. Bu dosya, azure işlevini barındırmak ve yönetmek için çalışma zamanı tarafından kullanılır. Derleme zamanı desteği olmayan diğer dil modellerinde (C# betiği veya JavaScript gibi) bu klasörlerin el ile oluşturularak korunması gerekir. C# geliştiricileri için, derleme sırasında öznitelik meta verilerinden otomatik olarak oluşturulurlar. function.json'a sağ tıklayın ve bunu seçerek Visual Studio.
Bu öğreticinin önceki adımlarını göz atarak, C# öznitelikleri hakkında temel bir anlayışa sahipsiniz. Bunu dikkate alarak bu JSON'un tanıdık olması gerekir. Ancak, önceki alıştırmalarda ele atılmlı birkaç öğe vardır. Örneğin, her bağlamanın kendi yön kümesine sahip olması gerekir. Sizin de çıkararak "in" parametresinin giriş olduğu anlamına gelirken "out", parametrenin bir dönüş değeri ($return aracılığıyla) veya yönteme yönelik bir out parametresi olduğunu gösterir. Ayrıca derleme içinde scriptFile (bu son konuma göre) ve entryPoint yöntemini (genel ve statik) belirtmeniz gerekir. Sonraki birkaç adımda bu modeli kullanarak özel bir işlev yolu ekliysiniz, bu nedenle bu dosyanın içeriğini panoya kopyalayın.
Çözüm Penceresinde AzureFunctionsLab proje düğümüne sağ tıklayın ve Yeni Klasöre Ekle'> seçin. Yeni klasöre Adder adını girin. Varsayılan kural olarak, bu klasörün adı API'nin yolunu (api/Adder gibi) tanımlar.
Adder klasörüne sağ tıklayın ve Add add > New File (Yeni Dosya) öğesini seçin.
Web kategorisini ve Boş JSON Dosyası şablonunu seçin. Ad'ı işlev olarak ayarlayın ve Yeni'ye tıklayın.
Yeni oluşturulan dosyanın varsayılan içeriğini değiştirmek için diğer function.json içeriğini (3. adımdan) dosyasına yapıştırın.

Aşağıdaki satırları json dosyasının üst kısmından kaldırın:

"configurationSource":"attributes",
"generatedBy":"Microsoft.NET.Sdk.Functions-1.0.13",

İlk bağlamanın sonuna ("name": "req" satırına) aşağıdaki özellikleri ekleyin. Önceki satıra virgül dahil etme. Bu özellik, artık int parametrelerini yoldan ayıklar ve bunları x ve y adlı yöntem parametrelerine yer değiştirecek şekilde varsayılan kökünü geçersiz kılar.
```
"direction": "in",
"route": "Adder/{x:int?}/{y:int?}"
```
İlkin altına başka bir bağlama ekleyin. Bu bağlama işlevin dönüş değerini işler. Önceki satıra virgül dahil etme:
```
{
"name": "$return",
"type": "http",
"direction": "out"
}
```
Ayrıca dosyanın en altındaki entryPoint özelliğini de aşağıda gösterildiği gibi "Add2" adlı bir yöntem kullanmak üzere güncelleştirin. Bu, api/Adder... yolunun herhangi bir adla (buraya Ekle2) uygun bir yönteme eşleyene bir yol olduğunu göstermektir.
```
"entryPoint": "<project-name>.<function-class-name>.Add2"
```

Son function.json dosyanız aşağıdaki json'a benzin:

{
"bindings": [
    {
    "type": "httpTrigger",
    "methods": [
        "get"
    ],
    "authLevel": "function",
    "direction": "in",
    "name": "req",
    "route": "Adder/{x:int?}/{y:int?}"
    },
    {
    "name": "$return",
    "type": "http",
    "direction": "out"
    }
],
"disabled": false,
"scriptFile": "../bin/AzureFunctionsProject.dll",
"entryPoint": "AzureFunctionsProject.Add.Add2"
}

Tüm bu çalışmaları yapmak için gereken son adım, bu Mac için Visual Studio her değişiklikte bu dosyayı çıkış dizininde aynı göreli yola kopyalamasını talimatını etmektir. Dosya seçiliyken sağ çubuktan özellikler sekmesini seçin ve Çıkış dizinine kopyala için Daha yeniyse kopyala'ya tıklayın:
Add.cs içinde beklenen işlevi yerine getirmek için yöntemini Run (özniteliği dahil) aşağıdaki yöntemle değiştirin. çok benzerdir, ancak hiçbir öznitelik kullanmaz ve Run x ve y için açık parametreleri vardır.
```
public static int Add2(
    HttpRequestMessage req,
    int x,
    int y,
    TraceWriter log)
{
    return x + y;
}
```
Projeyi derlemek ve çalıştırmak için F5 tuşuna basın.
Derleme tamamlandıktan ve platform hazırlandıktan sonra yeni eklenen yönteme eşlenen istekler için ikinci bir yol olduğunu gösterir:
Tarayıcı penceresini iade edin ve 'a http://localhost:7071/api/Adder/3/5 gidin.
Bu kez yöntem bir kez daha çalışır, yoldan parametreleri çekerek bir toplam sağlar.
Hata Mac için Visual Studio ve hata ayıklama oturumunu sona erer.

Alıştırma 5: Azure depolama tabloları ile çalışma

Genellikle, derlemek için şu ana kadar gerçekleştirilen hizmetten çok daha karmaşık olabilir ve yürütülecek önemli miktarda zaman ve/veya altyapıya ihtiyaç vardır. Bu durumda, kaynaklar kullanılabilir olduğunda iş için kuyruğa alınan istekleri kabul etme ve bu istekler için destek Azure İşlevleri bulabilirsiniz. Diğer durumlarda, verileri merkezi olarak depolamak istemeyebilirsiniz. Azure Depolama tabloları bunu hızlı bir şekilde yapmalarını sağlar.

Aşağıdaki sınıfı Add.cs'ye ekleyin. Ad alanının içine, ancak var olan sınıfın dışına gitmeli.

public class TableRow : TableEntity
{
    public int X { get; set; }
    public int Y { get; set; }
    public int Sum { get; set; }
}

Add sınıfına başka bir işlev eklemek için aşağıdaki kodu ekleyin. Bunun şu ana kadar http yanıtı içermeyen benzersiz olduğunu unutmayın. Son satır, daha sonra (PartitionKey ve RowKey) daha sonra almayı kolaylaştıracak bazı önemli bilgilerle doldurulmuş yeni bir TableRow ile birlikte parametrelerini ve toplamını döndürür. yöntemi içindeki kod, işlev çalıştırılırken daha kolay bilgi için TraceWriter kullanır.

[FunctionName("Process")]
[return: Table("Results")]
public static TableRow Process(
    [HttpTrigger(AuthorizationLevel.Function, "get",
        Route = "Process/{x:int}/{y:int}")]
    HttpRequestMessage req,
    int x,
    int y,
    TraceWriter log)
{
    log.Info($"Processing {x} + {y}");

    return new TableRow()
    {
        PartitionKey = "sums",
        RowKey = $"{x}_{y}",
        X = x,
        Y = y,
        Sum = x + y
    };
}

Projeyi derlemek ve çalıştırmak için F5 tuşuna basın.
Tarayıcı sekmesinde, 'a http://localhost:7071/api/Process/4/6 gidin. Bu, kuyruğa başka bir ileti ekleniyor ve sonunda tabloya başka bir satır ekleniyor.
Terminal'e geri dönüp 4 + 6 için gelen isteği izleyin.
İsteği aynı URL'ye yenilemek için tarayıcıya geri dönebilirsiniz. Bu kez Process yönteminden sonra bir hatayla karşılaştısınız. Bunun nedeni, kodun zaten var olan bir bölüm ve satır Depolama kullanarak Azure Tablo tablosuna satır eklemeye denemesidir.
```
System.Private.CoreLib: Exception while executing function: Process. Microsoft.Azure.WebJobs.Host: Error while handling parameter $return after function returned:. Microsoft.Azure.WebJobs.Host: The specified entity already exists.
```
Hata ayıklama oturumunu sona erer.
Hatayı azaltmak için aşağıdaki parametreyi TraceWriter parametresinin hemen öncesinde yöntem tanımına ekleyin. Bu parametre, Azure İşlevleri platforma sonuçları depolamak için kullanmakta olduğu PartitionKey'te bulunan Results tablosundan TableRow alma girişiminde bulunarak bunu denemesi talimatı verir. Ancak RowKey'in aynı yöntem için diğer x ve y parametrelerine göre dinamik olarak oluşturulduğuna dikkat edin. Bu satır zaten varsa, yöntem geliştiricinin fazladan çalışması gerektirerek başladığında tableRow satıra sahip olur. Satır yoksa yalnızca null olur. Bu verimlilik, geliştiricilerin altyapıya değil önemli iş mantığına odaklanmalarını sağlar.
```
[Table("Results", "sums", "{x}_{y}")]
TableRow tableRow,
```
Aşağıdaki kodu yönteminin başına ekleyin. tableRow null değilse, istenen işlem için zaten sonuçlarımız vardır ve bunu hemen döndürenin. Aksi takdirde işlev daha önce olduğu gibi devam eder. Verileri iade etmek için en güçlü yol bu değildir ancak çok az kodla birden çok ölçeklenebilir katmanda son derece karmaşık işlemleri düzenlemenizi sağlar.
```
if (tableRow != null)
{
    log.Info($"{x} + {y} already exists");
    return null;
}
```
Projeyi derlemek ve çalıştırmak için F5 tuşuna basın.
Tarayıcı sekmesindeki URL'yi http://localhost:7071/api/Process/4/6 yenileyin. Bu kaydın tablo satırı mevcut olduğu için hemen ve hatasız olarak geri dönilmelidir. HTTP çıktısı olmadığından çıktıyı terminalde görebilirsiniz.
URL 'YI, henüz test edilmemiş bir birleşimi yansıtacak şekilde güncelleştirin http://localhost:7071/api/Process/5/7 . Terminal 'teki, tablo satırının bulunamadığını (beklenen şekilde) belirten iletiyi not edin.
Mac için Visual Studio dönün ve hata ayıklama oturumunu sonlandırın.

Özet

bu laboratuvarda, Mac için Visual Studio ile Azure işlevleri oluşturmaya nasıl başladığınızı öğrendiniz.