Bearbeiten von Einstellungen für Hosts und Apps für Standard-Logik-Apps in Azure Logic Apps-Instanzen mit einem einzelnen Mandanten

Gilt für: Azure Logic Apps (Standard)

In Azure Logic Apps-Instanzen mit einem einzelnen Mandanten geben die App-Einstellungen für eine Standard-Logik-App die globalen Konfigurationsoptionen an, die für alle Workflows in dieser Logik-App gelten. Diese Einstellungen gelten jedoch nur, wenn diese Workflows in Ihrer lokalen Entwicklungsumgebung ausgeführt werden. Lokal ausgeführte Workflows können auf diese App-Einstellungen als lokale Umgebungsvariablen zugreifen, die von lokalen Entwicklungstools für Werte verwendet werden, die sich zwischen Umgebungen oft ändern können. Diese Werte können beispielsweise Verbindungszeichenfolgen enthalten. Bei Bereitstellungen in Azure werden App-Einstellungen ignoriert und nicht in Ihre Bereitstellung eingeschlossen.

Ihre Logik-App verfügt auch über Hosteinstellungen, die die Runtimekonfigurationseinstellungen und Werte angeben, die für alle Workflows in dieser Logik-App gelten. Beispiele hierfür sind Standardwerte für den Durchsatz, die Kapazität und die Datengröße, unabhängig davon, ob die Ausführung lokal oder in Azure erfolgt.

App-Einstellungen, Parameter und Bereitstellung

In Azure Logic Apps-Instanzen mit mehreren Mandanten hängt die Bereitstellung von ARM-Vorlagen (Azure Resource Manager) ab, welche die Ressourcenbereitstellung für Logik-Apps und die Infrastruktur kombinieren und verarbeiten. Dieser Entwurf stellt eine Herausforderung dar, wenn Sie Umgebungsvariablen für Logik-Apps in verschiedenen Entwicklungs-, Test- und Produktionsumgebungen verwalten müssen. Alles in einer ARM-Vorlage wird bei der Bereitstellung definiert. Wenn Sie nur eine einzelne Variable ändern müssen, müssen Sie alles erneut bereitstellen.

In Azure Logic Apps-Instanzen mit einem einzelnen Mandanten wird die Bereitstellung einfacher, da Sie die Ressourcenbereitstellung zwischen Apps und der Infrastruktur trennen können. Sie können Parameter zum Abstrahieren von Werten verwenden, die sich zwischen Umgebungen ändern können. Durch das Definieren der in Ihren Workflows zu verwendenden Parameter können Sie sich zunächst auf das Entwerfen Ihrer Workflows konzentrieren und Ihre umgebungsspezifischen Variablen dann später einfügen. Mithilfe der App-Einstellungen und -Parameter können Sie Ihre Umgebungsvariablen zur Laufzeit aufrufen und darauf verweisen. Auf diese Weise müssen Sie Ihre Lösung nicht so oft erneut bereitstellen.

App-Einstellungen werden mit Azure Key Vault integriert. Sie können direkt auf sichere Zeichenfolgen verweisen (z. B. Verbindungszeichenfolgen und Schlüssel). Ähnlich wie bei ARM-Vorlagen (Azure Resource Manager), bei denen Sie Umgebungsvariablen zum Bereitstellungszeitpunkt definieren können, können Sie App-Einstellungen in der Workflowdefinition für Ihre Logik-App definieren. Anschließend können Sie dynamisch generierte Infrastrukturwerte erfassen (z. B. Verbindungsendpunkte oder Speicherzeichenfolgen). App-Einstellungen haben jedoch Größenbeschränkungen, und in bestimmten Azure Logic Apps-Bereichen kann nicht auf diese verwiesen werden.

Weitere Informationen zur Einrichtung Ihrer Logik-Apps für die Bereitstellung finden Sie in der folgenden Dokumentation:

• Erstellen von Parametern für Werte, die sich in Workflows zwischen Umgebungen für Azure Logic Apps-Instanzen mit einem einzelnen Mandanten ändern
• Übersicht über die DevOps-Bereitstellung für auf einem einzelnen Mandanten basierende Logik-Apps
• Einrichten der DevOps-Bereitstellung für auf einem einzelnen Mandanten basierende Logik-Apps

Visual Studio Code-Projektstruktur

In Visual Studio Code verfügt Ihr Logik-App-Projekt über einen der folgenden Typen:

• Erweiterungs-Bundle-basiert (Node.js), was der Standardtyp ist
• NuGet-paketbasiertes (.NET), das Sie vom Standardtyp konvertieren können

Basierend auf diesen Typen enthält Ihr Projekt leicht unterschiedliche Ordner und Dateien. Ein NuGet-basiertes Projekt enthält einen .bin-Ordner, der Pakete und andere Bibliotheksdateien enthält. Ein Bundle-basiertes Projekt enthält nicht den .bin Ordner und andere Dateien. Einige Szenarien erfordern ein NuGet-basiertes Projekt, damit Ihre App ausgeführt werden kann, z. B. wenn Sie benutzerdefinierte integrierte Vorgänge entwickeln und ausführen möchten. Weitere Informationen zum Konvertieren Ihres Projekts zur Verwendung von NuGet finden Sie unter Aktivieren der Erstellung Connector-Entwicklung.

Für das standardmäßige Bundle-basierte Projekt verfügt Ihr Projekt über eine Ordner- und Dateistruktur, die dem folgenden Beispiel ähnelt:

MyBundleBasedLogicAppProjectName
| .vscode
| Artifacts
  || Maps 
     ||| MapName1
     ||| ...
  || Schemas
     ||| SchemaName1
     ||| ...
| WorkflowName1
  || workflow.json
  || ...
| WorkflowName2
  || workflow.json
  || ...
| workflow-designtime
| .funcignore
| connections.json
| host.json
| local.settings.json

Auf der Stammebene Ihres Projekts finden Sie die folgenden Dateien und Ordner mit anderen Elementen:

Verweis für App-Einstellungen (local.settings.json)

In Visual Studio Code enthält die Datei local.settings.json auf der Stammebene Ihres Logik-App-Projekts globale Konfigurationsoptionen, die bei der Ausführung in Ihrer lokalen Entwicklungsumgebung für alle Workflows in dieser Logik-App gelten. Wenn Ihre Workflows lokal ausgeführt werden, erfolgt der Zugriff auf diese Einstellungen als lokale Umgebungsvariablen, deren Werte sich zwischen den verschiedenen Umgebungen, in denen Sie Ihre Workflows ausführen, oft ändern können. Lesen Sie den Abschnitt Verwalten von App-Einstellungen (local.settings.json), um zu erfahren, wie Sie diese Einstellungen anzeigen und verwalten.

App-Einstellungen in Azure Logic Apps funktionieren ähnlich wie App-Einstellungen in Azure Functions oder Azure-Web-Apps. Wenn Sie diese anderen Dienste bereits verwendet haben, sind Sie möglicherweise mit den App-Einstellungen vertraut. Weitere Informationen finden Sie unter Referenz zu App-Einstellungen für Azure Functions und Arbeiten mit Azure Functions Core Tools – Datei für lokale Einstellungen.

Damit Ihr Workflow ordnungsgemäß ausgeführt wird, sind einige App-Einstellungen erforderlich.

Verwalten von App-Einstellungen (local.settings.json)

Informationen zum Hinzufügen, Aktualisieren oder Löschen von App-Einstellungen finden Sie in den folgenden Abschnitten zum Azure-Portal, zu Visual Studio Code, der Azure CLI oder ARM-Vorlagen (Bicep). App-Einstellungen, die für Logik-Apps spezifisch sind, finden Sie im Referenzleitfaden für verfügbare App-Einstellungen (local.settings.json).

az logicapp config appsettings list --name MyLogicApp --resource-group MyResourceGroup

az logicapp config appsettings set --name MyLogicApp --resource-group MyResourceGroup --settings CUSTOM_LOGIC_APP_SETTING=12345 

Referenz für Hosteinstellungen (host.json)

In Visual Studio Code enthält die Metadatendatei host.json auf der Stammebene Ihres Logik-App-Projekts die Runtimeeinstellungen und Standardwerte, die für alle Workflows in einer Logik-App-Ressource gelten, unabhängig davon, ob die Ausführung lokal oder in Azure erfolgt. Lesen Sie den Abschnitt Verwalten von Hosteinstellungen (host.json), um zu erfahren, wie Sie diese Einstellungen anzeigen und verwalten. In der Dokumentation Grenzwert- und Konfigurationsinformationen für Azure Logic Apps finden Sie ebenfalls auf Logik-Apps bezogene Informationen zu Grenzwerten.

Auftragsorchestrierungsdurchsatz

Diese Einstellungen wirken sich auf den Durchsatz und die Kapazität für Azure Logic Apps-Instanzen mit einem einzelnen Mandanten für die Ausführung von Workflowvorgängen aus.

Beide der folgenden Einstellungen werden verwendet, um die angegebenen Workflows in der Standardlogik-App manuell zu beenden und sofort zu löschen.

Das folgende Beispiel zeigt die Syntax für diese Einstellungen, in der jeder Workflow-ID ein Doppelpunkt (:) folgt und sie durch ein Semikolon (;) getrennt sind:

"Jobs.CleanupJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2:",
"Jobs.SuspendedJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2>:"

Wiederholungsbasierte Trigger

Triggerparallelität

Die folgenden Einstellungen funktionieren nur für Workflows, die mit einem serienbasierten Auslöser für integrierte, auf Dienstanbietern basierenden Connectors beginnen. Für einen Workflow, der mit einem funktionsbasierten Auslöser beginnt, können Sie versuchen, die Batchverarbeitung einzurichten, sofern dies unterstützt wird. Batchverarbeitung ist jedoch nicht immer die richtige Lösung. Bei Azure Service Bus-Auslösern kann beispielsweise ein Batch Nachrichten über die Sperrdauer hinaus enthalten. Daher ist jede Aktion, z. B. Abschließen oder Abbrechen, für solche Nachrichten fehlerhaft.

Aufbewahrung von Ausführungsdauer und -verlauf

Ausführen von Aktionen

Eingaben und Ausgaben

Paginierung

Segmentierung

Inlinespeichern von Inhalten oder Verwenden von Blobs

„For each“-Schleife

„Until“-Schleifen

Variablen

Integrierte HTTP-Vorgänge

Integrierte HTTP-Webhookvorgänge

Integrierte Azure Storage-Vorgänge

Blob Storage

Tabellen- und Warteschlangenspeicher

Dateifreigabe

Integrierte Azure Functions-Vorgänge

Integrierte Azure Service Bus-Vorgänge

Integrierte SFTP-Vorgänge

Verwaltete Connectorvorgänge

Wiederholungsrichtlinie für alle anderen Vorgänge

Begrenzungen

• Maximale Inhaltsgröße

  Standardmäßig sind integrierte Trigger, z. B. HTTP oder Anforderungen, auf die in Grenzwerte und Konfigurationsreferenz beschriebene Nachrichtengröße beschränkt – Nachrichten. Um Dateien zu verarbeiten, die größer als der Grenzwert sind, versuchen Sie, Ihre Inhalte als Blob in Azure Blob Storage hochzuladen, und rufen Sie dann Ihre Inhalte mit dem Azure Blob-Connector ab.

Verwalten von Hosteinstellungen (host.json)

Sie können Hosteinstellungen hinzufügen, aktualisieren oder löschen, die die Runtimekonfigurationseinstellungen und Werte angeben, die für alle Workflows in dieser Logik-App gelten. Beispiele hierfür sind Standardwerte für den Durchsatz, die Kapazität und die Datengröße, unabhängig davon, ob die Ausführung lokal oder in Azure erfolgt. Hosteinstellungen, die spezifisch für Logik-Apps sind, finden Sie im Referenzleitfaden für verfügbare Runtime- und Bereitstellungseinstellungen (host.json).

Azure-Portal (host.json)

Führen Sie die folgenden Schritte aus, um die Hosteinstellungen für Ihre auf einem einzelnen Mandanten basierende Logik-App im Azure-Portal zu überprüfen:

1. Suchen Sie im Suchfeld des Azure-Portals Ihre Logik-App, und öffnen Sie diese.

2. Wählen Sie im Ressourcenmenü unter Entwicklungstools die Option Erweiterte Tools aus.

3. Wählen Sie im Bereich Erweiterte Tools die Option Los aus, wodurch die Kudu-Umgebung für Ihre Logik-App geöffnet wird.

4. Öffnen Sie auf der Kudu-Symbolleiste das Menü Debugkonsole, und wählen Sie CMD aus.

   Ein Konsolenfenster wird geöffnet, in dem Sie mithilfe der Eingabeaufforderung zum Ordner wwwroot navigieren können. Alternativ können Sie die Verzeichnisstruktur durchsuchen, die oben im Konsolenfenster angezeigt wird.

5. Navigieren Sie entlang des folgenden Pfads zum Ordner wwwroot: ...\home\site\wwwroot.

6. Klicken Sie oben im Konsolenfenster in der Verzeichnistabelle neben der Datei host.json auf Bearbeiten.

7. Nachdem die Datei host.json geöffnet wurde, überprüfen Sie die Hosteinstellungen, die Sie zuvor zu Ihrer Logik-App hinzugefügt haben.

   Weitere Informationen zu Hosteinstellungen finden Sie im Referenzleitfaden für verfügbare Hosteinstellungen (host.json).

Führen Sie die folgenden Schritte aus, um eine Einstellung hinzuzufügen:

1. Beenden Sie Ihre Logik-App im Azure-Portal, bevor Sie Einstellungen hinzufügen oder bearbeiten.

   1. Wählen Sie im Ressourcenmenü Übersicht aus.

   2. Wählen Sie in der Symbolleiste des Bereichs Übersicht die Option Beenden aus.

2. Wenn die host.json-Datei bereits geöffnet ist, kehren Sie zur host.json-Datei zurück. Führen Sie andernfalls die vorstehenden Schritte aus, um die host.json-Datei zu öffnen.

3. Fügen Sie unter dem extensionBundle-Objekt das extensions-Objekt hinzu, das die Objekte workflow und settings umfasst. Beispiel:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

4. Fügen Sie im settings-Objekt eine flache Liste mit den Hosteinstellungen hinzu, die Sie für alle Workflows in Ihrer Logik-App verwenden möchten, unabhängig davon, ob diese Workflows lokal oder in Azure ausgeführt werden. Beispiel:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

5. Denken Sie daran, abschließend auf Speichern zu klicken.

6. Starten Sie jetzt Ihre Logik-App neu. Navigieren Sie zurück zur Seite Übersicht Ihrer Logik-App, und klicken Sie auf Neu starten.

Visual Studio Code (host.json)

Führen Sie die folgenden Schritte aus, um die Hosteinstellungen für Ihre Logik-App in Visual Studio Code zu überprüfen.

1. Suchen Sie die Datei host.json auf der Stammprojektebene in Ihrem Logik-App-Projekt, und öffnen Sie diese.

2. Überprüfen Sie im extensions-Objekt unter workflows und settings die Hosteinstellungen, die zuvor zu Ihrer Logik-App hinzugefügt wurden. Andernfalls wird das extensions-Objekt nicht in der Datei angezeigt.

   Weitere Informationen zu Hosteinstellungen finden Sie im Referenzleitfaden für verfügbare Hosteinstellungen (host.json).

Führen Sie die folgenden Schritte aus, um eine Hosteinstellung hinzuzufügen:

1. Fügen Sie in der Datei host.json unter dem extensionBundle-Objekt das extensions-Objekt hinzu, das die Objekte workflow und settings umfasst. Beispiel:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

2. Fügen Sie im settings-Objekt eine flache Liste mit den Hosteinstellungen hinzu, die Sie für alle Workflows in Ihrer Logik-App verwenden möchten, unabhängig davon, ob diese Workflows lokal oder in Azure ausgeführt werden. Beispiel:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

Nächste Schritte

• Erstellen von Parametern für Werte, die sich in Workflows zwischen Umgebungen für Azure Logic Apps-Instanzen mit einem einzelnen Mandanten ändern
• Einrichten der DevOps-Bereitstellung für Azure Logic Apps-Instanzen mit einem einzelnen Mandanten