Hızlı Başlangıç: Visual Studio kullanarak Azure'da ilk C# işlevinizi oluşturma

Azure İşlevleri, C# kodunuzu Azure'da sunucusuz bir ortamda çalıştırmanıza olanak sağlar.

Bu makalede şunları öğreneceksiniz:

Bu makale, her iki tür derlenmiş C# işlevi oluşturmayı destekler:

Bu hızlı başlangıç tamamladıktan sonra Azure hesabınıza birkaç ABD doları veya daha düşük bir maliyetle sahip oluruz.

Bu makalenin Visual Studio Code bir sürümü de vardır.

Önkoşullar

• Visual Studio .NET 6.0'i destekleyen 2022. Yükleme sırasında Azure geliştirme iş yükünü seçin.

• Azure aboneliği. Henüz bir hesabınız yoksa başlamadan önce ücretsiz bir hesap oluşturun.

İşlev uygulaması projesi oluşturma

Azure İşlevleri proje şablonu Visual Studio Azure'daki bir işlev uygulamasında yayımlayabilirsiniz bir C# sınıf kitaplığı projesi oluşturur. Kaynakların daha kolay yönetimi, dağıtımı, ölçeklendirmesi ve paylaşımı için işlevleri mantıksal birim olarak gruplamanız için işlev uygulamasını kullanabilirsiniz.

1. Dosya menüsünden Visual Studio Yeni > Dosya'Project. >

2. Yeni proje oluştur'da, arama kutusuna işlevler girin, Azure İşlevleri şablonunu seçin ve ardından Sonraki'yi seçin.

3. Yeni projenizi yapılandırma alanına projeniz için bir Project adı girin ve Oluştur'a basın. İşlev uygulamasının adı, bir C# ad alanı olarak geçerli olmalıdır; bu nedenle alt çizgi, kısa çizgi veya alfasayısal olmayan herhangi bir karakter kullanmayın.

4. Yeni bir uygulama Azure İşlevleri için aşağıdaki tabloda yer alan değerleri kullanın:

   Ayar	Değer	Açıklama
   .NET sürümü	.NET 6	Bu değer, çalışma zamanının 4.x sürümüyle işlem içinde Azure İşlevleri oluşturur. Ayrı bir çalışan işlemiyle çalışan bir proje oluşturmak için .NET 6 (yalıtılmış) de seçebilirsiniz. Azure İşlevleri 1.x, .NET Framework’ü destekler. Daha fazla bilgi için bkz. Azure İşlevleri çalışma zamanı sürümlerine genel bakış.
   İşlev şablonu	HTTP tetikleyicisi	Bu değer, bir HTTP isteği tarafından tetiklenen bir işlev oluşturur.
   Depolama hesabı (AzureWebJobsStorage)	Depolama öykünücüsü	Azure'daki bir işlev uygulaması bir depolama hesabı gerektirdiği için, projenizi Azure'da yayımlasanız bir tane atanır veya oluşturulur. HTTP tetikleyicisi bir Azure Depolama hesabı bağlantı dizesi kullanmaz; diğer tüm tetikleyici türleri geçerli bir Azure Depolama hesabı bağlantı dizesi gerektirir. Bu seçeneği tercih ederseniz Azurite öykünücüsü kullanılır.
   Yetkilendirme düzeyi	Anonim	Oluşturulan işlev, anahtar gerektirmeden herhangi bir istemci tarafından tetiklenebilir. Bu yetkilendirme ayarı yeni işlevinizi test etmenizi kolaylaştırır. Anahtarlar ve yetkilendirme hakkında daha fazla bilgi için bkz. Yetkilendirme anahtarları ve HTTP ve web kancası bağlamaları.

   

   Yetkilendirme düzeyini Anonim olarak ayarlayın. İşlev'in varsayılan düzeyini seçerseniz işlev anahtarını işlev uç noktanıza erişme isteklerinde sunsanız gerekir.

5. İşlev projesini ve HTTP tetikleyici işlevini oluşturmak için Oluştur'a seçin.

Visual Studio HTTP tetikleyicisi işlev türü için ortak kod içeren bir proje ve sınıf oluşturur. Ortak kod, istek gövdesi veya sorgu dizesinde yer alan bir değeri içeren bir HTTP yanıtı gönderir. HttpTriggerözniteliği, işlevin bir HTTP isteği tarafından tetiklendiğinden belirtir.

İşlevi yeniden adlandırma

yöntem FunctionName özniteliği, varsayılan olarak olarak oluşturulan işlevin adını Function1 ayarlar. Araç, projenizi oluşturma adımlarında varsayılan işlev adını geçersiz kılmanıza izin vermeyebilirsiniz. İşlev sınıfı, dosya ve meta veriler için daha iyi bir ad oluşturmak için bir dakikanızı alır.

1. bu Dosya Gezgini Function1.cs dosyasına sağ tıklayın ve olarak yeniden HttpExample.cs adlandırın.

2. Kodda Function1 sınıfını olarak yeniden HttpExample adlandırabilirsiniz.

3. adlı HttpTrigger yönteminde Run yöntem özniteliğini FunctionName olarak yeniden HttpExample adlandırarak.

İşlev tanımınız artık aşağıdaki kod gibi görünüyor olabilir:

[FunctionName("HttpExample")]
public static async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req,
    ILogger log)

İşlevi yeniden adlandırarak yerel bilgisayarınızda test edin.

İşlevi yerel olarak çalıştırma

Visual Studio, Azure Functions Core Tools çalışma zamanının tamamını kullanarak işlevlerinizi yerel olarak test etmek için Azure İşlevleri sağlar.

1. İşlevinizi çalıştırmak için, Visual Studio 'da F5 tuşuna basın. Araçların HTTP isteklerini işleyebilmesi için bir güvenlik duvarı özel durumu etkinleştirmeniz gerekebilir. Yerel olarak bir işlev çalıştırdığınızda yetkilendirme düzeyleri hiçbir zaman zorlanmaz.

2. Azure İşlevleri çalışma zamanı çıktısından işlevinizin URL'sini kopyalayın.

   

3. HTTP isteğinin URL’sini tarayıcınızın adres çubuğuna yapıştırın. Sorgu dizesini ?name=<YOUR_NAME> Bu URL 'ye ekleyin ve isteği çalıştırı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:

   

4. Hata ayıklamayı durdurmak için, + Visual Studio 'da SHIFTF5 tuşuna basın.

İşlevin yerel bilgisayarınızda düzgün çalıştığını doğruladıktan sonra, projeyi Azure'da yayımlamanın zamanı gelmiştir.

Projeyi Azure'da yayımlama

Projenizi yayımlamadan önce Azure aboneliğinde bir işlev uygulamasına sahip olmak gerekir. Visual Studio yayımlama, projenizi ilk kez yayımlayan sizin için bir işlev uygulaması oluşturur.

1. Çözüm Gezgini, projeye sağ tıklayın ve Yayımla ' yı seçin ve hedefte Azure ' ı seçin ve ardından İleri' yi seçin.

2. Belirli bir hedef Için, Windows üzerinde çalışan bir işlev uygulaması oluşturan Azure işlev uygulaması (Windows) öğesini seçin.

3. Işlev örneği' nde Yeni bir Azure işlevi oluştur ' u seçin...

   

4. Aşağıdaki tabloda belirtilen değerleri kullanarak yeni bir örnek oluşturun:

   Ayar	Değer	Açıklama
   Ad	Genel olarak benzersiz bir ad	Yeni işlev uygulamanızı benzersiz şekilde tanımlayan ad. Bu adı kabul edin veya yeni bir ad girin. Geçerli karakterler şunlardır: a-z , 0-9 , ve - .
   Abonelik	Aboneliğiniz	Kullanılacak Azure aboneliği. Bu aboneliği kabul edin veya açılan listeden yeni bir tane seçin.
   Kaynak grubu	Kaynak grubunuzun adı	İşlev uygulamanızın oluşturulacağı kaynak grubu. Açılan listeden var olan bir kaynak grubunu seçin veya yeni bir kaynak grubu oluşturmak için Yeni ' yi seçin.
   Plan türü	Tüketim	Projenizi bir Tüketim planındaçalışan bir işlev uygulamasında yayımladığınızda yalnızca işlevler uygulamanızın yürütmeleri için ödeme yaparsınız. Diğer barındırma planları daha yüksek maliyetler doğurur.
   Konum	App Service 'in konumu	Size yakın bir bölgede veya işlevlerinizin erişebileceği diğer hizmetlerden bir konum seçin.
   Azure Depolama	Genel amaçlı depolama hesabı	Işlevler çalışma zamanı için bir Azure depolama hesabı gereklidir. Genel amaçlı bir depolama hesabı yapılandırmak için Yeni ' yi seçin. Depolama hesabı gereksinimlerinikarşılayan mevcut bir hesabı da seçebilirsiniz.

   

5. Azure 'da bir işlev uygulaması ve ilgili kaynakları oluşturmak için Oluştur ' u seçin. Kaynak oluşturma durumu pencerenin sol alt kısmında gösterilir.

6. İşlevler örneğine geri döndüğünüzde, paket dosyasından Çalıştır ' ın işaretli olduğundan emin olun. İşlev uygulamanız, paket Çalıştır modu etkin olan ZIP dağıtımı kullanılarak dağıtılır. Bu, daha iyi performans ile sonuçlandığından, işlevler projeniz için önerilen dağıtım yöntemidir.

   

7. Son' u seçin ve Yayımla sayfasında, proje dosyalarınızı Içeren paketi Azure 'daki yeni işlev uygulamanıza dağıtmak için Yayımla ' yı seçin.

   Dağıtım tamamlandıktan sonra, Azure 'da işlev uygulamasının kök URL 'SI Yayımla sekmesinde gösterilir.

8. Yayımla sekmesinde, Cloud Explorer 'Da Yönet' i seçin. Bu, Cloud Explorer 'da yeni işlev uygulaması Azure kaynağı ' nı açar.

   

   Cloud Explorer, Visual Studio 'Yu kullanarak sitenin içeriğini görüntüleyebilir, işlev uygulamasını başlatıp durdurabilir ve doğrudan Azure 'daki ve Azure portal uygulama kaynaklarına gidebilir.

Azure'da işlevinizi doğrulama

1. Cloud Explorer'da yeni işlev uygulamanız seçilmelidir. Yoksa, App Services'> aboneliğinizi genişletin ve yeni işlev uygulamanızı seçin.

2. İşlev uygulamasına sağ tıklayın ve Tarayıcıda Aç'ı seçin. Bu, işlev uygulamanın kökünü varsayılan web tarayıcınızda açar ve işlev uygulamanın çalıştırıcı olduğunu gösteren sayfayı görüntüler.

   

3. Tarayıcının adres çubuğunda dizeyi temel /api/HttpExample?name=Functions URL'ye ekleyin ve isteği çalıştırın.

   HTTP tetikleyici işlevinizi çağıran URL şu biçimdedir:

   http://<APP_NAME>.azurewebsites.net/api/HttpExample?name=Functions

4. Bu URL'ye gidin ve tarayıcıda işlev tarafından döndürülen uzak GET isteğine aşağıdaki örnekteki gibi bir yanıt görüyorsunuz:

   

Kaynakları temizleme

Bu koleksiyondaki diğer hızlı başlangıçlar, bu hızlı başlangıcı temel alır. Sonraki hızlı başlangıçlar, öğreticiler veya bu hızlı başlangıçta oluşturduğunuz hizmetlerden herhangi biri ile çalışmayı planlıyorsanız, kaynakları temizlemeyin.

Azure’da Kaynaklar; işlev uygulamalarını, işlevleri, depolama hesaplarını ve benzeri öğeleri ifade eder. Bunlar kaynak gruplarına ayrılır ve grubu silerek bir gruptaki her şeyi silebilirsiniz.

Bu hızlı başlangıçları tamamlamak için kaynaklar oluşturdunuz. Hesap durumunuza ve hizmet fiyatlandırmanıza bağlı olarak size bu kaynakların ücretleri yansıtılabilir.

Daha fazla ücrete neden olan maliyetleri önlemek için işlev uygulamasını ve ilgili kaynaklarını silmek için aşağıdaki adımları kullanın.

1. Bulut Gezgini'nde, App Services > genişletin, işlev uygulamanıza sağ tıklayın ve Portalda Aç'ı seçin.

2. İşlev uygulaması sayfasında Genel Bakış sekmesini ve ardından Kaynak grubu altındaki bağlantıyı seçin.

   

3. Kaynak grubu sayfasında, dahil edilen kaynakların listesini gözden geçirin ve bunların silmek istediğiniz kaynaklar olduğunu doğrulayın.

4. Kaynak grubunu sil’i seçin ve yönergeleri izleyin.

   Silme işlemi birkaç dakika sürebilir. İşlem tamamlandığında, birkaç saniye boyunca bir bildirim görüntülenir. Bildirimi görüntülemek için sayfanın üst kısmındaki zil simgesini de seçebilirsiniz.

Sonraki adımlar

Bu hızlı başlangıçta, basit bir HTTP Visual Studio ile Azure'da bir C# işlev uygulaması oluşturmak ve yayımlamak için Visual Studio işlevini kullandınız.

İşleve Azure depolama kuyruğu bağlaması ekleme hakkında bilgi Depolama sonraki makaleye ilerleyin: