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

Azure İşlevleri yerel C# işlev projeleri oluşturmak için Visual Studio'yu kullanmanıza ve ardından bu projeyi Azure'da ölçeklenebilir sunucusuz bir ortamda çalıştırılacak şekilde kolayca yayımlamanıza olanak tanır. C# uygulamalarınızı Visual Studio Code kullanarak yerel olarak geliştirmeyi tercih ediyorsanız, bunun yerine bu makalenin Visual Studio Code tabanlı sürümünü göz önünde bulundurmanız gerekir.

Varsayılan olarak, bu makalede yalıtılmış bir çalışan işleminde .NET 8 üzerinde çalışan C# işlevlerinin nasıl oluşturulacağı gösterilmektedir. Yalıtılmış bir çalışan işleminde çalışan işlev uygulamaları, İşlevler tarafından desteklenen tüm .NET sürümlerinde desteklenir. Daha fazla bilgi için bkz . Desteklenen sürümler.

Bu makalede şunları öğreneceksiniz:

  • C# sınıf kitaplığı projesi oluşturmak için Visual Studio'yu kullanın.
  • HTTP isteklerine yanıt veren bir işlev oluşturun.
  • İşlev davranışını doğrulamak için kodunuzu yerel olarak çalıştırın.
  • Kod projenizi Azure İşlevleri dağıtın.

Bu hızlı başlangıcı tamamladığınızda Azure hesabınıza birkaç sentlik (ABD doları cinsinden) veya daha düşük bir ücret yansıtılır.

Bu videoda Azure'da C# işlevinin nasıl oluşturulacağı gösterilmektedir.

Videodaki adımlar aşağıdaki bölümlerde de açıklanmıştır.

Önkoşullar

İşlev uygulaması projesi oluşturma

Visual Studio'daki Azure İşlevleri proje şablonu, Azure'daki bir işlev uygulamasına yayımlayabileceğiniz bir C# sınıf kitaplığı projesi oluşturur. İşlevleri daha kolay yönetim, dağıtım, ölçeklendirme ve kaynakların paylaşımı için mantıksal birim olarak gruplandırmak için işlev uygulamasını kullanabilirsiniz.

  1. Visual Studio menüsünden Dosya>Yeni Proje'yi> seçin.

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

  3. Yeni projenizi yapılandırın bölümünde projeniz için bir Proje adı girin ve İleri'yi seçin. İş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. Kalan Ek bilgi ayarları için

    Ayar Value Açıklama
    İşlevler çalışanı .NET 8.0 Yalıtılmış (Uzun Vadeli Destek) İşlevleriniz yalıtılmış bir çalışan işleminde .NET 8 üzerinde çalışır.
    İşlev HTTP tetikleyicisi Bu değer, HTTP isteği tarafından tetiklenen bir işlev oluşturur.
    Çalışma zamanı depolama hesabı için Azurite kullanma (AzureWebJobs Depolama) Etkinleştir Azure'daki bir işlev uygulaması için depolama hesabı gerektiğinden, projenizi Azure'da yayımladığınızda bir uygulama atanır veya oluşturulur. HTTP tetikleyicisi bağlantı dizesi Azure Depolama hesabı kullanmaz; diğer tüm tetikleyici türleri geçerli bir Azure Depolama hesabı bağlantı dizesi gerektirir. Bu seçeneği belirlediğinizde 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ı.

    Screenshot of Azure Functions project settings.

    Yetkilendirme düzeyini Anonim olarak ayarladığınızdan emin olun. varsayılan İşlev düzeyini seçerseniz, Azure'da işlev uç noktanıza erişme isteklerinde işlev anahtarını sunmanız gerekir.

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

Visual Studio, HTTP tetikleyici 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ğini belirtir.

İşlevi yeniden adlandırma

Function method özniteliği, varsayılan olarak olarak Function1oluşturulan işlevin adını ayarlar. Araç, projenizi oluştururken varsayılan işlev adını geçersiz kılmanıza izin vermediğinden işlev sınıfı, dosya ve meta veriler için daha iyi bir ad oluşturmak için bir dakikanızı alır.

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

  2. Kodda function1 sınıfını olarak HttpExampleyeniden adlandırın.

  3. adlı Runyönteminde method özniteliğini olarak HttpExampleyeniden adlandırınFunction.

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

[Function("HttpExample")]
public IActionResult Run([HttpTrigger(AuthorizationLevel.AuthLevelValue, "get", "post")] HttpRequest req)
{
    return new OkObjectResult("Welcome to Azure Functions!");
}

İşlevi yeniden adlandırdığınıza göre, yerel bilgisayarınızda test edebilirsiniz.

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

Visual Studio, tam Azure İşlevleri çalışma zamanını kullanarak işlevlerinizi yerel olarak test edebilmeniz için Azure İşlevleri Temel Araçlar ile tümleştirilir.

  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 durumunu etkinleştirmeniz gerekebilir. Bir işlevi yerel olarak ç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.

    Azure local runtime

  3. HTTP isteğinin URL'sini tarayıcınızın adres çubuğuna yapıştırın ve isteği çalıştırın. Aşağıdaki görüntüde, işlev tarafından döndürülen yerel GET isteğine tarayıcıda verilen yanıt gösterilmektedir:

    Function localhost response in the browser

  4. Hata ayıklamayı durdurmak için Visual Studio'da Shift F5 tuşlarına+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

Visual Studio yerel projenizi Azure'da yayımlayabilir. Projenizi yayımlayabilmeniz için önce Azure aboneliğinizde bir işlev uygulaması olması gerekir. Azure'da henüz bir işlev uygulamanız yoksa Visual Studio yayımlama, projenizi ilk kez yayımladığınızda sizin için bir işlev uygulaması oluşturur. Bu makalede bir işlev uygulaması ve ilgili Azure kaynakları oluşturacaksınız.

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

    Screenshot of publish window.

  2. Windows üzerinde çalışan bir işlev uygulaması oluşturan Belirli hedef için Azure İşlev Uygulaması 'nı (Windows) ve ardından İleri'yi seçin.

    Screenshot of publish window with specific target.

  3. İşlev Örneği'nde Yeni Azure İşlevi oluştur... öğesini seçin.

    Screenshot of create a new function app instance.

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

    Ayar Value 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-9ve -.
    Abonelik Aboneliğiniz Kullanılacak Azure aboneliği. Bu aboneliği kabul edin veya açılan listeden yeni bir abonelik seçin.
    Kaynak grubu Kaynak grubunuzun adı İşlev uygulamanızı oluşturmak istediğiniz kaynak grubu. Yeni bir kaynak grubu oluşturmak için Yeni'yi seçin. Açılan listeden mevcut bir kaynak grubunu da seçebilirsiniz.
    Plan Türü Tüketim Projenizi Tüketim planında çalışan bir işlev uygulamasına yayımladığınızda, yalnızca işlev uygulamanızın yürütülmesi için ödeme alırsınız. Diğer barındırma planları daha yüksek maliyetlere neden olur.
    Konum Uygulama hizmetinin konumu Size yakın bir bölgede veya işlevlerinizin eriştirileceği diğer hizmetlerde bir Konum seçin.
    Azure Depolama Genel amaçlı depolama hesabı İş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ı gereksinimlerini karşılayan mevcut bir hesabı da seçebilirsiniz.
    Application Insights Uygulama Analizler örneği İşlev uygulamanız için Uygulama Analizler tümleştirmesini etkinleştirmeniz gerekir. Yeni bir örnekte veya mevcut log analytics çalışma alanında yeni bir örnek oluşturmak için Yeni'yi seçin. Ayrıca var olan bir örneği de seçebilirsiniz.

    Screenshot of Create App Service dialog.

  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ğinde Paketten çalıştır dosyasının işaretli olduğundan emin olun. İşlev uygulamanız, Paketten Çalıştır modu etkinken Zip Dağıtımı kullanılarak dağıtılır. Zip Deploy, daha iyi performansa neden olan işlev projeniz için önerilen dağıtım yöntemidir.

    Screenshot of Finish profile creation.

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

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

  8. Yayımla sekmesinin Barındırma bölümünde Azure portalında aç'ı seçin. Bu işlem, Azure portalında yeni işlev uygulaması Azure kaynağını açar.

    Screenshot of Publish success message.

Azure'da işlevinizi doğrulama

  1. Azure portalında, yeni işlevler uygulamanızın Genel Bakış sayfasında olmanız gerekir.

  2. İşlevler'in altında HttpExample adlı yeni işlevinizi seçin, ardından işlev sayfasında İşlev URL'sini al'ı ve ardından Panoya kopyala simgesini seçin.

  3. Tarayıcınızdaki adres çubuğuna, az önce kopyaladığınız URL'yi yapıştırın ve isteği çalıştırın.

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

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

  4. Bu URL'ye gittiğinizde tarayıcıda işlev tarafından döndürülen uzak GET isteğine bir yanıt görürsünüz ve bu aşağıdaki örneğe benzer:

    Function response in the browser

Kaynakları temizleme

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

Bu hızlı başlangıcı tamamlamak için Azure kaynakları oluşturdunuz. Hesap durumunuza ve hizmet fiyatlandırmanıza bağlı olarak size bu kaynakların ücretleri yansıtılabilir. 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 biriyle çalışmayı planlıyorsanız kaynakları temizlemeyin.

Daha fazla maliyet doğurmamak için işlev uygulamasını ve ilgili kaynaklarını silmek için aşağıdaki adımları kullanın.

  1. Visual Studio Yayımla iletişim kutusunda, Barındırma bölümünde Azure portalında aç'ı seçin.

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

    Select the resource group to delete from the function app page

  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 Visual Studio'yu kullanarak basit bir HTTP tetikleyici işleviyle Azure'da bir C# işlev uygulaması oluşturup yayımladınız.

Yalıtılmış bir çalışan işleminde çalışan C# işlevleriyle çalışma hakkında daha fazla bilgi edinmek için bkz. Yalıtılmış bir çalışan işleminde C# Azure İşlevleri çalıştırma kılavuzu. Yalıtılmış bir çalışan işleminde desteklenen .NET sürümlerinin diğer sürümlerini görmek için .NET desteklenen sürümlerine göz atın.

İşlevinize Azure Depolama kuyruğu bağlaması eklemeyi öğrenmek için sonraki makaleye ilerleyin: