Připojení Azure Functions se Azure Storage pomocí Visual Studio Code

• Nainstalujte .NET Core CLI nástroje.

• Proveďte kroky v první části tohoto rychlého Visual Studio Code startu.

• Proveďte kroky v první části tohoto rychlého Visual Studio Code startu.

• Proveďte kroky v první části tohoto rychlého Visual Studio Code startu.

• Proveďte kroky v první části tohoto rychlého Visual Studio Code startu.

• Proveďte kroky v první části tohoto rychlého Visual Studio Code startu.

• Proveďte kroky v první části tohoto rychlého Visual Studio Code startu.

Projekt je nakonfigurovaný tak, aby při používání sad rozšířeníautomaticky instaloval předdefinovanou sadu balíčků rozšíření.

Využití sad rozšíření je povolené v souboru host.json v kořenovém adresáři projektu, který se zobrazí takto:

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

Atributy vazby jsou definovány přímo v function.jsv souboru. V závislosti na typu vazby mohou být vyžadovány další vlastnosti. Konfigurace výstupu fronty popisuje pole požadovaná pro vazbu fronty Azure Storage. Rozšíření usnadňuje přidávání vazeb do function.jssouborů.

Vazbu vytvoříte tak, že kliknete pravým tlačítkem (CTRL + kliknete na macOS) do function.json souboru ve složce HttpTrigger a kliknete na Přidat vazbu.... Podle pokynů definujte následující vlastnosti vazby pro novou vazbu:

Vazba je přidána do bindings pole v function.jsv, což by mělo vypadat takto:

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

V projektu jazyka C# jsou vazby definovány jako atributy vazby v metodě funkce. Konkrétní definice závisí na tom, jestli vaše aplikace běží v procesu (knihovna tříd C#), nebo v izolovaném procesu.

[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; }
}

V projektu Java jsou vazby definovány jako anotace vazby v metodě Function. function.jsv souboru se pak automaticky generuje na základě těchto poznámek.

Přejděte do umístění kódu funkce v části Src/Main/Java, otevřete soubor projektu Function. Java a do definice metody přidejte následující parametr run :

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

msgParametr je OutputBinding<T> typ, který představuje kolekci řetězců, které jsou zapsány jako zprávy do výstupní vazby po dokončení funkce. V tomto případě je výstupem fronta úložiště s názvem outqueue . Připojovací řetězec pro účet úložiště je nastaven connection metodou. Místo samotného připojovacího řetězce předáte nastavení aplikace, které obsahuje připojovací řetězec účtu úložiště.

runDefinice metody by teď měla vypadat jako v následujícím příkladu:

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

Přidejte kód, který používá msg výstupní vazbu objektu pro context.bindings k vytvoření zprávy fronty. Přidejte tento kód před context.res příkaz.

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

V tomto okamžiku by měla funkce vypadat takto:

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"
        };
    }
};

Přidejte kód, který používá msg výstupní vazbu objektu pro context.bindings k vytvoření zprávy fronty. Přidejte tento kód před context.res příkaz.

context.bindings.msg = name;

V tomto okamžiku by měla funkce vypadat takto:

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;

Přidejte kód, který používá Push-OutputBinding rutinu k zápisu textu do fronty pomocí msg výstupní vazby. Před nastavením stavu OK v příkazu přidejte tento kód if .

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

V tomto okamžiku by měla funkce vypadat takto:

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

Aktualizujte soubor HttpExample \ _ _ init _ _ .py tak, aby odpovídal následujícímu kódu, a přidejte parametr do definice funkce a msg pod příkaz msg.set(name) if name: .

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
        )

Parametr msg je instance azure.functions.Out class . Jeho metoda zapíše do fronty řetězcovou zprávu, v tomto případě název předaný funkci set v řetězci dotazu adresy URL.

Nyní můžete použít nový msg parametr pro zápis do výstupní vazby z kódu funkce. Přidejte následující řádek kódu před reakci na úspěch pro přidání hodnoty name do msg výstupní vazby.

msg.setValue(name);

Když použijete výstupní vazbu, nemusíte používat Azure Storage kód SDK pro ověřování, získání odkazu na frontu nebo zápis dat. Úlohy za běhu functions a Queue výstupní vazby jsou za vás.

Vaše run Metoda by teď měla vypadat jako v následujícím příkladu:

@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();
    }
}

Aktualizace testů

Vzhledem k tomu, že Archetype také vytvoří sadu testů, je nutné aktualizovat tyto testy pro zpracování nového msg parametru v run signatuře metody.

Přejděte do umístění testovacího kódu v části Src/test/Java, otevřete soubor projektu Function. Java a nahraďte řádek kódu //Invoke následujícím kódem.

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

Místní spuštění funkce

Visual Studio Code se integruje s nástroji Azure Functions Core , aby bylo možné spustit tento projekt na místním vývojovém počítači před publikováním do Azure.

1. Pro volání funkce stiskněte klávesu F5 ke spuštění projektu Function App. Výstup z nástrojů Tools se zobrazí na panelu Terminál. Vaše aplikace se spustí na panelu terminálu . Koncový bod adresy URL vámi spuštěné funkce aktivované protokolem HTTP se zobrazí v místním prostředí.

   

   pokud máte potíže s provozem na Windows, ujistěte se, že výchozí terminál pro Visual Studio Code není nastaven na WSL Bash.

2. Se základními nástroji, které běží, přejdete do oblasti Azure: Functions . v části funkce rozbalte místní > funkce Project. klikněte pravým tlačítkem (Windows) nebo stiskněte klávesu Ctrl (macOS) HttpExample a vyberte možnost spustit funkci nyní....

   

3. V části Zadejte text žádosti stiskněte klávesu ENTER a odešlete do své funkce zprávu s požadavkem.

4. Když se funkce spustí místně a vrátí odpověď, vygeneruje se oznámení v Visual Studio Code. Informace o spuštění funkce se zobrazí na panelu terminálu .

5. Stisknutím kombinace kláves CTRL + C zastavte základní nástroje a odpojte ladicí program.

Místní spuštění funkce

1. Stejně jako v předchozím článku stiskněte klávesu F5 a spusťte projekt aplikace funkcí a nástroje Core Tools.

2. Se spuštěnou službou Core Tools přejděte do oblasti Azure: Functions. V části Funkce rozbalte místní Project > Functions. Klikněte pravým tlačítkem (ctrl+kliknutí na Mac) na funkci a HttpExample zvolte Execute Function Now... (Spustit funkci nyní).

   

3. V textu požadavku Enter se zobrazí hodnota textu zprávy požadavku { "name": "Azure" } . Stisknutím klávesy Enter odešlete tuto zprávu požadavku do vaší funkce.

4. Po vrácení odpovědi zastavte stisknutím kombinace kláves Ctrl +C nástroje Core Tools.

Vzhledem k tomu, že používáte připojovací řetězec úložiště, vaše funkce se při místním spuštění připojí k účtu úložiště Azure. Při prvním použití výstupní vazby vytvoří modul runtime služby Functions ve vašem účtu úložiště novou frontu s názvem outqueue. Pomocí tohoto Průzkumník služby Storage ověříte, že se fronta vytvořila spolu s novou zprávou.

• Příklady kompletních projektů funkcí v jazyce C#

• Azure Functions referenčních informace pro vývojáře v C#

• Příklady kompletních projektů funkcí v JavaScriptu

• Azure Functions – Příručka pro vývojáře v JavaScriptu

• Příklady kompletních projektů funkcí v Javě

• Azure Functions java – příručka pro vývojáře

• Příklady kompletních projektů funkcí v TypeScriptu

• Azure Functions TypeScript – příručka pro vývojáře

• Příklady kompletních projektů funkcí v Pythonu

• Azure Functions – Příručka pro vývojáře v Pythonu

• Příklady kompletních projektů funkcí v PowerShellu

• Azure Functions – Příručka pro vývojáře v PowerShellu