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

  • Makale

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ırmak üzere 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 6 ü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ı tamamlamak, Azure hesabınızda birkaç ABD doları veya daha az bir maliyete neden olur.

Önkoşullar

İşlev uygulaması projesi oluşturma

Visual Studio'daki Azure İşlevleri projesi şablonu, Azure'daki bir işlev uygulamasında yayımlayabileceğiniz bir C# sınıf kitaplığı projesi oluşturur. Kaynakların daha kolay yönetilmesi, dağıtılması, ölçeklenmesi ve paylaşılması için işlevleri 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 Değer Açıklama
    İşlev çalışanı .NET 6.0 Yalıtılmış (Uzun Vadeli Destek) İşlevleriniz yalıtılmış bir çalışan işleminde .NET 6 üzerinde çalışır.
    İşlev HTTP tetikleyicisi Bu değer, BIR HTTP isteği tarafından tetiklenen bir işlev oluşturur.
    Çalışma zamanı depolama hesabı için Azurite kullanma (AzureWebJobsStorage) 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 Azure Depolama hesabı bağlantı dizesi kullanmaz; diğer tüm tetikleyici türleri için geçerli bir Azure Depolama hesabı bağlantı dizesi gerekir. 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ı.

    Azure İşlevleri proje ayarlarının ekran görüntüsü.

    Yetkilendirme düzeyiniAnonim olarak ayarladığınızdan emin olun. varsayılan İşlev düzeyini seçerseniz, Azure'da işlev uç noktanıza erişmek için isteklerde 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 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ğini belirtir.

İşlevi yeniden adlandırma

FunctionName yöntem ö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ı, dosyası ve meta verileri için daha iyi bir ad oluşturmak bir dakikanızı alır.

  1. Dosya Gezgini'da Function1.cs dosyasına sağ tıklayın ve dosyasını olarak HttpExample.csyeniden adlandırın.

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

  3. adlı yönteminde HttpTrigger method özniteliğini olarak HttpExampleyeniden adlandırınFunctionName.Run

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

[Function("HttpExample")]
public static HttpResponseData Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequestData req,
    FunctionContext executionContext)

İş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 Core Tools ile tümleşir.

  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 yerel çalışma zamanı

  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, işlev tarafından döndürülen yerel GET isteğine tarayıcıda verilen yanıt gösterilmektedir:

    Tarayıcıdaki işlev localhost yanıtı

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

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.

    Yayımla penceresinin ekran görüntüsü.

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

    Belirli bir hedefe sahip yayımlama penceresinin ekran görüntüsü.

  3. İşlev ÖrneğindeYeni Azure İşlevi oluştur... öğesini seçin.

    Yeni işlev uygulaması örneği oluşturma ekran görüntüsü.

  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-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. 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 Tüketim planında çalışan bir işlev uygulamasında yayımladığınızda, yalnızca işlev uygulamanızın yürütmeleri için ödeme alırsınız. Diğer barındırma planları daha yüksek maliyetlere neden olur.
    Konum App Service'in konumu Size veya işlevlerinizin eriştirileceği diğer hizmetlere yakın bir bölgedekonum 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.

    App Service Oluştur iletişim kutusunun ekran görüntüsü.

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

    Son profil oluşturma işleminin ekran görüntüsü.

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

    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'de aç'ı seçin. Bu işlem, Azure portal yeni işlev uygulaması Azure kaynağını açar.

    Başarılı yayımla iletisinin ekran görüntüsü.

Azure'da işlevinizi doğrulama

  1. Bulut Gezgini'nde yeni işlev uygulamanız seçilmelidir. Aksi takdirde, abonelik >Uygulama Hizmetlerinizi 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şlem, işlev uygulamanızın kökünü varsayılan web tarayıcınızda açar ve işlev uygulamanızın çalıştığını gösteren sayfayı görüntüler.

    çalışan işlev uygulaması

  3. Tarayıcıdaki adres çubuğunda dizeyi /api/HttpExample?name=Functions temel URL'ye ekleyin 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 aşağıdaki örneğe benzer bir yanıt görürsünüz:

    Tarayıcıda işlev yanıtı

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 oluşmasını önlemek 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 aç'ı seçin.

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

    İşlev uygulaması sayfasından silinecek kaynak grubunu seçin

  3. Kaynak grubu sayfasında, eklenen 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ış ç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:

İşlevinize Azure Depolama kuyruğu bağlaması ekleme