Migrar aplicativos do plano de consumo para o plano Flex Consumption

A funcionalidade do Azure automatiza a maior parte da migração para si. Os seus passos principais são:

Os flex-migration comandos CLI automatizam a criação e configuração da aplicação. Os seus passos principais são:

O portal fornece um caminho de migração manual. Os passos de alto nível são:

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

A migração do Windows requer passos manuais para a criação e configuração da aplicação. Os seus passos principais são:

A migração do Windows requer passos manuais para a criação e configuração da aplicação. Os seus passos principais são:

Para iniciar uma migração interativa que analisa a sua subscrição e o convida a escolher que aplicações migrar, use este prompt:

migrate my linux function apps in azure from consumption to flex consumption

O Copilot identifica as suas aplicações elegíveis para o Linux Consumption, permite-lhe escolher quais migrar e depois guia-o pela avaliação, criação de aplicações, configuração e implementação de cada aplicação. Continuar com os passos de migração.

Se só quiser ver quais as apps elegíveis sem iniciar a migração, use este prompt em vez disso:

list my linux consumption apps eligible for flex consumption migration

O Copilot devolve uma lista de aplicações elegíveis e inelegíveis, juntamente com as razões de quaisquer incompatibilidades. Pode então migrar uma aplicação específica usando o prompt em Iniciar a migração para Linux.

Execute este comando para ver quais das suas aplicações Linux Consumption estão prontas 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. Revise e aborde as razões da incompatibilidade 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. Vai ao Explorador Azure Resource Graph no portal Azure.

2. Copie a seguinte 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 cria uma tabela com o nome da aplicação, localização, grupo de recursos e pilha de tempo de execução para todas as aplicações Consumption a correr em Linux na subscrição atual.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

Use o az graph query comando para listar todas as aplicações funcionais na sua subscrição que funcionam 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 cria uma tabela com o nome da aplicação, localização e grupo de recursos para todas as aplicações Consumption a correr no Windows na subscrição atual.

Se ainda não a tiveres, és solicitado a instalar a extensão resource-graph.

1. Vai ao Explorador Azure Resource Graph no portal Azure.

2. Copie a seguinte 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 cria uma tabela com o nome da aplicação, localização e grupo de recursos para todas as aplicações Consumption a correr no Windows na subscrição atual.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

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 das regiões do Azure onde o plano Flex Consumption é atualmente suportado.

O processo de criação de uma aplicação de funções no portal do Azure filtra regiões que o plano Flex Consumption atualmente não suporta.

1. No portal Azure, selecione Criar um recurso no menu esquerdo e selecione Function app>Create.

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.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

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 uma aplicação de função no portal do Azure filtra as versões do stack de linguagens que o plano Flex Consumption atualmente não suporta.

1. No portal Azure, selecione Criar um recurso no menu esquerdo e selecione Function app>Create.

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.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

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 Azure, pesquise ou vá à página da sua aplicação de funções.

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.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

Use o az webapp config ssl list comando para listar quaisquer certificados TLS/SSL disponíveis para a sua aplicação funcional:

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

Neste exemplo, substitua <RESOURCE_GROUP> pelo nome do grupo de recursos. Se este comando devolver a saída, a tua aplicação provavelmente está a usar certificados.

Para determinar se a sua aplicação de funções está a usar certificados TLS/SSL:

1. No portal Azure, pesquise ou vá para a página da sua aplicação de funções.

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

3. Verifique os separadores de Certificados Geridos, Traga os seus próprios certificados (.pfx) e Certificados de Chave Pública (.cer) para quaisquer certificados instalados.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

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 devolver linhas, há pelo menos um gatilho a utilizar polling de contêiner na sua aplicação de funções.

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 Azure, pesquise ou aceda à página da sua aplicação de funções.

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 source não tiver propriedade ou source tiver um valor de LogsAndContainerScan, o gatilho utiliza consulta de contentores. 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.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

Use o az functionapp config appsettings list comando para devolver um app_settings objeto que contenha as definições existentes da aplicação 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> por nome do seu grupo de recursos e nome da aplicação.

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

1. No portal Azure, pesquise ou vá à página da sua aplicação de funções.

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

3. No separador de definições da App, selecione Edição avançada e copie e guarde o conteúdo das definições JSON da aplicação.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

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 Azure, pesquise ou vá à página da sua aplicação 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 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.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

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> por nome do seu grupo de recursos e nome da aplicação. Anote todas as identidades e suas atribuições de função.

1. No portal Azure, pesquise ou vá à página da sua aplicação de funções.

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 ativado, selecione atribuições de funções do Azure para visualizar as funções atribuídas a esta identidade.

4. Verifique a aba Utilizador atribuído para ver se alguma identidade gerida pelo utilizador está atribuída. Observe os nomes de todas as identidades atribuídas pelo usuário.

5. Para cada identidade gerida atribuída pelo utilizador, selecione a identidade. Na página de identidade, selecione atribuições de funções 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.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

Use o az webapp auth show comando para verificar se a autenticação incorporada está configurada na sua aplicação de função:

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

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

Recrie estas definições na sua nova aplicação após a migração para que os seus clientes possam manter o acesso usando o seu fornecedor preferido.

Para verificar se a autenticação do cliente incorporada está configurada:

1. No portal Azure, pesquise ou vá para a página da sua aplicação de funções.

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

3. Se a autenticação incorporada estiver ativada, note quais os fornecedores de identidade do cliente configurados. Observe também todas as configurações avançadas, como armazenamento de tokens, redirecionamentos externos permitidos e públicos de token permitidos.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

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> por nome do seu grupo de recursos e nome da aplicação.

1. No portal Azure, pesquise ou vá à página da sua aplicação de funções.

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

3. Se vires Ativado sem restrições de acesso para rede pública, então 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.

Se utilizou o prompt de descoberta na secção Identificar, a capacidade já avaliou, criou e configurou a sua nova aplicação Flex Consumption. Pode saltar esta secção e continuar para os passos de Migração.

Se já sabe qual a aplicação a migrar, use este prompt:

migrate my app <APP_NAME> to flex consumption

A competência gere automaticamente a avaliação, criação de aplicações e migração de configuração — equivalente ao az functionapp flex-migration start comando e aos seus passos de verificação.

O az functionapp flex-migration start comando recolhe a configuração da sua aplicação e cria uma nova aplicação Flex Consumption com as mesmas definições.

az functionapp flex-migration start \
    --source-name <SOURCE_APP_NAME> \
    --source-resource-group <SOURCE_RESOURCE_GROUP> \
    --name <NEW_APP_NAME> \
    --resource-group <RESOURCE_GROUP>

Neste exemplo, substitui estes marcadores de posição pelos valores do teu cenário:

O az functionapp flex-migration start comando executa estas tarefas básicas:

• Avalia a compatibilidade do seu aplicativo de origem com o plano de hospedagem Flex Consumption.
• Cria um aplicativo de função no plano Flex Consumption.
• Migra a maioria das configurações, incluindo definições da aplicação, atribuições de identidade, montagens de armazenamento, definições de CORS, domínios personalizados e restrições de acesso.

O comando migration suporta várias opções para personalizar a migração:

Para obter opções de comando completas, use az functionapp flex-migration start --help.

O portal do Azure não fornece um comando de migração automatizado para aplicações Linux. Utilize os separadores CLI do Azure ou GitHub Copilot para obter a experiência recomendada de migração no Linux.

A competência de migração do Copilot tenta descarregar e redistribuir o seu projeto de código existente para a nova aplicação. Se não for bem-sucedido, ele orienta-o na obtenção e implementação do seu pacote de código como parte do fluxo de trabalho de migração. Pode saltar esta secção e continuar para os Passos de Migração.

1. Use o az functionapp config appsettings list comando para obter a definição da WEBSITE_RUN_FROM_PACKAGE aplicação, se existir:

   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> por nome do seu grupo de recursos e nome da aplicação. Se este comando devolver uma URL, pode descarregar o ficheiro do pacote de implementação a partir dessa localização remota e saltar para a secção seguinte.

2. Se o WEBSITE_RUN_FROM_PACKAGE valor estiver 1 ou vazio, use este script para obter o pacote de implementação para a aplicação 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 Azure, pesquise ou vá à página da sua aplicação 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, assegure-se de o definir para um valor de 1 ou uma 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 do endereço URL que possui.

4. Se a definição WEBSITE_RUN_FROM_PACKAGE não existir ou estiver definida para 1, deve descarregar o pacote a partir da conta de armazenamento específica, o que depende se está a correr em Linux ou 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.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

1. Use o az functionapp config appsettings list comando para obter a definição da WEBSITE_RUN_FROM_PACKAGE aplicação, se existir:

   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> por nome do seu grupo de recursos e nome da aplicação. Se este comando devolver uma URL, pode descarregar o ficheiro do pacote de implementação a partir dessa localização remota e saltar para a secção seguinte.

2. Se o WEBSITE_RUN_FROM_PACKAGE valor estiver 1 ou vazio, use este script para obter o pacote de implementação para a aplicação 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 Azure, pesquise ou vá à página da sua aplicação 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, assegure-se de atribuir-lhe um valor de 1 ou uma 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 do endereço URL que possui.

4. Se a definição WEBSITE_RUN_FROM_PACKAGE não existir ou estiver definida para 1, deve descarregar o pacote a partir da conta de armazenamento específica, o que depende se está a correr em Linux ou Windows.

5. Obtenha o nome da conta de armazenamento na WEBSITE_CONTENTAZUREFILECONNECTIONSTRING definição, onde o 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.

A competência de migração do Copilot verifica automaticamente a nova aplicação como parte da migração. Se iniciaste a migração usando um pedido ao Copilot em iniciar a migração para Linux, a habilidade já verificou que a aplicação foi criada e configurada corretamente. Pode saltar esta secção e continuar a Configurar autenticação incorporada.

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 estas definições com a sua aplicação de origem para garantir que as configurações críticas são 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 Azure, pesquise a sua nova aplicação de funções 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 Definições>as variáveis de Ambiente e reveja o separador Definições da aplicação para garantir que as definições da aplicação foram migradas corretamente.

4. Verifique >Identidade para confirmar se as identidades geridas estão configuradas como esperado.

5. Se aplicável, verifique Definições>de domínios personalizados para confirmar quaisquer mapeamentos de domínio personalizados.

6. Consulte as Definições>de Rede para verificar as restrições de acesso se existiam na aplicação de origem.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

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 seu grupo de recursos e pelos nomes da aplicação antiga e nova, respetivamente. Esse script pressupõe que ambos os aplicativos estejam no mesmo grupo de recursos.

Para transferir configurações:

1. No Azure portal, pesquise ou vá para a página da sua nova app.

2. No menu esquerdo, expande Definições>variáveis de ambiente. Na guia Configurações do aplicativo, selecione + Adicionar.

3. Escreva ou cole tanto o Nome como o Valor da definição, e depois 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. Também evite quaisquer definições obsoletas no plano Flex Consumption.

5. Depois de adicionares todas as definições relevantes, seleciona Aplicar>Guardar.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

Neste script, defina o valor de qualquer conjunto de configuração na aplicação original e comente quaisquer 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 nomes de grupos de recursos e de aplicações funcionais. Além disso, substitua os marcadores de quaisquer definições de variáveis para definições existentes que queira recriar na nova aplicação e comente quaisquer null definições.

1. No portal Azure, procure ou aceda à página da sua nova aplicação.

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.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

Use o az functionapp scale config set comando 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> por nomes de grupos de recursos e de aplicações funcionais. Substitui <MAX_SCALE_SETTING> pelo valor máximo da escala que queres definir.

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

1. No Azure Portal, procure ou aceda à página da sua nova aplicação.

2. No menu esquerdo, expande Definições>Escala e concorrência. Para o número máximo de instâncias, defina um valor máximo para até onde a sua aplicação pode escalar.

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

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

1. Use o az functionapp config hostname add comando para reassociar mapeamentos de domínio personalizados à sua aplicação:

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

   Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> por nomes de grupos de recursos e de aplicações funcionais. Substitua <CUSTOM_DOMAIN> pelo seu nome de domínio personalizado.

2. Use o az functionapp cors add comando para substituir as definiçõ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> por nomes de grupos de recursos e de aplicações funcionais. Substitua <ALLOWED_ORIGIN_*> pelas suas origens permitidas.

1. No portal Azure, procure ou aceda à página da sua nova aplicação.

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.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

1. Use o az functionapp identity assign comando para ativar a identidade gerida atribuída pelo sistema na sua nova aplicação:

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

   Neste exemplo, substitua <RESOURCE_GROUP> e <APP_NAME> por nomes de grupos de recursos e de aplicações funcionais.

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 Azure, procure ou aceda à página da sua nova aplicação.

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ções do Azure no painel esquerdo.

4. Selecione + Adicionar atribuição de função e defina estas propriedades de atribuição para um papel que documentou na aplicação 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 Guardar para adicionar o escopo. Para adicionar mais funções, repita o passo anterior para cada função documentada exigida pela nova aplicação.

1. No portal Azure, procure ou aceda à página da sua nova aplicação.

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

3. Selecione uma identidade existente e depois selecione Adicionar.

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

5. Selecione + Adicionar atribuição de função e defina estas propriedades de atribuição para um papel que documentou na aplicação 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 Guardar para adicionar o escopo. Para adicionar mais funções, repita o passo anterior para cada função documentada exigida pela nova aplicação.

A competência de migração do GitHub Copilot só é atualmente suportada na migração de aplicações Linux. Para migrar uma aplicação Windows Consumption, use o CLI do Azure ou o Azure portal.

Use o az functionapp config access-restriction add comando para cada restrição de acesso ao IP que pretende replicar na nova aplicação:

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 Azure, procure ou aceda à página da sua nova aplicação.

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.