Migrieren von Verbrauchsplan-Apps zum Flex-Verbrauchsplan

Die Azure Qualifikation automatisiert den größten Teil der Migration für Sie. Ihre übergeordneten Schritte sind:

Die flex-migration CLI-Befehle automatisieren die App-Erstellung und -Konfiguration. Ihre übergeordneten Schritte sind:

Das Portal bietet einen manuellen Migrationspfad. Ihre übergeordneten Schritte sind:

Richte GitHub Copilot mit den Voraussetzungen ein und nutze dann den Prompt in Start the migration. Copilot begleitet Sie durch die Bewertung, die Vorbereitung von Code für die Migration von Windows zu Linux, die Erstellung und Konfiguration der Zielumgebung, die Bereitstellung, Validierung und die Produktivsetzung. Sie bittet bei Bedarf um Ihre Eingabe oder Genehmigung.

Die folgenden Abschnitte erklären die Prüfungen und Migrationsaufgaben als Referenz. Du musst die manuellen CLI- oder Portal-Schritte nicht ausführen, wenn du dem Copilot-Workflow folgst.

Copilot hält die Quell-App während der Bewertung und Replikation schreibgeschützt. Änderungen an Quell-Triggern, Einstellungen, App-Status oder Ressourcen erfordern eine explizite Genehmigung für die spezifische Aktion.

Windows Migration erfordert manuelle Schritte für die App-Erstellung und -Konfiguration. Ihre übergeordneten Schritte sind:

Windows Migration erfordert manuelle Schritte für die App-Erstellung und -Konfiguration. Ihre übergeordneten Schritte sind:

Um eine interaktive Migration zu starten, die Ihr Abonnement überprüft und Sie auffordert, auszuwählen, welche Apps migriert werden sollen, verwenden Sie diese Eingabeaufforderung:

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

Copilot identifiziert Ihre berechtigten Linux-Verbrauchs-Apps, lässt Sie auswählen, welche migriert werden sollen, und führt Sie dann durch die Bewertung, die Erstellung, die Konfiguration und die Bereitstellung jeder App. Fahren Sie mit den Migrationsschritten fort.

Wenn Sie nur sehen möchten, welche Apps berechtigt sind, ohne die Migration zu starten, verwenden Sie stattdessen diese Eingabeaufforderung:

list my linux consumption apps eligible for flex consumption migration

Copilot gibt eine Liste berechtigter und nicht zulässiger Apps zusammen mit den Gründen für alle Inkompatibilitäten zurück. Anschließend können Sie eine bestimmte App mithilfe der Eingabeaufforderung unter Starten der Migration für Linux migrieren.

Führen Sie diesen Befehl aus, um zu sehen, welche Ihrer Linux-Verbrauchs-Apps zur Migration bereit sind:

az functionapp flex-migration list

Mit diesem Befehl wird Ihr Abonnement automatisch überprüft und zwei Arrays zurückgegeben:

• eligible_apps: Linux-Verbrauchs-Apps, die zu Flex Consumption migriert werden können. Diese Apps sind mit Flex Consumption kompatibel.
• ineligible_apps: Apps, die nicht migriert werden können, sowie die spezifischen Gründe dafür. Überprüfen und adressieren Sie die Gründe für die Inkompatibilität, bevor Sie fortfahren.

Die Ausgabe enthält den App-Namen, die Ressourcengruppe, den Standort und den Laufzeitstapel für jede App sowie Berechtigungsstatus- und Migrationsbereitschaftsinformationen.

1. Wechseln Sie zum Azure Resource Graph Explorer im Azure-Portal.

2. Kopieren Sie die folgende Kusto-Abfrage, fügen Sie sie in das Abfragefenster ein, und wählen Sie "Abfrage ausführen" aus:

   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)
   

Mit diesem Befehl wird eine Tabelle mit app-Name, Standort, Ressourcengruppe und Laufzeitstapel für alle Verbrauchs-Apps erstellt, die unter Linux im aktuellen Abonnement ausgeführt werden.

Um Windows Consumption-Apps in Ihrem Abo zu identifizieren, ohne eine Migration zu starten, verwenden Sie diese Aufforderung:

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

Copilot entdeckt Kandidaten-Apps und überprüft deren Region, Laufzeit, Bereitstellungskonfiguration und weitere Kompatibilitätsanforderungen. Discovery identifiziert Kandidaten, ist aber keine Garantie dafür, dass jede Anwendung bereit ist, zu migrieren. Überprüfen Sie die Bewertung, bevor Sie fortfahren.

Um eine bestimmte App zu migrieren, verwenden Sie die Eingabeaufforderung in Start the migration.

Verwenden Sie den az graph query Befehl, um alle Funktions-Apps in Ihrem Abonnement auflisten, die in einem Verbrauchsplan ausgeführt werden:

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

Mit diesem Befehl wird eine Tabelle mit dem App-Namen, dem Standort und der Ressourcengruppe für alle Verbrauchs-Apps erstellt, die auf Windows im aktuellen Abonnement ausgeführt werden.

Wenn Sie dies noch nicht haben, werden Sie aufgefordert, die Ressourcendiagrammerweiterung zu installieren.

1. Wechseln Sie zum Azure Resource Graph Explorer im Azure-Portal.

2. Kopieren Sie die folgende Kusto-Abfrage, fügen Sie sie in das Abfragefenster ein, und wählen Sie "Abfrage ausführen" aus:

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

Mit diesem Befehl wird eine Tabelle mit dem App-Namen, dem Standort und der Ressourcengruppe für alle Verbrauchs-Apps erstellt, die auf Windows im aktuellen Abonnement ausgeführt werden.

Copilot prüft, ob Flex Consumption in der Region der Quell-App verfügbar ist, und zeichnet das Ergebnis in der Bewertung auf. Wenn die Region nicht unterstützt wird, kläre die Standortwahl, bevor du die Ziel-App erstellst.

Mit diesem az functionapp list-flexconsumption-locations Befehl können Sie alle Regionen auflisten, in denen der Flex-Verbrauchsplan verfügbar ist:

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

Dieser Befehl generiert eine Tabelle mit Azure Regionen, in denen der Flex-Verbrauchsplan derzeit unterstützt wird.

Der Erstellungsprozess für eine Funktions-App im Azure Portal filtert Regionen aus, die der Flex-Verbrauchsplan derzeit nicht unterstützt.

1. Wählen Sie im portal AzureRessource erstellen im linken Menü aus, und wählen Sie Function app>Create aus.

2. Wählen Sie Flex Consumption> aus, und erweitern Sie auf der Registerkarte Grundlagen den Bereich Region.

3. Überprüfen Sie die unterstützten Flex-Verbrauchsplanbereiche.

Stellen Sie sicher, dass die Region, in der die zu migrierende Verbrauchsplananwendung läuft, in der Liste berücksichtigt wird.

Copilot vergleicht die Quellversion mit den von Flex Consumption in der Zielregion unterstützten Versionen. Es verwendet Metadaten aus Projekten oder Deployment-Paketen, wenn die Azure-Konfiguration fehlt oder mehrdeutig ist, und bittet Sie, eine Zielversion auszuwählen, wenn die Belege keine einzige unterstützte Version identifizieren.

Verwenden Sie diesen az functionapp list-flexconsumption-runtimes Befehl, um die Unterstützung des Flex-Verbrauchsplans für Ihre Sprachstapelversion in einer bestimmten Region zu überprüfen:

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

Ersetzen Sie <REGION> in diesem Beispiel durch Ihren aktuellen Bereich und <LANGUAGE_STACK> einen der folgenden Werte:

Mit diesem Befehl werden alle Versionen des angegebenen Sprachstapels angezeigt, die vom Flex-Verbrauchsplan in Ihrer Region unterstützt werden.

Der Erstellungsprozess für eine Funktions-App im Azure Portal filtert Sprachstapelversionen aus, die der Flex-Verbrauchsplan derzeit nicht unterstützt.

1. Wählen Sie im portal AzureRessource erstellen im linken Menü aus, und wählen Sie Function app>Create aus.

2. Wählen Sie "Flex Consumption>Select" aus, und wählen Sie auf der Registerkarte " Grundlagen " Ihren Sprach-Runtime-Stapel und Ihre Region aus.

3. Erweitern Sie Version und überprüfen Sie die unterstützten Versionen Ihrer Sprachumgebung in Ihrer ausgewählten Region.

Der Copilot erkennt Quell-Deployment-Slots und erfasst sie in der Bewertung. Da Flex Consumption keine Slots unterstützt, wählen Sie, ob Sie deren Funktionalität zusammenführen oder separate Apps verwenden, bevor Sie weitermachen.

Verwenden Sie diesen az functionapp deployment slot list Befehl, um alle Bereitstellungsplätze aufzulisten, die in Ihrer Funktions-App definiert sind:

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

Ersetzen Sie in diesem Beispiel den <RESOURCE_GROUP> mit Ihrem Ressourcengruppennamen und <APP_NAME> mit dem App-Namen. Wenn der Befehl einen Eintrag zurückgibt, sind die Bereitstellungsplätze für Ihre App aktiviert.

So bestimmen Sie, ob ihre Funktions-App Bereitstellungsplätze aktiviert hat:

1. Suchen Sie im Azure-Portal nach Ihrer Funktions-App-Seite, oder wechseln Sie auf andere Weise zu Ihrer Funktions-App-Seite.

2. Wählen Sie im linken Menü Bereitstellung>Bereitstellungsplätze aus.

3. Wenn auf der Seite Bereitstellungsplätze aufgeführt sind, verwendet die Funktions-App aktuell Bereitstellungsplätze.

Copilot inventarisiert die von der Quell-App verwendeten Zertifikate und überprüft die standortbezogenen Zertifikatsgrenzen. Zertifikate werden nicht automatisch übertragen. Erforderliche Zertifikate werden durch den site-scoped Zertifikatsprozess wieder hinzugefügt und der Code aktualisiert, der den Windows-Zertifikatsspeicher liest, um Linux-Zertifikatsdateipfade zu verwenden.

Verwenden Sie den az webapp config ssl list Befehl, um alle für Ihre Funktions-App verfügbaren TLS/SSL-Zertifikate auflisten:

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

Ersetzen Sie in diesem Beispiel <RESOURCE_GROUP> durch den Namen Ihrer Ressourcengruppe. Wenn dieser Befehl die Ausgabe zurückgibt, verwendet Ihre App Zertifikate, die Sie nach der Migration der neuen Flex Consumption-App erneut hinzufügen müssen.

So ermitteln Sie, ob Ihre Funktions-App TLS/SSL-Zertifikate verwendet:

1. Suchen Sie im Azure-Portal nach Ihrer Funktions-App-Seite, oder wechseln Sie auf andere Weise zu Ihrer Funktions-App-Seite.

2. Wählen Sie im linken Menü Einstellungen>Zertifikate aus.

3. Überprüfen Sie die Registerkarten Verwaltete Zertifikate, Eigene Zertifikate (.pfx) und Public Key-Zertifikate (.cer) auf installierte Zertifikate.

Copilot identifiziert Blob-Trigger-Bindungen nach Typ und markiert jeden Trigger, dessen Ursprung nicht explizit EventGrid festgelegt ist. Es beschreibt die erforderliche Codeänderung und die Einrichtung eines Event-Abonnements vor der Bereitstellung.

Verwenden Sie diesen [az functionapp function list] Befehl, um zu ermitteln, ob Ihre App Blob-Speichertrigger enthält, die kein Ereignisraster als Quelle verwenden:

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

Ersetzen Sie in diesem Beispiel den <RESOURCE_GROUP> mit Ihrem Ressourcengruppennamen und <APP_NAME> mit dem App-Namen. Wenn der Befehl Zeilen zurückgibt, gibt es mindestens einen Trigger mithilfe der Containerabfragung in Ihrer Funktions-App.

So bestimmen Sie, ob ihre Funktions-App über Blob-Speichertrigger verfügt, die kein Ereignisraster als Quelle verwenden:

1. Suchen Sie im Azure-Portal nach Ihrer Funktions-App-Seite, oder wechseln Sie auf andere Weise zu Ihrer Funktions-App-Seite.

2. Suchen Sie auf der Registerkarte "Funktionen" in der Übersicht nach allen Funktionen mit einem Triggertyp von Blob.

3. Wählen Sie eine Blobtriggerfunktion aus, und wählen Sie im Code + TestRessourcen-JSON aus.

4. Suchen Sie den properties.config.bindings Abschnitt der Funktionsdefinition. Dieser Abschnitt sollte eine bindings.type von blobTrigger haben. Wenn das bindings Objekt keine source Eigenschaft aufweist oder source einen Wert LogsAndContainerScanaufweist, verwendet der Trigger containerabfragung. Ein Event Grid-Trigger hat stattdessen einen source-Wert von EventGrid.

5. Wiederholen Sie die Schritte 3 bis 4 für alle verbleibenden Blob Storage-Triggerfunktionen in Ihrer App.

Copilot überprüft App-Einstellungsnamen, ohne geheime Werte anzuzeigen. Es wird gefragt, ob gefilterte Quelleinstellungen kopiert oder zurückgestellt werden sollen, um isolierte Zielabhängigkeiten zu konfigurieren. Wenn Sie die Einstellungen zurückstellen, wartet die Bereitstellung, bis die erforderliche Zielkonfiguration bereit ist.

Verwenden Sie den az functionapp config appsettings list Befehl, um ein app_settings Objekt zurückzugeben, das die vorhandenen App-Einstellungen als JSON enthält:

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

Ersetzen Sie in diesem Beispiel <RESOURCE_GROUP> durch den Namen Ihrer Ressourcengruppe und <APP_NAME> durch den Namen Ihrer App.

So rufen Sie die aktuellen Funktion-App-Einstellungen ab:

1. Suchen Sie im Azure-Portal nach Ihrer Funktions-App-Seite, oder wechseln Sie auf andere Weise zu Ihrer Funktions-App-Seite.

2. Erweitern Sie im linken Menü "Einstellungen" , und wählen Sie "Umgebungsvariablen" aus.

3. Wählen Sie auf der Registerkarte "App-Einstellungen " die Option "Erweitert bearbeiten" aus, und kopieren Sie den Inhalt der JSON-App-Einstellungen.

Copilot inventarisiert Websiteeinstellungen, Skalierungsgrenzen, CORS, benutzerdefinierte Domains und andere Konfigurationen. Es erfasst nicht unterstützte oder manuell behandelte Punkte in der Bewertung. Explizite Azure Files-Mount-Metadaten sind für diese Windows-Migration nur für die Bestandsaufnahme.

Verwenden Sie dieses Skript, um die relevanten Anwendungskonfigurationen Ihrer vorhandenen App abzurufen:

# 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 

Ersetzen Sie in diesem Beispiel den <RESOURCE_GROUP> mit Ihrem Ressourcengruppennamen und <APP_NAME> mit dem App-Namen. Wenn eine der Websiteeinstellungen oder -überprüfungen Werte zurückgibt, die nicht null sind, notieren Sie sich diese.

So überprüfen Sie die relevanten Anwendungskonfigurationen Ihrer vorhandenen App:

1. Suchen Sie im Azure-Portal nach Ihrer Funktions-App-Seite, oder wechseln Sie auf andere Weise zu Ihrer Funktions-App-Seite.

2. Erweitern Sie im linken Menü "Einstellungen" , und wählen Sie "Konfiguration" aus.

3. Notieren Sie sich auf der Registerkarte " Allgemeine Einstellungen " die folgenden Einstellungen:

   • SCM Basic Auth Veröffentlichungsanmeldedaten
   • HTTP-Version
   • Nur HTTPS
   • Minimale eingehende TLS-Version
   • Minimale eingehende TLS-Verschlüsselung
   • Eingehende Clientzertifikate

4. Überprüfen Sie auf der Registerkarte Pfadzuordnungen, ob für Ihre App vorhandene Dateifreigaben erforderlich sind. Wenn vorhanden, notieren Sie sich den Namen des Speicherkontos, den Freigabenamen, den Bereitstellungspfad und den Zugriffstyp für jede bereitgestellte Freigabe.

5. Unter Einstellungen>Scale Out, wenn Scale Out-Limit erzwingen auf Ja festgelegt ist, finden Sie den Wert Maximales Scale Out-Limit.

6. Notieren Sie sich unter "Einstellungen>benutzerdefinierte Domänen" alle anderen Domänennamen als *.azurewebsites.net, den Bindungstyp und die SSL-Zertifikatinformationen.

7. Beachten Sie unter API>CORS alle explizit zulässigen CORS-Ursprünge und andere CORS-Einstellungen.

Copilot inventarisiert system- und benutzerzugewiesene verwaltete Identitäten sowie deren Rollenzuweisungen. Dieser Bestand wird genutzt, um die Identitäten des Ziels zu konfigurieren und den erforderlichen Zugriff auf die entsprechenden Ressourcen wiederherzustellen.

Dieses Skript sucht sowohl nach der vom System zugewiesenen verwalteten Identität als auch auf alle mit Ihrer App verknüpften vom Benutzer zugewiesenen verwalteten Identitäten:

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

Ersetzen Sie in diesem Beispiel <RESOURCE_GROUP> durch den Namen Ihrer Ressourcengruppe und <APP_NAME> durch den Namen Ihrer App. Notieren Sie sich alle Identitäten und ihre Rollenzuweisungen.

1. Suchen Sie im Azure-Portal nach Ihrer Funktions-App-Seite, oder wechseln Sie auf andere Weise zu Ihrer Funktions-App-Seite.

2. Erweitern Sie im linken Menü "Einstellungen" , und wählen Sie "Identität" aus.

3. Überprüfen Sie die Registerkarte "System zugewiesen", um festzustellen, ob die systemzugewiesene verwaltete Identität aktiviert ist. Wenn diese Option aktiviert ist, wählen Sie Azure Rollenzuweisungen aus, um die dieser Identität zugewiesenen Rollen anzuzeigen.

4. Überprüfen Sie die Registerkarte Vom Benutzer zugewiesen, um festzustellen, ob von Benutzern zugewiesene verwaltete Identitäten zugewiesen sind. Notieren Sie sich die Namen aller vom Benutzer zugewiesenen Identitäten.

5. Wählen Sie für jede vom Benutzer zugewiesene verwaltete Identität die entsprechende Identität aus. Wählen Sie auf der Seite "Identität" Azure Rollenzuweisungen aus.

6. Notieren Sie sich jede der Identität zugewiesene Rolle und prüfen Sie, ob Ihre Anwendung diese benötigt.

Dokumentieren Sie alle Identitäten und ihre Rollenzuweisungen, damit Sie die gleiche Berechtigungsstruktur für Ihre neue Flex Consumption-App neu erstellen können.

Copilot erfasste aktivierte Anbieter und das Authentifizierungsverhalten, ohne Provider-Geheimnisse preiszugeben. Es identifiziert zielspezifische Callback-URIs und führt durch die Konfiguration des Anbieters vor der Code-Bereitstellung. Es kopiert Anbieterregistrierungen oder Geheimnisse nicht automatisch.

Verwenden Sie den az webapp auth show Befehl, um zu überprüfen, ob die integrierte Authentifizierung in Ihrer Funktions-App konfiguriert ist:

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

Ersetzen Sie in diesem Beispiel <RESOURCE_GROUP> durch den Namen Ihrer Ressourcengruppe und <APP_NAME> durch den Namen Ihrer App. Überprüfen Sie die Ausgabe, um zu ermitteln, ob die Authentifizierung aktiviert ist und welche Identitätsanbieter konfiguriert sind.

Erstellen Sie diese Einstellungen in Ihrer neuen App nach der Migration neu, damit Ihre Clients den Zugriff mit ihrem bevorzugten Anbieter verwalten können.

So überprüfen Sie, ob die integrierte Clientauthentifizierung konfiguriert ist:

1. Suchen Sie im Azure-Portal nach Ihrer Funktions-App-Seite, oder wechseln Sie auf andere Weise zu Ihrer Funktions-App-Seite.

2. Erweitern Sie im linken Menü "Einstellungen" , und wählen Sie "Authentifizierung" aus.

3. Wenn die integrierte Authentifizierung aktiviert ist, beachten Sie, welche Clientidentitätsanbieter konfiguriert sind. Beachten Sie außerdem alle erweiterten Einstellungen wie Tokenspeicher, zulässige externe Umleitungen und zulässige Tokengruppen.

Copilot inventarisiert und stellt kompatible Zugriffsbeschränkungen wieder her. Es schwächt diese Beschränkungen nicht automatisch ab, damit Gesundheitsprüfungen der Bereitstellung oder HTTP-Validierungen erfolgreich durchgeführt werden können.

Dieser az functionapp config access-restriction show Befehl gibt eine Liste aller vorhandenen IP-basierten Zugriffsbeschränkungen zurück:

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

Ersetzen Sie in diesem Beispiel <RESOURCE_GROUP> durch den Namen Ihrer Ressourcengruppe und <APP_NAME> durch den Namen Ihrer App.

1. Suchen Sie im Azure-Portal nach Ihrer Funktions-App-Seite, oder wechseln Sie auf andere Weise zu Ihrer Funktions-App-Seite.

2. Erweitern Sie im linken Menü "Einstellungen" , und wählen Sie "Netzwerk" aus.

3. Wenn "Aktiviert" ohne Zugriffsbeschränkungen für den Zugriff auf öffentliche Netzwerke angezeigt wird, gibt es keine Einschränkungen für eingehenden Zugriff. Wählen Sie andernfalls Access-Einschränkungen aus.

4. Dokumentieren Sie alle konfigurierten IP-basierten Zugriffsbeschränkungen.

Wenn Sie den Ermittlungsprompt im Abschnitt Identifizieren verwendet haben, hat die Skill Ihre neue Flex‑Verbrauchs‑App bereits analysiert, erstellt und konfiguriert. Sie können diesen Abschnitt überspringen und mit den Migrationsschritten fortfahren.

Wenn Sie bereits wissen, welche App migriert werden soll, verwenden Sie diese Eingabeaufforderung:

migrate my app <APP_NAME> to flex consumption

Die Skill behandelt automatisch Bewertung, App-Erstellung und Konfigurationsmigration und entspricht dem az functionapp flex-migration start-Befehl und dessen Überprüfungsschritten.

Der az functionapp flex-migration start Befehl sammelt die Konfiguration Ihrer App und erstellt eine neue Flex Consumption-App mit den gleichen Einstellungen.

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

Ersetzen Sie in diesem Beispiel diese Platzhalter durch die Werte für Ihr Szenario:

Der az functionapp flex-migration start Befehl führt die folgenden grundlegenden Aufgaben aus:

• Bewertet Ihre Quell-App auf Kompatibilität mit dem Flex Consumption-Hostingplan.
• Erstellt eine Funktions-App im Flex-Verbrauchsplan.
• Migriert die meisten Konfigurationen, einschließlich App-Einstellungen, Identitätszuweisungen, Speicher mounts, CORS-Einstellungen, benutzerdefinierte Domänen und Zugriffsbeschränkungen.

Der Migrationsbefehl unterstützt mehrere Optionen zum Anpassen der Migration:

Verwenden Sie az functionapp flex-migration start --helpfür vollständige Befehlsoptionen .

Das Azure-Portal stellt keinen automatisierten Migrationsbefehl für Linux-Apps bereit. Verwenden Sie die Registerkarten Azure CLI oder GitHub Copilot für die empfohlene Linux-Migrationsumgebung.

Wenn Sie bereits wissen, welche App migriert werden soll, verwenden Sie diese Eingabeaufforderung:

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

Ersetze <APP_NAME> durch den Namen deiner Quell-App. Copilot präsentiert den Migrationsplan, führt eine Bewertung durch, inventarisiert die Konfiguration und erstellt eine neue Flex-Consumption-App neben der Quelle.

Standardmäßig schlägt <APP_NAME>-flex der Workflow den Namen der Ziel-App vor. Copilot bittet Sie, zu entscheiden, ob Sie das Quellspeicherkonto wiederverwenden, ein neues erstellen oder ein bestimmtes bestehendes Konto verwenden, bevor Sie die Ziel-App erstellen. Sie können einen anderen Zielnamen anfordern oder Ihre Speicherpräferenz im Prompt angeben. Überprüfen Sie die Speicherwahl, denn gemeinsame Abhängigkeiten ermöglichen es beiden Anwendungen, dieselben Ereignisse zu verarbeiten.

Copilot prüft, ob die ausgewählten Speicherkonten die Authentifizierung mit Shared Key erlauben, und fragt nach den Anforderungen an die Richtlinie „nur Identität“. Wenn schlüsselbasierte Erstellung nicht erlaubt ist, pausiert Copilot vor der Erstellung der Ziel-App. Stellen Sie eine leere Flex-Consumption-App bereit, die für diese Migration im selben Abonnement dediziert ist, wobei identity-first-Infrastruktur als Code verwendet wird. Konfigurieren Sie den Zugriff der verwalteten Identität sowohl für Host- als auch für Deployment-Speicher, die erforderlichen Rollenzuweisungen und die Überwachung. Stelle den Funktionscode noch nicht bereit. Für Beispiele für Provisioning siehe die Flex Consumption Infrastructure-as-Code-Beispiele.

Geben Sie die vollständige Azure-Ressourcen-ID des Ziels und den gespeicherten Fortschrittsdateipfad zurück. Copilot überprüft das bestehende Ziel und setzt nach Ihrer Genehmigung die Konfiguration und Bereitstellung fort, ohne eine weitere App zu erstellen. Verwenden Sie diese Eingabeaufforderung:

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.

Vor der Bereitstellung unterstützt Copilot bei der Vorbereitung von Windows-zu-Linux-Code, Zielkonfiguration, integrierter Authentifizierung und Sicherheit bei Triggern ohne HTTP. Anschließend bietet es eine Bereitstellung über eine aktualisierte Pipeline, ein lokales Projekt oder ein kompatibles Bereitstellungspaket an.

Standardmäßig zeichnet Copilot den Fortschritt in .azure-upgrade/<SOURCE_APP_NAME>/upgrade-status.mdauf. Um fortzufahren, verwenden Sie diesen Prompt:

Resume the Flex Consumption migration for <APP_NAME>.

Die az functionapp flex-migration Befehle unterstützen keine Windows Consumption-Apps. Folgen Sie stattdessen den Aufgaben vor der Migration und den Windows-Migrationsschritten.

Folgen Sie den Aufgaben vor der Migration und den Windows-Migrationsschritten, um die Ziel-App manuell zu erstellen und zu konfigurieren.

Die Copilot Migrationskompetenz versucht, Ihr vorhandenes Codeprojekt in Ihre neue App herunterzuladen und erneut bereitzustellen. Wenn dies nicht erfolgreich ist, werden Sie stattdessen durch das Abrufen und Bereitstellen des Codepakets als Teil des Migrationsworkflows geleitet. Sie können diesen Abschnitt überspringen und mit den Migrationsschritten fortfahren.

1. Verwenden Sie den az functionapp config appsettings list Befehl, um die WEBSITE_RUN_FROM_PACKAGE App-Einstellung abzurufen, falls vorhanden:

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

   Ersetzen Sie in diesem Beispiel <RESOURCE_GROUP> durch den Namen Ihrer Ressourcengruppe und <APP_NAME> durch den Namen Ihrer App. Wenn dieser Befehl eine URL zurückgibt, können Sie die Bereitstellungspaketdatei von diesem Remotespeicherort herunterladen und zum nächsten Abschnitt springen.

2. Wenn der WEBSITE_RUN_FROM_PACKAGE-Wert 1 oder leer ist, verwenden Sie dieses Skript, um das Bereitstellungspaket für die bestehende App abzurufen.

   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
   

   Ersetzen Sie erneut <RESOURCE_GROUP> und <APP_NAME> durch Ihren Ressourcengruppennamen und App-Namen. Das Paket .zip Datei wird in das Verzeichnis heruntergeladen, aus dem Sie den Befehl ausgeführt haben.

1. Suchen Sie im Azure-Portal nach Ihrer Funktions-App-Seite, oder wechseln Sie auf andere Weise zu Ihrer Funktions-App-Seite.

2. Erweitern Sie> im linken Menüdie Einstellungsumgebungsvariablen, und überprüfen Sie, ob eine Einstellung mit dem Namen WEBSITE_RUN_FROM_PACKAGE vorhanden ist.

3. Wenn WEBSITE_RUN_FROM_PACKAGE vorhanden ist, stellen Sie sicher, dass er auf einen Wert von 1 oder eine URL festgelegt wird. Wenn auf eine URL festgelegt, ist diese der Ort der Paketdatei für den App-Inhalt. Laden Sie die ZIP-Datei von der URL-Adresse herunter, die Sie besitzen.

4. Wenn die Einstellung WEBSITE_RUN_FROM_PACKAGE nicht vorhanden ist oder auf 1 festgelegt ist, müssen Sie das Paket aus dem bestimmten Speicherkonto herunterladen, was davon abhängt, ob Sie unter Linux oder Windows ausgeführt werden.

5. Rufen Sie den Namen des Speicherkontos aus der AzureWebJobsStorage- oder AzureWebJobsStorage__accountName-Anwendungseinstellung ab. Bei einem Verbindungszeichenfolge ist der AccountName der Name Ihres Speicherkontos.

6. Suchen Sie im Portal nach Ihrem Speicherkontonamen.

7. Suchen Sie auf der Seite "Speicherkonto" das Bereitstellungspaket, und laden Sie es herunter.

8. Erweitern Sie Datenspeicher>Container und wählen Sie scm_releases. Wählen Sie die Datei mit dem Namen scm-latest-<APP_NAME>.zip und dann "Herunterladen" aus.

Copilot fragt zuerst nach einem lokalen Quellverzeichnis. Wenn die Quelle nicht verfügbar ist, bietet es an, das bereitgestellte Paket aus der Inhaltsfreigabe der Quell-App oder der externen Paket-URL abzurufen. Es prüft, ob das Paket für Linux und Flex Consumption geeignet ist; Windows-spezifische Builds erfordern Vorbereitung statt direkter erneuter Bereitstellung.

1. Verwenden Sie den az functionapp config appsettings list Befehl, um die WEBSITE_RUN_FROM_PACKAGE App-Einstellung abzurufen, falls vorhanden:

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

   Ersetzen Sie in diesem Beispiel <RESOURCE_GROUP> durch den Namen Ihrer Ressourcengruppe und <APP_NAME> durch den Namen Ihrer App. Wenn dieser Befehl eine URL zurückgibt, können Sie die Bereitstellungspaketdatei von diesem Remotespeicherort herunterladen und zum nächsten Abschnitt springen.

2. Wenn der WEBSITE_RUN_FROM_PACKAGE-Wert 1 oder leer ist, verwenden Sie dieses Skript, um das Bereitstellungspaket für die bestehende App abzurufen.

   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
   

   Ersetzen Sie erneut <RESOURCE_GROUP> und <APP_NAME> durch Ihren Ressourcengruppennamen und App-Namen. Das Paket .zip Datei wird in das Verzeichnis heruntergeladen, aus dem Sie den Befehl ausgeführt haben.

1. Suchen Sie im Azure-Portal nach Ihrer Funktions-App-Seite, oder wechseln Sie auf andere Weise zu Ihrer Funktions-App-Seite.

2. Erweitern Sie> im linken Menüdie Einstellungsumgebungsvariablen, und überprüfen Sie, ob eine Einstellung mit dem Namen WEBSITE_RUN_FROM_PACKAGE vorhanden ist.

3. Wenn WEBSITE_RUN_FROM_PACKAGE vorhanden ist, stellen Sie sicher, dass er auf einen Wert von 1 oder eine URL festgelegt wird. Wenn auf eine URL festgelegt, ist diese der Ort der Paketdatei für den App-Inhalt. Laden Sie die ZIP-Datei von der URL-Adresse herunter, die Sie besitzen.

4. Wenn die Einstellung WEBSITE_RUN_FROM_PACKAGE nicht vorhanden ist oder auf 1 festgelegt ist, müssen Sie das Paket aus dem bestimmten Speicherkonto herunterladen, was davon abhängt, ob Sie unter Linux oder Windows ausgeführt werden.

5. Rufen Sie den Namen des Speicherkontos aus der WEBSITE_CONTENTAZUREFILECONNECTIONSTRING Einstellung ab, wobei es sich dabei AccountName um den Namen Ihres Speicherkontos handelt. Notieren Sie sich außerdem den Wert WEBSITE_CONTENTSHARE. Dabei handelt es sich um den Namen der Dateifreigabe.

6. Suchen Sie im Portal nach Ihrem Speicherkontonamen.

7. Suchen Sie auf der Seite "Speicherkonto" das Bereitstellungspaket, und laden Sie es herunter.

8. Erweitern Sie Datenspeicher>Datei-Freigaben, wählen Sie den Freigabenamen aus WEBSITE_CONTENTSHARE aus, und gehen Soe zum Unterordner data\SitePackages. Wählen Sie die neueste .zip Datei aus, und wählen Sie "Herunterladen" aus.

Die Copilot Migrationsfunktion überprüft die neue Anwendung automatisch im Rahmen der Migration. Wenn Sie die Migration mit einer Copilot-Prompt in Start the migration for Linux gestartet haben, hat die Fähigkeit bereits überprüft, ob die App erstellt und ordnungsgemäß konfiguriert wurde. Sie können diesen Abschnitt überspringen und weiterhin die integrierte Authentifizierung konfigurieren.

1. Überprüfen Sie, ob die neue App vorhanden ist und ausgeführt wird:

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

2. Überprüfen Sie die migrierten App-Einstellungen:

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

   Vergleichen Sie diese Einstellungen mit Ihrer Quell-App, um sicherzustellen, dass wichtige Konfigurationen übertragen werden.

3. Überprüfen der Konfiguration der verwalteten Identität:

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

4. Überprüfen Sie, ob benutzerdefinierte Domänen migriert wurden:

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

1. Suchen Sie im portal Azure nach Ihrer neuen Funktions-App anhand des Namens.

2. Überprüfen Sie auf der Seite "Übersicht " der App Folgendes:

   • Status wird angezeigt als Running
   • Planart wird angezeigt als Flex Consumption
   • Die Ressourcengruppe und der Standort entsprechen Ihren Erwartungen

3. Erweitern Sie im linken Menüdie Variablen "Einstellungsumgebung>", und überprüfen Sie die Registerkarte "App-Einstellungen", um sicherzustellen, dass Ihre Anwendungseinstellungen ordnungsgemäß migriert wurden.

4. Überprüfen Sie die>, um zu überprüfen, ob verwaltete Identitäten erwartungsgemäß konfiguriert sind.

5. Überprüfen Sie ggf. "Einstellungen>benutzerdefinierte Domänen ", um benutzerdefinierte Domänenzuordnungen zu bestätigen.

6. Überprüfen Sie "Settings>Networking" , um Zugriffsbeschränkungen zu überprüfen, wenn sie in der Quell-App vorhanden sind.

Nach der Genehmigung kopiert Copilot die unterstützten App-Einstellungen, ohne unverarbeitete Geheimniswerte anzuzeigen oder zu speichern. Es behält target-owned Storage und Application Insights-Einstellungen bei. Es überprüft außerdem die für Linux erforderlichen Namenskonvertierungen von : zu __ und stoppt, wenn Quellnamen mehrdeutig abgebildet werden.

Führen Sie dieses Skript aus, das diese Aufgaben ausführt:

1. Ruft App-Einstellungen aus der alten App ab, wobei Einstellungen ignoriert werden, die nicht in einem Flex-Verbrauchsplan gelten oder die bereits in der neuen App vorhanden sind.
2. Schreibt die gesammelten Einstellungen lokal in eine temporäre Datei.
3. Wendet Einstellungen aus der Datei auf Ihre neue App an.
4. Löscht die temporäre Datei.

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 

In diesem Beispiel ersetzen Sie <RESOURCE_GROUP>, <SOURCE_APP_NAME> und <DEST_APP_NAME> durch den Namen Ihrer Ressourcengruppe sowie durch den alten und neuen App-Namen. Bei diesem Skript wird davon ausgegangen, dass sich beide Apps in derselben Ressourcengruppe befinden.

So übertragen Sie Einstellungen:

1. Suchen Sie im Azure-Portal nach der Seite für Ihre neue App oder gehen Sie andernfalls direkt dorthin.

2. Erweitern Sie im linken Menü Einstellungen>Umgebungsvariablen. Wählen Sie auf der Registerkarte App-Einstellungen+ Hinzufügen aus.

3. Geben Sie sowohl den Einstellungsnamen als auch den Wert ein oder fügen Sie sie ein, und wählen Sie dann Anwenden aus.

4. Wiederholen Sie den vorherigen Schritt für jede Einstellung in der alten App, die Sie in der neuen App neu erstellen müssen. Wenn in der neuen App bereits eine Einstellung vorhanden ist, überspringen Sie sie. Überspringen Sie auch alle veralteten Einstellungen im Flex-Verbrauchsplan.

5. Nachdem Sie alle relevanten Einstellungen hinzugefügt haben, wählen Sie "Speichern übernehmen">aus.

Copilot wendet die kompatible Standortkonfiguration aus dem Inventar an und überprüft das Ziel. Nicht unterstützte Einstellungen und Elemente, die manuelle Handhabung erfordern, bleiben als explizite Folgearbeit bestehen und werden nicht stillschweigend übernommen.

Legen Sie in diesem Skript den Wert für alle Konfigurationssätze in der ursprünglichen App fest, und kommentieren Sie alle Befehle für eine konfiguration aus, die nicht festgelegt ist (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

Ersetzen Sie in diesem Beispiel <RESOURCE_GROUP> und <APP_NAME> durch Ihre Ressourcengruppen- und Funktions-App-Namen. Ersetzen Sie außerdem die Platzhalter aller Variablendefinitionen für vorhandene Einstellungen, die Sie in der neuen App neu erstellen möchten, und kommentieren Sie alle null Einstellungen aus.

1. Suchen Sie im Azure-Portal nach der Seite für Ihre neue App oder gehen Sie andernfalls direkt dorthin.

2. Erweitern Sie im linken Menü die Einstellungskonfiguration>, und aktualisieren Sie auf der Registerkarte "Allgemeine Einstellungen" diese Einstellungen so, dass sie den von Ihrer ursprünglichen Verbrauchsplan-App dokumentierten Einstellungen entsprechen:

   • SCM Basic Auth Veröffentlichungsanmeldedaten
   • HTTP-Version
   • Nur HTTPS
   • Minimale eingehende TLS-Version und Cypher
   • Clientzertifikateinstellungen

3. Wählen Sie Speichern aus, um die Konfigurationsänderungen zu übernehmen.

Copilot prüft jede maximale Skalierungseinstellung der Quellquelle mit dem unterstützten Flex Consumption-Bereich ab, bevor er sie anwendet. Wenn die Quelle kein benutzerdefiniertes Limit gesetzt hat, bleibt der Standardwert des Ziels. Überprüfen Sie die arbeitslastspezifische Abstimmung der Parallelität nach der Migration.

Verwenden Sie den az functionapp scale config set Befehl, um den maximalen Skalierungsmaßstab festzulegen.

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

Ersetzen Sie in diesem Beispiel <RESOURCE_GROUP> und <APP_NAME> durch Ihre Ressourcengruppen- und Funktions-App-Namen. Ersetzen Sie diesen Wert <MAX_SCALE_SETTING> durch den maximalen Skalierungswert, den Sie festlegen möchten.

So konfigurieren Sie Skalierung und Parallelität in Ihrer neuen App:

1. Suchen Sie im Azure-Portal nach der Seite für Ihre neue App oder gehen Sie andernfalls direkt dorthin.

2. Erweitern Sie im linken Menü "Einstellungen">"Skalierung und Parallelität". Legen Sie für die maximale Anzahl von Instanzen einen Maximalwert für die Skalierung Ihrer App fest.

3. Wählen Sie diese Option Save aus, um die Änderungen anzuwenden.

Copilot erstellt die kompatible CORS-Konfiguration erneut und führt durch die Einrichtung benutzerdefinierter Domänen. Jede Änderung an Quellbindungen, DNS oder Produktionsrouting erfordert eine separate Genehmigung; die Erstellung der Ziel-App schließt den Traffic Cutover nicht ab.

1. Verwenden Sie den az functionapp config hostname add Befehl, um benutzerdefinierte Domänenzuordnungen zu Ihrer App neu zu binden:

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

   Ersetzen Sie in diesem Beispiel <RESOURCE_GROUP> und <APP_NAME> durch Ihre Ressourcengruppen- und Funktions-App-Namen. Ersetzen Sie <CUSTOM_DOMAIN> durch Ihren benutzerdefinierten Domänennamen.

2. Verwenden Sie den az functionapp cors add Befehl, um CORS-Einstellungen zu ersetzen:

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

   Ersetzen Sie in diesem Beispiel <RESOURCE_GROUP> und <APP_NAME> durch Ihre Ressourcengruppen- und Funktions-App-Namen. Ersetzen Sie <ALLOWED_ORIGIN_*> durch Ihre erlaubten Ursprünge.

1. Suchen Sie im Azure-Portal nach der Seite für Ihre neue App oder gehen Sie andernfalls direkt dorthin.

2. Erweitern Sieim linken Menü einstellungen >benutzerdefinierte Domänen, wählen Sie +Benutzerdefinierte Domäne hinzufügen, konfigurieren Sie die benutzerdefinierte Domäne, wählen Sie "Überprüfen" und dann "Hinzufügen" aus.

3. Wiederholen Sie den vorherigen Schritt, um alle anderen benutzerdefinierten Domänen hinzuzufügen.

4. Erweitern Sie im linken Menü API>CORS, fügen Sie einen oder mehrere zulässige Ursprünge hinzu, und wählen Sie "Speichern" aus.

Copilot ermöglicht eine systemzugeordnete Identität auf dem Ziel und erstellt die erforderlichen Rollenzuweisungen für den neuen Prinzipal nach. Es überprüft den Zugriff anhand der Zielressourcen, anstatt den Quell-Principal wiederzuverwenden.

Copilot fügt die ausgewählten, vom Nutzer zugewiesenen Identitäten an und überprüft deren erforderliche Rollenzuweisungen. Die Wiederverwendung einer Identität ersetzt nicht die Notwendigkeit, den Zugriff auf zielspezifische Ressourcen zu validieren.

1. Verwenden Sie den az functionapp identity assign Befehl, um die vom System zugewiesene verwaltete Identität in Ihrer neuen App zu aktivieren:

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

   Ersetzen Sie in diesem Beispiel <RESOURCE_GROUP> und <APP_NAME> durch Ihre Ressourcengruppen- und Funktions-App-Namen.

2. Verwenden Sie dieses Skript, um die Prinzipal-ID der vom System zugewiesenen Identität abzurufen und sie den erforderlichen Rollen hinzuzufügen:

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

   Ersetzen Sie <RESOURCE_GROUP> und <APP_NAME> in diesem Beispiel mit den Namen Ihrer Ressourcengruppe bzw. Ihrer Funktions-App. Ersetzen Sie <ROLE_NAME> und <RESOURCE_ID> mit dem Rollennamen und der spezifischen Ressource, die Sie aus der ursprünglichen App erfasst haben.

3. Wiederholen Sie die vorherigen Befehle für jede Rolle, die von der neuen App benötigt wird.

Verwenden Sie dieses Skript, um die ID einer vorhandenen vom Benutzer zugewiesenen verwalteten Identität abzurufen und sie Ihrer neuen App zuzuordnen:

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

Wiederholen Sie dieses Skript für jede Rolle, die von der neuen App benötigt wird.

1. Suchen Sie im Azure-Portal nach der Seite für Ihre neue App oder gehen Sie andernfalls direkt dorthin.

2. Erweitern Sie im linken Menü die Option Einstellungen>Identität, und setzen Sie auf der Registerkarte Systemseitig zugewiesen die Option Status auf Ein.

3. Wählen Sie Azure Rollenzuweisungen im linken Fensterbereich aus.

4. Wählen Sie +Rollenzuweisung hinzufügen und legen Sie diese Zuordnungseigenschaften für eine Rolle fest, die Sie in der ursprünglichen App dokumentiert haben:

   Eigentum	BESCHREIBUNG
   Bereich	Der Ressourcentyp, auf den zugegriffen wird.
   Abonnement	Das Abonnement der Ressource.
   Ressource	Die spezifische Ressource innerhalb des ausgewählten Bereichs.
   Rolle	Suchen Sie nach der zugewiesenen Rolle, und wählen Sie sie aus.

5. Wählen Sie "Speichern" aus, um den Bereich hinzuzufügen. Wenn Sie weitere Rollen hinzufügen möchten, wiederholen Sie den vorherigen Schritt für jede dokumentierte Rolle, die von der neuen App benötigt wird.

1. Suchen Sie im Azure-Portal nach der Seite für Ihre neue App oder gehen Sie andernfalls direkt dorthin.

2. Erweitern Sie im linken Menü Einstellungen>Identität, und wählen Sie auf der Registerkarte "Benutzer zugewiesen"+ Hinzufügen aus.

3. Wählen Sie eine vorhandene Identität und dann "Hinzufügen" aus.

4. Wählen Sie die soeben hinzugefügte Identität aus, und wählen Sie im linken Bereich Azure Rollenzuweisungen aus.

5. Wählen Sie +Rollenzuweisung hinzufügen und legen Sie diese Zuordnungseigenschaften für eine Rolle fest, die Sie in der ursprünglichen App dokumentiert haben:

   Eigentum	BESCHREIBUNG
   Bereich	Der Ressourcentyp, auf den zugegriffen wird.
   Abonnement	Das Abonnement der Ressource.
   Ressource	Die spezifische Ressource innerhalb des ausgewählten Bereichs.
   Rolle	Suchen Sie nach der zugewiesenen Rolle, und wählen Sie sie aus.

6. Wählen Sie "Speichern" aus, um den Bereich hinzuzufügen. Wenn Sie weitere Rollen hinzufügen möchten, wiederholen Sie den vorherigen Schritt für jede dokumentierte Rolle, die von der neuen App benötigt wird.

Copilot stellt kompatible Quellzugriffsbeschränkungen nach und überprüft diese. Wenn diese Einschränkungen direkte HTTP-Tests verhindern, wird die Validierung als zurückgestellt erfasst, anstatt den Zugriff automatisch zu öffnen.

Verwenden Sie den az functionapp config access-restriction add Befehl für jede IP-Zugriffseinschränkung, die Sie in der neuen App replizieren möchten:

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>

Ersetzen Sie in diesem Beispiel diese Platzhalter durch die Werte ihrer ursprünglichen App:

Führen Sie diesen Befehl für jede dokumentierte IP-Einschränkung aus der ursprünglichen App aus.

So fügen Sie IP-basierte Netzwerkeinschränkungen hinzu:

1. Suchen Sie im Azure-Portal nach der Seite für Ihre neue App oder gehen Sie andernfalls direkt dorthin.

2. Erweitern Sie im linken Menü die Option "Netzwerkeinstellungen>", und wählen Sie den Link neben dem Zugriff auf das öffentliche Netzwerk aus.

3. Wählen Sie auf der Seite "Zugriffseinschränkungen" unter "Websitezugriff und -regeln" die Option "+Hinzufügen" aus, und geben Sie diese Einstellungen für eine bestimmte IP-Einschränkung ein:

   Konfiguration	Wert
   Name	Freundlicher Name für die IP-Regel.
   Aktion	Deny (Verweigern)
   Priorität	Priorität für den Ausschluss.
   Typ	Wählen Sie entweder IPv4 oder IPv6 aus.
   IP-Adressblock	Die auszuschließenden IP-Adressen.

4. Wählen Sie "Regel hinzufügen" aus, und wiederholen Sie den vorherigen Schritt für jede von Ihnen dokumentierte Zugriffseinschränkung.

5. Nachdem Sie alle IP-Einschränkungen aus der ursprünglichen App eingegeben haben, wählen Sie "Speichern" aus.