Migración de aplicaciones del plan de consumo al plan de consumo flexible

La funcionalidad de Azure automatiza la mayor parte de la migración. Tus pasos a alto nivel son:

Los comandos de la flex-migration CLI automatizan la creación y configuración de aplicaciones. Tus pasos a alto nivel son:

El portal proporciona una ruta de migración manual. Tus pasos a alto nivel son:

Configura GitHub Copilot usando los requisitos previos y luego usa las indicaciones en Iniciar la migración. Copilot te guía en la evaluación, preparación del código de Windows a Linux, creación y configuración del entorno de destino, despliegue, validación y transición a producción. Te pide tu opinión o aprobación cuando lo necesita.

Las siguientes secciones explican las tareas de comprobación y migración para referencia. No necesitas realizar los pasos manuales de CLI o portal cuando sigues el flujo de trabajo de Copilot.

Copilot mantiene la aplicación de origen en modo solo lectura durante la evaluación y la replicación. Los cambios en los disparadores de origen, configuración, estado de la app o recursos requieren aprobación explícita para la acción específica.

Windows migración requiere pasos manuales para la creación y configuración de aplicaciones. Tus pasos a alto nivel son:

Windows migración requiere pasos manuales para la creación y configuración de aplicaciones. Tus pasos a alto nivel son:

Para iniciar una migración interactiva que examine la suscripción y le pida que elija qué aplicaciones migrar, use este mensaje:

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

Copilot identifica las aplicaciones de consumo de Linux aptas, le permite elegir cuáles se van a migrar y, a continuación, le guía por la evaluación, la creación de aplicaciones, la configuración y la implementación de cada aplicación. Continúe con los pasos de migración.

Si solo desea ver qué aplicaciones son compatibles sin iniciar la migración, use este comando en su lugar:

list my linux consumption apps eligible for flex consumption migration

Copilot devuelve una lista de aplicaciones aptas e inelegibles, junto con las razones de cualquier incompatibilidad. Después, puede migrar una aplicación específica utilizando el aviso en Iniciar la migración para Linux.

Ejecute este comando para ver cuál de las aplicaciones de consumo de Linux está lista para migrar:

az functionapp flex-migration list

Este comando examina automáticamente la suscripción y devuelve dos matrices:

• eligible_apps: aplicaciones de consumo de Linux que se pueden migrar a Flex Consumption. Estas aplicaciones son compatibles con Flex Consumption.
• ineligible_apps: aplicaciones que no se pueden migrar, junto con las razones específicas por las que. Revise y solucione los motivos de incompatibilidad antes de continuar.

La salida incluye el nombre de la aplicación, el grupo de recursos, la ubicación y la pila en tiempo de ejecución de cada aplicación, junto con el estado de elegibilidad y la disponibilidad para la migración.

1. Vaya al Azure Resource Graph Explorer en el portal de Azure.

2. Copie la siguiente consulta de Kusto, péguela en la ventana de consulta y seleccione Ejecutar 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 crea una tabla con el nombre de la aplicación, la ubicación, el grupo de recursos y la pila en tiempo de ejecución para todas las aplicaciones de consumo que se ejecutan en Linux en la suscripción actual.

Para identificar las aplicaciones de Windows Consumption en tu suscripción sin iniciar una migración, utiliza este prompt:

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

Copilot detecta aplicaciones candidatas y comprueba su región, tiempo de ejecución, configuración de despliegue y otros requisitos de compatibilidad. El descubrimiento identifica candidatos, no garantiza que cada aplicación esté lista para migrar. Revisa la evaluación antes de continuar.

Para migrar una aplicación específica, utilice la indicación de Iniciar la migración.

Use el comando az graph query para enumerar todas las aplicaciones de función de tu suscripción que se ejecutan en un plan 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 crea una tabla con el nombre de la aplicación, la ubicación y el grupo de recursos para todas las aplicaciones de consumo que se ejecutan en Windows de la suscripción actual.

Si aún no lo tiene, se le pedirá que instale la extensión resource-graph.

1. Vaya al Azure Resource Graph Explorer en el portal de Azure.

2. Copie la siguiente consulta de Kusto, péguela en la ventana de consulta y seleccione Ejecutar consulta:

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

Este comando crea una tabla con el nombre de la aplicación, la ubicación y el grupo de recursos para todas las aplicaciones de consumo que se ejecutan en Windows de la suscripción actual.

Copilot comprueba si Flex Consumption está disponible en la región de la app de origen y registra el resultado en la evaluación. Si la región no está soportada, resuelve la elección de ubicación antes de crear la aplicación objetivo.

Use este az functionapp list-flexconsumption-locations comando para enumerar todas las regiones en las que está disponible el plan de consumo flexible:

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

Este comando genera una tabla de las regiones de Azure en las que actualmente se admite el plan de Consumo Flexible.

El proceso de creación de una aplicación de funciones en el portal de Azure filtra las regiones que el plan de consumo flexible no admite actualmente.

1. En el portal Azure, seleccione Crear un recurso en el menú izquierdo y seleccione Function app>Crear.

2. Seleccione Consumo flexible> y en la pestaña Aspectos básicos, expanda Región.

3. Revise las regiones compatibles del plan de Consumo Flexible.

Asegúrese de que la región en la que se ejecuta la aplicación de Plan de consumo que desea migrar esté incluida en la lista.

Copilot compara la versión en el idioma original con las versiones soportadas por Flex Consumption en la región objetivo. Utiliza metadatos del proyecto o del paquete de despliegue cuando falta o es ambigua la configuración de Azure, y te pide que selecciones una versión objetivo cuando la evidencia no identifica una única versión compatible.

Use este comando az functionapp list-flexconsumption-runtimes para comprobar la compatibilidad del plan de consumo flexible con la versión de la pila de idiomas en una región específica:

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

En este ejemplo, reemplace por <REGION> la región actual y <LANGUAGE_STACK> por uno de estos valores:

Este comando muestra todas las versiones del stack de lenguaje especificado que son compatibles con el Flex Consumption plan en su región.

El proceso de creación de una aplicación de funciones en Azure Portal filtra las versiones de pila de lenguaje que el plan de Consumo flexible no admite actualmente.

1. En el portal Azure, seleccione Crear un recurso en el menú izquierdo y seleccione Function app>Crear.

2. Seleccione Consumo flexible>Seleccionar y, en la pestaña Aspectos básicos, seleccione su pila de tiempo de ejecución de idioma y su Región.

3. Expanda Versión y revise las versiones admitidas de la pila de idiomas en la región elegida.

Copilot detecta las ranuras de despliegue de origen y las registra en la evaluación. Dado que Consumo flexible no admite ranuras, elige cómo consolidar su funcionalidad o utiliza aplicaciones independientes antes de continuar.

Use este az functionapp deployment slot list comando para enumerar las ranuras de implementación definidas en la aplicación de funciones:

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

En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por el nombre del grupo de recursos y el nombre de la aplicación, respectivamente. Si el comando devuelve una entrada, la aplicación tiene habilitadas las ranuras de implementación.

Para determinar si la aplicación de funciones tiene ranuras de implementación habilitadas:

1. En el portal de Azure, busque o acceda a su página de la aplicación de funciones.

2. En el menú izquierdo, seleccione Ranuras de implementación>.

3. Si ve alguna ranura enumerada en la página Ranuras de implementación, su aplicación de funciones está utilizando actualmente las ranuras de implementación.

Copilot cataloga los certificados utilizados por la aplicación de origen y comprueba los límites de certificados con alcance del sitio. No transfiere automáticamente los certificados. Vuelve a añadir los certificados necesarios utilizando el proceso de certificado con alcance de sitio y actualiza el código que lee el almacén de certificados de Windows para usar rutas de archivos de certificados de Linux.

Use el az webapp config ssl list comando para enumerar los certificados TLS/SSL disponibles para la aplicación de funciones:

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

En este ejemplo, reemplace por <RESOURCE_GROUP> el nombre del grupo de recursos. Si este comando devuelve la salida, la aplicación usa certificados que necesita volver a agregar a la nueva aplicación Flex Consumption después de la migración.

Para determinar si la aplicación de funciones usa certificados TLS/SSL:

1. En el portal de Azure, busque o acceda a su página de la aplicación de funciones.

2. En el menú de la izquierda, seleccione Configuración>Certificados.

3. Compruebe las pestañas Certificados administrados, Traiga sus propios certificados (.pfx) y Certificados de clave pública (.cer) para ver los certificados instalados.

Copilot identifica los enlaces de desencadenador Blob por tipo y marca cualquier desencadenador cuya fuente no sea explícitamente EventGrid. Guía el cambio de código requerido y la configuración de la suscripción a eventos antes del despliegue.

Use este comando [az functionapp function list] para determinar si la aplicación tiene desencadenadores de Blob Storage que no usan Event Grid como origen:

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

En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por el nombre del grupo de recursos y el nombre de la aplicación, respectivamente. Si el comando devuelve filas, hay al menos un desencadenador que utiliza sondeo de contenedores en la aplicación de funciones.

Para determinar si la aplicación de funciones tiene desencadenadores de Blob Storage que no usan Event Grid como origen:

1. En el portal de Azure, busque o acceda a su página de la aplicación de funciones.

2. En la pestaña Información general de la pestaña Funciones , busque cualquier función con un tipo desencadenador de Blob.

3. Seleccione una función de desencadenador de blobs y, en Código y prueba , seleccione JSON de recurso.

4. Busque la sección properties.config.bindings de la definición de función. Esta sección debe tener un bindings.type de blobTrigger. Si el bindings objeto no tiene ninguna source propiedad o source tiene un valor de LogsAndContainerScan, el desencadenador usa el sondeo de contenedor. En su lugar, un desencadenador de origen de Event Grid tiene un valor source de EventGrid.

5. Repita los pasos del 3 al 4 para las funciones restantes del desencadenador de Blob Storage en la aplicación.

Copilot revisa nombres de configuración de apps sin mostrar valores secretos. Te pregunta si deseas copiar la configuración de origen filtrada o aplazarla para que puedas configurar las dependencias de destino de forma aislada. Si pospones la configuración, el despliegue espera hasta que la configuración de destino requerida esté lista.

Use el az functionapp config appsettings list comando para devolver un app_settings objeto que contenga la configuración de la aplicación existente como JSON:

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

En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por el nombre del grupo de recursos y el nombre de la aplicación.

Para obtener la configuración actual de la aplicación de funciones:

1. En el portal de Azure, busque o acceda a su página de la aplicación de funciones.

2. En el menú izquierdo, expanda Configuración y seleccione Variables de entorno.

3. En la pestaña Configuración de la aplicación, seleccione Edición avanzada y copia y guarde el contenido de configuración de la aplicación JSON.

Copilot hace un inventario de la configuración del sitio, los límites de escala, CORS, los dominios personalizados y otras configuraciones. Registra los elementos no soportados o manipulados manualmente en la evaluación. Los metadatos explícitos de montaje en Azure Files son solo de inventario para esta migración de Windows.

Use este script para obtener las configuraciones de aplicación pertinentes de la aplicación 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 

En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por el nombre del grupo de recursos y el nombre de la aplicación, respectivamente. Si alguna de las configuraciones del sitio o comprobaciones devuelven valores no nulos, tome nota de ellos.

Para revisar las configuraciones de aplicación pertinentes de la aplicación existente:

1. En el portal de Azure, busque o acceda a su página de la aplicación de funciones.

2. En el menú de la izquierda, expanda Configuración y seleccione Configuración.

3. En la pestaña Configuración general , anote estos valores:

   • Credenciales de autenticación básica de publicación de SCM
   • Versión HTTP
   • Solo HTTPS
   • Versión mínima de TLS de entrada
   • Cifrado TLS de entrada mínimo
   • Certificados de cliente entrantes

4. En la pestaña Asignaciones de ruta, compruebe si existe algún montaje de recurso compartido de archivos requerido por su aplicación. Si lo hay, anote el nombre de la cuenta de almacenamiento, el nombre del recurso compartido, la ruta de acceso de montaje y el tipo de acceso para cada recurso compartido montado.

5. En Configuración>Escalado horizontal, si Aplicar límite de escalabilidad horizontal está establecido en Sí, tenga en cuenta el valor Límite máximo de escalado horizontal.

6. En Configuración Dominios>personalizados, anote los nombres de dominio que no sean *.azurewebsites.net, el tipo de enlace y la información del certificado SSL.

7. Bajo API>CORS, tenga en cuenta los orígenes de CORS permitidos explícitamente y otras configuraciones de CORS.

Copilot realiza un inventario de las identidades administradas asignadas por el sistema y por el usuario, así como de sus asignaciones de roles. Utiliza este inventario para configurar las identidades del objetivo y recrear el acceso necesario sobre los recursos apropiados.

Este script comprueba la identidad administrada asignada por el sistema y las identidades administradas asignadas por el usuario asociadas a la aplicación:

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

En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por el nombre del grupo de recursos y el nombre de la aplicación. Anote todas las identidades y sus asignaciones de roles.

1. En el portal de Azure, busque o acceda a su página de la aplicación de funciones.

2. En el menú izquierdo, expanda Configuración y seleccione Identidad.

3. Compruebe la pestaña Sistema asignado para ver si la identidad administrada por el sistema está habilitada. Si está habilitado, seleccione asignaciones de roles de Azure para ver los roles asignados a esta identidad.

4. Compruebe la pestaña Usuario asignado para ver si se asignan identidades administradas asignadas por el usuario. Anote los nombres de las identidades asignadas por el usuario.

5. Para cada identidad administrada asignada por el usuario, seleccione la identidad. En la página de identidad, seleccione asignaciones de roles de Azure.

6. Tome nota de cada asignación de roles concedida a la identidad y determine si la aplicación lo requiere.

Documente todas las identidades y sus asignaciones de roles para que pueda volver a crear la misma estructura de permisos para la nueva aplicación Flex Consumption.

Copilot realiza un inventario de los proveedores habilitados y del comportamiento de autenticación sin exponer los secretos de los proveedores. Identifica los URI de callback específicos de cada objetivo y guía la configuración del proveedor antes del despliegue del código. No copia automáticamente los registros de proveedores ni los secretos.

Use el az webapp auth show comando para comprobar si la autenticación integrada está configurada en la aplicación de funciones:

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

En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por el nombre del grupo de recursos y el nombre de la aplicación. Revise la salida para determinar si la autenticación está habilitada y qué proveedores de identidades están configurados.

Vuelva a crear esta configuración en la nueva aplicación después de la migración para que los clientes puedan mantener el acceso mediante su proveedor preferido.

Para comprobar si la autenticación de cliente integrada está configurada:

1. En el portal de Azure, busque o acceda a su página de la aplicación de funciones.

2. En el menú de la izquierda, expanda Configuración y seleccione Autenticación.

3. Si la autenticación integrada está habilitada, tenga en cuenta qué proveedores de identidades de cliente están configurados. Tenga en cuenta también cualquier configuración avanzada, como el almacén de tokens, las redirecciones externas permitidas y las audiencias de tokens permitidas.

Copilot realiza un inventario y recrea las restricciones de acceso compatibles. No debilita automáticamente esas restricciones para que las comprobaciones de salud del despliegue o la validación HTTP tengan éxito.

Este az functionapp config access-restriction show comando devuelve una lista de las restricciones de acceso basadas en IP existentes:

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

En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por el nombre del grupo de recursos y el nombre de la aplicación.

1. En el portal de Azure, busque o acceda a su página de la aplicación de funciones.

2. En el menú izquierdo, expanda Configuración y seleccione Redes.

3. Si ve Habilitado sin restricciones de acceso para el acceso a la red pública, no hay restricciones de acceso de entrada. De lo contrario, seleccione Restricciones de acceso.

4. Documente todas las restricciones de acceso basadas en IP configuradas.

Si ha usado la solicitud de detección en la sección Identificar, la habilidad ya ha evaluado, creado y configurado su nueva aplicación Consumo flexible. Puede omitir esta sección y continuar con los pasos de migración.

Si ya sabe qué aplicación se va a migrar, use este mensaje:

migrate my app <APP_NAME> to flex consumption

La habilidad gestiona automáticamente la evaluación, la creación de aplicaciones y la migración de configuración az functionapp flex-migration start, que son equivalentes al comando y sus pasos de comprobación.

El az functionapp flex-migration start comando recopila la configuración de la aplicación y crea una nueva aplicación flex Consumption con la misma configuración.

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

En este ejemplo, reemplace estos marcadores de posición por los valores de su escenario:

El az functionapp flex-migration start comando realiza estas tareas básicas:

• Evalúa la aplicación de origen por motivos de compatibilidad con el plan de hospedaje Flex Consumption.
• Crea una aplicación de funciones en el Plan Flex Consumption.
• Migra la mayoría de las configuraciones, incluida la configuración de la aplicación, las asignaciones de identidades, los montajes de almacenamiento, la configuración de CORS, los dominios personalizados y las restricciones de acceso.

El comando de migración admite varias opciones para personalizar la migración:

Para obtener opciones de comando completas, use az functionapp flex-migration start --help.

El portal de Azure no proporciona un comando de migración automatizada para aplicaciones Linux. Use las pestañas CLI de Azure o GitHub Copilot para la experiencia de migración de Linux recomendada.

Si ya sabe qué aplicación se va a migrar, use este mensaje:

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

Sustituye <APP_NAME> por el nombre de tu app de origen. Copilot presenta el plan de migración, realiza evaluaciones, inventaría la configuración y crea una nueva aplicación Flex Consumption junto a la aplicación de origen.

Por defecto, el flujo de trabajo propone <APP_NAME>-flex como nombre de la aplicación de destino. Copilot te pide que elijas si reutilizar la cuenta de almacenamiento fuente, crear una nueva o usar una cuenta existente específica antes de crear la aplicación objetivo. Puedes solicitar un nombre de destino diferente o indicar tu preferencia de almacenamiento en el prompt. Revisa la elección de almacenamiento porque las dependencias compartidas permiten que ambas aplicaciones procesen los mismos eventos.

Copilot comprueba si las cuentas de almacenamiento seleccionadas permiten la autenticación por clave compartida y pregunta sobre los requisitos de política solo de identidad. Si no se permite la creación basada en claves, Copilot pausa antes de crear la aplicación objetivo. Aprovisiona una aplicación Flex Consumption vacía dedicada a esta migración en la misma suscripción, mediante infraestructura como código con prioridad para la identidad. Configura el acceso mediante identidad administrada tanto para el almacenamiento de host como para el de implementación, las asignaciones de roles requeridas y la supervisión. No implementes el código de la función todavía. Para ejemplos de provisionamiento, véase los ejemplos de infraestructura como código de Flex Consumption.

Devuelva el ID completo de recurso de Azure del destino y la ruta guardada del archivo de progreso. Copilot verifica el destino existente y, tras tu aprobación, reanuda la configuración y el despliegue sin crear otra aplicación. Utilice este indicador

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 del despliegue, Copilot guía la preparación del código de Windows a Linux, la configuración de destino, la autenticación integrada y la seguridad de desencadenadores no HTTP. Luego ofrece el despliegue a través de una pipeline actualizada, un proyecto local o un paquete de despliegue compatible.

Por defecto, Copilot registra el progreso en .azure-upgrade/<SOURCE_APP_NAME>/upgrade-status.md. Para reanudar, utiliza este prompt:

Resume the Flex Consumption migration for <APP_NAME>.

Los comandos az functionapp flex-migration no son compatibles con las aplicaciones de consumo de Windows. Sigue las tareas de premigración y los pasos de migración de Windows en su lugar.

Sigue las tareas de premigración y los pasos de migración de Windows para crear y configurar manualmente la aplicación objetivo.

La funcionalidad de migración de Copilot intenta descargar y desplegar su proyecto de código existente en la nueva aplicación. Si no tiene éxito, en su lugar le orienta a través de la obtención e implementación del paquete de código como parte del proceso de migración. Puede omitir esta sección y continuar con los pasos de migración.

1. Use el az functionapp config appsettings list comando para obtener la configuración de la WEBSITE_RUN_FROM_PACKAGE aplicación, si está presente:

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

   En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por el nombre del grupo de recursos y el nombre de la aplicación. Si este comando devuelve una dirección URL, puede descargar el archivo del paquete de implementación desde esa ubicación remota y pasar a la sección siguiente.

2. Si el WEBSITE_RUN_FROM_PACKAGE valor está 1 o está vacío, use este script para obtener el paquete de implementación de la aplicación 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
   

   De nuevo, reemplace <RESOURCE_GROUP> y <APP_NAME> por el nombre del grupo de recursos y el nombre de la aplicación. El paquete .zip archivo se descarga en el directorio desde el que ejecutó el comando.

1. En el portal de Azure, busque o acceda a su página de la aplicación de funciones.

2. En el menú de la izquierda, expanda Configuración>Variables de entorno y vea si existe una configuración denominada WEBSITE_RUN_FROM_PACKAGE .

3. Si WEBSITE_RUN_FROM_PACKAGE existe, asegúrese de establecerlo en un valor de 1 o una dirección URL. Si se establece en una dirección URL, esa dirección URL es la ubicación del archivo de paquete para el contenido de la aplicación. Descargue el archivo ZIP de esa ubicación URL que posee.

4. Si la configuración WEBSITE_RUN_FROM_PACKAGE no existe o está establecida en 1, debe descargar el paquete de la cuenta de almacenamiento específica, que depende de si se ejecuta en Linux o Windows.

5. Obtenga el nombre de la cuenta de almacenamiento de la configuración de la aplicación AzureWebJobsStorage o AzureWebJobsStorage__accountName. Para una cadena de conexión, el AccountName es el nombre de la cuenta de almacenamiento.

6. En el portal, busque el nombre de la cuenta de almacenamiento.

7. En la página de la cuenta de almacenamiento, busque el paquete de implementación y descárguelo.

8. Expanda almacenamiento de datos>Contenedores y seleccione scm_releases. Elija el archivo denominado scm-latest-<APP_NAME>.zip y seleccione Descargar.

Copilot pide primero un directorio de origen local. Si el origen no está disponible, ofrece la posibilidad de recuperar el paquete implementado desde el recurso compartido de contenido de la aplicación de origen o desde una URL de paquete externa. Comprueba si el paquete es adecuado para Linux y Flex Consumption; las compilaciones específicas de Windows requieren preparación en lugar de redespliegue directo.

1. Use el az functionapp config appsettings list comando para obtener la configuración de la WEBSITE_RUN_FROM_PACKAGE aplicación, si está presente:

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

   En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por el nombre del grupo de recursos y el nombre de la aplicación. Si este comando devuelve una dirección URL, puede descargar el archivo del paquete de implementación desde esa ubicación remota y pasar a la sección siguiente.

2. Si el WEBSITE_RUN_FROM_PACKAGE valor está 1 o está vacío, use este script para obtener el paquete de implementación de la aplicación 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
   

   De nuevo, reemplace <RESOURCE_GROUP> y <APP_NAME> por el nombre del grupo de recursos y el nombre de la aplicación. El paquete .zip archivo se descarga en el directorio desde el que ejecutó el comando.

1. En el portal de Azure, busque o acceda a su página de la aplicación de funciones.

2. En el menú de la izquierda, expanda Configuración>Variables de entorno y vea si existe una configuración denominada WEBSITE_RUN_FROM_PACKAGE .

3. Si WEBSITE_RUN_FROM_PACKAGE existe, asegúrese de establecerlo en un valor de 1 o una dirección URL. Si se establece en una dirección URL, esa dirección URL es la ubicación del archivo de paquete para el contenido de la aplicación. Descargue el archivo ZIP de esa ubicación URL que posee.

4. Si la configuración WEBSITE_RUN_FROM_PACKAGE no existe o está establecida en 1, debe descargar el paquete de la cuenta de almacenamiento específica, que depende de si se ejecuta en Linux o Windows.

5. Obtenga el nombre de la cuenta de almacenamiento de la WEBSITE_CONTENTAZUREFILECONNECTIONSTRING configuración, donde AccountName es el nombre de la cuenta de almacenamiento. Además, anote el valor WEBSITE_CONTENTSHARE, que es el nombre del recurso compartido de archivos.

6. En el portal, busque el nombre de la cuenta de almacenamiento.

7. En la página de la cuenta de almacenamiento, busque el paquete de implementación y descárguelo.

8. Expanda Almacenamiento de datos>Comparticiones de archivos, seleccione el nombre del recurso compartido en WEBSITE_CONTENTSHARE y vaya a la subcarpeta data\SitePackages. Elija el archivo de .zip más reciente y seleccione Descargar.

La habilidad de migración de Copilot verifica automáticamente la nueva aplicación como parte de la migración. Si inició la migración con un consulta de Copilot en Iniciar la migración para Linux, la aptitud ya ha comprobado que la aplicación se creó y configuró correctamente. Puede omitir esta sección y continuar con Configurar la autenticación integrada.

1. Compruebe que la nueva aplicación existe y que se está ejecutando:

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

2. Revise la configuración de la aplicación migrada:

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

   Compare esta configuración con la aplicación de origen para asegurarse de que se transfieren las configuraciones críticas.

3. Compruebe la configuración de identidad administrada:

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

4. Compruebe que se han migrado los dominios personalizados:

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

1. En el portal Azure, busque la nueva aplicación de funciones por nombre.

2. En la página Información general de la aplicación, compruebe lo siguiente:

   • El estado se muestra como Running
   • El tipo de plan se muestra como Flex Consumption
   • El grupo de recursos y la ubicación coinciden con sus expectativas

3. En el menú izquierdo, expanda ConfiguraciónVariables de entorno y >Configuración de la aplicación para asegurarse de que la configuración de la aplicación se migró correctamente.

4. Compruebe Configuración>Identidad para verificar que las identidades administradas están configuradas como se esperaba.

5. Si procede, consulte Configuración>Dominios personalizados para verificar las asignaciones de dominio personalizadas.

6. Revise Configuración>Redes para comprobar las restricciones de acceso si existían en la aplicación de origen.

Tras la aprobación, Copilot copia los ajustes compatibles de la app sin mostrar ni persistir los valores secretos en bruto. Conserva el almacenamiento propiedad del destino y la configuración de Application Insights. También revisa las conversiones de nombres de : a __ necesarias en Linux y se detiene si los nombres de origen se asignan de forma ambigua.

Ejecute este script que realice estas tareas:

1. Obtiene la configuración de la aplicación anterior, omitiendo la configuración que no se aplica en un plan de consumo flexible o que ya existe en la nueva aplicación.
2. Escribe la configuración recopilada localmente en un archivo temporal.
3. Aplica la configuración del archivo a la nueva aplicación.
4. Elimina el archivo temporal.

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 

En este ejemplo, reemplace <RESOURCE_GROUP>, <SOURCE_APP_NAME>y <DEST_APP_NAME> por el nombre del grupo de recursos y los nombres de aplicación antiguos y nuevos, respectivamente. Este script supone que ambas aplicaciones están en el mismo grupo de recursos.

Para transferir la configuración:

1. En el portal Azure, busque o, de otro modo, vaya a la página de su nueva aplicación.

2. En el menú izquierdo, expanda Configuración>Variables de entorno. En la pestaña Configuración de la aplicación, seleccione + Agregar.

3. Escriba o pegue tanto el nombre como el valor y, a continuación, seleccione Aplicar.

4. Repita el paso anterior para cada configuración de la aplicación antigua que necesita volver a crear en la nueva aplicación. Si ya existe una configuración en la nueva aplicación, omitala. Omita también cualquier configuración en desuso en el plan de consumo flexible.

5. Después de agregar toda la configuración pertinente, seleccione Aplicar>guardar.

Copilot aplica la configuración de sitio compatible a partir del inventario y verifica el destino. Los ajustes no soportados y los elementos que requieren manipulación manual permanecen como trabajo de seguimiento explícito en lugar de ser copiados silenciosamente.

En este script, establezca el valor de cualquier configuración establecida en la app original y comente los comandos de cualquier configuración no configurada (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

En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por los nombres de la aplicación de función y el grupo de recursos. Además, reemplace los marcadores de posición en las definiciones de variables de cualquier configuración existente que quiera volver a crear en la nueva aplicación, y convierta en comentario cualquier configuración null.

1. En el portal Azure, busque o, de otro modo, vaya a la página de su nueva aplicación.

2. En el menú izquierdo, expandaConfiguración y, en la pestaña >general, actualice esta configuración para que coincida con lo que documentó desde la aplicación plan de consumo original:

   • Credenciales de autenticación básica de publicación de SCM
   • Versión HTTP
   • Solo HTTPS
   • Versión mínima de TLS de entrada y cifrado
   • Configuración del certificado de cliente

3. Seleccione Guardar para aplicar los cambios en la configuración.

Copilot comprueba cualquier configuración máxima de escalabilidad horizontal de origen con el rango de consumo de Flex admitido antes de aplicarla. Si el origen no ha establecido un límite personalizado, se mantiene el límite predeterminado del destino. Revisa el ajuste de la concurrencia específico de la carga de trabajo tras la migración.

Use el comando az functionapp scale config set para establecer la escalabilidad horizontal máxima.

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

En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por los nombres de la aplicación de función y el grupo de recursos. Reemplace <MAX_SCALE_SETTING> por el valor de escala máximo que desea establecer.

Para configurar la escala y la simultaneidad en la nueva aplicación:

1. En el portal Azure, busque o, de otro modo, vaya a la página de su nueva aplicación.

2. En el menú de la izquierda, expanda Configuración>Escala y simultaneidad. En Número máximo de instancias, establezca un valor máximo para la escala de la aplicación.

3. Seleccione Save para aplicar los cambios.

Copilot recrea una configuración CORS compatible y guía la configuración personalizada del dominio. Cualquier cambio en las vinculaciones de origen, DNS o enrutamiento de producción requiere aprobación separada; crear la aplicación objetivo no completa la conmutación del tráfico.

1. Use el az functionapp config hostname add comando para volver a enlazar asignaciones de dominio personalizadas a la aplicación:

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

   En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por los nombres de la aplicación de función y el grupo de recursos. Reemplace por <CUSTOM_DOMAIN> el nombre de dominio personalizado.

2. Use el az functionapp cors add comando para reemplazar la configuración de CORS:

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

   En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por los nombres de la aplicación de función y el grupo de recursos. Reemplace <ALLOWED_ORIGIN_*> por los orígenes permitidos.

1. En el portal Azure, busque o, de otro modo, vaya a la página de su nueva aplicación.

2. En el menú izquierdo, expanda Configuración>Dominios personalizados, seleccione + Agregar dominio personalizado, configure el dominio personalizado, seleccione Validar y, a continuación, seleccione Agregar.

3. Repita el paso anterior para agregar cualquier otro dominio personalizado.

4. En el menú izquierdo, expanda API>CORS, agregue uno o varios orígenes permitidos y seleccione Guardar.

Copilot habilita una identidad asignada por el sistema en el destino y vuelve a crear las asignaciones de roles necesarias para su nuevo principal. Verifica el acceso contra los recursos objetivo en lugar de reutilizar el principal de origen.

Copilot adjunta las identidades asignadas al usuario seleccionadas y verifica sus asignaciones de rol requeridas. Reutilizar una identidad no reemplaza la necesidad de validar el acceso a recursos específicos del destino.

1. Use el comando para habilitar la identidad administrada asignada por el az functionapp identity assign sistema en la nueva aplicación:

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

   En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por los nombres de la aplicación de función y el grupo de recursos.

2. Use este script para obtener el ID principal de la identidad asignada por el sistema y agregarlo a los roles requeridos.

   # 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>"
   

   En este ejemplo, reemplace <RESOURCE_GROUP> y <APP_NAME> por los nombres de aplicación de función y del grupo de recursos, respectivamente. Reemplace <ROLE_NAME> y <RESOURCE_ID> por el nombre del rol y el recurso específico que capturó de la aplicación original.

3. Repita los comandos anteriores para cada rol requerido por la nueva aplicación.

Use este script para obtener el identificador de una identidad administrada asignada por el usuario existente y asociarlo a la nueva aplicación:

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 este script para cada rol requerido por la nueva aplicación.

1. En el portal Azure, busque o, de otro modo, vaya a la página de su nueva aplicación.

2. En el menú de la izquierda, expanda Configuración>Identidad y, en la pestaña Asignado por el sistema, establezca Estado en Activado.

3. Seleccione Asignaciones de roles de Azure en el panel de navegación izquierdo.

4. Seleccione + Agregar asignación de roles y establezca estas propiedades de asignación para un rol que documentó en la aplicación original:

   Propiedad	Descripción
   Ámbito	Tipo de recurso al que se accede.
   Suscripción	La suscripción del recurso.
   Recurso	Recurso específico dentro del ámbito seleccionado.
   Función	Busque y seleccione el rol que se va a asignar.

5. Seleccione Guardar para agregar el ámbito. Para agregar más roles, repita el paso anterior para cada rol documentado requerido por la nueva aplicación.

1. En el portal Azure, busque o, de otro modo, vaya a la página de su nueva aplicación.

2. En el menú izquierdo, expanda Configuración>Identidad y, en la pestaña Asignado por el usuario, seleccione + Agregar.

3. Seleccione una identidad existente y, a continuación, seleccione Agregar.

4. Seleccione la identidad que acaba de agregar y elija asignaciones de roles de Azure en el panel izquierdo.

5. Seleccione + Agregar asignación de roles y establezca estas propiedades de asignación para un rol que documentó en la aplicación original:

   Propiedad	Descripción
   Ámbito	Tipo de recurso al que se accede.
   Suscripción	La suscripción del recurso.
   Recurso	Recurso específico dentro del ámbito seleccionado.
   Función	Busque y seleccione el rol que se va a asignar.

6. Seleccione Guardar para agregar el ámbito. Para agregar más roles, repita el paso anterior para cada rol documentado requerido por la nueva aplicación.

Copilot recrea restricciones de acceso a fuentes compatibles y las verifica. Si esas restricciones impiden las pruebas HTTP directas, registra la validación como diferida en lugar de abrir el acceso automáticamente.

Use el az functionapp config access-restriction add comando para cada restricción de acceso IP que quiera replicar en la nueva aplicación:

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>

En este ejemplo, reemplace estos marcadores de posición por los valores de la aplicación original:

Ejecute este comando para cada restricción de IP documentada de la aplicación original.

Para agregar restricciones de red basadas en IP:

1. En el portal Azure, busque o, de otro modo, vaya a la página de su nueva aplicación.

2. En el menú izquierdo, expanda Configuración>Redes y seleccione el vínculo situado junto a Acceso a la red pública.

3. En la página Restricciones de acceso , en Acceso al sitio y reglas, seleccione + Agregar y escriba esta configuración para una restricción de IP específica:

   Configuración	Importancia
   Nombre	Nombre amigable de la regla de IP.
   Acción	Negar
   Prioridad	Prioridad para la exclusión.
   Tipo	Seleccione IPv4 o IPv6.
   Bloque de direcciones IP	Direcciones IP que se van a excluir.

4. Seleccione Agregar regla y repita el paso anterior para cada restricción de acceso que documentó.

5. Después de escribir todas las restricciones de IP de la aplicación original, seleccione Guardar.