Erstellen von Standardlogik-App-Workflows für die Hybridbereitstellung in Ihrer eigenen Infrastruktur

Gilt für: Azure Logic Apps (Standard)

Für Szenarien, in denen Sie Ihre eigene Infrastruktur nutzen, steuern und verwalten müssen, erstellen Sie Standard-Logik-App-Workflows mit dem hybriden Bereitstellungsmodell in Azure Logic Apps. Dieses Modell bietet Funktionen zum Erstellen und Hosten von Integrationslösungen für teilweise verbundene Umgebungen, die lokale Verarbeitung, Speicher und Netzwerkzugriff erfordern. Ihre Infrastruktur kann lokale Systeme, private Clouds und öffentliche Clouds umfassen. Durch die Verwendung des Hybridmodells wird Ihr Standard-Logic-App-Workflow vom Azure Logic Apps-Runtime angetrieben, das auf Ihrer Infrastruktur als Teil einer Azure Container Apps-Erweiterung gehostet wird.

Eine Architekturübersicht, die zeigt, wo Workflows der Standardlogik-App in einer teilweise verbundenen Umgebung gehostet und ausgeführt werden, finden Sie unter Einrichten von Infrastrukturanforderungen für die Hybridbereitstellung für Standardlogik-Apps.

Diese Anleitung zeigt, wie man einen Standard-Logik-App-Workflow erstellt und bereitstellt, indem man nach der Einrichtung der notwendigen Ressourcen für das Hosting der App das hybride Bereitstellungsmodell verwendet.

Important

Die lokalen Azure Logic Apps-Laufzeit und Workflows, die nur lokal verfügbare Abhängigkeiten verwenden, können weiterhin laufen, wenn die Azure-Konnektivität unterbrochen wird. Von Azure abhängige Verwaltung, Bereitstellung, Überwachung, Identitätsvorgänge und verwaltete Konnektoren sind im getrennten Zustand möglicherweise nicht verfügbar. Nach 24 Stunden könnten Sie Logging-Daten verlieren, obwohl die lokale Laufzeitlaufzeit weiterläuft. Weitere Informationen finden Sie unter Einschränkungen für hybride Bereitstellung.

Einschränkungen

Für die derzeit unterstützten Azure-Regionen, unterstützte Kubernetes-Cluster und plattformweite Einschränkungen siehe Einschränkungen für hybride Bereitstellung.

Die folgenden Einschränkungen gelten, wenn Sie hybride Logik-Apps erstellen und betreiben:

Einschränkung	BESCHREIBUNG
Verwaltete Identitätsauthentifizierung für verwaltete API-Verbindungen	Verwaltete API-Verbindungen unterstützen derzeit keine Authentifizierung mit verwalteter Identität in hybriden Logic Apps. Sie müssen Ihre eigene App-Registrierung mit Microsoft Entra ID erstellen. Um weitere Informationen zu erhalten befolgen Sie die Schritte weiter unten in diesem Leitfaden.
Funktionsbasierte Trigger	Einige funktionsbasierte Trigger, z. B. Azure Blob, Cosmos DB und Event Hubs, erfordern eine Verbindung mit dem Azure-Speicherkonto, das Ihrer Standardlogik-App zugeordnet ist. Wenn Sie funktionsbasierte Auslöser verwenden, fügen Sie in den Umgebungsvariablen Ihrer Standardlogik-App im Azure-Portal oder in der local.settings.json Datei Ihres Logik-App-Projekts in Visual Studio Code die App-Einstellung namens AzureWebJobsStorage hinzu, und stellen Sie die Verbindungszeichenfolge für Ihr Speicherkonto bereit: "Values": { "name": "AzureWebJobsStorage", "value": "{storage-account-connection-string}" }

Verhalten während einer Azure-Konnektivitätsunterbrechung

• Workflows können weiterhin laufen, wenn die Laufzeit und alle erforderlichen Workflow-Abhängigkeiten lokal verfügbar bleiben.
• Eingebaute Operationen laufen mit der lokalen Laufzeit, aber jeder externe Dienst, der von einer Operation aufgerufen wird, muss erreichbar bleiben.
• Managed Connector-Operationen erfordern eine Verbindung zu ihren Azure-gehosteten Diensten.
• Azure-Portalverwaltung, Azure-basierte Bereitstellung, Identitätsoperationen und Telemetrielieferung könnten unverfügbar oder verzögert werden.
• Wenn die Runtime-Umgebung nach 24 Stunden weiterhin getrennt bleibt, könnten Sie Protokolldaten verlieren, die nach diesem Zeitpunkt generiert werden.

Wenn Ihre Workloads während einer längeren Trennung Bereitstellung, Überwachung, Benachrichtigung, Neueinreichung oder Identitätsoperationen erfordern, überprüfen Sie das Verhalten Ihrer spezifischen Konfiguration mit Ihrem Microsoft Account oder Produktteam.

Voraussetzungen

• Ein Azure-Konto und ein Azure-Abonnement. Falls Sie kein Abonnement besitzen, können Sie sich für ein kostenloses Azure-Konto registrieren.

• Die folgenden kundenverwalteten Ressourcen, die alle im selben Netzwerk existieren müssen, um die erforderliche Konnektivität zu gewährleisten:

  • Ein unterstützter Kubernetes-Cluster, der mit Azure Arc verbunden ist
  • Eine SQL-Datenbank speichert lokal Workflow-Verlauf, Eingaben und Ausgaben für die Verarbeitung
  • Eine SMB-Dateifreigabe (Server Message Block) zum lokalen Speichern von Artefakten, die von Ihren Workflows verwendet werden

  Um diese Anforderungen zu erfüllen, richten Sie diese Ressourcen ein, um hybride Bereitstellung für Standard-Workflows zu unterstützen.

• Um in Visual Studio Code zu arbeiten, benötigen Sie die Azure Logic Apps (Standard)-Erweiterung für Visual Studio Code mit den entsprechenden Voraussetzungen.

  Tipp

  Wenn Sie über eine neue Visual Studio Code-Installation verfügen, vergewissern Sie sich, dass Sie einen einfachen Standardworkflow lokal ausführen können, bevor Sie versuchen, die Bereitstellung in Ihrer eigenen Infrastruktur durchzuführen. Diese Testausführung hilft beim Isolieren von Fehlern, die möglicherweise in Ihrem Standardworkflowprojekt vorhanden sind.

Erstellen ihrer Standardlogik-App

Portal

Erstellen Sie Ihre Standardlogik-App für die Hybridbereitstellung, indem Sie die folgenden Schritte ausführen:

1. Geben Sie in das Suchfeld des Azure-Portals den Begriff Logic Apps ein, und wählen Sie Logic Apps aus.

2. Wählen Sie auf der Symbolleiste der Seite Logic Apps die Option Hinzufügen aus.

3. Wählen Sie auf der Seite Erstellen einer Logik-App unter StandardHybrid aus.

4. Geben Sie auf der Seite Create Logic App (Hybrid) die folgenden Informationen ein:

   Eigenschaft	Erforderlich	Wert	BESCHREIBUNG
   Abonnement	Ja	< Name des Azure-Abonnements>	Den Namen Ihres Azure-Abonnements In diesem Beispiel wird Nutzungsbasierte Zahlung verwendet.
   Ressourcengruppe	Ja	< Name der Azure-Ressourcengruppe>	Die Azure-Ressourcengruppe, in der Sie Ihre Hybrid-App und zugehörige Ressourcen erstellen. Dieser Name muss regionsübergreifend eindeutig sein und darf nur Buchstaben, Ziffern, Bindestriche (-), Unterstriche (_), Klammern (()) und Punkte (.) enthalten. In diesem Beispiel wird eine Ressourcengruppe namens Hybrid-RG erstellt.
   Name der Logik-App	Ja	< Logic-App-Name>	Der Name der Logik-App, der für Regionen eindeutig sein muss und nur Kleinbuchstaben, Zahlen oder Bindestriche (-) enthalten kann. In diesem Beispiel wird my-logic-app-hybrid verwendet.
   Region	Ja	< Azure-Region>	Eine Azure-Region, die hybride Bereitstellung unterstützt. In diesem Beispiel wird USA, Osten verwendet.
   Mit Container-App verbundene Umgebung	Ja	< Name der verbundenen Umgebung>	Das Arc-fähige Kubernetes-Cluster, das Sie als Bereitstellungsumgebung für Ihre Logik-App erstellt haben. Weitere Informationen finden Sie im Tutorial: Aktivieren von Azure Container Apps auf Azure Arc-fähigem Kubernetes.
   Konfigurieren von Speichereinstellungen	Ja	„Aktiviert“ oder „Deaktiviert“	Setzt die Registerkarte Speicher auf der Seite Erstellen einer Logik-App (Hybrid) fort.

   Das folgende Beispiel zeigt die Seite zum Erstellen von Logik-Apps im Azure-Portal mit Beispielwerten:

   

5. Geben Sie auf der Seite Speicher die folgenden Informationen über den Speicheranbieter und die SMB-Dateifreigabe an, die Sie zuvor eingerichtet haben:

   Eigenschaft	Erforderlich	Wert	BESCHREIBUNG
   SQL-Verbindungszeichenfolge	Ja	< sql-server-verbindungsstring>	Die zuvor von Ihnen gespeicherte SQL Server-Verbindungszeichenfolge. Weitere Informationen finden Sie unter Erstellen eines SQL Server-Speicheranbieters.
   Hostname	Ja	< Dateifreigabe-Hostname>	Der Hostname für Ihre SMB-Dateifreigabe.
   Dateifreigabepfad	Ja	< Dateifreigabepfad>	Der Dateifreigabepfad für Ihre SMB-Dateifreigabe.
   Benutzername	Ja	< Dateifreigabe-Benutzername>	Der Benutzername für Ihre SMB-Dateifreigabe.
   Kennwort	Ja	< Dateifreigabekennwort>	Das Kennwort für Ihre SMB-Dateifreigabe.

6. Wenn Sie fertig sind, wählen Sie Überprüfen + Erstellen aus. Bestätigen Sie die bereitgestellten Informationen, und wählen Sie Erstellen aus.

7. Nachdem Azure die Bereitstellung abgeschlossen hat, wählen Sie Zu Ressource wechseln aus.

   Das Azure-Portal öffnet Ihre Logik-App-Ressource, z. B.:

   

8. Wählen Sie im Ressourcenmenü der Logik-App unter Workflows die Option Workflows aus.

9. Wählen Sie auf der Symbolleiste der Seite Workflows die Option Hinzufügen aus, um einen leeren zustandsbehafteten oder zustandslosen Workflow hinzuzufügen.

10. Nachdem der Designer geöffnet wurde, erstellen Sie Ihren Workflow, indem Sie einen Trigger und Aktionen hinzufügen.

    Weitere Informationen finden Sie unter Erstellen eines Workflows mit einem Trigger oder einer Aktion.

Visual Studio Code

Wenn Sie mit der SMB-Dateifreigabe bereitstellen möchten, vergewissern Sie sich, dass die folgenden Bedingungen erfüllt sind, bevor Sie Ihre Standardlogik-App für die Hybridbereitstellung in Visual Studio Code erstellen:

• Auf ihren SMB-Dateifreigabeserver kann zugegriffen werden.
• Port 445 ist auf dem Computer geöffnet, auf dem Sie Visual Studio Code ausführen.

Erstellen Ihrer Logik-App

1. Führen Sie Visual Studio Code als Administrator aus.

2. Wählen Sie auf der Aktivitätsleiste in Visual Studio Code das Azure-Symbol aus.

3. Wählen Sie im Abschnitt Arbeitsbereich auf der Symbolleiste das Symbol „Azure Logic Apps“ aus, und dann Neues Projekt erstellen.

4. Navigieren Sie zu dem Speicherort, an dem Sie den Projektordner für Ihre Standardlogik-App erstellen möchten. Erstellen Sie Ihren Projektordner, wählen Sie den Ordner aus, und wählen Sie dann Auswählen aus.

5. Wählen Sie in der Workflowtypliste Zustandsbehafteten Workflow oder Zustandslosen Workflow aus. Geben Sie einen Namen für den Workflow ein.

   In diesem Beispiel wird Zustandsbehafteter Workflow ausgewählt und my-stateful-workflow als Name verwendet.

6. Wählen Sie in der angezeigten Liste In aktuellem Fenster öffnen aus.

   Visual Studio Code erstellt und öffnet Ihr Logik-App-Projekt, um die workflow.json-Datei anzuzeigen.

7. Wählen Sie in der angezeigten Liste Connectors aus Azure verwenden aus.

8. Wählen Sie in der Abonnementliste das Azure-Abonnement aus.

9. Wählen Sie in der Ressourcengruppenliste Neue Ressourcengruppe erstellen aus. Geben Sie einen Namen für Ihre Ressourcengruppe an.

   In diesem Beispiel wird Hybrid-RGverwendet.

10. Wählen Sie in der Standortliste eine Azure-Region aus, die hybride Bereitstellung unterstützt.

    In diesem Beispiel wird USA, Osten verwendet.

11. Öffnen Sie im Explorer-Fenster das Kontextmenü für die workflow.json-Datei und wählen Sie Designer öffnen aus.

12. Erstellen Sie Ihren Workflow wie gewohnt, indem Sie einen Trigger und Aktionen hinzufügen. Weitere Informationen finden Sie unter Erstellen eines Workflows mit einem Trigger oder einer Aktion.

Bereitstellen Ihrer Logik-App

Nachdem Sie den Workflow erstellt haben, können Sie Ihre Logik-App in Ihrer lokalen verbundenen Azure-Container-Apps-Umgebung bereitstellen.

ZIP-Bereitstellung

Zip-Bereitstellung bietet die folgenden Vorteile gegenüber der SMB-Dateifreigabeoption.

• Visual Studio Code benötigt keine Verbindung mit der SMB-Dateifreigabe.
• Nachfolgende Einsätze benötigen keine Zugangsdaten für die SMB-Dateifreigabe.
• Zip-Bereitstellung bietet eine stabilere und zuverlässigere Option im Vergleich zur SMB-Bereitstellung, die anfällig für 409-Konflikte ist.

Beide Bereitstellungsoptionen hängen von Azure-Management-Diensten ab. Die SMB-Bereitstellung verändert, wie Workflow-Artefakte übertragen werden, macht die hybride Logik-App aber nicht unabhängig von Azure Arc oder Azure Management.

Führen Sie die folgenden Schritte aus, um die ZIP-Bereitstellung zu verwenden:

1. Erstellen Sie eine App-Registrierung mithilfe der Microsoft Entra-ID. Geben Sie in den entsprechenden Schritten eine Client-ID, Objekt-ID und einen geheimen Clientschlüssel an.

2. Um die ZIP-Bereitstellung mit einer vorhandenen Standard-Logik-App-Ressource im Azure-Portal zu verwenden, müssen Sie die App-Registrierung manuell als App-Einstellung in Ihrer Standard-Logik-App-Ressource hinzufügen.

   Weitere Informationen finden Sie unter Hinzufügen von App-Registrierungswerten zu Ihrer Standardlogik-App.

Wenn Sie Bedenken beim Erstellen einer App-Registrierung haben, können Sie weiterhin die Bereitstellungsoption für die SMB-Dateifreigabe verwenden.

1. Wählen Sie in Visual Studio Code auf der Aktivitätsleiste " Einstellungen verwalten" (Zahnradsymbol) >aus.

2. Wählen Sie unter Arbeitsbereich die Option Erweiterungen>Azure Logic Apps (Standard)>SMBDeployment For Hybrid>Aktivieren, um die SMB-Bereitstellung für hybride Logik-Apps zu nutzen aus.

3. Folgen Sie dem nächsten Abschnitt für die Bereitstellung der SMB-Dateifreigabe.

Bereitstellung der SMB-Dateifreigabe

1. Öffnen Sie im Explorer-Fenster von Visual Studio Code das Kontextmenü für den Workflowknoten, der in diesem Beispiel my-stateful-workflow ist, und wählen Sie Für Logik-App bereitstellen aus.

2. Wählen Sie in der Abonnementliste das Azure-Abonnement aus.

3. Wählen Sie in der Liste der verfügbaren Logik-Apps Neue Logik-App (Standard) in Azure erstellen aus. Stellen Sie einen global eindeutigen App-Namen bereit, der nur alphanumerische Zeichen in Kleinbuchstaben oder Bindestriche verwendet.

   In diesem Beispiel wird my-logic-app-hybrid verwendet.

4. Wählen Sie in der angezeigten Standortliste die gleiche Azure-Region aus, in der Sie ihre verbundene Umgebung haben.

   In diesem Beispiel wird USA, Osten verwendet.

5. Wählen Sie in der Hostingplanliste Hybrid aus.

6. Wählen Sie in der Ressourcengruppenliste Neue Ressourcengruppe erstellen aus. Geben Sie einen Namen für Ihre Ressourcengruppe an.

   In diesem Beispiel wird Hybrid-RGverwendet.

7. Wählen Sie in der Liste der verbundenen Umgebung Ihre Umgebung aus.

8. Geben Sie Ihre zuvor gespeicherten Werte für den Hostnamen, den SMB-Dateifreigabepfad, den Benutzernamen und das Kennwort für den Artefaktespeicher an.

9. Geben Sie die Verbindungszeichenfolge für die SQL-Datenbank an, die Sie für den Runtimespeicher eingerichtet haben.

   Visual Studio Code startet den Bereitstellungsprozess für Ihre Standardlogik-App.

10. Um den Bereitstellungsstatus und Azure-Aktivitätsprotokolle zu überwachen, wählen Sie im Menü AnsichtAusgabe aus. Wählen Sie im daraufhin geöffneten Fenster Azure aus.

    Nach Abschluss der Bereitstellung können Sie zum Azure-Portal wechseln, um Ihre bereitgestellte Standardlogik-App und Ihren Workflow anzuzeigen.

Versionsverwaltung für Hybridbereitstellungen

Eine Standardlogik-App mit der Hybridhostingoption erstellt automatisch eine neue Revision, bei der es sich um ein Versionsverwaltungskonzept von Azure Container Apps handelt, wenn Sie Änderungen an einem untergeordneten Workflow speichern. Diese Revision kann ein wenig Zeit in Anspruch nehmen, was bedeutet, dass Sie nach dem Speichern von Änderungen einige Augenblicke warten sollten, bevor Sie den Workflow testen.

Wenn Ihre Änderungen im Workflow noch nicht angezeigt werden, können Sie überprüfen, ob die Revision vorhanden ist:

1. Öffnen Sie Ihre Ressource im Azure-Portal. Wählen Sie im Ressourcenmenü unter Revisionen die Option Revisionen und Replikate aus.

2. Überprüfen Sie auf der Seite Revisionen und Replikate auf der Registerkarte Aktive Revisionen, ob eine neue Revision in der Liste angezeigt wird.

Weitere Informationen finden Sie in den folgenden Ressourcen:

• Aktualisieren und Bereitstellen von Änderungen in Azure Container Apps

• Verwalten von Revisionen in Azure Container Apps

Einrichten erweiterter Telemetrie oder OpenTelemetry für die Leistungsüberwachung

Sie können eine erweiterte Telemetrieauflistung in Application Insights für Ihre Standardlogik-App einrichten und dann die gesammelten Daten anzeigen, nachdem der Workflow eine Ausführung abgeschlossen hat. Diese Funktion bietet Ihnen eine einfachere Erfahrung, um Einblicke in Ihre Workflows zu erhalten und mehr Kontrolle über filterungsereignisse an der Datenquelle zu erhalten, wodurch Sie die Speicherkosten senken können. Diese Verbesserungen konzentrieren sich auf Echtzeit-Leistungsmetriken, die Einblicke in die Integrität und das Verhalten Ihres Systems bieten.

Für teilweise verbundene und lokale Szenarien können Sie Ihre Standardlogik-App so einrichten, dass Telemetrie basierend auf den von Ihnen für die spezifische Umgebung definierten OpenTelemetry-App-Einstellungen ausgegeben wird. Standardmäßig werden diese Telemetriedaten an Application Insights gesendet. Weitere Informationen finden Sie unter Erweiterte Telemetrie in Application Insights für Standard-Workflows in Azure Logic Apps aktivieren.

Application Insights benötigt Azure Connectivity. Während einer Verbindungsunterbrechung kann die Telemetrielieferung Verzögerungen erleiden, und Sie könnten nach 24 Stunden generierte Protokolldaten verlieren. Überprüfen Sie alle Anforderungen an lokale Überwachung und Warnung anhand des Telemetrieziels und der von Ihnen verwendeten Konfiguration.

Ändern der vCPU- und Speicherzuweisung im Azure-Portal

Sie können die vCPU- und Speichereinstellungen für Ihre Standardlogik-App-Ressource bearbeiten. Diese Änderungen wirken sich auf die Abrechnungsgebühr für Ihre Standardlogik-App-Workloads aus.

1. Öffnen Sie im Azure-Portal Ihre Standard-Logik-App-Ressource.

2. Wählen Sie im Ressourcenmenü unter Einstellungen die Option Container aus.

3. Wählen Sie auf der Symbolleiste der Seite ContainerBearbeiten und Bereitstellenaus, wodurch der Bereich Einen Container bearbeiten geöffnet wird.

4. Ändern Sie auf der Registerkarte Eigenschaften unter Containerressourcenzuordnung die folgenden Werte entsprechend Ihrem Szenario:

   Eigenschaft	Wert	BESCHREIBUNG
   CPU-Kerne	- Standard: 1 - Minimum: 0,25 - Maximal: 2	Bestimmt die vCPU-Kerne, die Ihrer Containerinstanz zugewiesen werden sollen. Sie können diesen Wert um 0,25 Kerne bis zum Maximalwert erhöhen. Die Gesamtanzahl aller Containerinstanzen für diese Logik-App ist auf 2 Kerne beschränkt.
   Gedächtnis	- Standard: 2 - Minimum: 0,1 - Maximal: 4	Bestimmt die Arbeitsspeicherkapazität in gibibytes (GiB), die Ihrer Containerinstanz zugewiesen werden soll. Sie können diesen Wert um 0,1 GiB bis zum Maximalwert erhöhen. Die Gesamtkapazität für alle Containerinstanzen für diese Logik-App ist auf 4 GiB beschränkt.

5. Wählen Sie abschließend Speichern aus.

Ändern der Replikatskalierung im Azure-Portal

Sie können die automatische Skalierung für den Replikatbereich steuern, der als Reaktion auf ein Triggerereignis bereitgestellt wird. Ein Replikat ist eine neue Instanz einer Logik-App-Ressourcenrevision oder -version. Um die Minimum- und Maximumwerte für diesen Bereich zu ändern, können Sie die Skalierungsregeln ändern, um die Ereignistypen zu bestimmen, welche die Skalierung auslösen. Weitere Informationen finden Sie unter Festlegen von Skalierungsregeln in Azure Container Apps.

1. Öffnen Sie im Azure-Portal Ihre Standard-Logik-App-Ressource.

2. Wählen Sie im Ressourcenmenü unter Einstellungen die Option Skalieren aus.

3. Ändern Sie auf der Seite Skalieren unter der Einstellung „Skalierungsregel“ die folgenden Werte so, dass sie ihrem Szenario entsprechen:

   Eigenschaft	Wert	BESCHREIBUNG
   Mindestanzahl Replikate	- Standard: 1 – Minimum: 0 - Maximal: 1000	Bestimmt die Mindestanzahl der Replikate, die für die Revision zu einem bestimmten Zeitpunkt zulässig sind. Dieser Wert setzt Skalierungsregeln außer Kraft und muss kleiner als die maximale Anzahl von Replikaten sein.
   Maximale Anzahl Replikate	- Standard: 30 – Minimum: 0 - Maximal: 1000	Bestimmt die maximale Anzahl von Replikaten, die für die Revision zu einem bestimmten Zeitpunkt zulässig sind. Dieser Wert setzt Skalierungsregeln außer Kraft.

4. Wählen Sie abschließend Speichern aus.

Steuern des eingehenden Datenverkehrs an Ihre Logik-App im Azure-Portal

Sie können Ihre Logik-App für das öffentliche Web, Ihr virtuelles Netzwerk und andere Logik-Apps in Ihrer Umgebung verfügbar machen, indem Sie den Eingang aktivieren. Azure erzwingt Eingangseinstellungen über eine Reihe von Regeln, die das Routing von externem und internem Datenverkehr an Ihre Logik-App steuern. Wenn Sie den Eingang aktivieren, müssen Sie keinen Azure Load Balancer, öffentliche IP-Adresse oder andere Azure-Ressourcen erstellen, um eingehende HTTP-Anforderungen oder TCP-Datenverkehr zu aktivieren. Weitere Informationen finden Sie unter Eingang in Container Apps.

Hinweis

Wenn Sie den Eingang aktivieren, wird der gesamte Datenverkehr standardmäßig an Ihre neueste Revision weitergeleitet. Wechseln Sie zur Seite „Revisionsverwaltung“, um die Datenverkehrseinstellungen zu ändern.

1. Wählen Sie im Ressourcenmenü unter Einstellungen die Option Eingang aus.

2. Wählen Sie auf der Seite Eingang neben Eingang das Feld Aktiviert aus.

3. Konfigurieren Sie basierend auf Ihrem Szenario die verbleibenden Optionen.

   Weitere Informationen finden Sie in der folgenden Dokumentation:

   • Konfigurieren des eingehenden Datenverkehrs für Ihre App in Azure Container Apps
   • Einrichten von IP-Eingangsbeschränkungen in Azure Container Apps

Einrichten der Authentifizierung für verwaltete API-Verbindungen

Managed API-Verbindungen unterstützen derzeit keine Managed Identity Authentication in hybriden Logikanwendungen. Um diese Verbindungen zu authentifizieren, müssen Sie Ihre eigene App-Registrierung mit Microsoft Entra ID erstellen. Du kannst dann die Werte dieser App-Registrierung als Umweltvariablen in deiner Standard-Logik-App-Ressource hinzufügen. Dieses Authentifizierungsmodell erfordert eine Verbindung zu Microsoft Entra ID.

Erstellen einer App-Registrierung bei Microsoft Entra ID

Azure-Portal

1. Folgen Sie im Azure-Portal der Schnellstartanleitung: Registrieren Sie eine Anwendung bei der Microsoft Identity Platform, um eine App-Registrierung zu erstellen.

2. Suchen Sie nach Abschluss der Erstellung Ihre neue App-Registrierung im Portal.

3. Wählen Sie im Ressourcenmenü Übersicht aus und speichern Sie die folgenden Werte, die Sie später für die Verbindungsauthentifizierung benötigen:

   • Client-ID
   • Mandanten-ID

4. Wählen Sie in der Ressourcenrandleiste Zertifikate & Geheimnisse>>Neues Clientgeheimnis aus.

5. Erstelle das Client-Geheimnis und speichere sofort den Wert des Geheimnisses. Der Wert erscheint nicht mehr, nachdem du die Seite verlassen hast.

6. Führen Sie für die Objekt-ID die folgenden Schritte aus:

   1. Wählen Sie auf der Seite Übersicht den Link Verwaltete Anwendung im lokalen Verzeichnis für Ihre App-Registrierung aus:

      

   2. Kopieren Sie auf der daraufhin geöffneten Seite den Wert der Objekt-ID:

      

7. Fügen Sie nun die gespeicherten Werte als Umgebungsvariablen zu Ihrer Standardlogik-App-Ressource hinzu.

Azure-Befehlszeilenschnittstelle (Azure CLI)

1. Um eine App-Registrierung und ihren Service Principal zu erstellen, ohne eine Azure-Rolle zuzuweisen, führen Sie folgenden Befehl aus:

   az ad sp create-for-rbac \
      --name <app-registration-name> \
      --skip-assignment
   

2. Speichern Sie aus der Befehlsausgabe die Werte appId, password und tenant als Werte für die Client-ID, das Client Secret und die Tenant-ID. Das Client-Geheimnis erscheint nur in der Befehlsausgabe.

3. Rufen Sie die Objekt-ID des Dienstprinzipals ab:

   az ad sp show \
      --id <client-ID> \
      --query id \
      --output tsv
   

4. Fügen Sie nun die gespeicherten Werte als Umgebungsvariablen zu Ihrer Standardlogik-App-Ressource hinzu.

Weitere Informationen findest du unter:

• az ad sp create-for-rbac
• az ad sp show

Hinzufügen von App-Registrierungswerten zur Standardlogik-App

1. Gehen Sie im Azure-Portal zu Ihrer Standard-Logik-App-Ressource.

2. Wählen Sie im Ressourcenmenü unter EinstellungenContainer aus und wählen Sie dann die Registerkarte Umgebungsvariablen aus.

   Weitere Informationen zu App-Einstellungen und Hosteinstellungen finden Sie unter Bearbeiten von App-Einstellungen und Hosteinstellungen.

3. Wählen Sie auf der Symbolleiste Bearbeiten und bereitstellen aus.

4. Wählen Sie im Bereich Container bearbeitenUmgebungsvariablen und dann Hinzufügen aus.

5. Fügen Sie in der folgenden Tabelle jede Umgebungsvariable mit dem angegebenen Wert hinzu:

   Umgebungsvariable	Wert
   WORKFLOWAPP_AAD_CLIENTID	< my-client-ID>
   WORKFLOWAPP_AAD_OBJECTID	< my-object-ID>
   WORKFLOWAPP_AAD_TENANTID	< mein-Mieter-ID>

6. Wählen Sie abschließend Speichern aus.

Speichere und referenziere das Client-Geheimnis

Speichere das Client-Geheimnis als Geheimnis in deiner Logik-App-Ressource. Verweisen Sie auf dieses Geheimnis in der Umgebungsvariable WORKFLOWAPP_AAD_CLIENTSECRET.

Important

Rotieren Sie das Geheimnis, bevor es abläuft.

1. Navigieren Sie im Azure-Portal zu Ihrer Logik-App-Ressource.

2. In der Seitenleiste der Logik-App wähle unter EinstellungenGeheimnisse aus.

3. Wählen Sie auf der Symbolleiste Hinzufügen aus.

4. Im Fenster Geheimnis hinzufügen geben Sie folgende Informationen an und wählen Sie dann Hinzufügen:

   Schlüssel	Wert
   WORKFLOWAPP_AAD_CLIENTSECRET	< Mein-Klient-Geheimnis>

5. Wähle in der Seitenleiste der Logic App unter Einstellungen die Option Container aus, und wähle dann die Registerkarte Umgebungsvariablen aus.

6. Wählen Sie auf der Symbolleiste Bearbeiten und bereitstellen aus.

7. Füge die Umgebungsvariable WORKFLOWAPP_AAD_CLIENTSECRET hinzu, wähle die Option aus, um auf ein Geheimnis zu verweisen, und wähle das erstellte Geheimnis aus.

8. Wählen Sie abschließend Speichern aus.

Bekannte Probleme und Problembehandlung

Im folgenden Abschnitt werden derzeit bekannte Probleme und Anleitungen zur Problembehandlung häufig auftretender Probleme beschrieben.

Allgemeine Umgebungs- und Portalbereitstellungsprobleme

Sie können versuchen, das troubleshoot.ps1 PowerShell-Skript auszuführen, das für die Hybridbereitstellungsoption bereitgestellt wurde, um Probleme mit der Umgebungskonfiguration oder der Portalbereitstellung zu diagnostizieren und zu debuggen.

1. Wechseln Sie zum GitHub-Repository für Azure Logic Apps: Skripts/Hybridordner.

2. Kopieren Sie die Datei troubleshoot.ps1 in einen Ordner am selben lokalen Speicherort wie die Logik-App-Bereitstellung.

3. Führen Sie das Skript mit PowerShell aus.

Arc-fähige Kubernetes-Cluster

In seltenen Szenarien bemerken Sie möglicherweise einen hohen Speicherbedarf in Ihrem Cluster. Um dieses Problem zu verhindern, skalieren Sie entweder hoch oder fügen Sie die automatische Skalierung für Knotenpools hinzu.

Funktionshost wird nicht ausgeführt

Vergewissern Sie sich nach der Bereitstellung der Standardlogik-App, dass Ihre App ordnungsgemäß ausgeführt wird.

1. Öffnen Sie im Azure-Portal Ihre Logik-App-Ressource.

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

3. Wählen Sie auf der Seite Übersicht neben dem Feld Anwendungs-URL die Ressourcen-URL aus.

   Wenn Ihre App ordnungsgemäß ausgeführt wird, wird ein Browserfenster geöffnet und zeigt die folgende Meldung an:

   

   Wenn deine App Fehler hat, überprüfe, ob deine Kubernetes-Pods richtig laufen. Stelle sicher, dass kubectl den Kontext für deinen Cluster verwendet, und führe dann die folgenden Befehle aus:

   kubectl get ns
   kubectl get pods -n logicapps-aca-ns
   kubectl describe pod {logic-app-pod-name} -n logicapps-aca-ns 
   

   Weitere Informationen finden Sie in der folgenden Dokumentation:

   • Befehlszeilentool (kubectl)

Der Cluster hat nicht genug Kapazität

Wenn Sie den vorherigen Befehl ausgeführt haben und eine Warnung erhalten, die dem folgenden Beispiel ähnelt, verfügt Ihr Cluster nicht über genügend Knoten für die Verarbeitung:

Warning: FailedScheduling  4m52s (x29 over 46m)  default-scheduler  0/2 nodes are available: 2 Too many pods. preemption: 0/2 nodes are available: 2 No preemption victims found for incoming pod.

Für AKS erhöhen Sie die Anzahl der Knoten und richten Sie die automatische Skalierung ein, indem Sie folgende Schritte befolgen:

1. Wechseln Sie im Azure-Portal zu Ihrer Kubernetes-Dienstinstanz.

2. Wählen Sie im Instanzmenü unter Einstellungen die Option Knotenpools aus.

3. Wählen Sie auf der Symbolleiste der Seite Knotentools+ Knotenpool hinzufügen aus.

Weitere Informationen finden Sie in der folgenden Dokumentation:

• Erstellen von Knotenpools für einen Cluster in Azure Kubernetes Service (AKS)
• Verwalten von Knotenpools für einen Cluster in Azure Kubernetes Service (AKS)
• Übersicht über die automatische Clusterskalierung in Azure Kubernetes Service (AKS)
• Verwenden der Autoskalierung für Cluster in Azure Kubernetes Service (AKS)

Für OpenShift oder RKE2 verwenden Sie das unterstützte Verfahren für Ihre Kubernetes-Distribution, um die Kapazität zu erhöhen.

SMB Container Storage Interface (CSI)-Treiber nicht installiert

Nachdem Sie den vorherigen kubectl describe pod-Befehl ausgeführt haben, vergewissern Sie sich, ob der CSI-Treiber für Ihre SMB-Dateifreigabe ordnungsgemäß installiert ist, wenn die folgende Warnung angezeigt wird:

Warning FailedScheduling 5m16s (x2 over 5m27s)  default-scheduler 0/14 nodes are available: pod has unbound immediate PersistentVolumeClaims. preemption: 0/14 nodes are available: 14 Preemption is not helpful for scheduling.

Normal NotTriggerScaleUp 9m49s (x31 over 14m) cluster-autoscaler pod didn't trigger scale-up: 3 pod has unbound immediate PersistentVolumeClaims

Zur Bestätigung führen Sie folgenden Befehl aus:

kubectl get csidrivers

Wenn die Ergebnisse smb.csi.k8s.io nicht enthalten, folgen Sie den distribution-spezifischen Anweisungen zur Installation des SMB-Treibers.

Um den Status des CSI SMB-Treiberpods zu überprüfen, führen Sie folgenden Befehl aus:

kubectl --namespace=kube-system get pods --selector="app.kubernetes.io/name=csi-driver-smb" --watch

Verwandte Inhalte

• Einrichten von Anforderungen für die Bereitstellung von Standardlogik-Apps in Ihrer eigenen Infrastruktur
• Aktivieren der erweiterten Telemetrie in Application Insights für Standardworkflows in Azure Logic Apps
• Warum von BizTalk Server auf Azure Logic Apps Standard migrieren?
• Migrate BizTalk Server mit Azure Logic Apps Migration Agent