Gerenciar seu aplicativo de função

No Azure Functions, um aplicativo de função fornece o contexto de execução para suas funções individuais. Os comportamentos do aplicativo de função aplicam-se a todas as funções hospedadas por um determinado aplicativo de função. Todas as funções em um aplicativo de função devem ser do mesmo idioma.

As funções individuais em um aplicativo de função são implantadas juntas e dimensionadas juntas. Todas as funções no mesmo aplicativo de função compartilham recursos, por instância, à medida que o aplicativo de função é dimensionado.

Cadeias de conexão, variáveis de ambiente e outras configurações de aplicativo são definidas separadamente para cada aplicativo de função. Todos os dados que devem ser compartilhados entre aplicativos de função devem ser armazenados externamente em um repositório persistente.

Introdução ao portal do Azure

Nota

Devido às limitações na edição do código de função no portal do Azure, você deve desenvolver suas funções localmente e publicar seu projeto de código em um aplicativo de função no Azure. Para obter mais informações, consulte Limitações de desenvolvimento no portal do Azure

Para visualizar as configurações do aplicativo em seu aplicativo de função, siga estas etapas:

1. Inicie sessão no portal do Azure com a sua conta do Azure. Procure seu aplicativo de função e selecione-o.

2. No painel esquerdo da sua aplicação de funções, expanda Definições, selecione Variáveis de ambiente e, em seguida, selecione o separador Definições da aplicação.

   

Trabalhar com configurações de aplicativos

Além das configurações de aplicativo predefinidas usadas pelo Azure Functions, você pode criar qualquer número de configurações de aplicativo, conforme exigido pelo seu código de função. Para obter mais informações, consulte Referência de configurações de aplicativo para o Azure Functions.

Essas configurações são armazenadas criptografadas. Para obter mais informações, consulte Segurança das configurações do aplicativo.

Você pode gerenciar as configurações do aplicativo no portal do Azure e usando a CLI do Azure e o Azure PowerShell. Você também pode gerenciar configurações de aplicativo do Visual Studio Code e do Visual Studio.

Portal do Azure

Para ver as definições da sua aplicação, consulte Introdução ao portal do Azure.

A guia Configurações do aplicativo mantém as configurações que são usadas pelo seu aplicativo de função:

1. Para ver os valores das configurações do aplicativo, selecione Mostrar valores.

2. Para adicionar uma configuração, selecione + Adicionar e insira o Nome e o Valor do novo par chave-valor.

   

CLI do Azure

O az functionapp config appsettings list comando retorna as configurações existentes do aplicativo, por exemplo:

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 configuração do aplicativo. O exemplo a seguir cria uma configuração com uma chave nomeada CUSTOM_FUNCTION_APP_SETTING e um valor de 12345:

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

Azure PowerShell

O Get-AzFunctionAppSetting cmdlet retorna as configurações existentes do aplicativo, por exemplo:

Get-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME>

O Update-AzFunctionAppSetting comando adiciona ou atualiza uma configuração do aplicativo. O exemplo a seguir cria uma configuração com uma chave nomeada CUSTOM_FUNCTION_APP_SETTING e um valor de 12345:

Update-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME> -AppSetting @{"CUSTOM_FUNCTION_APP_SETTING" = "12345"}

Usar configurações do aplicativo

Os valores das configurações do aplicativo de função também podem ser lidos em seu código como variáveis de ambiente. Para obter mais informações, consulte a seção Variáveis de ambiente destes artigos de referência específicos do idioma:

• C# pré-compilado
• Script C# (.csx)
• Java
• JavaScript
• PowerShell
• Python

Ao desenvolver um aplicativo de função localmente, você deve manter cópias locais desses valores no arquivo de projeto local.settings.json . Para obter mais informações, consulte Arquivo de configurações locais.

Configurações de implantação de FTPS

O Azure Functions dá suporte à implantação de código de projeto em seu aplicativo de função usando FTPS. Como esse método de implantação exige que você sincronize gatilhos, ele não é recomendado. Para transferir arquivos de projeto com segurança, use sempre FTPS e não FTP.

Para obter as credenciais necessárias para a implantação de FTPS, use um destes métodos:

Portal do Azure

Você pode obter as credenciais de publicação FTPS no portal do Azure baixando o perfil de publicação para seu aplicativo de função.

Importante

O perfil de publicação contém credenciais de segurança importantes. Proteja sempre o ficheiro transferido no seu computador local.

Para baixar o perfil de publicação do seu aplicativo de função:

1. Selecione a página Visão geral do aplicativo de função e, em seguida, selecione Obter perfil de publicação.

   

2. Salve e copie o conteúdo do arquivo.

3. No arquivo, localize o publishProfile elemento com o atributo publishMethod="FTP". Neste elemento, os publishUrlatributos , userName, e userPWD contêm a URL de destino e as credenciais para publicação de FTPS.

CLI do Azure

Execute este comando da CLI do Azure que retorna as credenciais FTPS do perfil de publicação.

az functionapp deployment list-publishing-profiles --name <APP_NAME> --resource-group <GROUP_NAME> --query "[?publishMethod=='FTP'].{URL:publishUrl, username:userName, password:userPWD}" -o table

Neste exemplo, substitua <APP_NAME> pelo nome do aplicativo de função e <GROUP_NAME> pelo grupo de recursos. As colunas retornadas URL, username, e password contêm a URL de destino e as credenciais para publicação de FTPS.

Azure PowerShell

Execute este comando do Azure PowerShell que retorna as credenciais FTPS do perfil de publicação.

$profile = [xml](Get-AzWebAppPublishingProfile -ResourceGroupName "<GROUP_NAME>" -Name "<APP_NAME>" -Format "Ftp") 
$profile.publishData.publishProfile | Where-Object -Property publishMethod -eq Ftp | Select-Object -Property @{Name="URL"; Expression = {$_.publishUrl}}, 
@{Name="username"; Expression = {$_.userName}}, @{Name="password"; Expression = {$_.userPWD}} | Format-Table

Neste exemplo, substitua <APP_NAME> pelo nome do aplicativo de função e <GROUP_NAME> pelo grupo de recursos. As colunas retornadas URL, username, e password contêm a URL de destino e as credenciais para publicação de FTPS.

Tipo de plano de hospedagem

Ao criar um aplicativo funcional, você também cria um plano de hospedagem no qual o aplicativo é executado. Um plano pode ter um ou mais aplicativos funcionais. A funcionalidade, o dimensionamento e o preço das suas funções dependem do tipo de plano. Para obter mais informações, veja Opções de alojamento das Funções do Azure.

Você pode determinar o tipo de plano que está sendo usado pelo seu aplicativo de função no portal do Azure ou usando a CLI do Azure ou as APIs do Azure PowerShell.

Os seguintes valores indicam o tipo de plano:

Tipo de plano	Portal do Azure	CLI do Azure/PowerShell
Consumo	Consumo	Dynamic
Premium	Elástico Premium	ElasticPremium
Dedicado (Serviço de Aplicativo)	Vários	Vários

Portal do Azure

1. Para determinar o tipo de plano usado pelo seu aplicativo de função, consulte o Plano do Serviço de Aplicativo na página Visão geral do aplicativo de função no portal do Azure.

   

2. Para ver o nível de preço, selecione o nome do Plano do Serviço de Aplicativo e selecione Propriedades de Configurações > no painel esquerdo.

CLI do Azure

Execute o seguinte comando da CLI do Azure para obter o tipo de plano de hospedagem:

functionApp=<FUNCTION_APP_NAME>
resourceGroup=FunctionMonitoringExamples
appServicePlanId=$(az functionapp show --name $functionApp --resource-group $resourceGroup --query appServicePlanId --output tsv)
az appservice plan list --query "[?id=='$appServicePlanId'].sku.tier" --output tsv

No exemplo anterior, substitua <RESOURCE_GROUP> e <FUNCTION_APP_NAME> pelos nomes de aplicativo de grupo de recursos e função, respectivamente.

Azure PowerShell

Execute o seguinte comando do Azure PowerShell para obter seu tipo de plano de hospedagem:

$FunctionApp = '<FUNCTION_APP_NAME>'
$ResourceGroup = '<RESOURCE_GROUP>'

$PlanID = (Get-AzFunctionApp -ResourceGroupName $ResourceGroup -Name $FunctionApp).AppServicePlan
(Get-AzFunctionAppPlan -Name $PlanID -ResourceGroupName $ResourceGroup).SkuTier

No exemplo anterior, substitua <RESOURCE_GROUP> e <FUNCTION_APP_NAME> pelos nomes de aplicativo de grupo de recursos e função, respectivamente.

Planejar a migração

Você pode migrar um aplicativo de função entre um plano de consumo e um plano Premium no Windows. Ao migrar entre planos, tenha em mente as seguintes considerações:

• A migração direta para um plano Dedicado (Serviço de Aplicativo) não é suportada.
• A migração não é suportada no Linux.
• O plano de origem e o plano de destino devem estar no mesmo grupo de recursos e região geográfica. Para obter mais informações, consulte Mover um aplicativo para outro plano do Serviço de Aplicativo.
• Os comandos específicos da CLI dependem da direção da migração.
• O tempo de inatividade em suas execuções de função ocorre quando o aplicativo de função é migrado entre planos.
• O estado e outro conteúdo específico do aplicativo são mantidos, porque o mesmo compartilhamento de Arquivos do Azure é usado pelo aplicativo antes e depois da migração.

Você pode migrar seu plano usando estas ferramentas:

Portal do Azure

Você pode usar o portal do Azure para alternar para um plano diferente.

CLI do Azure

Você pode usar os comandos da CLI do Azure para criar manualmente um novo plano, alternar seu aplicativo para usar o novo plano e excluir o plano original.

Azure PowerShell

Você pode usar os comandos do Azure PowerShell para criar manualmente um novo plano, alternar seu aplicativo para usar o novo plano e excluir o plano original.

Escolha a direção da migração para seu aplicativo no Windows.

Consumo para Premium

1. No portal do Azure, navegue até o aplicativo Plano de consumo e escolha Alterar plano do Serviço de Aplicativo em Plano do Serviço de Aplicativo.

2. Selecione Premium em Tipo de plano, crie um novo plano Premium e selecione OK.

Para obter mais informações, consulte Mover um aplicativo para outro plano do Serviço de Aplicativo.

Premium-to-Consumo

1. No portal do Azure, navegue até seu aplicativo de plano Premium e escolha Alterar plano do Serviço de Aplicativo em Plano do Serviço de Aplicativo.

2. Selecione Consumo em Tipo de plano, crie um novo plano de consumo e selecione OK.

Para obter mais informações, consulte Mover um aplicativo para outro plano do Serviço de Aplicativo.

Consumo para Premium

Use o procedimento a seguir para migrar de um plano de consumo para um plano Premium no Windows:

1. Execute o comando az functionapp create da seguinte forma para criar um novo plano do Serviço de Aplicativo (Elastic Premium) na mesma região e grupo de recursos que seu aplicativo de função existente:

   az functionapp plan create --name <NEW_PREMIUM_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP> --location <REGION> --sku EP1
   

2. Execute o comando az functionapp update da seguinte forma para migrar o aplicativo de função existente para o novo plano Premium:

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_PREMIUM_PLAN>
   

3. Quando você não precisar mais do plano de consumo usado originalmente pelo aplicativo, exclua seu plano original depois de confirmar que migrou com sucesso para o novo. Execute o comando az functionapp plan list da seguinte forma para obter uma lista de todos os planos de consumo no seu grupo de recursos:

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='Y'].{PlanName:name,Sites:numberOfSites}" -o table
   

   Você pode excluir com segurança o plano com zero sites, que é aquele do qual você migrou.

4. Execute o comando az functionapp plan delete da seguinte forma para excluir o plano de consumo do qual você migrou.

   az functionapp plan delete --name <CONSUMPTION_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP>
   

Premium-to-Consumo

Use o procedimento a seguir para migrar de um plano Premium para um plano de Consumo no Windows:

1. Execute o comando az functionapp create da seguinte forma para criar um novo aplicativo de função (Consumo) na mesma região e grupo de recursos que seu aplicativo de função existente. Este comando também cria um novo plano de consumo no qual o aplicativo de função é executado:

   az functionapp create --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --consumption-plan-location <REGION> --runtime <LANGUAGE_RUNTIME> --functions-version 4 --storage-account <STORAGE_NAME>
   

2. Execute o comando az functionapp show da seguinte forma para obter o nome do plano de consumo criado com o novo aplicativo de função:

   az functionapp show --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --query "{appServicePlanId}" -o tsv
   

   O nome do plano de consumo é o segmento final do ID de recurso totalmente qualificado que é retornado.

3. Execute o comando az functionapp update da seguinte forma para migrar o aplicativo de função existente para o novo plano de consumo:

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_CONSUMPTION_PLAN> --force
   

4. Execute o comando az functionapp delete da seguinte forma para excluir o aplicativo de função que você criou na etapa 1, já que você só precisa do plano que foi criado para executar o aplicativo de função existente:

   az functionapp delete --name <NEW_CONSUMPTION_APP_NAME> --resource-group <MY_RESOURCE_GROUP>
   

5. Quando você não precisar mais do plano Premium usado originalmente pelo aplicativo, exclua seu plano original depois de confirmar que migrou com sucesso para o novo. Até que o plano Premium seja excluído, você continuará a ser cobrado por ele. Execute o comando az functionapp plan list da seguinte forma para obter uma lista de todos os planos Premium no seu grupo de recursos:

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='EP'].{PlanName:name,Sites:numberOfSites}" -o table
   

6. Execute o comando az functionapp plan delete da seguinte forma para excluir o plano Premium do qual você migrou:

   az functionapp plan delete --name <PREMIUM_PLAN> --resource-group <MY_RESOURCE_GROUP>
   

Consumo para Premium

Use o procedimento a seguir para migrar de um plano de consumo para um plano Premium no Windows:

1. Execute o comando New-AzFunctionAppPlan da seguinte forma para criar um novo plano do Serviço de Aplicativo (Elastic Premium) na mesma região e grupo de recursos que seu aplicativo de função existente:

   New-AzFunctionAppPlan -Name <NEW_PREMIUM_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Location <REGION> -Sku EP1 -WorkerType Windows
   

2. Execute o comando Update-AzFunctionApp da seguinte forma para migrar o aplicativo de função existente para o novo plano Premium:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_PREMIUM_PLAN> -Force
   

3. Quando não precisar mais do plano de consumo usado originalmente pelo aplicativo, você poderá executar o comando Remove-AzFunctionAppPlan da seguinte forma para excluir o plano de consumo do qual migrou:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

Premium-to-Consumo

Use o procedimento a seguir para migrar de um plano Premium para um plano de Consumo no Windows:

1. Execute o comando New-AzFunctionApp da seguinte forma para criar um novo aplicativo de função (Consumo) na mesma região e grupo de recursos que seu aplicativo de função existente. Este comando também cria um novo plano de consumo no qual o aplicativo de função é executado:

   New-AzFunctionApp -Name <NEW_CONSUMPTION_APP_NAME> -StorageAccountName <STORAGE_NAME> -Location <REGION> -ResourceGroupName <MY_RESOURCE_GROUP> -Runtime <LANGUAGE_RUNTIME> -RuntimeVersion <LANGUAGE_VERSION> -FunctionsVersion 4 -OSType Windows
   

2. Execute o comando Get-AzFunctionApp da seguinte forma para obter o nome do plano de consumo criado com o novo aplicativo de função:

   Get-AzFunctionApp -ResourceGroupName <MY_RESOURCE_GROUP> -Name <NEW_CONSUMPTION_APP_NAME> | Select-Object -Property AppServicePlan | Format-List
   

3. Execute o comando Update-AzFunctionApp da seguinte forma para migrar o aplicativo de função existente para o novo plano de consumo:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_CONSUMPTION_PLAN> -Force
   

4. Quando não precisar mais do plano de consumo usado originalmente pelo aplicativo, você poderá executar o comando Remove-AzFunctionAppPlan da seguinte forma para excluir o plano de consumo do qual migrou:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

Obtenha as teclas de acesso à sua função

As funções acionadas por HTTP geralmente podem ser chamadas usando uma URL no formato: https://<APP_NAME>.azurewebsites.net/api/<FUNCTION_NAME>. Quando a autorização para sua função é definida um valor diferente de anonymous, você também deve fornecer uma chave de acesso em sua solicitação. A chave de acesso pode ser fornecida na URL usando a cadeia de caracteres de ?code= consulta ou no cabeçalho da solicitação. Para obter mais informações, consulte Teclas de acesso de função. Existem várias formas de obter as suas chaves de acesso.

Portal do Azure

1. Entre no portal do Azure e, em seguida, procure e selecione Aplicativo de função.

2. Selecione a função que deseja verificar.

3. No painel esquerdo, expanda Funções e selecione Teclas do aplicativo.

   A página Chaves do aplicativo é exibida. Nesta página são exibidas as chaves de host, que podem ser usadas para acessar qualquer função no aplicativo. A chave do sistema também é exibida, o que dá a qualquer pessoa acesso em nível de administrador a todas as APIs de aplicativos funcionais.

Você também pode praticar privilégios mínimos usando a tecla para uma função específica. Para fazer isso, selecione Teclas de função em Desenvolvedor em sua função acionada por HTTP.

CLI do Azure

Execute o seguinte script no Azure Cloud Shell, cuja saída é a chave padrão (host) que pode ser usada para acessar qualquer função acionada HTTP no aplicativo de função.

subName='<SUBSCRIPTION_ID>'
resGroup=AzureFunctionsContainers-rg
appName=glengagtestdocker
path=/subscriptions/$subName/resourceGroups/$resGroup/providers/Microsoft.Web/sites/$appName/host/default/listKeys?api-version=2018-11-01
az rest --method POST --uri $path --query functionKeys.default --output tsv

Neste script, substitua <SUBSCRIPTION_ID> e <APP_NAME> pelo ID da sua assinatura e pelo nome do aplicativo da função, respetivo. Este script é executado no Bash no Cloud Shell. Ele deve ser modificado para ser executado em um prompt de comando do Windows.

Azure PowerShell

Execute o script a seguir, cuja saída é a chave padrão (host) que pode ser usada para acessar qualquer função acionada HTTP no aplicativo de função.

$subName = '<SUBSCRIPTION_ID>'
$rGroup = 'AzureFunctionsContainers-rg'
$appName = '<APP_NAME>'
$path = "/subscriptions/$subName/resourceGroups/$rGroup/providers/Microsoft.Web/sites/$appName/host/default/listKeys?api-version=2018-11-01"
((Invoke-AzRestMethod -Path $path -Method POST).Content | ConvertFrom-JSON).functionKeys.default

Neste script, substitua <SUBSCRIPTION_ID> e <APP_NAME> pelo ID da sua subscrição e do nome da sua aplicação funcional, respetivamente.

Limitações de desenvolvimento no portal do Azure

Considere estas limitações ao desenvolver suas funções no portal do Azure:

• A edição no portal é suportada apenas para funções que foram criadas ou modificadas pela última vez no portal do Azure.
• A edição no portal é suportada apenas para funções JavaScript, PowerShell, Python e C# Script.
• A edição no portal não é suportada na versão de pré-visualização do plano Flex Consumption.
• Quando você implanta código em um aplicativo de função de fora do portal do Azure, não pode mais editar nenhum código para esse aplicativo de função no portal. Neste caso, basta continuar a utilizar o desenvolvimento local.
• Para funções C# compiladas e funções Java, você pode criar o aplicativo de função e recursos relacionados no portal. No entanto, você deve criar o projeto de código de funções localmente e, em seguida, publicá-lo no Azure.

Quando possível, desenvolva suas funções localmente e publique seu projeto de código em um aplicativo de função no Azure. Para obter mais informações, consulte Codificar e testar o Azure Functions localmente.

Instalar extensões manualmente

As funções da biblioteca de classes C# podem incluir os pacotes NuGet para extensões de vinculação diretamente no projeto da biblioteca de classes. Para outras linguagens non-.NET e script C#, você deve usar pacotes de extensão. Se tiver de instalar manualmente extensões, pode fazê-lo utilizando localmente as Ferramentas Principais do Azure Functions. Se você não pode usar pacotes de extensão e só pode trabalhar no portal, você precisa usar Ferramentas Avançadas (Kudu) para criar manualmente o arquivo extensions.csproj diretamente no site. Certifique-se de remover primeiro o extensionBundle elemento do arquivo host.json .

Esse mesmo processo funciona para qualquer outro arquivo que você precise adicionar ao seu aplicativo.

Importante

Quando possível, não edite arquivos diretamente em seu aplicativo de função no Azure. Recomendamos baixar os arquivos do aplicativo localmente, usar as Ferramentas Principais para instalar extensões e outros pacotes, validar as alterações e, em seguida , republicar seu aplicativo usando as Ferramentas Principais ou um dos outros métodos de implantação suportados.

O editor de Funções incorporado no portal do Azure permite-lhe atualizar o código de função e os ficheiros de configuração diretamente no portal:

1. Selecione seu aplicativo de função e, em Funções, selecione Funções.

2. Escolha sua função e selecione Código + teste em Desenvolvedor.

3. Escolha seu arquivo para editar e selecione Salvar quando terminar.

Os arquivos na raiz do aplicativo, como function.proj ou extensions.csproj, precisam ser criados e editados usando as Ferramentas Avançadas (Kudu):

1. Selecione seu aplicativo de função, expanda Ferramentas de desenvolvimento e, em seguida, selecione Ferramentas>avançadas Ir.

2. Se solicitado, entre no site do Gerenciador de Controle do Código-Fonte (SCM) com suas credenciais do Azure.

3. No menu Depurar console , escolha CMD.

4. Navegue até .\site\wwwroot, selecione o botão de adição (+) na parte superior e selecione Novo arquivo.

5. Dê um nome ao arquivo, como extensions.csproj, e pressione Enter.

6. Selecione o botão de edição ao lado do novo arquivo, adicione ou atualize o código no arquivo e selecione Salvar.

7. Para um arquivo de projeto como extensions.csproj, execute o seguinte comando para reconstruir o projeto de extensões:

   dotnet build extensions.csproj
   

Funcionalidades de plataforma

Os aplicativos de função são executados na plataforma do Serviço de Aplicativo do Azure, que os mantém. Como tal, as suas aplicações funcionais têm acesso à maioria das funcionalidades da principal plataforma de alojamento Web do Azure. Quando você usa o portal do Azure, o painel esquerdo é onde você acessa os vários recursos da plataforma do Serviço de Aplicativo que você pode usar em seus aplicativos de função.

A matriz a seguir indica o suporte a recursos do portal do Azure por plano de hospedagem e sistema operacional:

Caraterística	Plano de consumo	Plano Premium	Plano dedicado
Ferramentas avançadas (Kudu)	Janelas: ✔ Linux: X	✔	✔
Editor do Serviço de Aplicativo	Janelas: ✔ Linux: X	Janelas: ✔ Linux: X	Janelas: ✔ Linux: X
Cópias de segurança	X	X	✔
Consola	Windows: linha de comando Linux: X	Windows: linha de comando Linux: SSH	Windows: linha de comando Linux: SSH

O restante deste artigo se concentra nos seguintes recursos no portal que são úteis para seus aplicativos de função:

• Editor do Serviço de Aplicativo
• Consola
• Ferramentas avançadas (Kudu)
• Opções de implementação
• CORS
• Autenticação

Para obter mais informações sobre como trabalhar com as configurações do Serviço de Aplicativo, consulte Definir configurações do Serviço de Aplicativo do Azure.

Editor do Serviço de Aplicativo

O editor do Serviço de Aplicativo é um editor avançado no portal que você pode usar para modificar arquivos de configuração JSON e arquivos de código. Escolher esta opção abre uma guia separada do navegador com um editor básico. Este editor permite que você se integre ao repositório Git, execute e depure código e modifique as configurações do aplicativo de função. Este editor fornece um ambiente de desenvolvimento aprimorado para suas funções em comparação com o editor de funções integrado.

Recomendamos que considere desenvolver as suas funções no seu computador local. Quando você desenvolve localmente e publica no Azure, seus arquivos de projeto são somente leitura no portal do Azure. Para obter mais informações, consulte Codificar e testar o Azure Functions localmente.

Consola

O console no portal é uma ferramenta de desenvolvedor ideal quando você prefere interagir com seu aplicativo de função a partir da linha de comando. Os comandos comuns incluem a criação e navegação de diretórios e arquivos, bem como a execução de arquivos em lote e scripts.

Ao desenvolver localmente, recomendamos usar as Ferramentas Principais do Azure Functions e a CLI do Azure.

Ferramentas avançadas (Kudu)

As ferramentas avançadas para o Serviço de Aplicativo (também conhecido como Kudu) fornecem acesso a recursos administrativos avançados do seu aplicativo de função. A partir do Kudu, você gerencia informações do sistema, configurações do aplicativo, variáveis de ambiente, extensões de site, cabeçalhos HTTP e variáveis de servidor. Você também pode iniciar o Kudu navegando até o ponto de extremidade SCM para seu aplicativo de função, por exemplo: https://<myfunctionapp>.scm.azurewebsites.net/.

Centro de Implementação

Quando você usa uma solução de controle do código-fonte para desenvolver e manter seu código de funções, o Centro de Implantação permite criar e implantar a partir do controle do código-fonte. Seu projeto é criado e implantado no Azure quando você faz atualizações. Para obter mais informações, consulte Tecnologias de implantação no Azure Functions.

Partilha de recursos de várias origens

Para evitar a execução de códigos mal-intencionados no cliente, os navegadores modernos bloqueiam solicitações de aplicativos da Web para recursos executados em um domínio separado. O compartilhamento de recursos entre origens (CORS) permite que um Access-Control-Allow-Origin cabeçalho declare quais origens têm permissão para chamar pontos de extremidade em seu aplicativo de função.

Portal do Azure

Quando você configura a lista Origens permitidas para seu aplicativo de função, o Access-Control-Allow-Origin cabeçalho é adicionado automaticamente a todas as respostas de pontos de extremidade HTTP em seu aplicativo de função.

Se houver outra entrada de domínio, o curinga (*) será ignorado.

CLI do Azure

Use o az functionapp cors add comando para adicionar um domínio à lista de origens permitidas. O exemplo a seguir adiciona o domínio contoso.com:

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

Use o az functionapp cors show comando para listar as origens permitidas atuais.

Azure PowerShell

No momento, não é possível atualizar as configurações do CORS usando o Azure PowerShell.

Autenticação

Quando as funções usam um gatilho HTTP, você pode exigir que as chamadas sejam autenticadas primeiro. O Serviço de Aplicativo oferece suporte à autenticação e entrada do Microsoft Entra com provedores sociais, como Facebook, Microsoft e Twitter. Para obter informações sobre como configurar provedores de autenticação específicos, consulte Visão geral da autenticação do Serviço de Aplicativo do Azure.

Conteúdos relacionados

• Configurar um aplicativo do Serviço de Aplicativo
• Implementação contínua para Funções do Azure