Gerir a sua aplicação de funçãoManage your function app

Em Funções Azure, uma aplicação de função fornece o contexto de execução para as suas funções individuais.In Azure Functions, a function app provides the execution context for your individual functions. Os comportamentos da aplicação de funções aplicam-se a todas as funções hospedadas por uma determinada aplicação de função.Function app behaviors apply to all functions hosted by a given function app. Todas as funções numa aplicação de função devem ser do mesmo idioma.All functions in a function app must be of the same language.

As funções individuais numa aplicação de função são implementadas em conjunto e são dimensionadas em conjunto.Individual functions in a function app are deployed together and are scaled together. Todas as funções na mesma função a aplicação partilham recursos, por exemplo, à medida que a tabela de aplicações de função.All functions in the same function app share resources, per instance, as the function app scales.

As cadeias de ligação, as variáveis ambientais e outras configurações de aplicação são definidas separadamente para cada aplicação de função.Connection strings, environment variables, and other application settings are defined separately for each function app. Quaisquer dados que devam ser partilhados entre aplicações de função devem ser armazenados externamente numa loja persistiu.Any data that must be shared between function apps should be stored externally in a persisted store.

Este artigo descreve como configurar e gerir as suas aplicações de função.This article describes how to configure and manage your function apps.

Dica

Muitas opções de configuração também podem ser geridas utilizando o Azure CLI.Many configuration options can also be managed by using the Azure CLI.

Começar a utilizar o portal do AzureGet started in the Azure portal

  1. Para começar, vá ao [portal Azure] e inscreva-se na sua conta Azure.To begin, go to the Azure portal and sign in to your Azure account. Na barra de pesquisa no topo do portal, insira o nome da sua aplicação de função e selecione-a da lista.In the search bar at the top of the portal, enter the name of your function app and select it from the list.

  2. Em Definições no painel esquerdo, selecione Configuração.Under Settings in the left pane, select Configuration.

    Visão geral da aplicação de função no portal Azure

Pode navegar para tudo o que necessita para gerir a sua aplicação de função a partir da página de visão geral, em particular as definições de Aplicação e as funcionalidades da Plataforma.You can navigate to everything you need to manage your function app from the overview page, in particular the Application settings and Platform features.

Definições da aplicaçãoApplication settings

O separador de definições de aplicação mantém as definições que são utilizadas pela sua aplicação de função.The Application settings tab maintains settings that are used by your function app. Estas definições são armazenadas encriptadas e tem de selecionar valores de 'Mostrar' para ver os valores no portal.These settings are stored encrypted, and you must select Show values to see the values in the portal. Também pode aceder às definições da aplicação utilizando o CLI Azure.You can also access application settings by using the Azure CLI.

PortalPortal

Para adicionar uma definição no portal, selecione nova definição de aplicação e adicione o novo par de valor-chave.To add a setting in the portal, select New application setting and add the new key-value pair.

Definições de aplicações de função no portal Azure.

CLI do AzureAzure CLI

O az functionapp config appsettings list comando devolve as definições de aplicação existentes, como no exemplo seguinte:The az functionapp config appsettings list command returns the existing application settings, as in the following example:

az functionapp config appsettings list --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>

O az functionapp config appsettings set comando adiciona ou atualiza uma definição de aplicação.The az functionapp config appsettings set command adds or updates an application setting. O exemplo a seguir cria uma definição com uma chave nomeada CUSTOM_FUNCTION_APP_SETTING e um valor 12345 de:The following example creates a setting with a key named CUSTOM_FUNCTION_APP_SETTING and a value of 12345:

az functionapp config appsettings set --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--settings CUSTOM_FUNCTION_APP_SETTING=12345

Utilizar as definições de aplicaçõesUse application settings

Os valores de definição de aplicações de função também podem ser lidos no seu código como variáveis ambientais.The function app settings values can also be read in your code as environment variables. Para obter mais informações, consulte a secção de variáveis ambientais destes tópicos de referência específicos da linguagem:For more information, see the Environment variables section of these language-specific reference topics:

Quando desenvolve uma aplicação de função localmente, deve manter cópias locais destes valores no local.settings.jsno ficheiro do projeto.When you develop a function app locally, you must maintain local copies of these values in the local.settings.json project file. Para saber mais, consulte o ficheiro de definições locais.To learn more, see Local settings file.

Funcionalidades da plataformaPlatform features

As aplicações de função são executadas e mantidas pela plataforma Azure App Service.Function apps run in, and are maintained by, the Azure App Service platform. Como tal, as aplicações da sua função têm acesso à maioria das funcionalidades da plataforma de hospedagem web core da Azure.As such, your function apps have access to most of the features of Azure's core web hosting platform. O painel esquerdo é onde acede às muitas funcionalidades da plataforma De Serviço de Aplicações que pode utilizar nas suas aplicações de função.The left pane is where you access the many features of the App Service platform that you can use in your function apps.

Nota

Nem todas as funcionalidades do Serviço de Aplicações estão disponíveis quando uma aplicação de função funciona no plano de hospedagem De Consumo.Not all App Service features are available when a function app runs on the Consumption hosting plan.

O resto deste artigo centra-se nas seguintes funcionalidades do Serviço de Aplicações no portal Azure que são úteis para funções:The rest of this article focuses on the following App Service features in the Azure portal that are useful for Functions:

Para obter mais informações sobre como trabalhar com as definições do Serviço de Aplicações, consulte configurações do Serviço de Aplicações Configure Azure.For more information about how to work with App Service settings, see Configure Azure App Service Settings.

Editor de Serviço de AplicaçõesApp Service editor

O editor do Serviço de Aplicações

O editor do Serviço de Aplicações é um editor avançado no portal que pode usar para modificar ficheiros de configuração JSON e ficheiros de código.The App Service editor is an advanced in-portal editor that you can use to modify JSON configuration files and code files alike. A escolha desta opção lança um separado separado do navegador com um editor básico.Choosing this option launches a separate browser tab with a basic editor. Isto permite-lhe integrar-se com o código de repositório, executar e depurar Git e modificar as definições de aplicações de função.This enables you to integrate with the Git repository, run and debug code, and modify function app settings. Este editor proporciona um ambiente de desenvolvimento melhorado para as suas funções em comparação com o editor de funções incorporado.This editor provides an enhanced development environment for your functions compared with the built-in function editor.

Recomendamos que considere desenvolver as suas funções no seu computador local.We recommend that you consider developing your functions on your local computer. Quando desenvolve localmente e publica para o Azure, os seus ficheiros de projeto são apenas lidos no portal.When you develop locally and publish to Azure, your project files are read-only in the portal. Para saber mais, consulte Código e teste as Funções Azure localmente.To learn more, see Code and test Azure Functions locally.

ConsolaConsole

Consola de aplicativos de função

A consola no portal é uma ferramenta de desenvolvimento ideal quando prefere interagir com a sua aplicação de função a partir da linha de comando.The in-portal console is an ideal developer tool when you prefer to interact with your function app from the command line. Os comandos comuns incluem diretório e criação de ficheiros e navegação, bem como a execução de ficheiros e scripts de lote.Common commands include directory and file creation and navigation, as well as executing batch files and scripts.

Ao desenvolver-se localmente, recomendamos a utilização das Ferramentas Centrais de Funções Azure e do [CLI Azure].When developing locally, we recommend using the Azure Functions Core Tools and the Azure CLI.

Ferramentas avançadas (Kudu)Advanced tools (Kudu)

Configuure Kudu

As ferramentas avançadas para o Serviço de Aplicações (também conhecido como Kudu) fornecem acesso a funcionalidades administrativas avançadas da sua aplicação de função.The advanced tools for App Service (also known as Kudu) provide access to advanced administrative features of your function app. A partir de Kudu, gere informações do sistema, configurações de aplicações, variáveis ambientais, extensões de site, cabeçalhos HTTP e variáveis de servidor.From Kudu, you manage system information, app settings, environment variables, site extensions, HTTP headers, and server variables. Também pode lançar Kudu navegando no ponto final SCM para a sua aplicação de função, comohttps://<myfunctionapp>.scm.azurewebsites.net/You can also launch Kudu by browsing to the SCM endpoint for your function app, like https://<myfunctionapp>.scm.azurewebsites.net/

Centro de ImplementaçãoDeployment Center

Quando utiliza uma solução de controlo de fontes para desenvolver e manter o código de funções, o Centro de Implantação permite-lhe construir e implantar a partir do controlo de origem.When you use a source control solution to develop and maintain your functions code, Deployment Center lets you build and deploy from source control. O seu projeto é construído e implantado para a Azure quando faz atualizações.Your project is built and deployed to Azure when you make updates. Para obter mais informações, consulte as tecnologias de implantação em Funções Azure.For more information, see Deployment technologies in Azure Functions.

Partilha de recursos de várias origensCross-origin resource sharing

Para evitar a execução de código malicioso no cliente, os navegadores modernos bloqueiam pedidos de aplicações web a recursos executados em um domínio separado.To prevent malicious code execution on the client, modern browsers block requests from web applications to resources running in a separate domain. A partilha de recursos de origem cruzada (CORS) permite que um Access-Control-Allow-Origin cabeçalho declare quais as origens que podem chamar pontos finais na sua aplicação de função.Cross-origin resource sharing (CORS) lets an Access-Control-Allow-Origin header declare which origins are allowed to call endpoints on your function app.

PortalPortal

Quando configurar a lista de origens permitidas para a sua aplicação de função, o Access-Control-Allow-Origin cabeçalho é automaticamente adicionado a todas as respostas dos pontos finais HTTP na sua aplicação de função.When you configure the Allowed origins list for your function app, the Access-Control-Allow-Origin header is automatically added to all responses from HTTP endpoints in your function app.

Configurar a lista DE CORS da app de funções configurar

Quando o wildcard * é usado, todos os outros domínios são ignorados.When the wildcard (*) is used, all other domains are ignored.

Utilize o az functionapp cors add comando para adicionar um domínio à lista de origens permitidas.Use the az functionapp cors add command to add a domain to the allowed origins list. O seguinte exemplo adiciona o domínio contoso.com:The following example adds the contoso.com domain:

az functionapp cors add --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--allowed-origins https://contoso.com

Utilize o az functionapp cors show comando para listar as origens atuais permitidas.Use the az functionapp cors show command to list the current allowed origins.

AutenticaçãoAuthentication

Configurar a autenticação para uma aplicação de função

Quando as funções utilizarem um gatilho HTTP, pode exigir que as chamadas sejam autenticadas primeiro.When functions use an HTTP trigger, you can require calls to first be authenticated. O App Service suporta a autenticação e o sômposições do Azure Ative Directory com fornecedores sociais, como facebook, Microsoft e Twitter.App Service supports Azure Active Directory authentication and sign-in with social providers, such as Facebook, Microsoft, and Twitter. Para obter detalhes sobre a configuração de fornecedores de autenticação específica, consulte a visão geral da autenticação do Azure App Service.For details on configuring specific authentication providers, see Azure App Service authentication overview.

Próximos passosNext steps