Partilhar via


Guia de início rápido: criar e implantar funções no Azure Functions usando a CLI do desenvolvedor do Azure

Neste Guia de início rápido, você usa as ferramentas de linha de comando do Azure Developer para criar funções que respondem a solicitações HTTP. Depois de testar o código localmente, você o implanta em um novo aplicativo de função sem servidor criado em execução em um plano de Consumo Flex no Azure Functions.

A origem do projeto usa a CLI do Desenvolvedor do Azure (azd) para simplificar a implantação de seu código no Azure. Essa implantação segue as práticas recomendadas atuais para implantações seguras e escaláveis do Azure Functions.

Por padrão, o plano Flex Consumption segue um modelo de cobrança de pagamento pelo que você usa , o que significa que concluir esse início rápido incorre em um pequeno custo de alguns centavos de dólar ou menos em sua conta do Azure.

Pré-requisitos

  • Uma ferramenta de teste HTTP segura para enviar solicitações com cargas úteis JSON para seus pontos de extremidade de função. Este artigo usa curlo .

Inicializar o projeto

Você pode usar o azd init comando para criar um projeto de código local do Azure Functions a partir de um modelo.

  1. No terminal local ou prompt de comando, execute este azd init comando em uma pasta vazia:

    azd init --template functions-quickstart-dotnet-azd -e flexquickstart-dotnet
    

    Este comando extrai os arquivos de projeto do repositório de modelos e inicializa o projeto na pasta atual. O -e sinalizador define um nome para o ambiente atual. No azd, o ambiente é usado para manter um contexto de implantação exclusivo para seu aplicativo, e você pode definir mais de um. Ele também é usado no nome do grupo de recursos que você cria no Azure.

  2. Execute este comando para navegar até a pasta do http aplicativo:

    cd http
    
  3. Crie um arquivo chamado local.settings.json na http pasta que contém esses dados JSON:

    {
        "IsEncrypted": false,
        "Values": {
            "AzureWebJobsStorage": "UseDevelopmentStorage=true",
            "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated"
        }
    }
    

    Esse arquivo é necessário quando executado localmente.

  1. No terminal local ou prompt de comando, execute este azd init comando em uma pasta vazia:

    azd init --template azure-functions-java-flex-consumption-azd -e flexquickstart-java 
    

    Este comando extrai os arquivos de projeto do repositório de modelos e inicializa o projeto na pasta atual. O -e sinalizador define um nome para o ambiente atual. No azd, o ambiente é usado para manter um contexto de implantação exclusivo para seu aplicativo, e você pode definir mais de um. Ele também é usado no nome do grupo de recursos que você cria no Azure.

  2. Execute este comando para navegar até a pasta do http aplicativo:

    cd http
    
  3. Crie um arquivo chamado local.settings.json na http pasta que contém esses dados JSON:

    {
        "IsEncrypted": false,
        "Values": {
            "AzureWebJobsStorage": "UseDevelopmentStorage=true",
            "FUNCTIONS_WORKER_RUNTIME": "java"
        }
    }
    

    Esse arquivo é necessário quando executado localmente.

  1. No terminal local ou prompt de comando, execute este azd init comando em uma pasta vazia:

    azd init --template functions-quickstart-javascript-azd -e flexquickstart-js
    

    Este comando extrai os arquivos de projeto do repositório de modelos e inicializa o projeto na pasta raiz. O -e sinalizador define um nome para o ambiente atual. No azd, o ambiente é usado para manter um contexto de implantação exclusivo para seu aplicativo, e você pode definir mais de um. Ele também é usado no nome do grupo de recursos que você cria no Azure.

  2. Crie um arquivo chamado local.settings.json na pasta raiz que contém esses dados JSON:

    {
        "IsEncrypted": false,
        "Values": {
            "AzureWebJobsStorage": "UseDevelopmentStorage=true",
            "FUNCTIONS_WORKER_RUNTIME": "node"
        }
    }
    

    Esse arquivo é necessário quando executado localmente.

  1. No terminal local ou prompt de comando, execute este azd init comando em uma pasta vazia:

    azd init --template functions-quickstart-powershell-azd -e flexquickstart-ps
    

    Este comando extrai os arquivos de projeto do repositório de modelos e inicializa o projeto na pasta raiz. O -e sinalizador define um nome para o ambiente atual. No azd, o ambiente é usado para manter um contexto de implantação exclusivo para seu aplicativo, e você pode definir mais de um. Ele também é usado no nome do grupo de recursos que você cria no Azure.

  2. Execute este comando para navegar até a pasta do src aplicativo:

    cd src
    
  3. Crie um arquivo chamado local.settings.json na src pasta que contém esses dados JSON:

    {
        "IsEncrypted": false,
        "Values": {
            "AzureWebJobsStorage": "UseDevelopmentStorage=true",
            "FUNCTIONS_WORKER_RUNTIME": "powershell",
            "FUNCTIONS_WORKER_RUNTIME_VERSION": "7.2"
        }
    }
    

    Esse arquivo é necessário quando executado localmente.

  1. No terminal local ou prompt de comando, execute este azd init comando em uma pasta vazia:

    azd init --template functions-quickstart-typescript-azd -e flexquickstart-ts
    

    Este comando extrai os arquivos de projeto do repositório de modelos e inicializa o projeto na pasta raiz. O -e sinalizador define um nome para o ambiente atual. No azd, o ambiente é usado para manter um contexto de implantação exclusivo para seu aplicativo, e você pode definir mais de um. Ele também é usado no nome do grupo de recursos que você cria no Azure.

  2. Crie um arquivo chamado local.settings.json na pasta raiz que contém esses dados JSON:

    {
        "IsEncrypted": false,
        "Values": {
            "AzureWebJobsStorage": "UseDevelopmentStorage=true",
            "FUNCTIONS_WORKER_RUNTIME": "node"
        }
    }
    

    Esse arquivo é necessário quando executado localmente.

  1. No terminal local ou prompt de comando, execute este azd init comando em uma pasta vazia:

    azd init --template functions-quickstart-python-http-azd -e flexquickstart-py
    

    Este comando extrai os arquivos de projeto do repositório de modelos e inicializa o projeto na pasta raiz. O -e sinalizador define um nome para o ambiente atual. No azd, o ambiente é usado para manter um contexto de implantação exclusivo para seu aplicativo, e você pode definir mais de um. Ele também é usado no nome do grupo de recursos que você cria no Azure.

  2. Crie um arquivo chamado local.settings.json na pasta raiz que contém esses dados JSON:

    {
        "IsEncrypted": false,
        "Values": {
            "AzureWebJobsStorage": "UseDevelopmentStorage=true",
            "FUNCTIONS_WORKER_RUNTIME": "python"
        }
    }
    

    Esse arquivo é necessário quando executado localmente.

Criar e ativar um ambiente virtual

Na pasta raiz, execute estes comandos para criar e ativar um ambiente virtual chamado .venv:

python3 -m venv .venv
source .venv/bin/activate

Se o Python não instalou o pacote venv na sua distribuição Linux, execute o seguinte comando:

sudo apt-get install python3-venv

Executar no seu ambiente local

  1. Execute este comando a partir da pasta da sua aplicação num terminal ou linha de comandos:

    func start
    
    mvn clean package
    mvn azure-functions:run
    
    npm install
    func start  
    
    npm install
    npm start  
    

    Quando o host Functions é iniciado na pasta do projeto local, ele grava os pontos de extremidade de URL das funções acionadas por HTTP na saída do terminal.

  2. No navegador, navegue até o ponto de httpget extremidade, que deve se parecer com este URL:

    http://localhost:7071/api/httpget

  3. A partir de um novo terminal ou janela de prompt de comando, execute este curl comando para enviar uma solicitação POST com uma carga JSON para o httppost ponto de extremidade:

    curl -i http://localhost:7071/api/httppost -H "Content-Type: text/json" -d @testdata.json
    
    curl -i http://localhost:7071/api/httppost -H "Content-Type: text/json" -d "@src/functions/testdata.json"
    

    Este comando lê dados de carga JSON do testdata.json arquivo de projeto. Você pode encontrar exemplos de ambas as test.http solicitações HTTP no arquivo de projeto.

  4. Quando terminar, pressione Ctrl+C na janela do terminal para interromper o processo do func.exe host.

  1. Execute deactivate para desligar o ambiente virtual.

Rever o código (opcional)

Você pode revisar o código que define os dois pontos de extremidade da função de gatilho HTTP:

       [Function("httpget")]
       public IActionResult Run([HttpTrigger(AuthorizationLevel.Function, "get")]
         HttpRequest req,
         string name)
       {
           var returnValue = string.IsNullOrEmpty(name)
               ? "Hello, World."
               : $"Hello, {name}.";

           _logger.LogInformation($"C# HTTP trigger function processed a request for {returnValue}.");

           return new OkObjectResult(returnValue);
       }
@FunctionName("httpget")
public HttpResponseMessage run(
        @HttpTrigger(
            name = "req",
            methods = {HttpMethod.GET},
            authLevel = AuthorizationLevel.FUNCTION)
            HttpRequestMessage<Optional<String>> request,
        final ExecutionContext context) {
    context.getLogger().info("Java HTTP trigger processed a request.");

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

    return request.createResponseBuilder(HttpStatus.OK).body("Hello, " + name).build();
}
const { app } = require('@azure/functions');

app.http('httpget', {
    methods: ['GET'],
    authLevel: 'function',
    handler: async (request, context) => {
        context.log(`Http function processed request for url "${request.url}"`);

        const name = request.query.get('name') || await request.text() || 'world';

        return { body: `Hello, ${name}!` };
    }
});
import { app, HttpRequest, HttpResponseInit, InvocationContext } from "@azure/functions";

export async function httpGetFunction(request: HttpRequest, context: InvocationContext): Promise<HttpResponseInit> {
    context.log(`Http function processed request for url "${request.url}"`);

    const name = request.query.get('name') || await request.text() || 'world';

    return { body: `Hello, ${name}!` };
};

app.http('httpget', {
    methods: ['GET'],
    authLevel: 'function',
    handler: httpGetFunction
});

Este function.json ficheiro define a httpget função:

{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "Request",
      "methods": [
        "get"
      ],
      "route": "httpget"
    },
    {
      "type": "http",
      "direction": "out",
      "name": "Response"
    }
  ]
}

Este run.ps1 arquivo implementa o código da função:

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
$name = $Request.Query.name

$body = "This HTTP triggered function executed successfully. Pass a name in the query string for a personalized response."

if ($name) {
    $body = "Hello, $name. This HTTP triggered function executed successfully."
}

# Associate values to output bindings by calling 'Push-OutputBinding'.
Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = [HttpStatusCode]::OK
    Body = $body
})
@app.route(route="httpget", methods=["GET"])
def http_get(req: func.HttpRequest) -> func.HttpResponse:
    name = req.params.get("name", "World")

    logging.info(f"Processing GET request. Name: {name}")

    return func.HttpResponse(f"Hello, {name}!")

Você pode revisar o projeto de modelo completo aqui.

Você pode revisar o projeto de modelo completo aqui.

Você pode revisar o projeto de modelo completo aqui.

Você pode revisar o projeto de modelo completo aqui.

Você pode revisar o projeto de modelo completo aqui.

Você pode revisar o projeto de modelo completo aqui.

Depois de verificar suas funções localmente, é hora de publicá-las no Azure.

Criar recursos do Azure

Este projeto está configurado para usar o comando para criar um aplicativo de função em um plano Flex Consumption, juntamente com outros recursos necessários do azd provision Azure.

Nota

Este projeto inclui um conjunto de arquivos Bicep que azd usa para criar uma implantação segura para um plano de consumo Flex que segue as práticas recomendadas.

Os azd up comandos e azd deploy não são suportados atualmente para aplicativos Java.

  1. Na pasta raiz do projeto, execute este comando para criar os recursos necessários do Azure:

    azd provision
    

    A pasta raiz contém o arquivo de azure.yaml definição exigido pelo azd.

    Se ainda não tiver sessão iniciada, ser-lhe-á pedido para se autenticar com a sua conta do Azure.

  2. Quando solicitado, forneça estes parâmetros de implantação necessários:

    Parâmetro Description
    Subscrição do Azure Subscrição na qual os seus recursos são criados.
    Localização do Azure Região do Azure na qual criar o grupo de recursos que contém os novos recursos do Azure. Apenas as regiões que atualmente suportam o plano Flex Consumption são mostradas.

    O azd provision comando usa sua resposta a esses prompts com os arquivos de configuração do Bicep para criar e configurar estes recursos necessários do Azure:

    • Plano Flex Consumption e aplicação funcional
    • Armazenamento do Azure (obrigatório) e Application Insights (recomendado)
    • Políticas e funções de acesso para a sua conta
    • Conexões de serviço a serviço usando identidades gerenciadas (em vez de cadeias de conexão armazenadas)
    • Rede virtual para executar com segurança o aplicativo de função e os outros recursos do Azure

    Depois que o comando for concluído com êxito, você poderá implantar o código do projeto nesse novo aplicativo de função no Azure.

Implementar no Azure

Você pode usar as Ferramentas Principais para empacotar seu código e implantá-lo no Azure a partir da target pasta de saída.

  1. Navegue até a pasta do aplicativo equivalente na target pasta de saída:

    cd http/target/azure-functions/contoso-functions
    

    Esta pasta deve ter um arquivo host.json, que indica que é a raiz do seu aplicativo de função Java compilado.

  2. Execute estes comandos para implantar seu projeto de código Java compilado no novo recurso de aplicativo de função no Azure usando as Ferramentas Principais:

    APP_NAME=$(azd env get-value AZURE_FUNCTION_NAME)
    func azure functionapp publish $APP_NAME
    

    O azd env get-value comando obtém o nome do aplicativo de função do ambiente local, que é necessário para a implantação usando func azure functionapp publisho . Depois que a publicação for concluída com êxito, você verá links para os pontos de extremidade de gatilho HTTP no Azure.

Implementar no Azure

Este projeto está configurado para usar o azd up comando para implantar esse projeto em um novo aplicativo de função em um plano de Consumo Flex no Azure.

Gorjeta

Este projeto inclui um conjunto de arquivos Bicep que azd usa para criar uma implantação segura para um plano de consumo Flex que segue as práticas recomendadas.

  1. Execute este comando para criar azd os recursos necessários do Azure no Azure e implantar seu projeto de código no novo aplicativo de função:

    azd up
    

    A pasta raiz contém o arquivo de azure.yaml definição exigido pelo azd.

    Se ainda não tiver sessão iniciada, ser-lhe-á pedido para se autenticar com a sua conta do Azure.

  2. Quando solicitado, forneça estes parâmetros de implantação necessários:

    Parâmetro Description
    Subscrição do Azure Subscrição na qual os seus recursos são criados.
    Localização do Azure Região do Azure na qual criar o grupo de recursos que contém os novos recursos do Azure. Apenas as regiões que atualmente suportam o plano Flex Consumption são mostradas.

    O azd up comando usa sua resposta a esses prompts com os arquivos de configuração do Bicep para concluir estas tarefas de implantação:

    • Crie e configure estes recursos necessários do Azure (equivalentes a azd provision):

      • Plano Flex Consumption e aplicação funcional
      • Armazenamento do Azure (obrigatório) e Application Insights (recomendado)
      • Políticas e funções de acesso para a sua conta
      • Conexões de serviço a serviço usando identidades gerenciadas (em vez de cadeias de conexão armazenadas)
      • Rede virtual para executar com segurança o aplicativo de função e os outros recursos do Azure
    • Empacote e implante seu código no contêiner de implantação (equivalente a azd deploy). O aplicativo é então iniciado e executado no pacote implantado.

    Depois que o comando for concluído com êxito, você verá links para os recursos criados.

Invoque a função no Azure

Agora você pode invocar seus pontos de extremidade de função no Azure fazendo solicitações HTTP para suas URLs usando sua ferramenta de teste HTTP ou do navegador (para solicitações GET). Quando suas funções são executadas no Azure, a autorização de chave de acesso é imposta e você deve fornecer uma chave de acesso de função com sua solicitação.

Você pode usar as Ferramentas Principais para obter os pontos de extremidade de URL de suas funções em execução no Azure.

  1. No terminal local ou prompt de comando, execute estes comandos para obter os valores de ponto de extremidade de URL:

    SET APP_NAME=(azd env get-value AZURE_FUNCTION_NAME)
    func azure functionapp list-functions $APP_NAME --show-keys
    
    $APP_NAME = azd env get-value AZURE_FUNCTION_NAME
    func azure functionapp list-functions $APP_NAME --show-keys
    

    O azd env get-value comando obtém o nome do aplicativo de função do ambiente local. Usar a opção com func azure functionapp list-functions significa que o valor Invoke URL: retornado para cada ponto de extremidade inclui uma chave de acesso no nível da --show-keys função.

  2. Como antes, use sua ferramenta de teste HTTP para validar essas URLs em seu aplicativo de função em execução no Azure.

Reimplantar seu código

Você pode executar o azd up comando quantas vezes precisar para provisionar seus recursos do Azure e implantar atualizações de código em seu aplicativo de função.

Nota

Os arquivos de código implantados são sempre substituídos pelo pacote de implantação mais recente.

Suas respostas iniciais a azd prompts e quaisquer variáveis de ambiente geradas por azd são armazenadas localmente em seu ambiente nomeado. Use o azd env get-values comando para revisar todas as variáveis em seu ambiente que foram usadas ao criar recursos do Azure.

Clean up resources (Limpar recursos)

Quando terminar de trabalhar com seu aplicativo de função e recursos relacionados, você poderá usar este comando para excluir o aplicativo de função e seus recursos relacionados do Azure e evitar incorrer em custos adicionais:

azd down --no-prompt

Nota

A --no-prompt opção instrui azd a excluir seu grupo de recursos sem uma confirmação sua.

Este comando não afeta seu projeto de código local.