Hızlı Başlangıç: Azure'da komut satırından C# işlevi oluşturma

Makale
10/16/2024

Bu makalede komut satırı araçlarını kullanarak HTTP isteklerine yanıt veren bir C# işlevi oluşturacaksınız. Kodu yerel olarak test ettikten sonra bunu Azure İşlevleri’nin sunucusuz ortamına dağıtacaksınız.

Bu makale, yalıtılmış bir çalışan işleminde .NET 8 üzerinde çalışan HTTP ile tetiklenen bir işlev oluşturur. C# işlevleri için desteklenen .NET sürümleri hakkında bilgi için bkz . Desteklenen sürümler. Bu makalenin Visual Studio Code tabanlı bir sürümü de vardır.

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.

Yerel ortamınızı yapılandırma

Başlamadan önce aşağıdakilere sahip olmanız gerekir:

.NET 8.0 SDK.
Azure kaynakları oluşturmak için aşağıdaki araçlardan biri:
- Azure CLI sürüm 2.4 veya üzeri.
- Azure Az PowerShell modülü sürüm 5.9.0 veya üzeri.

Etkin aboneliği olan bir Azure hesabına da ihtiyacınız vardır. Ücretsiz hesap oluşturun.

Azure Functions Core Tools’u Yükleme

Çekirdek Araçları'nı yüklemenin önerilen yolu, yerel geliştirme bilgisayarınızın işletim sistemine bağlıdır.

Aşağıdaki adımlarda Core Tools v4.x'i yüklemek için bir Windows yükleyicisi (MSI) kullanılır. Diğer paket tabanlı yükleyiciler hakkında daha fazla bilgi için bkz . Çekirdek Araçları benioku.

Windows sürümünüz temelinde Core Tools yükleyicisini indirin ve çalıştırın:

v4.x - Windows 64 bit (Önerilir. Visual Studio Code hata ayıklaması 64 bit gerektirir.)
v4.x - Windows 32 bit

Daha önce Windows'a Core Tools yüklemek için Windows installer (MSI) kullandıysanız, en son sürümü yüklemeden önce Program Ekle Kaldır'dan eski sürümü kaldırmanız gerekir.

Aşağıdaki adımlarda, macOS'ta Core Tools'u yüklemek için Homebrew kullanılır.

Henüz yüklü değilse Homebrew'ı yükleyin.

Core Tools paketini yükleyin:

brew tap azure/functions
brew install azure-functions-core-tools@4
# if upgrading on a machine that has 2.x or 3.x installed:
brew link --overwrite azure-functions-core-tools@4

Aşağıdaki adımlarda, Ubuntu/Debian Linux dağıtımınıza Core Tools yüklemek için APT kullanılır. Diğer Linux dağıtımları için bkz . Temel Araçlar benioku.

Paket bütünlüğünü doğrulamak için Microsoft paket deposu GPG anahtarını yükleyin:

curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg

APT güncelleştirmesini yapmadan önce APT kaynak listesini ayarlayın.

Ubuntu

sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-$(lsb_release -cs 2>/dev/null)-prod $(lsb_release -cs 2>/dev/null) main" > /etc/apt/sources.list.d/dotnetdev.list'

Debian

sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/debian/$(lsb_release -rs 2>/dev/null | cut -d'.' -f 1)/prod $(lsb_release -cs 2>/dev/null) main" > /etc/apt/sources.list.d/dotnetdev.list'

Aşağıdaki tabloda dosyada /etc/apt/sources.list.d/dotnetdev.list uygun Linux sürüm dizelerinden biri olup olmadığını denetleyin:

Linux dağıtımı	Sürüm
Debian 12	`bookworm`
Debian 11	`bullseye`
Debian 10	`buster`
Debian 9	`stretch`
Ubuntu 22.04	`jammy`
Ubuntu 20.04	`focal`
Ubuntu 19.04	`disco`
Ubuntu 18.10	`cosmic`
Ubuntu 18.04	`bionic`
Ubuntu 17.04	`zesty`
Ubuntu 16.04/Linux Mint 18	`xenial`

APT kaynak güncelleştirmesini başlatın:
```
sudo apt-get update
```

Core Tools paketini yükleyin:

sudo apt-get install azure-functions-core-tools-4

Yerel işlev projesi oluşturma

Azure İşlevleri işlev projesi, her birinin belirli bir tetikleyiciye yanıt verdiği bir veya daha fazla tek tek işlev için bir kapsayıcıdır. Projedeki tüm işlevler aynı yerel ve barındırma yapılandırmalarını paylaşır. Bu bölümde, tek bir işlev içeren bir işlev projesi oluşturacaksınız.

Belirtilen çalışma zamanına func init sahip LocalFunctionProj adlı bir klasörde işlev projesi oluşturmak için komutunu aşağıdaki gibi çalıştırın:
```
func init LocalFunctionProj --worker-runtime dotnet-isolated --target-framework net8.0
```
Proje klasörüne gidin:
```
cd LocalFunctionProj
```
Bu klasör, local.settings.json ve host.json adlı yapılandırma dosyaları da dahil olmak üzere proje için çeşitli dosyalar içerir. local.settings.json Azure'dan indirilen gizli dizileri içerebileceğinden, dosya .gitignore dosyasında varsayılan olarak kaynak denetimin dışında tutulur.
Aşağıdaki komutu kullanarak projenize bir işlev ekleyin; burada --name bağımsız değişken işlevinizin benzersiz adıdır (HttpExample) ve --template bağımsız değişken işlevin tetikleyicisini (HTTP) belirtir.
```
func new --name HttpExample --template "HTTP trigger" --authlevel "anonymous"
```
func new bir HttpExample.cs kod dosyası oluşturur.

(İsteğe bağlı) Dosya içeriğini inceleme

İsterseniz, İşlevi yerel olarak çalıştır'a atlayabilir ve dosya içeriğini daha sonra inceleyebilirsiniz.

HttpExample.cs

HttpExample.cs, değişkendeki req istek verilerini HttpRequest nesnesi olarak alan bir yöntem içerirRun. Bu parametre, tetikleyici davranışını tanımlamak için HttpTriggerAttribute ile dekore edilmiştir.

using System.Net;
using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.Logging;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

namespace Company.Function
{
    public class HttpExample
    {
        private readonly ILogger<HttpExample> _logger;

        public HttpExample(ILogger<HttpExample> logger)
        {
            _logger = logger;
        }

        [Function("HttpExample")]
        public IActionResult Run([HttpTrigger(AuthorizationLevel.AuthLevelValue, "get", "post")] HttpRequest req)
        {            
            _logger.LogInformation("C# HTTP trigger function processed a request.");

            return new OkObjectResult("Welcome to Azure Functions!");
        }
    }
}

Dönüş nesnesi, HTTP yanıtına geri verilen verileri içeren bir IActionResult nesnesidir.

Daha fazla bilgi edinmek için bkz. HTTP tetikleyicileri ve bağlamaları Azure İşlevleri.

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

LocalFunctionProj klasöründen yerel Azure İşlevleri çalışma zamanı ana bilgisayarını başlatarak işlevinizi çalıştırın:
```
func start
```
Çıktının sonuna doğru aşağıdaki satırlar görünmelidir:
```
 ...

 Now listening on: http://0.0.0.0:7071
 Application started. Press Ctrl+C to shut down.

 Http Functions:

         HttpExample: [GET,POST] http://localhost:7071/api/HttpExample
 ...

 
```
Not

HttpExample yukarıda gösterildiği gibi görünmüyorsa, konağı büyük olasılıkla projenin kök klasörünün dışından başlatmış olursunuz. Bu durumda, konağı durdurmak için Ctrl+C tuşunu kullanın, projenin kök klasörüne gidin ve önceki komutu yeniden çalıştırın.
Bu çıkıştan işlevinizin HttpExample URL'sini bir tarayıcıya kopyalayın ve işlev URL'sine göz atın; Azure İşlevleri hoş geldiniz iletisi almalısınız.
İşiniz bittiğinde Ctrl+C tuşunu kullanın ve işlevler konasını durdurmayı seçin.y

İşleviniz için destekleyici Azure kaynakları oluşturma

İşlev kodunuzu Azure'a dağıtabilmeniz için önce üç kaynak oluşturmanız gerekir:

İlgili kaynaklar için mantıksal bir kapsayıcı olan kaynak grubu.
İşlevleriniz hakkındaki durumu ve diğer bilgileri korumak için kullanılan bir Depolama hesabı.
İşlev kodunuzu yürütmek için ortam sağlayan bir işlev uygulaması. İşlev uygulaması yerel işlev projenize eşler ve kaynakların daha kolay yönetilmesi, dağıtılması ve paylaşılması için işlevleri mantıksal birim olarak gruplandırmanıza olanak tanır.

Bu öğeleri oluşturmak için aşağıdaki komutları kullanın. Hem Azure CLI hem de PowerShell desteklenir.

Henüz yapmadıysanız Azure'da oturum açın:
- Azure CLI
- Azure PowerShell
```
az login
```
az login komutu sizi Azure hesabınızda oturum açar.
```
Connect-AzAccount
```
Connect-AzAccount cmdlet'i sizi Azure hesabınızda oturum açar.
Seçtiğiniz bölgede adlı AzureFunctionsQuickstart-rg bir kaynak grubu oluşturun:
- Azure CLI
- Azure PowerShell
```
az group create --name AzureFunctionsQuickstart-rg --location <REGION>
```
az group create komutu bir kaynak grubu oluşturur. Yukarıdaki komutta, az account list-locations komutundan döndürülen kullanılabilir bir bölge kodunu kullanarak değerini yakınınızdaki bir bölgeyle değiştirin<REGION>.
```
New-AzResourceGroup -Name AzureFunctionsQuickstart-rg -Location <REGION>
```
New-AzResourceGroup komutu bir kaynak grubu oluşturur. Kaynak grubunuzu ve kaynaklarınızı genellikle Get-AzLocation cmdlet'inden döndürülen kullanılabilir bir bölgeyi kullanarak yakınınızdaki bir bölgede oluşturursunuz.
Kaynak grubunuz ve bölgenizde genel amaçlı bir depolama hesabı oluşturun:
- Azure CLI
- Azure PowerShell
```
az storage account create --name <STORAGE_NAME> --location <REGION> --resource-group AzureFunctionsQuickstart-rg --sku Standard_LRS --allow-blob-public-access false
```
az storage account create komutu depolama hesabını oluşturur.
```
New-AzStorageAccount -ResourceGroupName AzureFunctionsQuickstart-rg -Name <STORAGE_NAME> -SkuName Standard_LRS -Location <REGION> -AllowBlobPublicAccess $false
```
New-AzStorageAccount cmdlet'i depolama hesabını oluşturur.
Önceki örnekte değerini size uygun ve Azure Depolama'da benzersiz bir adla değiştirin <STORAGE_NAME> . Adlar yalnızca üç ile 24 karakter arasında sayı ve küçük harf içermelidir. Standard_LRSİşlevler tarafından desteklenen genel amaçlı bir hesap belirtir.

Önemli

Depolama hesabı, bazen uygulama kodunun kendisi de dahil olmak üzere önemli uygulama verilerini depolamak için kullanılır. Diğer uygulama ve kullanıcılardan depolama hesabına erişimi sınırlamanız gerekir.

Azure'da işlev uygulamasını oluşturun:
- Azure CLI
- Azure PowerShell
```
az functionapp create --resource-group AzureFunctionsQuickstart-rg --consumption-plan-location <REGION> --runtime dotnet-isolated --functions-version 4 --name <APP_NAME> --storage-account <STORAGE_NAME>
```
az functionapp create komutu, Azure'da işlev uygulamasını oluşturur.
```
New-AzFunctionApp -Name <APP_NAME> -ResourceGroupName AzureFunctionsQuickstart-rg -StorageAccount <STORAGE_NAME> -Runtime dotnet-isolated -FunctionsVersion 4 -Location '<REGION>'
```
New-AzFunctionApp cmdlet'i, işlev uygulamasını Azure'da oluşturur.
Önceki örnekte değerini önceki <STORAGE_NAME> adımda kullandığınız hesabın adıyla değiştirin ve değerini size uygun genel olarak benzersiz bir adla değiştirin <APP_NAME> . <APP_NAME> aynı zamanda işlev uygulamasının varsayılan DNS etki alanıdır.

Bu komut, Azure İşlevleri Tüketim Planı'nın altında belirtilen dil çalışma zamanınızda çalışan bir işlev uygulaması oluşturur ve bu uygulama burada tahakkuk ettiğiniz kullanım miktarı için ücretsizdir. Komut aynı kaynak grubunda, işlev uygulamanızı izleyip günlükleri görüntüleyebileceğiniz ilişkili bir Azure Uygulaması lication Insights örneği de oluşturur. Daha fazla bilgi için bkz. İzleme Azure İşlevleri. Örnek, siz etkinleştirene kadar ücret ödemez.

İşlev projesini Azure'a dağıtma

İşlev uygulamanızı Azure'da başarıyla oluşturduktan sonra, komutunu kullanarak yerel işlevler projenizi dağıtmaya func azure functionapp publish hazır olursunuz.

Kök proje klasörünüzde şu func azure functionapp publish komutu çalıştırın:

func azure functionapp publish <APP_NAME>

Bu örnekte değerini uygulamanızın adıyla değiştirin <APP_NAME> . Başarılı bir dağıtım, aşağıdaki çıkışa benzer sonuçlar gösterir (basitlik için kesilmiş):

...

Getting site publishing info...
Creating archive for current directory...
Performing remote build for functions project.

...

Deployment successful.
Remote build succeeded!
Syncing triggers...
Functions in msdocs-azurefunctions-qs:
    HttpExample - [httpTrigger]
        Invoke url: https://msdocs-azurefunctions-qs.azurewebsites.net/api/httpexample

İşlevi Azure'da çağırma

İşleviniz bir HTTP tetikleyicisi kullandığından ve GET isteklerini desteklediğinden, URL'sine bir HTTP isteği yaparak bu tetikleyiciyi çağırırsınız. Bunu tarayıcıda yapmak en kolayıdır.

Yayımla komutunun çıkışında gösterilen tam Çağırma URL'sini tarayıcı adres çubuğuna kopyalayın. Bu URL'ye gittiğinizde, tarayıcı işlevi yerel olarak çalıştırdığınızda olduğu gibi benzer bir çıkış görüntülemelidir.

Gerçek zamanlıya yakın akış günlüklerini görüntülemek için aşağıdaki komutu çalıştırın:

func azure functionapp logstream <APP_NAME>

Ayrı bir terminal penceresinde veya tarayıcıda uzak işlevi yeniden çağırın. Terminalde Azure'da işlev yürütme işleminin ayrıntılı bir günlüğü gösterilir.

Kaynakları temizleme

Bir sonraki adıma devam edip bir Azure Depolama kuyruğu çıkış bağlaması eklerseniz, daha önce yaptıklarınızı derleyeceğiniz gibi tüm kaynaklarınızı yerinde tutun.

Aksi takdirde, daha fazla maliyet oluşmasını önlemek için kaynak grubunu ve içerdiği tüm kaynakları silmek için aşağıdaki komutu kullanın.

Azure CLI
Azure PowerShell

az group delete --name AzureFunctionsQuickstart-rg

Remove-AzResourceGroup -Name AzureFunctionsQuickstart-rg

Sonraki adımlar

Azure Cosmos DB'ye bağlanma

Azure Kuyruk Depolama'ya bağlanma

Aracılığıyla paylaş