Bağlan Azure İşlevleri kullanarak Azure Depolama'e Visual Studio Code

• Uygulama .NET Core CLI yükleyin.

• hızlı başlangıç adımlarının 1. Visual Studio Code tamamlayın.

• hızlı başlangıç adımlarının 1. Visual Studio Code tamamlayın.

• hızlı başlangıç adımlarının 1. Visual Studio Code tamamlayın.

• hızlı başlangıç adımlarının 1. Visual Studio Code tamamlayın.

• hızlı başlangıç adımlarının 1. Visual Studio Code tamamlayın.

• hızlı başlangıç adımlarının 1. Visual Studio Code tamamlayın.

Projeniz, önceden tanımlanmış bir uzantı paketleri kümesi otomatikolarak yüken uzantı paketlerini kullanmak üzere yapılandırıldı.

Uzantı paketleri kullanımı, projenin kökünde yer alan host.json dosyasında etkindir ve şu şekilde görünür:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[1.*, 2.0.0)"
  } 
}

Bağlama öznitelikleri, dosyasında function.jsdoğrudan tanımlanmıştır. Bağlama türüne bağlı olarak ek özellikler gerekli olabilir. Kuyruk çıkış yapılandırması , bir Azure depolama kuyruğu bağlaması için gereken alanları açıklar. Uzantı, dosyadaki function.jsbağlama eklemeyi kolaylaştırır.

Bir bağlama oluşturmak için, HttpTrigger klasörünüzdeki dosyayı sağ tıklatın (macOS üzerinde CTRL + tıklama) function.json ve bağlama Ekle... seçeneğini belirleyin. Yeni bağlama yönelik aşağıdaki bağlama özelliklerini tanımlamak için istemleri izleyin:

Üzerinde function.jsdizisine eklenen bir bağlama bindings , aşağıdaki gibi görünmelidir:

{
  "type": "queue",
  "direction": "out",
  "name": "msg",
  "queueName": "outqueue",
  "connection": "AzureWebJobsStorage"
}

Bir C# projesinde, bağlamalar işlev yönteminde bağlama öznitelikleri olarak tanımlanır. Belirli tanımlar, uygulamanızın işlem içinde (C# sınıf kitaplığı) veya yalıtılmış bir işlemde çalışmasına bağlıdır.

[Queue("outqueue"),StorageAccount("AzureWebJobsStorage")] ICollector<string> msg,

[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)

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

Java projesinde bağlamalar, işlev yönteminde bağlama ek açıklamaları olarak tanımlanır. Dosyadaki function.js bu ek açıklamaları temel alınarak otomatik olarak oluşturulur.

Src/Main/Java altındaki işlev kodunuzun konumuna gidin, function. Java proje dosyasını açın ve Yöntem tanımına aşağıdaki parametreyi ekleyin run :

@QueueOutput(name = "msg", queueName = "outqueue", 
connection = "AzureWebJobsStorage") OutputBinding<String> msg,

msgParametresi OutputBinding<T> , işlev tamamlandığında çıkış bağlamaya ileti olarak yazılmış dizeler koleksiyonunu temsil eden bir türdür. Bu durumda, çıktı adlı bir depolama kuyruğudur outqueue . Depolama hesabı için bağlantı dizesi yöntemi tarafından ayarlanır connection . Bağlantı dizesinin kendisi yerine, depolama hesabı bağlantı dizesini içeren uygulama ayarını geçirirsiniz.

runYöntem tanımı şimdi aşağıdaki örnekteki gibi görünmelidir:

@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) {

msgKuyruk iletisi oluşturmak için çıkış bağlama nesnesi kullanan kodu ekleyin context.bindings . Bu kodu context.res deyimden önce ekleyin.

// Add a message to the Storage queue,
// which is the name passed to the function.
context.bindings.msg = (req.query.name || req.body.name);

Bu noktada, işleviniz aşağıdaki gibi görünmelidir:

module.exports = async function (context, req) {
    context.log('JavaScript HTTP trigger function processed a request.');

    if (req.query.name || (req.body && req.body.name)) {
        // Add a message to the Storage queue,
        // which is the name passed to the function.
        context.bindings.msg = (req.query.name || req.body.name);
        context.res = {
            // status: 200, /* Defaults to 200 */
            body: "Hello " + (req.query.name || req.body.name)
        };
    }
    else {
        context.res = {
            status: 400,
            body: "Please pass a name on the query string or in the request body"
        };
    }
};

msgKuyruk iletisi oluşturmak için çıkış bağlama nesnesi kullanan kodu ekleyin context.bindings . Bu kodu context.res deyimden önce ekleyin.

context.bindings.msg = name;

Bu noktada, işleviniz aşağıdaki gibi görünmelidir:

import { AzureFunction, Context, HttpRequest } from "@azure/functions"

const httpTrigger: AzureFunction = async function (context: Context, req: HttpRequest): Promise<void> {
    context.log('HTTP trigger function processed a request.');
    const name = (req.query.name || (req.body && req.body.name));

    if (name) {
        // Add a message to the storage queue, 
        // which is the name passed to the function.
        context.bindings.msg = name; 
        // Send a "hello" response.
        context.res = {
            // status: 200, /* Defaults to 200 */
            body: "Hello " + (req.query.name || req.body.name)
        };
    }
    else {
        context.res = {
            status: 400,
            body: "Please pass a name on the query string or in the request body"
        };
    }
};

export default httpTrigger;

Push-OutputBindingÇıkış bağlamayı kullanarak bir metni kuyruğa yazmak için cmdlet 'ini kullanan kodu ekleyin msg . Deyimdeki Tamam durumunu ayarlamadan önce bu kodu ekleyin if .

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

Bu noktada, işleviniz aşağıdaki gibi görünmelidir:

using namespace System.Net

# Input bindings are passed in via param block.
param($Request, $TriggerMetadata)

# Write to the Azure Functions log stream.
Write-Host "PowerShell HTTP trigger function processed a request."

# Interact with query parameters or the body of the request.
$name = $Request.Query.Name
if (-not $name) {
    $name = $Request.Body.Name
}

if ($name) {
    # Write the $name value to the queue, 
    # which is the name passed to the function.
    $outputMsg = $name
    Push-OutputBinding -name msg -Value $outputMsg

    $status = [HttpStatusCode]::OK
    $body = "Hello $name"
}
else {
    $status = [HttpStatusCode]::BadRequest
    $body = "Please pass a name on the query string or in the request body."
}

# Associate values to output bindings by calling 'Push-OutputBinding'.
Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = $status
    Body = $body
})

HttpExample \ _ _ init _ _ .py'yi aşağıdaki kodla eşecek şekilde güncelleştirin, msg parametresini işlev tanımına ve msg.set(name) deyiminin altına if name: ekler.

import logging

import azure.functions as func


def main(req: func.HttpRequest, msg: func.Out[func.QueueMessage]) -> str:

    name = req.params.get('name')
    if not name:
        try:
            req_body = req.get_json()
        except ValueError:
            pass
        else:
            name = req_body.get('name')

    if name:
        msg.set(name)
        return func.HttpResponse(f"Hello {name}!")
    else:
        return func.HttpResponse(
            "Please pass a name on the query string or in the request body",
            status_code=400
        )

msgparametresi bir azure.functions.Out class örneğidir. yöntemi set kuyruğa bir dize iletisi yazar, bu durumda URL sorgu dizesinde işleve geçirilen ad.

Şimdi, msg işlev kodunuzda çıkış bağlamaya yazmak için yeni parametresini kullanabilirsiniz. Değerini çıkış bağlamaya eklemek için, başarı yanıtından önce aşağıdaki kod satırını ekleyin name msg .

msg.setValue(name);

Çıkış bağlamayı kullandığınızda, kimlik doğrulaması, kuyruk başvurusu alma veya veri yazma için Azure depolama SDK kodunu kullanmanız gerekmez. Işlevler çalışma zamanı ve kuyruk çıkış bağlaması bu görevleri sizin için işler.

runYönteminiz aşağıdaki örnekteki gibi görünmelidir:

@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) {
    context.getLogger().info("Java HTTP trigger processed a request.");

    // Parse query parameter
    String query = request.getQueryParameters().get("name");
    String name = request.getBody().orElse(query);

    if (name == null) {
        return request.createResponseBuilder(HttpStatus.BAD_REQUEST)
        .body("Please pass a name on the query string or in the request body").build();
    } else {
        // Write the name to the message queue. 
        msg.setValue(name);

        return request.createResponseBuilder(HttpStatus.OK).body("Hello, " + name).build();
    }
}

Testleri güncelleştirme

Ayrıca, aynı zamanda bir test kümesi oluşturduğundan, yöntem imzasında yeni parametreyi işlemek için bu testleri güncelleştirmeniz gerekir msg run .

Src/test/Java altındaki test kodunuzun konumuna gidin, function. Java proje dosyasını açın ve altındaki kod satırını //Invoke aşağıdaki kodla değiştirin.

@SuppressWarnings("unchecked")
final OutputBinding<String> msg = (OutputBinding<String>)mock(OutputBinding.class);
final HttpResponseMessage ret = new Function().run(req, msg, context);

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

Visual Studio Code, Azure'Azure İşlevleri yayımlamadan önce bu projeyi yerel geliştirme bilgisayarınızda çalıştırmanıza izin vermenizi sağlar.

1. İşlevini çağırarak F5 tuşuna basarak işlev uygulaması projesini başlatabilirsiniz. Temel Araçlar’daki çıktı, Terminal panelinde görüntülenir. Uygulamanız Terminal panelinden başlar. HTTP ile tetiklenen işlevinizin URL uç noktasının yerel olarak çalıştır çalıştırıi olduğunu görüyorsunuz.

   

   Windows'da çalıştırma konusunda sorun Visual Studio Code için varsayılan terminalin WSL Bash olarak ayarlanmay olduğundan emin olun.

2. Core Tools çalışıyorken Azure: İşlevler alanına gidin. İşlevler'in altında, Yerel Project İşlevler'i > genişletin. İşleve sağ tıklayın (Windows) veya Ctrl tuşunu basılı tutarak (macOS) HttpExample tıklayın ve İşlevi Şimdi Yürüt... öğesini seçin.

   

3. İstek gövdenizi girin içinde, işlevinize bir istek iletisi göndermek için Enter tuşuna basın.

4. İşlev yerel olarak yürütülür ve bir yanıt döndürülürken, bir bildirim Visual Studio Code. İşlev yürütmesi hakkında bilgiler Terminal panelinde gösterilir.

5. Core Tools'ı durdurmak ve hata ayıklayıcının bağlantısını kesmek için Ctrl + C tuşlarına basın.

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

1. Önceki makalede olduğu gibi, işlev uygulaması projesini ve Core Tools'i başlatmak için F5 tuşuna basın.

2. Core Tools çalışıyorken Azure: İşlevler alanına gidin. İşlevler altında Yerel İşlevler'Project > genişletin. İşleve sağ tıklayın (Mac'e Ctrl tuşunu basılı tutarak HttpExample tıklayın) ve İşlevi Şimdi Yürüt... öğesini seçin.

   

3. İstek gövdeyi girin içinde istek iletisi gövdesi değerini { "name": "Azure" } görüyorsunuz. Bu istek iletiyi işlevinize göndermek için Enter tuşuna basın.

4. Yanıt döndürüldikten sonra Core Tools'ları durdurmak için Ctrl + C tuşlarına basın.

Depolama bağlantı dizesini kullanmakta olduğunuz için işleviniz yerel olarak çalıştırarak Azure depolama hesabına bağlanır. Çıkış bağlaması ilk kez kullanılırken depolama hesabınıza İşlevler çalışma zamanı tarafından outqueue adlı yeni bir kuyruk oluşturulur. Kuyruğun yeni iletiyle Depolama Gezgini doğrulamak için Depolama Gezgini'i kullanırsınız.

• C# içinde tam İşlev projeleri örnekleri.

• Azure İşlevleri C# geliştirici başvurusu

• JavaScript'te tam İşlev projeleri örnekleri.

• Azure İşlevleri JavaScript geliştirici kılavuzu

• Java'da tam İşlev projeleri örnekleri.

• Azure İşlevleri Java geliştirici kılavuzu

• TypeScript'te tam İşlev projeleri örnekleri.

• Azure Işlevleri TypeScript Geliştirici Kılavuzu

• Python 'da tüm işlev projelerinin örnekleri.

• Azure İşlevleri Python geliştirici kılavuzu

• PowerShell 'de tüm işlev projelerinin örnekleri.

• Azure İşlevleri PowerShell geliştirici kılavuzu