Criar e gerenciar aplicativos de funções no plano de Consumo Flex

Este artigo mostra como criar aplicativos de funções hospedados no do plano de Consumo Flex do no Azure Functions. Ele também mostra como gerenciar determinados recursos de um aplicativo hospedado do plano de Consumo Flex.

Os recursos do aplicativo de funções são específicos da linguagem. Escolha sua linguagem de desenvolvimento de código preferencial no início do artigo.

Importante

O plano de Consumo Flex está atualmente em versão preliminar.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se ainda não tem uma, crie uma conta gratuita.

• CLI do Azure: usada para criar e gerenciar recursos no Azure. Ao usar a CLI do Azure em seu computador local, use a versão 2.60.0 ou uma versão posterior. Você também pode usar o Azure Cloud Shell, que tem a versão correta da CLI do Azure.

• Visual Studio Code: usado para criar e desenvolver aplicativos, criar recursos do Azure e implantar projetos de código no Azure. Ao usar o Visual Studio Code, instale também a extensão do Azure Functions mas recente. Você também pode instalar o pacote de extensão de Ferramentas do Azure.

• Embora não seja necessário criar um aplicativo de plano de Consumo Flex, você precisa de um projeto de código para poder implantar e validar um novo aplicativo de funções. Conclua a primeira parte de um destes artigos de início rápido, em que você cria um projeto de código com uma função disparada por HTTP:

  • Criar um projeto do Azure Functions da linha de comando
  • Criar um projeto do Azure Functions usando o Visual Studio Code
  • Criar um projeto do Azure Functions da linha de comando
  • Criar um projeto do Azure Functions usando o Visual Studio Code
  • Criar um projeto do Azure Functions da linha de comando
  • Criar um projeto do Azure Functions usando o Visual Studio Code

  Para criar um aplicativo em um novo plano de Consumo Flex durante uma implantação do Maven, você deve criar seu projeto de aplicativo local e atualizar o arquivo pom.xml do projeto. Para obter mais informações, consulte Criar um aplicativo de Consumo Java Flex usando o Maven

  • Criar um projeto do Azure Functions da linha de comando
  • Criar um projeto do Azure Functions usando o Visual Studio Code
  • Criar um projeto do Azure Functions da linha de comando
  • Criar um projeto do Azure Functions usando o Visual Studio Code
  • Criar um projeto do Azure Functions da linha de comando
  • Criar um projeto do Azure Functions usando o Visual Studio Code

  Retorne a este artigo depois de criar e executar o projeto local, mas antes de ser solicitado a criar recursos do Azure. Você cria o aplicativo de funções e outros recursos do Azure na próxima seção.

Criar um aplicativo de Consumo Flex

Esta seção mostra como criar um aplicativo de funções no plano de Consumo Flex usando a CLI do Azure, o portal do Azure ou o Visual Studio Code. Para obter um exemplo de criação de um aplicativo em um plano de consumo flex usando modelos Bicep/ARM, consulte o repositório de Consumo Flex.

Você pode ignorar esta seção se optar por criar e implantar seu aplicativo usando o Maven.

Para dar suporte ao código de função, você precisa criar três recursos:

• Um grupo de recursos, que é um contêiner lógico para recursos relacionados.
• Uma conta de armazenamento, que é usada para manter o estado e outras informações sobre suas funções.
• Um aplicativo de funções no plano de Consumo Flex, que fornece o ambiente para executar seu código de função. Um aplicativo de funções é mapeado para seu projeto de função local e permite agrupar funções como uma unidade lógica para facilitar o gerenciamento, a implantação e o compartilhamento de recursos no plano de Consumo Flex.

CLI do Azure

1. Se você ainda não tiver feito isso, entre no Azure:

   az login
   

   O comando az login conecta você à conta do Azure.

2. Use o comando az functionapp list-flexconsumption-locations para examinar a lista de regiões que atualmente dão suporte ao Consumo Flex.

   az functionapp list-flexconsumption-locations --output table
   

3. Crie um grupo de recursos em uma das regiões com suporte no momento:

   az group create --name <RESOURCE_GROUP> --location <REGION>
   

   No comando acima, substitua <RESOURCE_GROUP> por um valor exclusivo em sua assinatura e <REGION> por uma das regiões com suporte no momento. O comando az group create cria um grupo de recursos.

4. Crie uma conta de armazenamento para uso geral no grupo de recursos e na região:

   az storage account create --name <STORAGE_NAME> --location <REGION> --resource-group <RESOURCE_GROUP> --sku Standard_LRS --allow-blob-public-access false
   

   No exemplo anterior, substitua <STORAGE_NAME> por um nome que seja apropriado para você e exclusivo no Armazenamento do Azure. Os nomes devem conter de 3 a 24 caracteres e podem conter somente números e letras minúsculas. Standard_LRS especifica uma conta de uso geral, que é compatível com o Functions. O comando az storage account create cria a conta de armazenamento.

   Importante

   A conta de armazenamento é usada para armazenar dados importantes do aplicativo, às vezes incluindo o próprio código do aplicativo. Você deve limitar o acesso de outros aplicativos e usuários à conta de armazenamento.

5. Criar o aplicativo de funções no Azure:

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime dotnet-isolated --runtime-version 8.0 
   

   aplicativos C# que executam em processo não têm suporte no momento durante a execução em um plano de Consumo Flex.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime java --runtime-version 17 
   

   Para aplicativos Java, o Java 11 também tem suporte no momento.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime node --runtime-version 20 
   

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime python --runtime-version 3.11 
   

   Para aplicativos Python, o Python 3.10 também tem suporte no momento.

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime powershell --runtime-version 7.4 
   

   Neste exemplo, substitua <RESOURCE_GROUP> e <STORAGE_NAME> pelo grupo de recursos e pelo nome da conta usada na etapa anterior, respectivamente. Substitua também <APP_NAME> por um nome globalmente exclusivo apropriado para você. O <APP_NAME> também é o domínio DNS (servidor de nomes de domínio) padrão para o aplicativo de funções. O comando az functionapp create cria o aplicativo de funções no Azure.

   Esse comando cria um aplicativo de funções em execução no plano de Consumo Flex. A versão de runtime de idioma específica usada é uma que atualmente tem suporte na versão prévia.

   Como você criou o aplicativo sem especificar instâncias sempre prontas, seu aplicativo só incorre em custos ao executar ativamente funções. O comando também cria uma instância associada do Azure Application Insights no mesmo grupo de recursos, com o qual será possível monitorar o aplicativo de funções e exibir os logs. Para saber mais, consulte Monitorar Azure Functions.

Portal do Azure

1. No portal do Azure, no menu ou na Página inicial, selecione Criar um recurso.

2. Selecione Introdução e, em seguida, Criar em Aplicativo de Funções.

3. Em Selecione uma opção de hospedagem, escolha Consumo Flex>Selecionar.

4. Na página Informações básicas, use as configurações do aplicativo de funções conforme especificado na seguinte tabela:

   Configuração	Valor sugerido	Descrição
   Assinatura	Sua assinatura	A assinatura na qual você cria seu novo aplicativo de funções.
   Grupo de Recursos	myResourceGroup	Nome do novo grupo de recursos no qual você cria o aplicativo de funções.
   Nome do aplicativo de funções	Nome globalmente exclusivo	Nome que identifica seu novo aplicativo de funções. Os caracteres válidos são a-z (não diferencia maiúsculas de minúsculas), 0-9 e -.
   Região	Região preferencial	Selecione uma região perto de você ou perto de outros serviços que suas funções podem acessar. Regiões sem suporte não são exibidas. Para obter mais informações, consulte Exibir regiões com suporte no momento.
   Pilha de runtime	Linguagem preferencial	Escolha uma das pilhas de runtime de idioma com suporte. Atualmente, a edição no portal usando o Visual Studio Code para a Web só está disponível para aplicativos Node.js, PowerShell e Python. A biblioteca de classes C# e as funções Java devem ser desenvolvidas localmente.
   Versão	Versão da linguagem	Escolha uma versão com suporte da pilha de runtime do idioma.
   Tamanho da instância	Padrão	Determina a quantidade de memória da instância alocada para cada instância do seu aplicativo. Para obter mais informações, consulte memória da Instância.

5. Aceite as opções padrão as guias restantes, incluindo o comportamento padrão de criação de uma nova conta de armazenamento na guia Armazenamento e uma nova instância do Application Insights na guia Monitoramento. Você também pode optar por usar uma conta de armazenamento existente ou uma instância do Application Insights.

6. Selecione Examinar + criar para examinar as configurações do aplicativo escolhidas e selecione Criar para provisionar e implantar o aplicativo de funções.

7. Selecione o ícone Notificações no canto superior direito do portal e veja se a mensagem Implantação concluída com êxito é exibida.

8. Selecione Ir para recursos para exibir o novo aplicativo de funções. Você também pode selecionar Fixar no painel. A fixação torna mais fácil retornar a esse recurso de aplicativo de função no seu painel.

Visual Studio Code

1. Pressione F1 e, no pallet de comando, insira Azure Functions: Criar aplicativo de funções no Azure... (Avançado).

2. Se você não estiver conectado, será solicitado a Entrar no Azure. Você também pode Criar uma conta gratuita do Azure. Após entrar pelo navegador, retorne ao Visual Studio Code.

3. Após os prompts, forneça estas informações:

   Prompt	Seleção
   Insira um nome exclusivo globalmente para o novo aplicativo de funções.	Digite um nome globalmente exclusivo que identifique o novo aplicativo de funções e selecione ENTER. Caracteres válidos para um nome de aplicativo de funções são a-z, 0-9 e -.
   Selecione um plano de hospedagem.	Escolha Consumo Flex (versão prévia).
   Selecione uma pilha de runtime.	Escolha uma das versões de pilha de idiomas com suporte.
   Selecione um grupo de recursos para novos recursos.	Escolha Criar grupo de recursos, digite um nome de grupo de recursos, como myResourceGroup, e selecione ENTER. Você também pode escolher um grupo de recursos existente.
   Selecione uma localização para novos recursos.	Selecione um local em uma região de com suporte perto de você ou perto de outros serviços que suas funções acessam. Regiões sem suporte não são exibidas. Para obter mais informações, consulte Exibir regiões com suporte no momento.
   Selecione uma conta de armazenamento.	Escolha Criar nova conta de armazenamento e, no prompt, forneça um nome global exclusivo para a nova conta de armazenamento usada pelo aplicativo de funções e selecione Enter. Os nomes da conta de armazenamento precisam ter entre 3 e 24 caracteres e podem conter apenas números e letras minúsculas. Você também pode selecionar uma conta existente.
   Selecione um recurso do Application Insights para o seu aplicativo.	Escolha Criar novo recurso do Application Insights e, no prompt, forneça o nome da instância usada para armazenar dados de runtime de suas funções.

   Uma notificação é exibida após a criação do aplicativo de funções. Escolha Exibir Saída nessa notificação para exibir a criação e os resultados da implantação, incluindo os recursos do Azure que você criou.

Implantar seu projeto de código

Você pode ignorar esta seção se optar por criar e implantar seu aplicativo usando o Maven.

Você pode optar por implantar o código do projeto em um aplicativo de funções existente usando várias ferramentas:

Visual Studio Code

Importante

A implantação em um aplicativo de funções existente sempre substitui o conteúdo do aplicativo no Azure.

1. Na paleta de comandos, pesquise e execute o comando Azure Functions: Deploy to Function App....

2. Selecione o aplicativo de funções que você acabou de criar. Quando solicitado sobre a substituição de implantações anteriores, selecione Implantar para implantar seu código de função no novo recurso do aplicativo de funções.

3. Após a conclusão da implantação, escolha Exibir Saída para ver a criação e os resultados da implantação, incluindo os recursos do Azure que você criou. Se você perder a notificação, selecione o ícone de sino no canto inferior direito para vê-lo novamente.

   

Ferramentas do Core

Na pasta raiz do projeto, execute este comando func azure functionapp publish:

func azure functionapp publish <APP_NAME>

Nesse exemplo, substitua <APP_NAME> pelo nome de seu aplicativo. Uma implantação bem-sucedida mostra resultados semelhantes à seguinte saída (truncada para simplificar):

...

Getting site publishing info...
Creating archive for current directory...
Performing remote build for functions project.

...

Deployment successful.
Remote build succeeded!
Syncing triggers...
Functions in msdocs-azurefunctions-qs:
    HttpExample - [httpTrigger]
        Invoke url: https://msdocs-azurefunctions-qs.azurewebsites.net/api/httpexample

Criar e implantar seu aplicativo usando o Maven

Você pode usar o Maven para criar um aplicativo de funções hospedado por Consumo Flex e recursos necessários durante a implantação modificando o arquivo pom.xml.

1. Crie um projeto de código Java concluindo a primeira parte de um destes artigos de início rápido:

   • Criar um projeto do Azure Functions da linha de comando
   • Criar um projeto do Azure Functions usando o Visual Studio Code

2. Em seu projeto de código Java, abra o arquivo pom.xml e faça estas alterações para criar seu aplicativo de funções no plano de Consumo Flex:

   • Altere o valor de <properties>.<azure.functions.maven.plugin.version> para 1.34.0.

   • Na seção <plugin>.<configuration> do azure-functions-maven-plugin, adicione ou descompacte o elemento <pricingTier> da seguinte maneira:

     <pricingTier>Flex Consumption</pricingTier>
     

3. (Opcional) Personalize o plano de Consumo Flex em sua implantação do Maven incluindo também estes elementos na seção <plugin>.<configuration>: .

   • <instanceSize> – define o tamanho de memória da instância para o aplicativo de funções. O valor padrão é 2048.
   • <maximumInstances> – define o valor mais alto para a contagem máxima de instâncias do aplicativo de funções.
   • <alwaysReadyInstances> - define o contagens de instâncias sempre prontas com elementos filho para grupos de gatilhos HTTP (<http>), grupos de funções duráveis (<durable>) e outros gatilhos específicos (<my_function>). Quando você define qualquer contagem de instâncias maior que zero, você é cobrado por essas instâncias se suas funções são executadas ou não. Para mais informações, consulte Faturamento.

4. Antes de implantar, entre em sua assinatura do Azure usando a CLI do Azure.

   az login
   

   O comando az login conecta você à conta do Azure.

5. Use o comando a seguir para implantar seu projeto de código em um novo aplicativo de funções no Consumo Flex.

   mvn azure-functions:deploy
   

   O Maven usa configurações no modelo de pom.xml para criar seu aplicativo de funções em um plano de Consumo Flex no Azure, juntamente com os outros recursos necessários. Se esses recursos já existirem, o código será implantado em seu aplicativo de funções, substituindo qualquer código existente.

Habilitar a integração de rede virtual

Você pode habilitar integração de rede virtual para seu aplicativo em um plano de Consumo Flex. Os exemplos nesta seção pressupõem que você já criou uma rede virtual com de sub-rede em sua conta. Você pode habilitar a integração de rede virtual ao criar seu aplicativo ou em um momento posterior.

Para habilitar a rede virtual ao criar seu aplicativo:

CLI do Azure

Você pode habilitar a integração de rede virtual executando o comando az functionapp create e incluindo os parâmetros --vnet e --subnet.

1. Criar a rede virtual e a sub-rede, caso ainda não tenha feito isso.

2. Conclua as etapas 1 a 4 em Criar um aplicativo de Consumo Flex para criar os recursos exigidos pelo seu aplicativo.

3. Execute o comando az functionapp create, incluindo os parâmetros --vnet e --subnet, como neste exemplo:

   az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime <RUNTIME_NAME> --runtime-version <RUNTIME_VERSION> --vnet <VNET_RESOURCE_ID> --subnet <SUBNET_NAME>
   

   O valor <VNET_RESOURCE_ID> é a ID do recurso da rede virtual, que está no formato: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCER_GROUP>/providers/Microsoft.Network/virtualNetworks/<VNET_NAME>. Você pode usar esse comando para obter uma lista de IDs de rede virtual, filtradas por <RESOURCE_GROUP>: az network vnet list --resource-group <RESOURCE_GROUP> --output tsv --query "[]".id.

Portal do Azure

Use estas etapas para criar seu aplicativo de funções com integração de rede virtual e recursos relacionados do Azure.

1. No portal do Azure, no menu ou na Página inicial, selecione Criar um recurso.

2. Selecione Introdução e, em seguida, Criar em Aplicativo de Funções.

3. Em Selecione uma opção de hospedagem, escolha Consumo Flex>Selecionar.

4. Na página Informações básicas, use as configurações do aplicativo de funções conforme especificado na seguinte tabela:

   Configuração	Valor sugerido	Descrição
   Assinatura	Sua assinatura	A assinatura na qual você cria seu novo aplicativo de funções.
   Grupo de Recursos	myResourceGroup	Nome do novo grupo de recursos no qual você cria o aplicativo de funções.
   Nome do aplicativo de funções	Nome globalmente exclusivo	Nome que identifica seu novo aplicativo de funções. Os caracteres válidos são a-z (não diferencia maiúsculas de minúsculas), 0-9 e -.
   Região	Região preferencial	Selecione uma região perto de você ou perto de outros serviços que suas funções podem acessar. Regiões sem suporte não são exibidas. Para obter mais informações, consulte Exibir regiões com suporte no momento.
   Pilha de runtime	Linguagem preferencial	Escolha uma das pilhas de runtime de idioma com suporte. Atualmente, a edição no portal usando o Visual Studio Code para a Web só está disponível para aplicativos Node.js, PowerShell e Python. A biblioteca de classes C# e as funções Java devem ser desenvolvidas localmente.
   Versão	Versão da linguagem	Escolha uma versão com suporte da pilha de runtime do idioma.
   Tamanho da instância	Padrão	Determina a quantidade de memória da instância alocada para cada instância do seu aplicativo. Para obter mais informações, consulte memória da Instância.

5. Aceite as opções padrão as guias restantes, incluindo o comportamento padrão de criação de uma nova conta de armazenamento na guia Armazenamento e uma nova instância do Application Insights na guia Monitoramento. Você também pode optar por usar uma conta de armazenamento existente ou uma instância do Application Insights.

6. Na guia Rede, defina Habilitar acesso público para Desativado e Habilitar injeção de rede para Ativado.

7. Para rede virtual, selecione ou crie uma rede virtual que esteja na mesma região que seu aplicativo.

8. Defina Habilitar integração de VNet para Ativado e selecione ou crie uma sub-rede.

9. Selecione Examinar + criar para examinar as configurações do aplicativo escolhidas e selecione Criar para provisionar e implantar o aplicativo de funções com rede virtual.

10. Selecione o ícone Notificações no canto superior direito do portal e veja se a mensagem Implantação concluída com êxito é exibida.

11. Selecione Ir para recursos para exibir o novo aplicativo de funções. Você também pode selecionar Fixar no painel. A fixação torna mais fácil retornar a esse recurso de aplicativo de função no seu painel.

Visual Studio Code

No momento, você não pode habilitar a rede virtual ao usar o Visual Studio Code para criar seu aplicativo.

Para obter exemplos de ponta a ponta de como criar aplicativos no Consumo Flex com integração de rede virtual, consulte estes recursos:

• Consumo Flexível: HTTP para Hubs de Eventos usando a integração VNET
• Consumo Flex: disparado do Barramento de Serviço usando Integração VNET

Para modificar ou excluir a integração de rede virtual em um aplicativo existente:

CLI do Azure

Use o comando az functionapp vnet-integration add para habilitar a integração de rede virtual a um aplicativo de funções existente:

az functionapp vnet-integration add --resource-group <RESOURCE_GROUP> --name <APP_NAME> --vnet <VNET_RESOURCE_ID> --subnet <SUBNET_NAME>

Use o comando az functionapp vnet-integration remove para desabilitar a integração de rede virtual em seu aplicativo:

az functionapp vnet-integration remove --resource-group <RESOURCE_GROUP> --name <APP_NAME>

Use o comando az functionapp vnet-integration list para listar as integrações de rede virtual atuais para seu aplicativo:

az functionapp vnet-integration list --resource-group <RESOURCE_GROUP> --name <APP_NAME>

Portal do Azure

Você pode integrar seu aplicativo existente a uma rede virtual e uma sub-rede existentes no portal.

1. Na página do aplicativo de funções no portal do Azure, expanda Configurações no menu à esquerda e selecione Rede.

2. Em Configuração de tráfego de saída, selecione Não configurado.

3. Na página Integração de rede virtual, selecione Adicionar integração de rede virtual.

4. Selecione uma Rede virtual existente e Sub-rede e selecione Conectar.

Visual Studio Code

No momento, não é possível configurar a rede virtual no Visual Studio Code.

Ao escolher uma sub-rede, essas considerações se aplicam:

• A sub-rede escolhida ainda não pode ser usada para outras finalidades, como pontos de extremidade privados ou pontos de extremidade de serviço, ou ser delegada a qualquer outro plano ou serviço de hospedagem.
• Você pode compartilhar a mesma sub-rede com mais de um aplicativo em execução em um plano de Consumo Flex. Como os recursos de rede são compartilhados em todos os aplicativos, um aplicativo de funções pode afetar o desempenho de outras pessoas na mesma sub-rede.
• Em um plano de Consumo Flex, um único aplicativo de funções pode usar até 40 endereços IP, mesmo quando o aplicativo escala além de 40 instâncias. Embora essa regra geral seja útil ao estimar o tamanho da sub-rede necessária, ela não é estritamente imposta.

Definir configurações de implantação

No plano Consumo Flex, o pacote de implantação que contém o código do aplicativo é mantido em um contêiner do Armazenamento de Blobs do Azure. Por padrão, as implantações usam a mesma conta de armazenamento (AzureWebJobsStorage) e o mesmo valor da cadeia de conexão usados pelo runtime do Functions para manter seu aplicativo. A cadeia de conexão é armazenada na configuração de aplicativo DEPLOYMENT_STORAGE_CONNECTION_STRING. No entanto, você pode designar um contêiner de blob em uma conta de armazenamento separada como a fonte de implantação do código. Você também pode alterar o método de autenticação usado para acessar o contêiner.

Uma fonte de implantação personalizada deve atender a esses critérios:

• A conta de armazenamento já deve existir.
• Também é necessário ter um contêiner que será usado para as implantações, e ele precisa estar vazio.
• Quando mais de um aplicativo usa a mesma conta de armazenamento, cada um deve ter um contêiner de implantação próprio. O uso de um contêiner exclusivo para cada aplicativo impede que os pacotes de implantação sejam substituídos, o que ocorreria se os aplicativos compartilhassem o mesmo contêiner.

Ao configurar a autenticação de armazenamento de implantação, tenha estas considerações em mente:

• Quando você usa uma cadeia de conexão para se conectar à conta de armazenamento de implantação, a configuração do aplicativo que contém a cadeia de conexão já precisa existir.
• Quando você usa uma identidade gerenciada atribuída pelo usuário, a identidade fornecida é vinculada ao aplicativo de funções. A função Storage Blob Data Contributor com escopo para a conta de armazenamento de implantação também é atribuída à identidade.
• Quando você usa uma identidade gerenciada atribuída pelo sistema, é criada uma identidade quando uma identidade atribuída pelo sistema válida ainda não existe no aplicativo. Quando há uma identidade atribuída pelo sistema, a função Storage Blob Data Contributor com escopo para a conta de armazenamento de implantação também é atribuída à identidade.

Para definir as configurações de implantação ao criar seu aplicativo de funções no plano Consumo Flex:

CLI do Azure

Use o comando az functionapp create e forneça estas opções adicionais que personalizam o armazenamento de implantação:

Parâmetro	Descrição
--deployment-storage-name	O nome da conta de armazenamento de implantação.
--deployment-storage-container-name	O nome do contêiner da conta que conterá o pacote de implantação do aplicativo.
--deployment-storage-auth-type	O tipo de autenticação a ser usado para se conectar à conta de armazenamento de implantação. Os valores aceitos incluem StorageAccountConnectionString, UserAssignedIdentity e SystemAssignedIdentity.
--deployment-storage-auth-value	Quando StorageAccountConnectionString é usado, esse parâmetro é definido como o nome da configuração do aplicativo que contém a cadeia de conexão para a conta de armazenamento de implantação. Quando UserAssignedIdentity é usado, esse parâmetro é definido como o nome da ID do recurso da identidade que você deseja usar.

Este exemplo cria um aplicativo de funções no plano Consumo Flex com uma conta de armazenamento de implantação e uma identidade atribuída pelo usuário separadas:

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime dotnet-isolated --runtime-version 8.0 --flexconsumption-location "<REGION>" --deployment-storage-name <DEPLOYMENT_ACCCOUNT_NAME> --deployment-storage-container-name <DEPLOYMENT_CONTAINER_NAME> --deployment-storage-auth-type UserAssignedIdentity --deployment-storage-auth-value <MI_RESOURCE_ID>

Portal do Azure

No momento, não é possível configurar o armazenamento de implantação ao criar seu aplicativo no portal do Azure. Para configurar o armazenamento de implantação durante a criação do aplicativo, use a CLI do Azure para criar seu aplicativo.

Você pode usar o portal para modificar as configurações de implantação de um aplicativo existente, conforme detalhado na próxima seção.

Visual Studio Code

No momento, não é possível configurar o armazenamento de implantação ao criar seu aplicativo no Azure usando o Visual Studio Code.

Você também pode modificar a configuração de armazenamento de implantação para um aplicativo existente.

CLI do Azure

Use o comando az functionapp deployment config set para modificar a configuração de armazenamento de implantação:

az functionapp deployment config set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --deployment-storage-name <DEPLOYMENT_ACCCOUNT_NAME> --deployment-storage-container-name <DEPLOYMENT_CONTAINER_NAME>

Portal do Azure

1. Na página do aplicativo de funções no portal do Azure, expanda Configurações no menu à esquerda e selecione Configurações de Implantação.

2. No local do pacote do aplicativo, selecione uma Conta de armazenamento e um contêiner vazio existentes na conta.

3. Em Autenticação de armazenamento, selecione o tipo de autenticação preferencial

   • Se você selecionou Cadeia de conexão, escolha o nome da configuração de aplicativo que contém a cadeia de conexão da conta de armazenamento de implantação.

   • Se você selecionou Identidade atribuída pelo usuário, escolha a identidade que deseja usar.

4. Selecione Salvar para atualizar o aplicativo.

Visual Studio Code

No momento, não é possível configurar o armazenamento de implantação para o seu aplicativo no Azure usando o Visual Studio Code.

Configurar a memória da instância

O tamanho da memória da instância usado pelo seu plano de Consumo Flex pode ser definido explicitamente quando você cria seu aplicativo. Para obter mais informações sobre tamanhos com suporte, consulte memória da instância.

Para definir um tamanho de memória de instância diferente do padrão ao criar seu aplicativo:

CLI do Azure

Especifique o parâmetro --instance-memory no comando az functionapp create. Este exemplo cria um aplicativo C# com um tamanho de instância de 4096:

az functionapp create --instance-memory 4096 --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage-account <STORAGE_NAME> --flexconsumption-location <REGION> --runtime dotnet-isolated --runtime-version 8.0

Portal do Azure

Ao criar seu aplicativo em um plano de Consumo Flex no portal do Azure, você pode escolher o tamanho da memória da instância no campo tamanho da instância na guia Básicos. Para obter mais informações, consulte Criar um aplicativo de Consumo Flex.

Visual Studio Code

No momento, você não pode controlar o tamanho da memória da instância ao usar o Visual Studio Code para criar seu aplicativo. O tamanho padrão é usado.

A qualquer momento, você pode alterar a configuração de tamanho de memória da instância usada pelo aplicativo.

CLI do Azure

Este exemplo usa o comando az functionapp scale config set para alterar a configuração de tamanho de memória da instância para 4.096 MB:

az functionapp scale config set --resource-group <resourceGroup> --name <APP_NAME> --instance-memory 4096

Portal do Azure

1. Na página do aplicativo de funções no portal do Azure, expanda Configurações no menu à esquerda e selecione Escala e simultaneidade.

2. Selecione uma opção Memória da instância e selecione Salvar para atualizar o aplicativo.

Visual Studio Code

No momento, não é possível alterar a configuração de tamanho de memória da instância para seu aplicativo usando o Visual Studio Code.

Definir contagens de instâncias sempre prontas

Ao criar um aplicativo em um plano de Consumo Flex, você pode definir a contagem de instâncias sempre pronta para grupos específicos (gatilhos HTTP ou Duráveis) e gatilhos. Para funções individuais, use o formato function:<FUNCTION_NAME>=n.

CLI do Azure

Use o parâmetro --always-ready-instances com o comando az functionapp create para definir uma ou mais designações de instância sempre prontas. Este exemplo define a contagem de instâncias sempre pronta para todas as funções disparadas por HTTP como 5:

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime <LANGUAGE_RUNTIME> --runtime-version <RUNTIME_VERSION> --flexconsumption-location <REGION> --always-ready-instances http=10

Este exemplo define a contagem de instâncias sempre pronta para todas as funções de gatilho duráveis para 3 e define a contagem de instâncias sempre pronta como 2 para uma função disparada do barramento de serviço chamada function5:

az functionapp create --resource-group <RESOURCE_GROUP> --name <APP_NAME> --storage <STORAGE_NAME> --runtime <LANGUAGE_RUNTIME> --runtime-version <RUNTIME_VERSION> --flexconsumption-location <REGION> --always-ready-instances durable=3 function:function5=2

Portal do Azure

No momento, você não pode definir instâncias sempre prontas ao criar seu aplicativo no portal do Azure. Para configurar o armazenamento de implantação durante a criação do aplicativo, use a CLI do Azure para criar seu aplicativo.

Você pode usar o portal para modificar instâncias sempre prontas em um aplicativo existente, conforme detalhado na próxima seção.

Visual Studio Code

No momento, não é possível definir instâncias sempre prontas ao criar seu aplicativo no Azure usando o Visual Studio Code.

Você também pode modificar instâncias sempre prontas em um aplicativo existente adicionando ou removendo designações de instância ou alterando as contagens de designação de instância existentes.

CLI do Azure

Este exemplo usa o comando az functionapp scale config always-ready set para alterar a contagem de instâncias sempre pronta para o grupo de gatilhos HTTP 10:

az functionapp scale config always-ready set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --settings http=10

Para remover instâncias sempre prontas, use o comando az functionapp scale config always-ready delete, como neste exemplo que remove todas as instâncias sempre prontas do grupo de gatilhos HTTP e também de uma função chamada hello_world:

az functionapp scale config always-ready delete --resource-group <RESOURCE_GROUP> --name <APP_NAME> --setting-names http hello_world

Portal do Azure

1. Na página do aplicativo de funções no portal do Azure, expanda Configurações no menu à esquerda e selecione Escala e simultaneidade.

2. Em tipo mínimo da instância sempre pronta, http, blob, durableou um nome de função específico no Gatilho e digite o número de instâncias sempre prontas.

3. Selecione Salvar para atualizar o aplicativo.

Visual Studio Code

No momento, não é possível modificar instâncias sempre prontas usando o Visual Studio Code.

Definir limites de simultaneidade HTTP

A menos que você defina limites específicos, os padrões de simultaneidade HTTP para aplicativos de plano de Consumo Flex são determinados com base na configuração de tamanho da instância. Para obter mais informações, consulte Simultaneidade do gatilho HTTP.

Veja como você pode definir limites de simultaneidade HTTP para um aplicativo existente:

CLI do Azure

Use o comando az functionapp scale config set para definir limites de simultaneidade HTTP específicos para seu aplicativo, independentemente do tamanho da instância.

az functionapp scale config set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --trigger-type http --trigger-settings perInstanceConcurrency=10

Este exemplo define o nível de simultaneidade do gatilho HTTP como 10. Depois de definir especificamente um valor de simultaneidade HTTP, esse valor será mantido apesar de quaisquer alterações na configuração de tamanho da instância do aplicativo.

Portal do Azure

1. Na página do aplicativo de funções no portal do Azure, expanda Configurações no menu à esquerda e selecione Escala e simultaneidade.

2. Em Simultaneidade por instância, selecione Atribuir manualmente e digite um limite específico.

3. Selecione Salvar para atualizar o aplicativo.

Visual Studio Code

No momento, não é possível definir limites de simultaneidade HTTP usando o Visual Studio Code.

Exibir regiões com suporte no momento

Durante a visualização, você só poderá executar no plano de Consumo Flex somente em regiões selecionadas. Para exibir a lista de regiões que atualmente dão suporte a planos de Consumo Flex:

1. Se você ainda não tiver feito isso, entre no Azure:

   az login
   

   O comando az login conecta você à conta do Azure.

2. Use o comando az functionapp list-flexconsumption-locations para examinar a lista de regiões que atualmente dão suporte ao Consumo Flex.

   az functionapp list-flexconsumption-locations --output table
   

Quando você cria um aplicativo no portal do Azure ou usando o Visual Studio Code, as regiões atualmente sem suporte são filtradas para fora da lista de regiões.

Conteúdo relacionado

• Plano de hospedagem do Consumo Flex do Azure Functions
• Opções de hospedagem do Azure Functions