Temel Araçları kullanarak yerel olarak Azure İşlevleri geliştirme

Azure İşlevleri Temel Araçlar, işlevlerinizi yerel bilgisayarınızda geliştirmenize ve test etmenizi sağlar. Hazır olduğunuzda, kod projenizi Azure'a dağıtmak ve uygulama ayarlarıyla çalışmak için Temel Araçlar'ı da kullanabilirsiniz.

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.

Sürümle ilgili sorunlarla ilgili yardım için bkz . Temel Araçlar sürümleri.

Yerel projenizi oluşturma

Terminal penceresinde veya komut isteminden aşağıdaki komutu çalıştırarak klasörde bir proje MyProjFolder oluşturun:

func init MyProjFolder --worker-runtime dotnet-isolated 

func init MyProjFolder --worker-runtime dotnet 

func init MyProjFolder --worker-runtime javascript --model V4

func init MyProjFolder --worker-runtime javascript --model V3

func init MyProjFolder --worker-runtime typescript --model V4

func init MyProjFolder --worker-runtime typescript --model V3

func init MyProjFolder --worker-runtime powershell

func init MyProjFolder --worker-runtime python --model V2

func init MyProjFolder --worker-runtime python

seçeneği olmadan çalıştırdığınızda func init --worker-runtime proje dilinizi seçmeniz istenir. Komutun kullanılabilir seçenekleri hakkında daha fazla bilgi edinmek için func init başvuruya func init bakın.

İşlev oluşturma

Projenize işlev eklemek için tetikleyici şablonunuzu seçme seçeneğini kullanarak --template komutunu çalıştırınfunc new. Aşağıdaki örnek adlı MyHttpTriggerbir HTTP tetikleyicisi oluşturur:

func new --template "Http Trigger" --name MyHttpTrigger

Bu örnek adlı MyQueueTriggerbir Kuyruk Depolama tetikleyicisi oluşturur:

func new --template "Azure Queue Storage Trigger" --name MyQueueTrigger

İşlevler eklenirken aşağıdaki noktalar geçerlidir:

• seçeneği olmadan çalıştırdığınızda func new --template , bir şablon seçmeniz istenir.

• func templates list Dilinize yönelik kullanılabilir şablonların tam listesini görmek için komutunu kullanın.

• Bir hizmete bağlanan bir tetikleyici eklediğinizde, local.settings.json dosyasına bir bağlantı dizesi veya yönetilen kimliğe başvuran bir uygulama ayarı da eklemeniz gerekir. Uygulama ayarlarını bu şekilde kullanmak, kodunuzda kimlik bilgilerini eklemenizi önler. Daha fazla bilgi için bkz . Yerel olarak uygulama ayarlarıyla çalışma.

Komutun kullanılabilir seçenekleri hakkında daha fazla bilgi edinmek için func new başvuruya func new bakın.

İşlevinize bağlama ekleme

İşlevler hizmete özgü giriş ve çıkış bağlamaları kümesi sağlar ve bu da işlevinizin hizmete özgü istemci SDK'larını kullanmak zorunda kalmadan diğer Azure hizmetlerine bağlanmasını kolaylaştırır. Daha fazla bilgi için bkz. Azure İşlevleri tetikleyicileri ve bağlama kavramları.

Var olan bir işleve giriş veya çıkış bağlaması eklemek için işlev tanımını el ile güncelleştirmeniz gerekir.

Aşağıdaki örnekte, HTTP ile tetiklenen bir işleve Kuyruk Depolama çıkış bağlaması eklendikten sonra işlev tanımı gösterilmektedir:

[Function("HttpExample")]
public static MultiResponse Run([HttpTrigger(AuthorizationLevel.Function, "get", "post")] HttpRequest req,
    FunctionContext executionContext)
{

public class MultiResponse
{
    [QueueOutput("outqueue",Connection = "AzureWebJobsStorage")]
    public string[] Messages { get; set; }
    public IActionResult HttpResponse { get; set; }
}

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

@FunctionName("HttpExample")
public HttpResponseMessage run(
        @HttpTrigger(name = "req", methods = {HttpMethod.GET, HttpMethod.POST}, authLevel = AuthorizationLevel.ANONYMOUS) 
        HttpRequestMessage<Optional<String>> request, 
        @QueueOutput(name = "msg", queueName = "outqueue", 
        connection = "AzureWebJobsStorage") OutputBinding<String> msg, 
        final ExecutionContext context) {

{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": ["get", "post"]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

$outputMsg = $name
Push-OutputBinding -name msg -Value $outputMsg

@app.route(route="HttpExample")
@app.queue_output(arg_name="msg", queue_name="outqueue", connection="AzureWebJobsStorage")
def HttpExample(req: func.HttpRequest, msg: func.Out [func.QueueMessage]) -> func.HttpResponse:
    logging.info('Python HTTP trigger function processed a request.')

{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": ["get", "post"]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "req",
      "methods": ["get", "post"]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "res"
    },
    {
      "type": "queue",
      "direction": "out",
      "name": "msg",
      "queueName": "outqueue",
      "connection": "AzureWebJobsStorage"
    }
  ]
}

Bir işleve bağlama eklerken aşağıdaki noktalar geçerlidir:

• Bir hizmete bağlanan bağlamalar eklediğinizde, local.settings.json dosyasına bağlantı dizesi veya yönetilen kimliğe başvuran bir uygulama ayarı da eklemeniz gerekir. Daha fazla bilgi için bkz . Yerel olarak uygulama ayarlarıyla çalışma.

İşlevler çalışma zamanını başlatma

Projenizdeki işlevleri çalıştırabilmeniz veya hatalarını ayıklayabilmeniz için önce İşlevler ana bilgisayarını projenizin kök dizininden başlatmanız gerekir. Konak, projedeki tüm işlevler için tetikleyicileri etkinleştirir. Yerel çalışma zamanını başlatmak için şu komutu kullanın:

mvn clean package 
mvn azure-functions:run

func start

func start

func start

npm install
npm start     

İşlevler konağı başlatıldığında, aşağıdaki örnekte olduğu gibi HTTP ile tetiklenen işlevlerin URL'leri de dahil olmak üzere projedeki işlevlerin listesini oluşturur:

Found the following functions:
Host.Functions.MyHttpTrigger

Job host started
Http Function MyHttpTrigger: http://localhost:7071/api/MyHttpTrigger

İşlevlerinizi yerel olarak çalıştırırken aşağıdaki noktaları göz önünde bulundurun:

• Varsayılan olarak, YETKILENDIRME HTTP uç noktaları için yerel olarak zorlanmaz. Bu, tüm yerel HTTP isteklerinin olarak authLevel = "anonymous"işlendiğini gösterir. Daha fazla bilgi için bkz . Yetkilendirme düzeyi. Yerel olarak çalışırken yetkilendirme istemek için seçeneğini kullanabilirsiniz --enableAuth . Daha fazla bilgi için bkz. func start.

• Azure'da bu hizmetlere bağlanmak zorunda kalmadan Azure Depolama hizmetlerine (Kuyruk Depolama, Blob Depolama ve Tablo Depolama) erişim gerektiren işlevleri yerel olarak çalıştırırken yerel Azurite öykünücüsü kullanabilirsiniz. Yerel öykünme kullanırken yerel konağı (func.exe) başlatmadan önce Azurite'yi başlattığınızdan emin olun. Daha fazla bilgi için bkz . Yerel depolama öykünmesi.

• Canlı bir hizmete bağlanmadan HTTP dışı işlevleri yerel olarak tetikleyebilirsiniz. Daha fazla bilgi için bkz . Yerel işlev çalıştırma.

• Application Insights bağlantı bilgilerinizi local.settings.json dosyasına eklediğinizde, yerel günlük verileri belirli Application Insights örneğine yazılır. Yerel telemetri verilerini üretim verilerinden ayrı tutmak için geliştirme ve test için ayrı bir Application Insights örneği kullanmayı göz önünde bulundurun.

Yerel işlev çalıştırma

Yerel İşlevler ana bilgisayarınız (func.exe) çalışırken işlev kodunuzu çalıştırmak ve hatalarını ayıklamak için tek tek işlevleri tetikleyebilirsiniz. Tek bir işlevi yürütme yönteminiz tetikleyici türüne bağlıdır.

http://localhost:<PORT>/api/<FUNCTION_NAME>

curl --get http://localhost:7071/api/MyHttpTrigger?name=Azure%20Rocks

curl --request POST http://localhost:7071/api/MyHttpTrigger --data '{"name":"Azure Rocks"}'

curl --request POST http://localhost:7071/api/MyHttpTrigger --data "{'name':'Azure Rocks'}"

http://localhost:<PORT>/admin/functions/<FUNCTION_NAME>

{
    "input": "<TRIGGER_INPUT>"
}

curl --request POST -H "Content-Type:application/json" --data '{"input":"sample queue data"}' http://localhost:7071/admin/functions/QueueTrigger

curl --request POST -H "Content-Type:application/json" --data "{'input':'sample queue data'}" http://localhost:7071/admin/functions/QueueTrigger

Azure'a Yayımlama

Azure İşlevleri Temel Araçları üç dağıtım türünü destekler:

Core Tools'tan Azure'da yayımlama yapabilmek için yerel olarak Azure CLI veya Azure PowerShell yüklü olmalıdır. Varsayılan olarak Core Tools, Azure hesabınızla kimlik doğrulaması yapmak için bu araçları kullanır.

Bu araçlar yüklü değilse, bunun yerine dağıtım sırasında kullanmak üzere geçerli bir erişim belirteci almanız gerekir. Dağıtım komutlarındaki seçeneği kullanarak --access-token erişim belirteci sunabilirsiniz.

Proje dosyalarını dağıtma

func azure functionapp publish <FunctionAppName>

mvn azure-functions:deploy

Kapsayıcıları dağıtma

Temel Araçlar, kapsayıcılı işlev uygulamanızı hem yönetilen Azure Container Apps ortamlarına hem de yönettiğiniz Kubernetes kümelerine dağıtmanıza olanak tanır.

func azurecontainerapps deploy --name <APP_NAME> --environment <ENVIRONMENT_NAME> --storage-account <STORAGE_CONNECTION> --resource-group <RESOURCE_GROUP> --image-name <IMAGE_NAME> [--registry-password] [--registry-server] [--registry-username]

func kubernetes deploy --name <DEPLOYMENT_NAME> --registry <REGISTRY_USERNAME> 

Uygulama ayarlarıyla yerel olarak çalışma

Azure'da bir işlev uygulamasında çalışırken, işlevlerinizin gerektirdiği ayarlar uygulama ayarlarında güvenli bir şekilde depolanır. Yerel geliştirme sırasında, bu ayarlar bunun yerine local.settings.json dosyasındaki koleksiyona Values eklenir. local.settings.json dosyası, yerel geliştirme araçları tarafından kullanılan ayarları da depolar.

Projenizin local.settings.json dosyasındaki koleksiyondaki Values öğeler, işlev uygulamanızın Azure'daki uygulama ayarlarındaki öğeleri yansıtmaya yöneliktir.

Yerel ayarlar dosyasıyla çalışırken aşağıdaki noktalar geçerlidir:

• local.settings.json bağlantı dizesi gibi gizli diziler içerebileceğinden, bunu hiçbir zaman uzak bir depoda depolamamalısınız. Çekirdek Araçlar, gelişmiş güvenlik için bu yerel ayarlar dosyasını şifrelemenize yardımcı olur. Daha fazla bilgi için bkz . Yerel ayarlar dosyası. Ek güvenlik için local.settings.json dosyasını da şifreleyebilirsiniz.

• Varsayılan olarak, proje Azure'da yayımlandığında yerel ayarlar otomatik olarak geçirilmez. Bu ayarların Azure'daki --publish-local-settings işlev uygulamasına eklendiğinden emin olmak için proje dosyalarınızı yayımlarken seçeneğini kullanın. bölümündeki değerler ConnectionStrings hiçbir zaman yayımlanmaz. İstediğiniz zaman local.settings.json dosyasından da ayarları karşıya yükleyebilirsiniz.

• Azure'daki işlev uygulamanızdan ayarları local.settings.json dosyanızdaki ayarları indirebilir ve üzerine yazabilirsiniz. Daha fazla bilgi için bkz . Uygulama ayarlarını indirme.

• için AzureWebJobsStorage geçerli bir depolama bağlantı dizesi ayarlanmadığında ve yerel depolama öykünücüsü kullanılmadığında bir hata gösterilir. Azure Depolama hesaplarınızdan herhangi birinden belirli bir bağlantı dizesi indirmek için Temel Araçlar'ı kullanabilirsiniz.

Uygulama ayarlarını indirme

Proje kökünden aşağıdaki komutu kullanarak Azure'daki uygulamadan myfunctionapp12345 tüm uygulama ayarlarını indirin:

func azure functionapp fetch-app-settings myfunctionapp12345

Bu komut, azure değerleriyle local.settings.json dosyasındaki mevcut ayarların üzerine yazar. Henüz mevcut olmadığında, koleksiyona yeni öğeler eklenir. Daha fazla bilgi için komutuna func azure functionapp fetch-app-settings bakın.

Depolama bağlantı dizesi indirme

Temel Araçlar, erişiminiz olan herhangi bir depolama hesabının bağlantı dizesi almayı da kolaylaştırır. Proje kökünden, adlı mystorage12345bir depolama hesabından bağlantı dizesi indirmek için aşağıdaki komutu kullanın.

func azure storage fetch-connection-string mystorage12345

Bu komut, hesabın bağlantı dizesi içeren mystorage12345 local.settings.json dosyasına adlı mystorage12345_STORAGE bir ayar ekler. Daha fazla bilgi için komutuna func azure storage fetch-connection-string bakın.

Geliştirme sırasında gelişmiş güvenlik için local.settings.json dosyasını şifrelemeyi göz önünde bulundurun.

Yerel ayarları Azure'a yükleme

Seçeneğini kullanmadan --publish-local-settings proje dosyalarınızı Azure'da yayımladığınızda, local.settings.json dosyasındaki ayarlar işlev uygulamanızda ayarlanmamıştır. proje dosyalarını yeniden yayımlamadan yalnızca ayarları karşıya yükleme seçeneğiyle --publish-settings-only öğesini istediğiniz zaman yeniden çalıştırabilirsinizfunc azure functionapp publish.

Aşağıdaki örnek yalnızca local.settings.json dosyasındaki Values koleksiyondaki ayarları Adlı Azure'daki myfunctionapp12345işlev uygulamasına yükler:

func azure functionapp publish myfunctionapp12345 --publish-settings-only

Yerel ayarlar dosyasını şifreleme

Yerel ayarlarınızdaki bağlantı dizesi ve diğer değerli verilerin güvenliğini artırmak için Core Tools, local.settings.json dosyasını şifrelemenize olanak tanır. Bu dosya şifrelendiğinde çalışma zamanı, Azure'daki uygulama ayarında olduğu gibi gerektiğinde ayarların şifresini otomatik olarak çözer. Ayarlarla çalışmak için yerel olarak şifrelenmiş bir dosyanın şifresini de çözebilirsiniz.

Projenin yerel ayarlar dosyasını şifrelemek için aşağıdaki komutu kullanın:

func settings encrypt

Şifrelenmiş bir yerel ayarın şifresini çözmek için aşağıdaki komutu kullanın; böylece bu ayarla çalışabilirsiniz:

func settings decrypt

Ayarlar dosyası şifrelendiğinde ve şifresi çözildiğinde, dosyanın IsEncrypted ayarı da güncelleştirilir.

Bağlama uzantılarını yapılandırma

İşlev tetikleyicileri ve bağlamaları .NET uzantısı (NuGet) paketleri olarak uygulanır. Belirli bir bağlama uzantısını kullanabilmek için bu uzantının projeye yüklenmesi gerekir.

Core Tools sürümleri

Azure İşlevleri Core Tools'un ana sürümleri, Azure İşlevleri çalışma zamanının belirli ana sürümlerine bağlanır. Örneğin, Core Tools'un 4.x sürümü İşlevler çalışma zamanının 4.x sürümünü destekler. Bu sürüm, hem İşlevler çalışma zamanının hem de Çekirdek Araçları'nın önerilen ana sürümüdür. Core Tools'un en son sürümünü Azure İşlevleri Core Tools deposunda belirleyebilirsiniz.

Geçerli Core Tools yüklemenizin sürümünü belirlemek için aşağıdaki komutu çalıştırın:

func --version

Aksi belirtilmediği sürece, bu makaledeki örnekler 4.x sürümüne yöneliktir.

Temel Araçlar yüklemeleri için aşağıdaki önemli noktalar geçerlidir:

• Belirli bir bilgisayara Core Tools'un yalnızca bir sürümünü yükleyebilirsiniz.

• Core Tools'un en son sürümüne yükseltirken, yükseltmeyi gerçekleştirmek için özgün yükleme için kullandığınız yöntemi kullanmanız gerekir. Örneğin, Windows'ta bir MSI kullandıysanız, geçerli MSI'yi kaldırın ve en son MSI'yi yükleyin. Veya npm kullandıysanız, öğesini npm install commandyeniden çalıştırın.

• Core Tools'un 2.x ve 3.x sürümleri, İşlevler çalışma zamanının destek sonuna ulaşmış olan 2.x ve 3.x sürümleriyle kullanıldı. Daha fazla bilgi için bkz. Azure İşlevleri çalışma zamanı sürümlerine genel bakış.

Sonraki adımlar

Azure İşlevleri temel araçları kullanarak Azure işlevlerini geliştirmeyi, test etmeyi ve yayımlamayı öğrenin. Azure İşlevleri Temel Araçları açık kaynak ve GitHub'da barındırılır. Hata veya özellik isteği göndermek için bir GitHub sorunu açın.