Beheben von Problemen beim Erstellen, Löschen oder Wiederherstellen von Azure-Funktions-Apps
In diesem Artikel werden einige häufige Probleme aufgeführt, die beim Erstellen, Löschen oder Wiederherstellen von Azure-Funktions-Apps auftreten können, sowie Schritte zum Beheben der Probleme.
Erstellen von Funktions-Apps
Für Azure-Funktions-Apps wird die Azure App Service-Infrastruktur verwendet. Sie können eine Azure-Funktions-App mithilfe von:
- Azure portal
- Azure-Befehlszeilenschnittstelle
- PowerShell
- Azure Resource Manager-Vorlage oder Bicep-Vorlage
Sie können eine App auch beim Bereitstellen eines Funktionsprojekts aus Visual Studio oder Visual Studio Code erstellen.
Überlegungen zu einem Azure Storage-Konto, das von Azure Functions verwendet wird
Beim Erstellen einer Funktions-App können Sie ein universelles Azure Storage-Konto erstellen oder eine Verknüpfung mit einem universellen Konto herstellen, das Blob Storage, Queue Storage und Table Storage unterstützt. Azure Functions basiert für Vorgänge wie das Verwalten von Triggern und das Ausführen von Protokollierfunktionen auf Azure Storage. Weitere Informationen finden Sie unter Speicheraspekte für Azure Functions.
- Stellen Sie sicher, dass Sie über die Berechtigung zum Erstellen von Speicherkonten und anderen Ressourcen verfügen. Es darf nicht zu Verstößen gegen die rollenbasierte Zugriffssteuerung (Role Based Access Control, RBAC), Richtlinien oder den Geltungsbereich kommen.
- Verwenden Sie die verwaltete Identität für die Verbindungszeichenfolge des Azure Storage-Kontos nur für
AzureWebJobsStorage
. Weitere Informationen finden Sie unter Verbinden mit dem Hostspeicher mit einer Identität (Vorschau).
Sichern des azure Storage-Kontos, das von Azure Functions verwendet wird
Sie können eine Azure-Funktions-App und ein neues Speicherkonto erstellen, das mit privaten Endpunkten gesichert ist. Hosten Sie die Funktions-App in einem Plan, der die Integration des virtuellen Netzwerks unterstützt.
- Informationen zum Erstellen aus dem Portal finden Sie im Lernprogramm zum Netzwerk.
- Informationen zu den Azure Resource Manager-Vorlagen finden Sie in Azure/azure-quickstart-templates.
- Sie können auch eine vorhandene Funktions-App aktualisieren, um auf ein neues sicheres Speicherkonto zu verweisen. Weitere Informationen finden Sie unter Einschränken Ihres Speicherkontos auf ein virtuelles Netzwerk.
Migrieren einer Azure-Funktions-App über verschiedene Hostingpläne hinweg
In Windows können Sie Azure CLI-Befehle verwenden, um eine Funktions-App zwischen einem Verbrauch und einem Premium-Plan zu migrieren oder umgekehrt. Weitere Informationen finden Sie unter Planen der Migration.
- Direkte Migration von/zu einem dedizierten Plan (App Service) zu/aus einem Verbrauchs-/Premium-Plan wird nicht unterstützt, da Features für die ereignisgesteuerte Skalierung und die Verwendung von serverlosen Features in Hostingplänen unterschiedlich sind.
Notiz
Linux unterstützt die Migration von Hostingplänen nicht.
Überprüfen Sie Hostingplanangebote (Verbrauch, Premium, dediziert) wie Konnektivität des virtuellen Netzwerks, Timeout, Abrechnung usw. Weitere Informationen finden Sie unter Hostingoptionen für Azure Functions.
Beheben Sie den Fehler "Diese Region hat Kontingent von 0 Instanzen für Ihr Abonnement. Wählen Sie eine andere Region oder SKU aus.“
Wenn bei der Erstellung von Ressourcen in einer bestimmten Region konsistent Probleme auftreten, versuchen Sie, die Ressource in einer geografisch gekoppelten Region zu erstellen, wenn Ihr Unternehmen dies zulässt. Beispielsweise sind USA, Westen 2 und USA, Westen-Mitte gekoppelte Regionen. Ostasien (Hongkong SAR) und Südostasien (Singapur) sind ebenfalls gekoppelte Regionen.
Weitere Informationen finden Sie unter:
- Leitfaden zur Entscheidungsfindung für Azure-Regionen – Cloud Adoption Framework
- Regionsübergreifende Replikation in Azure
Beheben Sie den Fehler "Die Preisstufe ist in dieser Ressourcengruppe nicht zulässig" oder "SkuNotAllowedForResourceGroup"
Es wird empfohlen, den Plan in einer neuen Ressourcengruppe zu erstellen. Für unterschiedliche SKUs sind eindeutige Computer erforderlich. Wenn Sie eine App in einer Ressourcengruppe erstellen, wird sie einem Ressourcenpool zugeordnet und zugewiesen. Wenn Sie einen anderen Plan in dieser Ressourcengruppe erstellen und der zugeordnete Pool nicht über die erforderlichen Ressourcen verfügt, wird der Fehler angezeigt.
Weitere Informationen finden Sie unter Erstellen von Funktions-Apps in einer vorhandenen Ressourcengruppe.
Das Erstellen einer Funktions-App-Inhaltsdateifreigabe schlägt fehl mit: "Der Remoteserver hat einen Fehler zurückgegeben: (403) Verboten"
Für Funktions-Apps im Verbrauchsplan oder Elastic Premium-Plan wird eine Dateifreigabe auf dem Speicherkonto erstellt und mithilfe der App-Einstellung WEBSITE_CONTENT_SHARE
referenziert. Dieser Fehler kann auftreten, da das Speicherkonto über eine Firewall, private Endpunkte oder andere Sicherheitseinschränkungen für virtuelle Netzwerke verfügt, z. B. NSG-Regeln (Network Security Group).
Zum Beheben des Fehlers erstellen Sie vorab eine Dateifreigabe im sicheren Speicherkonto und konfigurieren sie als WEBSITE_CONTENT_SHARE
. Weitere Informationen finden Sie unter Einschränken Ihres Speicherkontos auf ein virtuelles Netzwerk.
Alternative Tools für die Erstellung
Sie können alternative Tools wie Azure CLI, PowerShell und Az.Functions
. Stellen Sie sicher, dass Sie die neuesten Versionen der Tools verwenden. Wenn beim Verwenden eines der Tools wie Azure-Portal ein Problem aufgetreten ist, versuchen Sie es mit einer anderen, z. B. Azure CLI.
Festlegen der Version der Funktionsruntime für Windows und Linux
Legen Sie für Windows-Apps die Laufzeitversion im Azure-Portal (Laufzeitversion der Einstellungskonfigurationsfunktions-Laufzeiteinstellung>>>) fest, oder erstellen Sie eine AnwendungseinstellungFUNCTIONS_EXTENSION_VERSION
, und legen Sie sie auf die Hauptlaufzeitversion fest, ~4
z. B. auf V4. Weitere Informationen finden Sie unter Einstellen von Runtimeversionen von Azure Functions als Ziel. Heften Sie es an eine Nebenversion basierend auf Hostversionen, indem Sie FUNCTIONS_EXTENSION_VERSION
auf eine Nebenversion festlegen. Siehe auch Azure Functions-Hostreleases.
Informationen zu Linux-Apps finden Sie unter Manuelle Versionsupdates unter Linux.
Problembehandlung von HTTP 429-Fehlern
Die Drosselung erfolgt auf zwei Ebenen: Azure Resource Manager und Ressourcenanbieter (Microsoft.Web). Die Ebene hängt vom Abonnementtyp und dem Hostingplan ab. Weitere Informationen finden Sie unter
- Azure Resource Manager-Drosselung
- Einschränkungen für Azure-Abonnements und Dienste, Kontingente und Einschränkungen
- Azure-App Diensteinschränkung
Notiz
Wenn das Problem selten ist, warten Sie, und versuchen Sie es nach einiger Zeit erneut, um festzustellen, ob das Problem behoben wird. Wenn das Problem häufig auftritt, können Sie ein anderes Abonnement kaufen oder den Hostingplan aktualisieren, um den Fehler zu beheben.
Löschen oder Wiederherstellen von Funktions-Apps
Nachdem Sie Code aus Visual Studio veröffentlicht und verwendet habenWEBSITE_RUN_FROM_PACKAGE
, legt die Azure-Portal Funktionen als schreibgeschützt fest, um die Bearbeitung von vorkompilierten Ressourcen im Portal zu verhindern. Wenn Sie Funktionen in einer Funktions-App löschen möchten, entfernen Sie die unerwünschten Funktionen aus Ihrem Code, aktivieren Sie die Option "Weitere Dateien am Zielort entfernen" in den Profileinstellungen, und stellen Sie Den Code erneut bereit.
Das Wiederherstellen von Azure-Funktions-Apps, die in einem Verbrauchsplan oder einem Elastic Premium-Plan gehostet werden, wird nicht unterstützt. Wenn Sie über den App-Inhalt der Funktion verfügen oder auf das Speicherkonto zugreifen können, aktualisieren Sie die App-Einstellungen, oder erstellen Sie eine neue Funktions-App, und verwenden Sie den Inhalt. Sie können Azure-Funktions-Apps in einem dedizierten App-Serviceplan wiederherstellen, wenn azure Files nicht für die Inhaltsspeicherung verwendet wird.
Weitere Informationen finden Sie unter Wiederherstellen (Löschen rückgängig machen) von gelöschten Web-Apps.
Stellen Sie sicher, dass Sie über ausreichende Berechtigungen zum Löschen einer Azure-Funktions-App verfügen. Es darf nicht zu Verstößen gegen die rollenbasierte Zugriffssteuerung (Role Based Access Control, RBAC), Richtlinien oder den Geltungsbereich kommen.
Sammeln von Daten vor dem Kontaktieren des Microsoft-Supports
Wenn die Erstellung oder Löschung der Funktions-App fehlschlägt, sammeln und teilen Sie beim Erstellen eines Supporttickets die folgenden Daten:
Azure-Portal: Reproduzieren Sie das Problem, und erfassen Sie eine Browserablaufverfolgung.
Azure CLI oder Azure PowerShell: Teilen Sie den Befehl, der den Fehler und die ausführliche Protokollierung gemeldet hat.
Suchen Sie bei Bereitstellungsfehlern von Azure Resource Manager die Fehlermeldung im Azure-Portal:
- Wählen Sie Ressourcengruppe>Bereitstellungen aus.
- Geben Sie die Korrelations-ID des fehlgeschlagenen Vorgangs gemeinsam an.
Kontaktieren Sie uns für Hilfe
Wenn Sie Fragen haben oder Hilfe mit Ihren Azure-Gutschriften benötigen, dann erstellen Sie beim Azure-Support eine Support-Anforderung oder fragen Sie den Azure Community-Support. Sie können auch Produktfeedback an die Azure Feedback Community senden.