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 seus passos principais são:

Configura o GitHub Copilot usando os pré-requisitos e depois usa o prompt em Iniciar a migração. O Copilot orienta-o na avaliação, preparação de código Windows para Linux, criação e configuração de destinos, implantação, validação e corte de produção. Pede a tua opinião ou aprovação quando necessário.

As secções seguintes explicam as verificações e as tarefas de migração a título de referência. Não precisas de realizar os passos manuais de CLI ou portal quando segues o fluxo de trabalho do Copilot.

O Copilot mantém a aplicação de origem em modo só de leitura durante a avaliação e replicação. Alterações aos gatilhos de origem, definições, estado da aplicação ou recursos requerem aprovação explícita para a ação específica.

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.

Para identificar aplicações de Windows Consumption na sua subscrição sem iniciar uma migração, use este prompt:

What Windows Consumption Function Apps can I upgrade to Flex Consumption?

O Copilot descobre aplicações candidatas e verifica a sua região, runtime, configuração de implementação e outros requisitos de compatibilidade. A descoberta identifica candidatos, não garante que cada aplicação esteja pronta para migrar. Rever a avaliação antes de prosseguir.

Para migrar uma aplicação específica, use o prompt em Start the migration.

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.

O Copilot verifica se o Flex Consumption está disponível na região da aplicação de origem e regista o resultado na avaliação. Se a região não for suportada, resolve a escolha da localização antes de resolveres criar a aplicação de destino.

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.

O Copilot compara a versão em língua de origem com as versões suportadas pelo Flex Consumption na região-alvo. Utiliza metadados do projeto ou do pacote de implementação quando a configuração do Azure está em falta ou é ambígua, e pede-lhe para selecionar uma versão alvo quando a evidência não identifica uma única versão suportada.

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.

O Copilot deteta os slots de implementação de origem e regista-os na análise. Como o Flex Consumption não suporta slots, escolha como consolidar as respetivas funcionalidades ou usar aplicações separadas antes de continuar.

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.

O Copilot faz o inventário dos certificados usados pela aplicação de origem e verifica os limites de certificados no âmbito do site. Não transfere automaticamente os certificados. Adicione novamente os certificados necessários usando o processo de certificado com âmbito de site, e atualize o código que lê a loja de certificados do Windows para usar os caminhos dos ficheiros de certificados do Linux.

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 sua aplicação está a usar certificados que precisa de voltar a adicionar à nova aplicação Flex Consumption após a migração.

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

1. No portal Azure, pesquise ou vá à 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.

O Copilot identifica as associações de acionador Blob pelo tipo e assinala qualquer acionador cuja origem não esteja explicitamente EventGrid. Orienta a alteração de código necessária e a configuração da subscrição de eventos antes da implementação.

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 "[].{Function:name, BlobTrigger:(config.bindings[?type=='blobTrigger'] | [0])} | [?BlobTrigger && BlobTrigger.source!='EventGrid'].{Function:Function, TriggerType:BlobTrigger.type, Source:BlobTrigger.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 vá à 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.

O Copilot analisa nomes de definição de aplicações sem mostrar valores secretos. Pergunta se deves copiar as definições de origem filtradas ou adiá-las para que possas configurar dependências de alvo isoladas. Se adiar as definições, a implementação espera até que a configuração alvo necessária esteja pronta.

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.

O Copilot inventaria definições do site, limites de escala, CORS, domínios personalizados e outras configurações. Regista itens não suportados ou manipulados manualmente na avaliação. Os metadados explícitos de montagem do Ficheiros do Azure são apenas de inventário para esta migração do Windows.

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.

O Copilot inventaria identidades geridas atribuídas ao sistema e ao utilizador, bem como as suas atribuições de funções. Utiliza este inventário para configurar as identidades do alvo e recriar o acesso necessário aos recursos apropriados.

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.

O Copilot inventaria os fornecedores ativados e o comportamento de autenticação sem expor segredos dos fornecedores. Identifica URIs de callback específicos do destino e orienta a configuração do provedor antes da implementação do código. Não copia automaticamente registos de fornecedores ou segredos.

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á à 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.

O Copilot inventaria e recria restrições de acesso compatíveis. Não enfraquece automaticamente essas restrições para que as verificações de saúde da implantação ou a validação HTTP sejam bem-sucedidas.

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.

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

Migrate my Windows Consumption Function App <APP_NAME> to Flex Consumption.

Substitui <APP_NAME> pelo nome da tua aplicação de origem. O Copilot apresenta o plano de migração, realiza a avaliação, inventaria a configuração e cria uma nova aplicação Flex Consumption juntamente com a origem.

Por defeito, o fluxo de trabalho propõe <APP_NAME>-flex para o nome da aplicação de destino. O Copilot pede para escolher se reutiliza a conta de armazenamento de origem, cria uma nova ou usa uma conta existente específica antes de criar a aplicação de destino. Pode pedir um nome do destino diferente ou indicar a sua preferência de armazenamento no prompt. Revê a escolha de armazenamento porque dependências partilhadas permitem que ambas as aplicações processem os mesmos eventos.

O Copilot verifica se as contas de armazenamento selecionadas permitem autenticação por Chave Partilhada e pergunta sobre os requisitos da política apenas de identidade. Se a criação baseada em chaves não for permitida, o Copilot pausa antes de criar a aplicação alvo. Crie uma aplicação Flex Consumption vazia dedicada a esta migração na mesma subscrição, usando infraestrutura como código com prioridade à identidade. Configurar o acesso de identidade gerida tanto para o armazenamento do anfitrião como para o da implementação, as atribuições de funções necessárias e a monitorização. Ainda não faças o deployment do código da função. Para exemplos de provisionamento, veja os exemplos de infraestrutura como código Flex Consumption.

Devolva o ID completo do recurso Azure do alvo e o caminho do ficheiro de progresso guardado. O Copilot verifica o alvo existente e, após a sua aprovação, retoma a configuração e implementação sem criar outra aplicação. Use este prompt:

Resume the Flex Consumption migration for <APP_NAME> using progress at <PROGRESS_FILE_PATH>.
I provisioned a keyless target at <TARGET_RESOURCE_ID>. Use that existing target; do not create another app.

Antes da implantação, o Copilot orienta a preparação do código Windows-para-Linux, a configuração do alvo, a autenticação incorporada e a segurança de accionadores não HTTP. Depois, oferece implantação através de um pipeline atualizado, um projeto local ou um pacote de implantação compatível.

Por defeito, o Copilot regista o progresso em .azure-upgrade/<SOURCE_APP_NAME>/upgrade-status.md. Para retomar, use este prompt:

Resume the Flex Consumption migration for <APP_NAME>.

Os az functionapp flex-migration comandos não suportam aplicações Windows Consumption. Siga as tarefas de Pré-Migração e os passos de Migração do Windows, em vez disso.

Siga as tarefas de Pré-Migração e os passos de Migração do Windows para criar e configurar manualmente a aplicação de destino.

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.

O Copilot pede primeiro um diretório de origem local. Se a fonte não estiver disponível, é possível recuperar o pacote implementado a partir da partilha de conteúdo da aplicação de origem ou do URL do pacote externo. Verifica se o pacote é adequado para Linux e Flex Consumption; Compilações específicas para Windows requerem preparação em vez de nova implementação direta.

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 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 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 > 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.

Após a aprovação, o Copilot copia as definições suportadas da aplicação sem mostrar ou persistir valores secretos brutos. Preserva o armazenamento pertencente ao alvo e as definições do Application Insights. Também revê : as __ conversões de nomes necessárias no Linux e para se os nomes de origem forem mapeados de forma ambígua.

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.

O Copilot aplica a configuração compatível do site a partir do inventário e verifica o destino. Definições não suportadas e itens que requerem manuseamento manual continuam a ser trabalho de seguimento explícito em vez de serem copiados silenciosamente.

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 Azure portal, pesquise ou vá para a página da sua nova app.

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.

O Copilot verifica qualquer definição de escalabilidade horizontal máxima da origem com o intervalo suportado do Flex Consumption antes de a aplicar. Se a fonte não definiu um limite personalizado, mantém o valor predefinido do destino. Reveja o ajuste da concorrência específico da carga de trabalho após a migração.

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, pesquise ou vá para a página da sua nova app.

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.

O Copilot recria uma configuração CORS compatível e orienta a configuração de domínio personalizado. Qualquer alteração nas ligações de origem, DNS ou encaminhamento de produção requer aprovação separada; criar a aplicação alvo não completa o corte de tráfego.

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 Azure portal, pesquise ou vá para a página da sua nova app.

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.

O Copilot permite uma identidade atribuída pelo sistema no destino e recria as atribuições de funções necessárias para a sua nova identidade. Verifica o acesso em relação aos recursos de destino em vez de reutilizar a identidade principal de origem.

O Copilot anexa as identidades atribuídas pelo utilizador selecionadas e verifica as atribuições de funções necessárias. Reutilizar uma identidade não substitui a necessidade de validar o acesso a recursos específicos do alvo.

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 Azure portal, pesquise ou vá para a página da sua nova app.

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 Azure portal, pesquise ou vá para a página da sua nova app.

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.

O Copilot recria restrições de acesso à origem compatíveis e verifica-as. Se essas restrições impedirem testes HTTP diretos, regista a validação como diferida em vez de abrir o acesso automaticamente.

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 Azure portal, pesquise ou vá para a página da sua nova app.

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.