Migrar aplicativos do plano de consumo para o plano Flex Consumption

Para aplicativos de consumo do Linux, use o novo az functionapp flex-migration list comando para identificar aplicativos qualificados para migração:

az functionapp flex-migration list

Este comando verifica automaticamente sua assinatura e retorna duas matrizes:

• eligible_apps: Aplicativos de consumo do Linux que podem ser migrados para o Flex Consumption. Estas aplicações são compatíveis com o Flex Consumption.
• ineligible_apps: Aplicativos que não podem ser migrados, juntamente com os motivos específicos. As razões da incompatibilidade devem ser analisadas e abordadas antes de continuar.

A saída inclui o nome do aplicativo, o grupo de recursos, o local e a pilha de tempo de execução para cada aplicativo, juntamente com o status de elegibilidade e as informações de preparação para a migração.

1. Navegue até o Azure Resource Graph Explorer no portal do Azure.

2. Copie esta consulta Kusto, cole-a na janela de consulta e selecione Executar consulta:

   resources 
   | where type == 'microsoft.web/sites' 
   | where ['kind'] == 'functionapp,linux' 
   | where properties.sku == 'Dynamic'
   | extend siteProperties=todynamic(properties.siteProperties.properties) 
   | mv-expand siteProperties 
   | where siteProperties.name=='LinuxFxVersion' 
   | project name, location, resourceGroup, stack=tostring(siteProperties.value)
   

Este comando gera uma tabela com o nome do aplicativo, local, grupo de recursos e pilha de tempo de execução para todos os aplicativos de consumo em execução no Linux na assinatura atual.

Use este az graph query comando para listar todas as aplicações de função na sua subscrição que estão a ser executadas num Plano de Consumo.

az graph query -q "resources | where subscriptionId == '$(az account show --query id -o tsv)' \
   | where type == 'microsoft.web/sites' | where ['kind'] == 'functionapp' | where properties.sku == 'Dynamic' \
   | project name, location, resourceGroup" \
   --query data --output table

Este comando gera uma tabela com o nome da aplicação, a localização e o grupo de recursos para todas as aplicações de Consumo em execução no Windows na subscrição atual.

Você será solicitado a instalar a extensão de gráfico de recursos, se ela ainda não estiver instalada.

1. Navegue até o Azure Resource Graph Explorer no portal do Azure.

2. Copie esta consulta Kusto, cole-a na janela de consulta e selecione Executar consulta:

   resources 
   	| where type == 'microsoft.web/sites' 
   	| where ['kind'] == 'functionapp' 
   	| where properties.sku == 'Dynamic'
   	| project name, location, resourceGroup
   

Este comando gera uma tabela com o nome da aplicação, a localização e o grupo de recursos para todas as aplicações de Consumo em execução no Windows na subscrição atual.

Use este az functionapp list-flexconsumption-locations comando para listar todas as regiões onde o plano Flex Consumption está disponível:

az functionapp list-flexconsumption-locations --query "sort_by(@, &name)[].{Region:name}" -o table

Este comando gera uma tabela de regiões do Azure onde o plano Flex Consumption é suportado atualmente.

O processo de criação de um aplicativo de função no portal do Azure filtra regiões que o plano Flex Consumption não oferece suporte no momento.

1. No portal do Azure, selecione Criar um recurso no menu esquerdo e selecione Criar aplicativo> de função.

2. Selecione Flex Consumption>Selecione e, na guia Noções básicas , expanda Região.

3. Analise as regiões suportadas do plano Flex Consumption.

Verifique se a região na qual o aplicativo Plano de consumo que você deseja migrar é executado está incluída na lista.

Use este az functionapp list-flexconsumption-runtimes comando para verificar o suporte do plano Flex Consumption para sua versão da pilha de idiomas em uma região específica:

az functionapp list-flexconsumption-runtimes --location <REGION> --runtime <LANGUAGE_STACK> --query '[].{version:version}' -o tsv

Neste exemplo, substitua <REGION> pela sua região atual e <LANGUAGE_STACK> por um destes valores:

Este comando exibe todas as versões da pilha de idiomas especificada suportada pelo plano Flex Consumption na sua região.

O processo de criação de um aplicativo de função no portal do Azure filtra as versões da pilha de idiomas que o plano Flex Consumption não oferece suporte no momento.

1. No portal do Azure, selecione Criar um recurso no menu esquerdo e selecione Criar aplicativo> de função.

2. Selecione Flex Consumption>Selecione e, na guia Noções básicas , selecione seu idioma, tempo de execução, pilha e região.

3. Expanda Versão e analise as versões suportadas da sua pilha de idiomas na região escolhida.

Use este az functionapp deployment slot list comando para listar todos os slots de implantação definidos em seu aplicativo de função:

az functionapp deployment slot list --name <APP_NAME> --resource-group <RESOURCE_GROUP> --output table

Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> pelo nome do grupo de recursos e nome do aplicativo, respectivamente. Se o comando retornar uma entrada, seu aplicativo terá slots de implantação habilitados.

Para determinar se seu aplicativo de função tem slots de implantação habilitados:

1. No portal do Azure, pesquise ou navegue até a página do aplicativo de função.

2. No menu à esquerda, selecione Deployment>Deployment slots.

3. Se vir algum slot listado na página Slots de implantação, a sua aplicação de funções está a usar slots de implantação neste momento.

Use o az webapp config ssl list comando para listar todos os certificados TSL/SSL disponíveis para seu aplicativo de função:

az webapp config ssl list --resource-group <RESOURCE_GROUP>  

Neste exemplo, substitua <RESOURCE_GROUP> pelo nome do grupo de recursos. Se esse comando produzir saída, é provável que seu aplicativo esteja usando certificados.

Para determinar se seu aplicativo de função está usando certificados TSL/SSL:

1. No portal do Azure, pesquise ou navegue até a página do aplicativo de função.

2. No menu à esquerda, selecione Configurações>de certificados.

3. Verifique as guias Certificados gerenciados, Traga seus próprios certificados (.pfx), Certificados de chave pública (.cer) para todos os certificados instalados.

Use este comando [az functionapp function list] para determinar se seu aplicativo tem gatilhos de armazenamento de Blob que não usam a Grade de Eventos como origem:

az functionapp function list  --name <APP_NAME> --resource-group <RESOURCE_GROUP> \
  --query "[?config.bindings[0].type=='blobTrigger' && config.bindings[0].source!='EventGrid'].{Function:name,TriggerType:config.bindings[0].type,Source:config.bindings[0].source}" \
  --output table

Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> pelo nome do grupo de recursos e nome do aplicativo, respectivamente. Se o comando retornar linhas, haverá pelo menos um gatilho usando sondagem de contêiner em seu aplicativo de função.

Para determinar se seu aplicativo de função tem gatilhos de armazenamento de Blob que não usam a Grade de Eventos como origem:

1. No portal do Azure, pesquise ou navegue até a página do aplicativo de função.

2. Na Visão geral na guia Funções, procure por quaisquer funções com o tipo de gatilho de Blob.

3. Selecione uma função de gatilho de blob e, em Código + Teste , selecione JSON de recurso.

4. Localize a properties.config.bindings seção da definição da função. Esta secção precisa ter um bindings.type de blobTrigger. Se o bindings objeto não tiver nenhuma source propriedade ou source tiver um valor de LogsAndContainerScan, o gatilho está usando sondagem de contentor. Em vez disso, um gatilho de origem da Grade de Eventos tem um source valor de EventGrid.

5. Repita as etapas 3 a 4 para todas as funções de gatilho de armazenamento de Blob restantes na sua aplicação.

Use este az functionapp config appsettings list comando para retornar um app_settings objeto que contém a configuração de aplicativo existente como JSON:

app_settings=$(az functionapp config appsettings list --name `<APP_NAME>` --resource-group `<RESOURCE_GROUP>`)
echo $app_settings

Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> pelo nome do grupo de recursos e nome do aplicativo, respectivamente.

Para obter as configurações atuais do seu aplicativo de função:

1. No portal do Azure, pesquise ou navegue até a página do aplicativo de função.

2. No menu à esquerda, expanda Configurações e selecione Variáveis de ambiente.

3. Na guia Configurações do aplicativo , selecione Edição avançada e copie e salve o conteúdo das configurações do aplicativo JSON.

Use este script para obter as configurações de aplicativo relevantes do seu aplicativo existente:

# Set the app and resource group names
appName=<APP_NAME>
rgName=<RESOURCE_GROUP>

echo "Getting commonly used site settings..."
az functionapp config show --name $appName --resource-group $rgName \
    --query "{http20Enabled:http20Enabled, httpsOnly:httpsOnly, minTlsVersion:minTlsVersion, \
    minTlsCipherSuite:minTlsCipherSuite, clientCertEnabled:clientCertEnabled, \
    clientCertMode:clientCertMode, clientCertExclusionPaths:clientCertExclusionPaths}"

echo "Checking for SCM basic publishing credentials policies..."
az resource show --resource-group $rgName --name scm --namespace Microsoft.Web \
    --resource-type basicPublishingCredentialsPolicies --parent sites/$appName --query properties

echo "Checking for the maximum scale-out limit configuration..."
az functionapp config appsettings list --name $appName --resource-group $rgName \
    --query "[?name=='WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT'].value" -o tsv

echo "Checking for any file share mount configurations..."
az webapp config storage-account list --name $appName --resource-group $rgName

echo "Checking for any custom domains..."
az functionapp config hostname list --webapp-name $appName --resource-group $rgName --query "[?contains(name, 'azurewebsites.net')==\`false\`]" --output table

echo "Checking for any CORS settings..."
az functionapp cors show --name $appName --resource-group $rgName 

Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> pelo nome do grupo de recursos e nome do aplicativo, respectivamente. Se qualquer uma das configurações ou verificações do site retornar valores não nulos, anote eles.

Para rever as configurações de aplicação relevantes da sua aplicação existente:

1. No portal do Azure, pesquise ou navegue até a página do aplicativo de função.

2. No menu à esquerda, expanda Configurações e selecione Configuração.

3. Na guia Configurações gerais , anote estas configurações:

   • Credenciais básicas de publicação de autenticação do SCM
   • Versão HTTP
   • Apenas HTTPS
   • Versão mínima de entrada TLS
   • Cifra TLS mínima de entrada
   • Certificados de cliente de entrada

4. Na guia Mapeamentos de caminho , verifique se há alguma montagem de compartilhamento de arquivos existente exigida pelo seu aplicativo. Se houver, anote o nome da conta de armazenamento, o nome do compartilhamento, o caminho de montagem e o tipo de acesso para cada compartilhamento montado.

5. Em Configurações>de Expansão, se Aplicar Limite de Expansão estiver definido como Sim, observe o valor do Limite de Expansão Máxima.

6. Em Configurações>Domínios personalizados, observe quaisquer nomes de domínio diferentes de *.azurewebsites.net, o tipo de associação e as informações do certificado SSL.

7. Em API>CORS, observe todas as origens de CORS explicitamente permitidas e outras configurações de CORS.

Este script verifica a identidade gerenciada atribuída pelo sistema e quaisquer identidades gerenciadas atribuídas pelo usuário associadas ao seu aplicativo:

appName=<APP_NAME>
rgName=<RESOURCE_GROUP>

echo "Checking for a system-assigned managed identity..."
systemUserId=$(az functionapp identity show --name $appName --resource-group $rgName --query "principalId" -o tsv) 

if [[ -n "$systemUserId" ]]; then
echo "System-assigned identity principal ID: $systemUserId"
echo "Checking for role assignments..."
az role assignment list --assignee $systemUserId --all
else
  echo "No system-assigned identity found."
fi

echo "Checking for user-assigned managed identities..."
userIdentities=$(az functionapp identity show --name $appName --resource-group $rgName --query 'userAssignedIdentities' -o json)
if [[ "$userIdentities" != "{}" && "$userIdentities" != "null" ]]; then
  echo "$userIdentities" | jq -c 'to_entries[]' | while read -r identity; do
    echo "User-assigned identity name: $(echo "$identity" | jq -r '.key' | sed 's|.*/userAssignedIdentities/||')"
	echo "Checking for role assignments..."
    az role assignment list --assignee $(echo "$identity" | jq -r '.value.principalId') --all --output json
    echo
  done
else
  echo "No user-assigned identities found."
fi

Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> pelo nome do grupo de recursos e nome do aplicativo, respectivamente. Anote todas as identidades e suas atribuições de função.

1. No portal do Azure, pesquise ou navegue até a página do aplicativo de função.

2. No menu à esquerda, expanda Configurações e selecione Identidade.

3. Verifique a guia Sistema atribuído para ver se a identidade gerenciada atribuída ao sistema está habilitada. Se habilitado, selecione Atribuições de função do Azure para exibir as funções atribuídas a essa identidade.

4. Verifique o separador Usuário atribuído para ver se existem identidades geridas pelo usuário atribuídas. Observe os nomes de todas as identidades atribuídas pelo usuário.

5. Para cada identidade gerenciada atribuída pelo usuário, selecione a identidade e, na página de identidade, selecione Atribuições de função do Azure.

6. Anote cada atribuição de função concedida à identidade e determine se seu aplicativo a exige.

Documente todas as identidades e suas atribuições de função para que você possa recriar a mesma estrutura de permissões para seu novo aplicativo Flex Consumption.

Use este az webapp auth show comando para determinar se a autenticação interna está configurada em seu aplicativo de função:

az webapp auth show --name <APP_NAME> --resource-group <RESOURCE_GROUP>

Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> pelo nome do grupo de recursos e nome do aplicativo, respectivamente. Analise a saída para determinar se a autenticação está habilitada e quais provedores de identidade estão configurados.

Você deve recriar essas configurações em seu novo aplicativo pós-migração para que seus clientes possam manter o acesso usando seu provedor preferido.

Para determinar se a autenticação de cliente interna está configurada:

1. No portal do Azure, pesquise ou navegue até a página do aplicativo de função.

2. No menu à esquerda, expanda Configurações e selecione Autenticação.

3. Se a autenticação interna estiver habilitada, anote quais provedores de identidade de cliente estão configurados. Observe também todas as configurações avançadas, como armazenamento de tokens, redirecionamentos externos permitidos e públicos de token permitidos.

Este az functionapp config access-restriction show comando retorna uma lista de quaisquer restrições de acesso baseadas em IP existentes:

az functionapp config access-restriction show --name <APP_NAME> --resource-group <RESOURCE_GROUP>

Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> pelo nome do grupo de recursos e nome do aplicativo, respectivamente.

1. No portal do Azure, pesquise ou navegue até a página do aplicativo de função.

2. No menu à esquerda, expanda Configurações e selecione Rede.

3. Se você vir Habilitado sem restrições de acesso para acesso à rede pública , não há restrições de acesso de entrada. Caso contrário, selecione Restrições de acesso.

4. Documente todas as restrições de acesso baseadas em IP configuradas no momento.

1. Use este az functionapp config appsettings list comando para obter a configuração do WEBSITE_RUN_FROM_PACKAGE aplicativo, se houver:

   az functionapp config appsettings list --name <APP_NAME> --resource-group <RESOURCE_GROUP> \
       --query "[?name=='WEBSITE_RUN_FROM_PACKAGE'].value" -o tsv
   

   Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> pelo nome do grupo de recursos e nome do aplicativo, respectivamente. Se esse comando retornar uma URL, você poderá baixar o arquivo do pacote de implantação desse local remoto e pular para a próxima seção.

2. Se o valor de WEBSITE_RUN_FROM_PACKAGE for 1 ou não houver valor, use este script para obter o pacote de implementação da aplicação já existente:

   appName=<APP_NAME>
   rgName=<RESOURCE_GROUP>
   
   echo "Getting the storage account connection string from app settings..."
   storageConnection=$(az functionapp config appsettings list --name $appName --resource-group $rgName \
            --query "[?name=='AzureWebJobsStorage'].value" -o tsv)
   
   echo "Getting the package name..."
   packageName=$(az storage blob list --connection-string $storageConnection --container-name scm-releases \
   --query "[0].name" -o tsv)
   
   echo "Download the package? $packageName? (Y to proceed, any other key to exit)"
   read -r answer
   if [[ "$answer" == "Y" || "$answer" == "y" ]]; then
      echo "Proceeding with download..."
      az storage blob download --connection-string $storageConnection --container-name scm-releases \
   --name $packageName --file $packageName
   else
      echo "Exiting script."
      exit 0
   fi
   

   Novamente, substitua <RESOURCE_GROUP> e <APP_NAME> pelo nome do grupo de recursos e nome do aplicativo. O arquivo de .zip do pacote é baixado para o diretório a partir do qual você executou o comando.

1. No portal do Azure, pesquise ou navegue até a página do aplicativo de função.

2. No menu à esquerda, expanda Configurações>Variáveis de ambiente e veja se existe uma configuração nomeada WEBSITE_RUN_FROM_PACKAGE .

3. Se WEBSITE_RUN_FROM_PACKAGE existir, verifique se está definido como um valor de 1 ou um URL. Se definido como um URL, esse URL é o local do arquivo de pacote para o conteúdo do seu aplicativo. Transfira o ficheiro .zip a partir da localização do URL que possui.

4. Se a WEBSITE_RUN_FROM_PACKAGE configuração não existir ou estiver definida como 1, você deverá baixar o pacote da conta de armazenamento específica, o que depende se você está executando no Linux ou no Windows.

5. Obtenha o nome da conta de armazenamento da definição de aplicação AzureWebJobsStorage ou AzureWebJobsStorage__accountName. Para uma cadeia de conexão, o AccountName é o nome da sua conta de armazenamento.

6. No portal, procure o nome da sua conta de armazenamento.

7. Na página da conta de armazenamento, localize o pacote de implantação e baixe-o.

8. Expanda armazenamento de dados>Contentores e selecione scm_releases. Escolha o nome scm-latest-<APP_NAME>.zip do arquivo e selecione Download.

1. Use este az functionapp config appsettings list comando para obter a configuração do WEBSITE_RUN_FROM_PACKAGE aplicativo, se houver:

   az functionapp config appsettings list --name <APP_NAME> --resource-group <RESOURCE_GROUP> \
       --query "[?name=='WEBSITE_RUN_FROM_PACKAGE'].value" -o tsv
   

   Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> pelo nome do grupo de recursos e nome do aplicativo, respectivamente. Se esse comando retornar uma URL, você poderá baixar o arquivo do pacote de implantação desse local remoto e pular para a próxima seção.

2. Se o valor de WEBSITE_RUN_FROM_PACKAGE for 1 ou não houver valor, use este script para obter o pacote de implementação da aplicação já existente:

   appName=<APP_NAME>
   rgName=<RESOURCE_GROUP>
   
   echo "Getting the storage account connection string and file share from app settings..."
   json=$(az functionapp config appsettings list --name $appName --resource-group $rgName \
       --query "[?name=='WEBSITE_CONTENTAZUREFILECONNECTIONSTRING' || name=='WEBSITE_CONTENTSHARE'].value" -o json)
   
   storageConnection=$(echo "$json" | jq -r '.[0]')
   fileShare=$(echo "$json" | jq -r '.[1]')
   
   echo "Getting the package name..."
   packageName=$(az storage file list --share-name $fileShare --connection-string $storageConnection \
     --path "data/SitePackages" --query "[?ends_with(name, '.zip')] | sort_by(@, &properties.lastModified)[-1].name" \
     -o tsv) 
   
   echo "Download the package? $packageName? (Y to proceed, any other key to exit)"
   read -r answer
   if [[ "$answer" == "Y" || "$answer" == "y" ]]; then
       echo "Proceeding with download..."
       az storage file download --connection-string $storageConnection --share-name $fileShare \
   	--path "data/SitePackages/$packageName"
   else
       echo "Exiting script."
       exit 0
   fi
   

   Novamente, substitua <RESOURCE_GROUP> e <APP_NAME> pelo nome do grupo de recursos e nome do aplicativo. O arquivo de .zip do pacote é baixado para o diretório a partir do qual você executou o comando.

1. No portal do Azure, pesquise ou navegue até a página do aplicativo de função.

2. No menu à esquerda, expanda Configurações>Variáveis de ambiente e veja se existe uma configuração nomeada WEBSITE_RUN_FROM_PACKAGE .

3. Se WEBSITE_RUN_FROM_PACKAGE existir, verifique se está definido como um valor de 1 ou um URL. Se definido como um URL, esse URL é o local do arquivo de pacote para o conteúdo do seu aplicativo. Transfira o ficheiro .zip a partir da localização do URL que possui.

4. Se a WEBSITE_RUN_FROM_PACKAGE configuração não existir ou estiver definida como 1, você deverá baixar o pacote da conta de armazenamento específica, o que depende se você está executando no Linux ou no Windows.

5. Obtenha o nome da conta de armazenamento na configuração WEBSITE_CONTENTAZUREFILECONNECTIONSTRING, onde AccountName é o nome da sua conta de armazenamento. Além disso, anote o WEBSITE_CONTENTSHARE valor, que é o nome do compartilhamento de arquivos.

6. No portal, procure o nome da sua conta de armazenamento.

7. Na página da conta de armazenamento, localize o pacote de implantação e baixe-o.

8. Expanda Armazenamento de dados>Partilhas de ficheiros, selecione o nome da partilha a partir de WEBSITE_CONTENTSHARE e navegue até à data\SitePackages subpasta. Escolha o arquivo de .zip mais recente e selecione Download.

1. Verifique se o novo aplicativo existe e está em execução:

   az functionapp show --name <NEW_APP_NAME> --resource-group <RESOURCE_GROUP> \
        --query "{name:name, kind:kind, sku:properties.sku}" --output table
   

2. Revise as configurações do aplicativo migrado:

   az functionapp config appsettings list --name <NEW_APP_NAME> --resource-group <RESOURCE_GROUP> \
        --output table
   

   Compare essas configurações com seu aplicativo de origem para garantir que as configurações críticas sejam transferidas.

3. Verifique a configuração de identidade gerenciada:

   az functionapp identity show --name <NEW_APP_NAME> --resource-group <RESOURCE_GROUP>
   

4. Verifique se todos os domínios personalizados foram migrados:

   az functionapp config hostname list --webapp-name <NEW_APP_NAME> --resource-group <RESOURCE_GROUP> \
        --output table
   

1. No portal do Azure, procure seu novo aplicativo de função pelo nome.

2. Na página Visão geral do aplicativo, verifique:

   • O status é mostrado como Running
   • O tipo de plano é apresentado como Flex Consumption
   • O grupo de recursos e a localização correspondem às suas expectativas

3. No menu à esquerda, expanda Configurações>Variáveis de ambiente e revise a guia Configurações do aplicativo para garantir que as configurações do aplicativo foram migradas corretamente.

4. Verifique Configurações>de Identidade para verificar se as identidades gerenciadas foram configuradas conforme o esperado.

5. Se aplicável, verifique Configurações>Domínios personalizados para confirmar que todos os mapeamentos de domínio personalizados foram migrados.

6. Revise Configurações>de rede para verificar se as restrições de acesso foram aplicadas se elas existiam no aplicativo de origem.

Execute este script que executa estas tarefas:

1. Obtém as configurações do aplicativo antigo, ignorando as configurações que não se aplicam em um plano Flex Consumption ou que já existem no novo aplicativo.
2. Grava as configurações coletadas localmente em um arquivo temporário.
3. Aplica as configurações do arquivo ao seu novo aplicativo.
4. Exclui o arquivo temporário.

sourceAppName=<SOURCE_APP_NAME>
destAppName=<DESTINATION_APP_NAME>
rgName=<RESOURCE_GROUP>

echo "Getting app settings from the old app..."
app_settings=$(az functionapp config appsettings list --name $sourceAppName --resource-group $rgName)

# Filter out settings that don't apply to Flex Consumption apps or that will already have been created
filtered_settings=$(echo "$app_settings" | jq 'map(select(
  (.name | ascii_downcase) != "website_use_placeholder_dotnetisolated" and
  (.name | ascii_downcase | startswith("azurewebjobsstorage") | not) and
  (.name | ascii_downcase) != "website_mount_enabled" and
  (.name | ascii_downcase) != "enable_oryx_build" and
  (.name | ascii_downcase) != "functions_extension_version" and
  (.name | ascii_downcase) != "functions_worker_runtime" and
  (.name | ascii_downcase) != "functions_worker_runtime_version" and
  (.name | ascii_downcase) != "functions_max_http_concurrency" and
  (.name | ascii_downcase) != "functions_worker_process_count" and
  (.name | ascii_downcase) != "functions_worker_dynamic_concurrency_enabled" and
  (.name | ascii_downcase) != "scm_do_build_during_deployment" and
  (.name | ascii_downcase) != "website_contentazurefileconnectionstring" and
  (.name | ascii_downcase) != "website_contentovervnet" and
  (.name | ascii_downcase) != "website_contentshare" and
  (.name | ascii_downcase) != "website_dns_server" and
  (.name | ascii_downcase) != "website_max_dynamic_application_scale_out" and
  (.name | ascii_downcase) != "website_node_default_version" and
  (.name | ascii_downcase) != "website_run_from_package" and
  (.name | ascii_downcase) != "website_skip_contentshare_validation" and
  (.name | ascii_downcase) != "website_vnet_route_all" and
  (.name | ascii_downcase) != "applicationinsights_connection_string"
))')

echo "Settings to migrate..."
echo "$filtered_settings"

echo "Writing settings to a local a local file (app_settings_filtered.json)..."
echo "$filtered_settings" > app_settings_filtered.json

echo "Applying settings to the new app..."
output=$(az functionapp config appsettings set --name $destAppName --resource-group $rgName --settings @app_settings_filtered.json)

echo "Deleting the temporary settings file..."
rm -rf app_settings_filtered.json  

echo "Current app settings in the new app..."
az functionapp config appsettings list --name $destAppName --resource-group $rgName 

Neste exemplo, substitua <RESOURCE_GROUP>, <SOURCE_APP_NAME> e <DEST_APP_NAME> pelo nome do grupo de recursos, o antigo nome do aplicativo e o novo nome do aplicativo, respectivamente. Esse script pressupõe que ambos os aplicativos estejam no mesmo grupo de recursos.

Para transferir configurações:

1. No portal do Azure, pesquise ou navegue até a página do seu novo aplicativo.

2. No menu à esquerda, expanda Configurações>Variáveis de ambiente e, na guia Configurações do aplicativo , selecione + Adicionar.

3. Digite ou cole a configuração Nome e Valor e selecione Aplicar.

4. Repita a etapa anterior para cada configuração no aplicativo antigo que você precisa recriar no novo aplicativo. Se já existir uma definição na nova aplicação, ignore-a. Você também deve ignorar qualquer configuração que tenha sido preterida no plano Flex Consumption.

5. Depois de adicionar todas as configurações relevantes, selecione Aplicar>Salvar.

Neste script, defina o valor para qualquer configuração definida no aplicativo original e comente todos os comandos para qualquer configuração não definida (null):

appName=<APP_NAME>
rgName=<RESOURCE_GROUP>
http20Setting=<YOUR_HTTP_20_SETTING>
minTlsVersion=<YOUR_TLS_VERSION>
minTlsCipher=<YOUR_TLS_CIPHER>
httpsOnly=<YOUR_HTTPS_ONLY_SETTING>
certEnabled=<CLIENT_CERT_ENABLED>
certMode=<YOUR_CLIENT_CERT_MODE>
certExPaths=<CERT_EXCLUSION_PATHS>
scmAllowBasicAuth=<ALLOW_SCM_BASIC_AUTH>

# Apply HTTP version and minimum TLS settings
az functionapp config set --name $appName --resource-group $rgName --http20-enabled $http20Setting  
az functionapp config set --name $appName --resource-group $rgName --min-tls-version $minTlsVersion

# Apply the HTTPS-only setting
az functionapp update --name $appName --resource-group $rgName --set HttpsOnly=$httpsOnly

# Apply incoming client cert settings
az functionapp update --name $appName --resource-group $rgName --set clientCertEnabled=$certEnabled
az functionapp update --name $appName --resource-group $rgName --set clientCertMode=$certMode
az functionapp update --name $appName --resource-group $rgName --set clientCertExclusionPaths=$certExPaths

# Apply the TLS cipher suite setting
az functionapp update --name $appName --resource-group $rgName --set minTlsCipherSuite=$minTlsCipher

# Apply the allow scm basic auth configuration
az resource update --resource-group $rgName --name scm --namespace Microsoft.Web --resource-type basicPublishingCredentialsPolicies \
	--parent sites/$appName --set properties.allow=$scmAllowBasicAuth

Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> por seus nomes de aplicativo de função e grupo de recursos, respectivamente. Além disso, substitua os placeholders de quaisquer definições de variáveis para as configurações existentes que você deseja recriar no novo aplicativo e comente as configurações null.

1. No portal do Azure, pesquise ou navegue até a página do seu novo aplicativo.

2. No menu à esquerda, expanda Configurações>Configuração e, no separador Configurações gerais, atualize essas configurações para corresponder ao que documentou no seu aplicativo original do Plano de Consumo.

   • Credenciais básicas de publicação de autenticação do SCM
   • Versão HTTP
   • Apenas HTTPS
   • Versão mínima de entrada TLS e cypher
   • Configurações de certificado de cliente

3. Selecione Salvar para aplicar as alterações de configuração.

Use este az functionapp scale config set comando para definir a expansão máxima.

az functionapp scale config set --name <APP_NAME> --resource-group <RESOURCE_GROUP> \
    --maximum-instance-count <MAX_SCALE_SETTING>

Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> por seus nomes de aplicativo de função e grupo de recursos, respectivamente. Substitua <MAX_SCALE_SETTING> pelo valor máximo de escala que você está definindo.

Para configurar a escala e a simultaneidade em seu novo aplicativo:

1. No portal do Azure, pesquise ou navegue até a página do seu novo aplicativo.

2. No menu à esquerda, expanda Escala de Configurações>e simultaneidade e, para Contagem máxima de instâncias , defina um valor máximo para o qual seu aplicativo pode ser dimensionado.

3. Selecione Save para aplicar as alterações.

1. Use este az functionapp config hostname add comando para revincular quaisquer mapeamentos de domínio personalizados ao seu aplicativo:

   az functionapp config hostname add --name <APP_NAME> --resource-group <RESOURCE_GROUP> \
       --hostname <CUSTOM_DOMAIN>
   

   Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> por seus nomes de aplicativo de função e grupo de recursos, respectivamente. Substitua <CUSTOM_DOMAIN> pelo seu nome de domínio personalizado.

2. Use este az functionapp cors add comando para substituir quaisquer configurações de CORS:

   az functionapp cors add --name <APP_NAME> --resource-group <RESOURCE_GROUP> \
       --allowed-origins <ALLOWED_ORIGIN_1> <ALLOWED_ORIGIN_2> <ALLOWED_ORIGIN_N>
   

   Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> por seus nomes de aplicativo de função e grupo de recursos, respectivamente. Substitua <ALLOWED_ORIGIN_*> pelas suas origens permitidas.

1. No portal do Azure, pesquise ou navegue até a página do seu novo aplicativo.

2. No menu à esquerda, expanda Configurações>Domínios personalizados, selecione + Adicionar domínio personalizado, configure o domínio personalizado, selecione Validar e, em seguida, selecione Adicionar.

3. Repita a etapa anterior para adicionar outros domínios personalizados.

4. No menu à esquerda, expanda API>CORS, adicione uma ou mais origens permitidas e selecione Guardar.

1. Use este az functionapp identity assign comando para habilitar a identidade gerenciada atribuída ao sistema em seu novo aplicativo:

   az functionapp identity assign --name <APP_NAME> --resource-group <RESOURCE_GROUP>
   

   Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> por seus nomes de aplicativo de função e grupo de recursos, respectivamente.

2. Use este script para obter o ID principal da identidade atribuída ao sistema e adicioná-lo às funções necessárias:

   # Get the principal ID of the system identity
   principalId=$(az functionapp identity show --name <APP_NAME> --resource-group <RESOURCE_GROUP> \
       --query principalId -o tsv)
   
   # Assign a role in a specific resource (scope) to the system identity
   az role assignment create --assignee $principalId --role "<ROLE_NAME>" --scope "<RESOURCE_ID>"
   

   Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> por seus nomes de aplicativo de função e grupo de recursos, respectivamente. Substitua <ROLE_NAME> e <RESOURCE_ID> pelo nome da função e recurso específico capturado do aplicativo original.

3. Repita os comandos anteriores para cada função exigida pelo novo aplicativo.

Use este script para obter a ID de uma identidade gerenciada atribuída pelo usuário existente e associá-la ao seu novo aplicativo:

appName=<APP_NAME>
rgName=<RESOURCE_GROUP>
userName=<USER_IDENTITY_NAME>

userId=$(az identity show --name $userName --resource-group $rgName --query 'id' -o tsv)
az functionapp identity assign --name $appName --resource-group $rgName --identities $userId

Repita esse script para cada função exigida pelo novo aplicativo.

1. No portal do Azure, pesquise ou navegue até a página do seu novo aplicativo.

2. No menu à esquerda, expanda Configurações>de Identidade e, na guia Sistema atribuído , defina Status como Ativado.

3. Selecione Atribuições de função do Azure no painel esquerdo.

4. Selecione + Adicionar atribuição de função para definir estas propriedades de atribuição para uma função documentada no aplicativo original:

   Propriedade	Descrição
   Âmbito de aplicação	O tipo de recurso que está sendo acessado.
   Subscrição	A subscrição do recurso.
   Recurso	O recurso específico dentro do escopo selecionado.
   Função	Procure e selecione a função que está sendo atribuída.

5. Selecione Salvar para adicionar o escopo e repita a etapa anterior para cada função documentada exigida pelo novo aplicativo.

1. No portal do Azure, pesquise ou navegue até a página do seu novo aplicativo.

2. No menu à esquerda, expanda Configurações>de identidade e, na guia Usuário atribuído , selecione + Adicionar.

3. Selecione uma identidade existente e, em seguida, Adicionar.

4. Selecione a identidade que você acabou de adicionar e selecione Atribuições de função do Azure no painel esquerdo.

5. Selecione + Adicionar atribuição de função para definir estas propriedades de atribuição para uma função documentada no aplicativo original:

   Propriedade	Descrição
   Âmbito de aplicação	O tipo de recurso que está sendo acessado.
   Subscrição	A subscrição do recurso.
   Recurso	O recurso específico dentro do escopo selecionado.
   Função	Procure e selecione a função que está sendo atribuída.

6. Selecione Salvar para adicionar o escopo e repita a etapa anterior para cada função documentada exigida pelo novo aplicativo.

Use este az functionapp config access-restriction add comando para cada restrição de acesso IP que você deseja replicar no novo aplicativo:

az functionapp config access-restriction add --name <APP_NAME> --resource-group <RESOURCE_GROUP> \
  --rule-name <RULE_NAME> --action Deny --ip-address <IP_ADDRESS> --priority <PRIORITY>

Neste exemplo, substitua esses marcadores de posição pelos valores do seu aplicativo original.

Execute este comando para cada restrição de IP documentada do aplicativo original.

Para adicionar restrições de rede baseadas em IP:

1. No portal do Azure, pesquise ou navegue até a página do seu novo aplicativo.

2. No menu à esquerda, expanda Configurações>de rede e selecione o link ao lado de Acesso à rede pública.

3. Na página Restrições de acesso , em Regras e acesso ao site, selecione + Adicionar e insira estas configurações para uma restrição de IP específica:

   Configurações	Valor
   Nome	Nome amigável para a regra IP.
   Ação	Negar
   Prioridade	Prioridade para a exclusão.
   Tipo	Selecione IPv4 ou IPv6.
   Bloco de endereços IP	Os endereços IP a excluir.

4. Selecione Adicionar regra e repita a etapa anterior para cada restrição de acesso documentada.

5. Depois de inserir todas as restrições de IP do aplicativo original, selecione Salvar.