Migrar aplicativos do plano de consumo para o plano de consumo Flex

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

Esse comando examina automaticamente sua assinatura e retorna duas matrizes:

• eligible_apps: Aplicativos de Consumo em Linux que podem ser migrados para Consumo Flexível. Esses aplicativos são compatíveis com o Consumo Flex.
• ineligible_apps: aplicativos que não podem ser migrados, juntamente com os motivos específicos. Os motivos para incompatibilidade precisam ser revisados e resolvidos antes de continuar.

A saída inclui o nome do aplicativo, o grupo de recursos, o local e a pilha de execução para cada aplicativo, juntamente com informações de status de elegibilidade e prontidão para 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)
   

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

Use este az graph query comando para listar todos os aplicativos de funções em sua assinatura que estão em execução em um 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

Esse comando gera uma tabela com o nome do aplicativo, a localização e o grupo de recursos para todos os aplicativos de consumo em execução no Windows na assinatura atual.

Você será solicitado a instalar a extensão de grafo de recursos, caso ela ainda não esteja 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
   

Esse comando gera uma tabela com o nome do aplicativo, a localização e o grupo de recursos para todos os aplicativos de consumo em execução no Windows na assinatura atual.

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

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

Esse comando gera uma tabela de regiões do Azure em que o plano de Consumo Flex tem suporte no momento.

O processo de criação de um aplicativo de funções no portal do Azure filtra regiões que o plano de Consumo Flexível não dá suporte no momento.

1. No portal do Azure, selecione Criar um recurso no menu à esquerda e selecioneCriar> de funções.

2. Selecione Selecionar>Consumo Flexível e, na guia Noções Básicas, expanda Região.

3. Examine as regiões de plano de Consumo Flexível com suporte.

Verifique se a região na qual o aplicativo de plano de Consumo que você deseja migrar é incluída na lista.

Use este comando az functionapp list-flexconsumption-runtimes para verificar o suporte ao plano de Consumo Flexível para sua versão de 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 região atual e <LANGUAGE_STACK> por um destes valores:

Esse comando exibe todas as versões do stack de linguagem especificado compatíveis com o plano de Consumo Flex em sua região.

O processo de criação de um aplicativo de funções no portal do Azure filtra versões de pilha de idiomas que o plano de Consumo Flex não dá suporte no momento.

1. No portal do Azure, selecione Criar um recurso no menu à esquerda e selecioneCriar> de funções.

2. Selecione Selecionar>Consumo Flexível e, na guia Noções Básicas , selecione sua pilha de runtime de idioma e Região.

3. Expanda a Versão e examine as versões com suporte da 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ções:

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

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

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

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

2. No menu à esquerda, selecione Implantação>slots de Implantação.

3. Caso visualize os slots listados na página Slots de implantação, seu aplicativo de funções está usando slots de implantação no momento.

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

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, o aplicativo provavelmente usará certificados.

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

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

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

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

Use este comando [az functionapp function list] para determinar se seu aplicativo tem gatilhos de armazenamento de Blobs 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> pelos nomes do grupo de recursos e do aplicativo, respectivamente. Se o comando retornar linhas, haverá pelo menos um gatilho usando sondagem de contêiner em seu aplicativo de funções.

Para verificar se a função do aplicativo possui gatilhos de Blob storage que não usam o Event Grid como origem:

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

2. Na Visão geral na guia Funções, procure todas as funções com um tipo Gatilho de Blob

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

4. Localize a properties.config.bindings seção da definição da função. Esta seção deve ter um bindings.type de blobTrigger. Se o objeto bindings não tiver a propriedade source ou source tiver o valor LogsAndContainerScan, então o gatilho estará usando a sondagem de contêiner. Em vez disso, um gatilho de origem da Grade de Eventos tem um valor source de EventGrid.

5. Repita as etapas 3 a 4 para quaisquer funções de gatilho de Armazenamento de Blobs restantes em seu aplicativo.

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> pelos nomes do grupo de recursos e do aplicativo, respectivamente.

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

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

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, em seguida, copie e salve o conteúdo das configurações do aplicativo JSON.

Use esse 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> pelos nomes do grupo de recursos e do aplicativo, respectivamente. Se qualquer uma das configurações do site ou verificações retornar valores não nulos, anote-os.

Para examinar as configurações de aplicativo relevantes do seu aplicativo existente:

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

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

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

   • Credenciais de publicação de autenticação básica do SCM
   • Versão HTTP
   • Somente HTTPS
   • Versão mínima do TLS de entrada
   • Criptografia mínima de TLS de entrada
   • Certificados de cliente de entrada

4. Na guia Mapeamentos de caminho , verifique se há alguma montagem de compartilhamento de arquivo existente exigida pelo 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>Escalar horizontalmente, se Impor o Limite de Scale Out estiver definido como Sim, observe o valor Máximo do Limite de Scale Out.

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

7. Sob o API>CORS, anote quaisquer origens de CORS explicitamente permitidas e outras configurações de CORS.

Esse script verifica a identidade gerenciada atribuída pelo sistema e as 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> pelos nomes do grupo de recursos e 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ções.

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

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

4. Verifique a guia Atribuído ao usuário para ver se há identidades gerenciadas atribuídas a um usuário. Anote os nomes de qualquer identidade atribuída pelo usuário.

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

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

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 de Consumo Flex.

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

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

Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> pelos nomes do grupo de recursos e do aplicativo, respectivamente. Examine 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 após a migração para que seus clientes possam manter o acesso usando seu provedor preferencial.

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ções.

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

3. Se a autenticação interna estiver habilitada, anote quais provedores de identidade do cliente estão configurados. Observe também as configurações avançadas, como repositório de tokens, redirecionamentos externos permitidos e audiências de token permitidas.

Este az functionapp config access-restriction show comando retorna uma lista de 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> pelos nomes do grupo de recursos e do aplicativo, respectivamente.

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

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 haverá restrições de acesso de entrada. Caso contrário, selecione restrições de acesso.

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

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

   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> pelos nomes do grupo de recursos e do aplicativo, respectivamente. Se esse comando retornar uma URL, você poderá baixar o arquivo do pacote de implantação desse local remoto e ir para a próxima seção.

2. Se o WEBSITE_RUN_FROM_PACKAGE valor for 1 ou nada, use esse script para obter o pacote de implantação do aplicativo 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> pelo nome do seu grupo de recursos e <APP_NAME> pelo nome do seu aplicativo. O pacote .zip arquivo é baixado para o diretório do qual você executou o comando.

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

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 ele está definido como um valor ou 1 uma URL. Se definido como uma URL, essa URL será o local do arquivo de pacote para o conteúdo do aplicativo. Baixe o arquivo .zip desse local de URL que você 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ê estiver executando no Linux ou no Windows.

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

6. No portal, pesquise o nome da conta de armazenamento.

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

8. Expanda contêineres de armazenamento de dados> e selecione . Escolha o arquivo nomeado scm-latest-<APP_NAME>.zip e selecione Baixar.

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

   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> pelos nomes do grupo de recursos e do aplicativo, respectivamente. Se esse comando retornar uma URL, você poderá baixar o arquivo do pacote de implantação desse local remoto e ir para a próxima seção.

2. Se o WEBSITE_RUN_FROM_PACKAGE valor for 1 ou nada, use esse script para obter o pacote de implantação do aplicativo 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> pelo nome do seu grupo de recursos e <APP_NAME> pelo nome do seu aplicativo. O pacote .zip arquivo é baixado para o diretório do qual você executou o comando.

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

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 ele está definido como um valor ou 1 uma URL. Se definido como uma URL, essa URL será o local do arquivo de pacote para o conteúdo do aplicativo. Baixe o arquivo .zip desse local de URL que você 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ê estiver executando no Linux ou no Windows.

5. Obtenha o nome da conta de armazenamento da configuração WEBSITE_CONTENTAZUREFILECONNECTIONSTRING, em que 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, pesquise o nome da 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>Compartilhamentos de Arquivos, selecione o nome do compartilhamento de WEBSITE_CONTENTSHARE e navegue até a subpasta data\SitePackages. Escolha o arquivo de .zip mais recente e selecione Baixar.

1. Verifique se o novo aplicativo existe e se 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. Examine 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 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, pesquise seu novo aplicativo de funções pelo nome.

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

   • O status é mostrado como Running
   • O tipo de plano é mostrado como Flex Consumption
   • O grupo de recursos e o local correspondem às suas expectativas

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

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

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

6. Examine Configurações>Rede para verificar a aplicação das restrições de acesso, 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 de Consumo Flex 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 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 e os nomes antigos de um novo 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 novo aplicativo.

2. No menu à esquerda, expandavariáveis de Ambiente de > 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 uma configuração já existir no novo aplicativo, ignore-a. Você também deve ignorar qualquer configuração que seja descontinuada no plano de consumo Flex.

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

Neste script, defina o valor de 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> pelos nomes do grupo de recursos e do aplicativo de funções, respectivamente. Além disso, substitua os espaços reservados de qualquer definição de variável para as configurações existentes que você deseja recriar no novo aplicativo e comente todas as configurações null.

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

2. No menu à esquerda, expanda Configurações>e, na guia Configurações gerais , atualize estas configurações para corresponder ao que você documentou do seu aplicativo de plano de consumo original:

   • Credenciais de publicação de autenticação básica do SCM
   • Versão HTTP
   • Somente HTTPS
   • Versão e codificação mínimas do TLS de entrada
   • Configurações do Certificado do Cliente

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

Use este comando az functionapp scale config set para definir a escala 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> pelos nomes do grupo de recursos e do aplicativo de funções, 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 novo aplicativo.

2. No menu à esquerda, expanda Configurações>Escala e simultaneidade e, para Contagem máxima de instâncias, defina um valor máximo até o qual seu aplicativo está autorizado a escalar.

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

1. Use este az functionapp config hostname add comando para associar novamente todos os 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> pelos nomes do grupo de recursos e do aplicativo de funções, respectivamente. Substitua <CUSTOM_DOMAIN> pelo nome de domínio personalizado.

2. Use este az functionapp cors add comando para substituir as configurações do 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> pelos nomes do grupo de recursos e do aplicativo de funções, respectivamente. Substitua por <ALLOWED_ORIGIN_*> suas origens permitidas.

1. No portal do Azure, pesquise ou navegue até a página do 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 a API>CORS, adicione uma ou mais origens permitidas e selecione Salvar.

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

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

   Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> pelos nomes do grupo de recursos e do aplicativo de funções, respectivamente.

2. Use este script para obter a ID principal da identidade atribuída pelo sistema e adicioná-la à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> pelos nomes do grupo de recursos e do aplicativo de funções, respectivamente. Substitua <ROLE_NAME> e <RESOURCE_ID> pelo nome da função e o recurso específico que você capturou do aplicativo original.

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

Use esse script para obter a ID de uma identidade gerenciada atribuída pelo usuário existente e associá-la ao 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 novo aplicativo.

2. No menu à esquerda, expanda Configurações>Identidade e, na guia Atribuída pelo sistema, defina Status como Ativado.

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

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

   Propriedade	Descrição
   Âmbito	O tipo de recurso que está sendo acessado.
   Subscrição	A assinatura do recurso.
   Recurso	O recurso específico dentro do escopo selecionado.
   Função	Pesquise 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 novo aplicativo.

2. No menu à esquerda, expanda Configurações>Identidade e, na guia Atribuído ao usuário, selecione + Adicionar.

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

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

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

   Propriedade	Descrição
   Âmbito	O tipo de recurso que está sendo acessado.
   Subscrição	A assinatura do recurso.
   Recurso	O recurso específico dentro do escopo selecionado.
   Função	Pesquise 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 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 novo aplicativo.

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

3. Na página de 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 da regra de IP.
   Ação	Negar
   Prioridade	Prioridade para a exclusão.
   Tipo	Selecione IPv4 ou IPv6.
   Bloco de Endereço IP	Os endereços IP a serem excluídos.

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.